# 校园论坛系统 Campus Forum System

**Repository Path**: meda/Campus-Forum-System

## Basic Information

- **Project Name**: 校园论坛系统 Campus Forum System
- **Description**: 校园论坛系统 Campus Forum System是一个基于SpringBoot3，Vue3，TS的全栈项目，采用Element Plus作为UI组件库，MyBatis-Plus作为ORM框架，JWT实现用户认证。支持用户管理、板块管理、帖子发布与评论、消息通知等功能，管理员可通过用户管理模块修改所有用户信息，包括头像、用户名、昵称、邮箱、积分、角色和注册时间。项目结构清晰，代码风格规范。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-02-23
- **Last Updated**: 2026-02-26

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园论坛系统

## 📖 项目简介

一个基于 Vue 3 + Spring Boot 的现代化校园论坛系统，专为高校师生打造，提供高质量的学术交流和校园生活分享平台。系统支持用户发帖、评论、板块管理等核心功能，同时集成了积分系统、权限管理、消息通知等高级特性。

## 🎯 项目目标

- **构建现代化校园社区**：提供友好的用户界面和流畅的交互体验
- **促进学术交流**：支持 Markdown 语法，方便分享技术内容和学术讨论
- **完善的权限体系**：基于角色的访问控制，确保系统安全和管理效率
- **高性能架构**：前后端分离设计，支持高并发访问

## 🛠 技术栈

### 前端技术
- **Vue 3** - 使用 Composition API 和 `<script setup>` 语法，提供更好的代码组织和复用性
- **TypeScript** - 完整的类型支持，减少运行时错误
- **Vite** - 现代化的前端构建工具，提供快速的开发体验
- **Vue Router 4** - 官方路由管理，支持嵌套路由和路由守卫
- **Pinia** - 轻量级状态管理库，替代 Vuex
- **Element Plus** - 基于 Vue 3 的 UI 组件库，提供丰富的界面元素
- **@kangc/v-md-editor** - 功能强大的 Markdown 编辑器，支持代码高亮和数学公式
- **Sass** - CSS 预处理器，提高样式代码的可维护性
- **Axios** - HTTP 客户端，用于与后端 API 通信

### 后端技术
- **Spring Boot 3.3.5** - 主框架，提供自动配置和快速开发能力
- **Java 17** - 使用稳定的 Java 特性，确保系统兼容性
- **MySQL 8.0** - 关系型数据库，存储系统数据
- **MyBatis-Plus 3.5.10** - ORM 框架，简化数据库操作

- **Spring Security + JWT** - 安全认证框架，实现无状态登录
- **Knife4j 4.3.0** - API 文档生成工具，提供交互式接口文档
- **Maven** - 项目构建和依赖管理工具
- **Lombok** - 简化 Java 代码，减少样板代码

## 📁 项目结构

### 后端结构
```
backend/
├── src/main/java/com/zwz/forum/      # 后端代码
│   ├── aspect/                       # 切面（如管理员权限检查、积分奖励）
│   ├── common/                       # 公共模块
│   │   ├── annotation/               # 自定义注解
│   │   ├── exception/                # 异常处理
│   │   └── Result.java               # 统一响应封装
│   ├── config/                       # 配置类（数据库、安全、Web MVC等）
│   ├── controller/                   # 控制器（处理 HTTP 请求）
│   ├── dto/                          # 数据传输对象（请求和响应）
│   ├── entity/                       # 实体类（对应数据库表）
│   ├── mapper/                       # 数据访问层（MyBatis 接口）
│   ├── security/                     # 安全相关（JWT 过滤器）
│   ├── service/                      # 服务层（业务逻辑）
│   │   └── impl/                     # 服务实现
│   ├── utils/                        # 工具类
│   ├── vo/                           # 视图对象（返回给前端的数据结构）
│   └── ForumApplication.java         # 应用入口
├── src/main/resources/               # 资源文件
│   ├── mapper/                       # MyBatis XML 映射文件
│   └── application.yaml              # 应用配置文件
├── sql/                              # SQL 脚本
│   └── campus_forum.sql              # 数据库初始化脚本
├── file/                             # 文件存储
│   └── image/                        # 图片文件
└── pom.xml                           # Maven 配置文件
```

