# CampusForum

**Repository Path**: asia3115/CampusForum

## Basic Information

- **Project Name**: CampusForum
- **Description**: 基于springboot+vue的校园论坛

- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2025-07-02
- **Last Updated**: 2025-07-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# Campus Forum 项目说明

这是一个基于 Spring Boot 的校园论坛项目，旨在为高校学生提供一个交流与分享的平台。用户可以注册、登录、发布文章、评论、点赞等，同时提供了日志记录、权限控制和全局异常处理等模块。

---

## 功能特点

- 用户注册与登录（JWT 认证）
- 文章发布与管理（支持分类和图片）
- 评论与回复系统
- 用户信息管理
- 全局异常处理与日志记录
- 支持分页查询文章

---

## 项目结构

- **Controller**：处理 HTTP 请求，如用户登录、文章发布等。
- **DTO**：数据传输对象，用于接收客户端请求参数。
- **Entity**：数据库实体类，与数据库表一一对应。
- **Mapper**：MyBatis Plus 数据库映射接口。
- **Service**：业务逻辑接口及其实现。
- **VO**：视图对象，用于向前端返回数据。
- **Utils**：工具类，如 JWT 工具、异常处理工具等。
- **Config**：配置类，包括 MyBatis Plus 配置和 Web 配置。
- **Common**：通用类，如分页结果封装类。

---

## 安装与运行

### 环境要求

- Java 8 或更高版本
- Maven
- MySQL 数据库
- Redis（用于缓存）
- Git

### 安装步骤

1. **克隆项目**：
   ```bash
   git clone <项目地址>
   ```

2. **配置数据库**：
   - 在 `application.yml` 中配置 MySQL 数据库连接信息。
   - 创建所需数据库和表结构。

3. **启动项目**：
   ```bash
   cd campus-forum
   mvn spring-boot:run
   ```

4. **访问接口**：
   启动成功后，访问 `http://localhost:8080` 开始使用 API。

---

## 使用示例

### 用户登录

**请求：**
```http
POST /user/user/login
Content-Type: application/json

{
  "email": "user@example.com",
  "password": "yourpassword"
}
```

**响应：**
```json
{
  "code": 200,
  "msg": "success",
  "data": {
    "id": 1,
    "token": "your-jwt-token"
  }
}
```

---

## 异常处理

项目通过 `GlobalExceptionHandler` 统一处理异常，返回统一格式的错误信息：

```json
{
  "code": 400,
  "msg": "错误信息",
  "data": null
}
```

---

## 贡献指南

欢迎贡献代码！请遵循以下步骤：

1. Fork 项目
2. 创建新分支 (`git checkout -b feature/your-feature-name`)
3. 提交代码 (`git commit -am 'Add some feature'`)
4. Push 到分支 (`git push origin feature/your-feature-name`)
5. 提交 Pull Request

---

## 协议

本项目使用 MIT License。详情请查看 `LICENSE` 文件。

---

## 联系我们

如果你有任何问题或建议，请在 Gitee 上提交 Issue 或联系项目维护者。