### 前端结构
```
frontend/
├── src/                              # 前端代码
│   ├── api/                          # API 接口封装
│   ├── assets/                       # 静态资源（样式、图片等）
│   ├── components/                   # 可复用组件
│   │   └── icons/                    # 图标组件
│   ├── layout/                       # 布局组件
│   ├── router/                       # 路由配置
│   ├── store/                        # Pinia 状态管理
│   ├── utils/                        # 工具函数
│   ├── views/                        # 页面组件
│   │   ├── admin/                    # 管理员后台
│   │   ├── auth/                     # 登录注册
│   │   ├── forum/                    # 论坛相关
│   │   ├── moderator/                # 板主后台
│   │   └── user/                     # 用户中心
│   ├── App.vue                       # 根组件
│   └── main.ts                       # 应用入口
├── public/                           # 公共静态资源
├── package.json                      # 项目依赖配置
├── tsconfig.json                     # TypeScript 配置
└── vite.config.ts                    # Vite 配置
```

## 🚀 功能特性

### 用户系统
- **用户注册/登录**：支持手机号注册，JWT 令牌认证
- **个人信息管理**：头像上传、昵称修改、密码重置
- **积分系统**：发帖、评论获得积分，积分等级体系
- **权限管理**：三级权限体系（普通用户/板主/管理员）
- **消息通知**：评论回复、系统消息、未读消息提醒

### 论坛功能
- **多板块管理**：支持创建多个论坛板块，每个板块可设置板主
- **帖子管理**：发布、编辑、删除帖子，支持 Markdown 格式
- **评论系统**：支持楼中楼回复，评论点赞
- **帖子搜索**：支持标题和内容搜索，按时间、热度排序
- **浏览量统计**：实时统计帖子浏览次数
- **帖子置顶**：管理员和板主可置顶重要帖子
- **图片上传**：支持在帖子和评论中插入图片

### 管理功能
- **管理员后台**：用户管理、内容审核、系统配置
- **板主后台**：板块管理、帖子管理、用户管理
- **数据统计**：用户活跃度、帖子数量、板块热度等统计

## 📦 快速开始

### 环境要求
- **Java 17** 或更高版本
- **Node.js v22.17.0** 或更高版本
- **MySQL 8.0** 或更高版本

### 数据库配置
1. **创建数据库**：在 MySQL 中创建名为 `campus_forum` 的数据库
2. **导入数据**：执行 `backend/sql/campus_forum.sql` 脚本初始化表结构和基础数据

### 后端配置
1. **修改配置文件**：编辑 `backend/src/main/resources/application.yaml`
   ```yaml
   spring:
     datasource:
       url: jdbc:mysql://localhost:3306/campus_forum?useUnicode=true&characterEncoding=utf-8&serverTimezone=Asia/Shanghai
       username: root  # 修改为你的 MySQL 用户名
       password: root  # 修改为你的 MySQL 密码
   ```

2. **构建和启动后端**
   ```bash
   cd backend
   # 编译项目
   mvn clean install
   # 启动应用
   mvn spring-boot:run
   ```

3. **访问 API 文档**：http://localhost:8080/doc.html

### 前端配置
1. **安装依赖**
   ```bash
   cd frontend
   npm install
   ```

2. **启动开发服务器**
   ```bash
   npm run dev
   ```

3. **访问应用**：http://localhost:5173

## 📊 数据库设计

### 核心表结构

#### 1. **sys_user** - 用户表
| 字段名 | 数据类型 | 描述 |
| :--- | :--- | :--- |
| `id` | `BIGINT` | 用户ID |
| `username` | `VARCHAR(50)` | 用户名 |
| `password` | `VARCHAR(100)` | 加密后的密码 |
| `nickname` | `VARCHAR(50)` | 昵称 |
| `avatar` | `VARCHAR(255)` | 头像URL |
| `phone` | `VARCHAR(20)` | 手机号 |
| `role` | `INT` | 角色（0:普通用户, 1:板主, 2:管理员） |
| `score` | `INT` | 积分 |
| `status` | `INT` | 状态（0:禁用, 1:启用） |
| `created_at` | `DATETIME` | 创建时间 |
| `updated_at` | `DATETIME` | 更新时间 |

#### 2. **forum_board** - 板块表
| 字段名 | 数据类型 | 描述 |
| :--- | :--- | :--- |
| `id` | `BIGINT` | 板块ID |
| `name` | `VARCHAR(50)` | 板块名称 |
| `description` | `VARCHAR(255)` | 板块描述 |
| `moderator_id` | `BIGINT` | 板主ID |
| `post_count` | `INT` | 帖子数量 |
| `created_at` | `DATETIME` | 创建时间 |
| `updated_at` | `DATETIME` | 更新时间 |

#### 3. **forum_post** - 帖子表
| 字段名 | 数据类型 | 描述 |
| :--- | :--- | :--- |
| `id` | `BIGINT` | 帖子ID |
| `title` | `VARCHAR(100)` | 标题 |
| `content` | `TEXT` | 内容（Markdown格式） |
| `user_id` | `BIGINT` | 作者ID |
| `board_id` | `BIGINT` | 所属板块ID |
| `view_count` | `INT` | 浏览量 |
| `comment_count` | `INT` | 评论数 |
| `is_top` | `INT` | 是否置顶（0:否, 1:是） |
| `status` | `INT` | 状态（0:禁用, 1:正常） |
| `created_at` | `DATETIME` | 创建时间 |
| `updated_at` | `DATETIME` | 更新时间 |

#### 4. **forum_comment** - 评论表
| 字段名 | 数据类型 | 描述 |
| :--- | :--- | :--- |
| `id` | `BIGINT` | 评论ID |
| `post_id` | `BIGINT` | 所属帖子ID |
| `user_id` | `BIGINT` | 评论者ID |
| `content` | `TEXT` | 评论内容 |
| `parent_id` | `BIGINT` | 父评论ID（用于楼中楼） |
| `created_at` | `DATETIME` | 创建时间 |
| `updated_at` | `DATETIME` | 更新时间 |

#### 5. **sys_message** - 消息通知表
| 字段名 | 数据类型 | 描述 |
| :--- | :--- | :--- |
| `id` | `BIGINT` | 消息ID |
| `user_id` | `BIGINT` | 接收用户ID |
| `type` | `INT` | 消息类型（0:系统消息, 1:评论回复, 2:点赞通知） |
| `content` | `TEXT` | 消息内容 |
| `related_id` | `BIGINT` | 相关对象ID（如帖子ID、评论ID） |
| `is_read` | `INT` | 是否已读（0:未读, 1:已读） |
| `created_at` | `DATETIME` | 创建时间 |

## 🔑 默认账号

- **管理员账号**：
  - 手机号：154284221
  - 密码：qwaszx123
- **测试账号**：
  - 手机号：13800138000
  - 密码：123456

## 📝 API 接口文档

### 认证相关接口
- **POST /api/auth/login** - 用户登录
- **POST /api/auth/register** - 用户注册
- **GET /api/auth/profile** - 获取当前用户信息
- **PUT /api/auth/profile** - 更新用户信息
- **PUT /api/auth/password** - 修改密码

### 用户相关接口
- **GET /api/users** - 获取用户列表（分页）
- **GET /api/users/{id}** - 获取用户详情
- **PUT /api/users/{id}** - 更新用户信息（管理员）
- **DELETE /api/users/{id}** - 删除用户（管理员）

### 板块相关接口
- **GET /api/boards** - 获取板块列表
- **GET /api/boards/{id}** - 获取板块详情
- **POST /api/boards** - 创建板块（管理员）
- **PUT /api/boards/{id}** - 更新板块信息
- **DELETE /api/boards/{id}** - 删除板块（管理员）

### 帖子相关接口
- **GET /api/posts** - 获取帖子列表（支持分页和筛选）
- **GET /api/posts/{id}** - 获取帖子详情
- **POST /api/posts** - 发布帖子
- **PUT /api/posts/{id}** - 更新帖子
- **DELETE /api/posts/{id}** - 删除帖子
- **PUT /api/posts/{id}/top** - 置顶/取消置顶帖子

### 评论相关接口
- **GET /api/posts/{postId}/comments** - 获取帖子评论
- **POST /api/posts/{postId}/comments** - 发表评论
- **PUT /api/comments/{id}** - 更新评论
- **DELETE /api/comments/{id}** - 删除评论

### 消息相关接口
- **GET /api/messages** - 获取消息列表
- **GET /api/messages/unread** - 获取未读消息数量
- **PUT /api/messages/{id}/read** - 标记消息为已读
- **PUT /api/messages/read-all** - 标记所有消息为已读

### 管理员接口
- **GET /api/admin/users** - 管理员用户管理
- **GET /api/admin/posts** - 管理员帖子管理
- **GET /api/admin/comments** - 管理员评论管理

### 板主接口
- **GET /api/moderator/boards** - 板主板块管理
- **GET /api/moderator/posts** - 板主板块帖子管理

## 💡 技术亮点

### 1. **现代化架构设计**
- **前后端分离**：RESTful API 设计，前端和后端完全解耦
- **模块化开发**：清晰的代码结构，便于维护和扩展
- **响应式设计**：适配不同屏幕尺寸的设备

### 2. **安全可靠**
- **JWT 认证**：无状态登录，支持分布式部署
- **密码加密**：使用 BCrypt 算法加密存储密码
- **权限控制**：基于角色的访问控制（RBAC），细粒度权限管理
- **请求验证**：统一的请求参数验证，防止恶意请求

### 3. **高性能**
- **异步处理**：使用 Spring 异步注解处理耗时操作
- **分页查询**：优化数据库查询，支持大数据量分页

### 4. **用户体验**
- **Markdown 编辑器**：支持富文本编辑，代码高亮，数学公式
- **实时消息**：未读消息提醒，及时获取互动通知
- **流畅动画**：Vue 3 过渡动画，提升用户体验
- **响应式布局**：适配 PC、平板和手机等多种设备

### 5. **开发效率**
- **TypeScript**：前端类型安全，减少运行时错误
- **MyBatis-Plus**：简化数据库操作，提供代码生成器
- **Knife4j**：自动生成 API 文档，方便前后端协作
- **Vite**：快速的前端构建工具，提升开发效率

## 🛡️ 安全措施

1. **SQL 注入防护**：使用 MyBatis-Plus 预编译语句
2. **XSS 防护**：前端输入验证和后端 HTML 转义
3. **CSRF 防护**：Spring Security 内置 CSRF 保护
4. **敏感信息保护**：配置文件敏感信息加密
5. **请求频率限制**：防止暴力破解和 DDoS 攻击

## 📈 系统监控

- **API 调用统计**：记录接口调用次数和响应时间
- **错误日志**：详细的错误信息记录，便于排查问题
- **性能监控**：使用 Spring Boot Actuator 监控系统状态

## 🤝 贡献指南

### 开发流程
1. **Fork 仓库**：在 Gitee 上 Fork 本项目
2. **克隆仓库**：`git clone https://gitee.com/your-username/Campus-Forum-System.git`
3. **创建分支**：`git checkout -b feature/your-feature`
4. **提交代码**：`git commit -m "Add your feature"`
5. **推送分支**：`git push origin feature/your-feature`
6. **创建 PR**：在 Gitee 上创建 Pull Request

### 代码规范
- **Java 代码**：遵循 Alibaba Java Coding Guidelines
- **TypeScript 代码**：遵循 Vue 官方风格指南
- **提交信息**：使用语义化提交信息

## 📄 许可证

本项目采用 MIT 许可证，详见 [LICENSE](backend/LICENSE) 文件。

## 📞 联系方式

- **项目维护者**：张三
- **邮箱**：zhangsan@example.com
- **GitHub**：https://github.com/zhangsan
- **Gitee**：https://gitee.com/zhangsan

## 🎉 致谢

- **Vue 团队**：提供优秀的前端框架
- **Spring 团队**：提供强大的后端生态
- **Element Plus**：提供美观的 UI 组件
- **所有贡献者**：感谢你们的辛勤工作和宝贵建议

---

**✨ 欢迎使用校园论坛系统！希望它能为你的校园生活增添色彩！**