Initial commit

2026-06-14 14:39:51 +08:00
commit e186d45bec
1484 changed files with 305925 additions and 0 deletions
--- a/jy-system/README_FORUM.md
+++ b/jy-system/README_FORUM.md
@@ -0,0 +1,211 @@
+# 开发者论坛模块说明
+
+## 文件结构
+
+### 前端文件
+- `src/views/forum/index.vue` - 论坛首页组件
+- `src/api/forum/post.js` - 帖子相关API
+- `src/api/forum/reply.js` - 回复相关API
+
+### 后端文件
+- `ForumPostController.java` - 帖子控制器
+- `IForumPostService.java` - 帖子服务接口
+- `ForumPostServiceImpl.java` - 帖子服务实现
+- `ForumPostMapper.java` - 帖子Mapper接口
+- `ForumPostMapper.xml` - MyBatis映射文件
+- `ForumPost.java` - 帖子实体类
+
+### 数据库文件
+- `database/forum_tables.sql` - 数据库表结构SQL
+
+## 安装步骤
+
+### 1. 数据库安装
+执行 `database/forum_tables.sql` 文件创建数据库表：
+```sql
+-- 执行SQL文件
+source database/forum_tables.sql;
+```
+
+### 2. 后端代码集成
+1. 将后端Java文件复制到对应的包路径：
+   - Controller: `com.ruoyi.jysystem.controller`
+   - Service: `com.ruoyi.jysystem.service`
+   - Mapper: `com.ruoyi.jysystem.mapper`
+   - Domain: `com.ruoyi.jysystem.domain`
+
+2. 将 `ForumPostMapper.xml` 复制到 `resources/mapper/jysystem/` 目录
+
+3. 确保MyBatis扫描到Mapper接口
+
+### 3. 前端代码集成
+前端文件已自动集成到项目中，路由已配置。
+
+## API接口说明
+
+### 帖子相关接口
+
+#### 查询帖子列表
+```
+GET /forum/post/list
+参数：
+- pageNum: 页码
+- pageSize: 每页数量
+- categoryId: 分类ID（可选）
+- sort: 排序方式（latest/hot/replies/views）
+- keyword: 搜索关键词（可选）
+```
+
+#### 查询帖子详情
+```
+GET /forum/post/{id}
+```
+
+#### 新增帖子
+```
+POST /forum/post
+Body: {
+  categoryId: 分类ID,
+  title: 标题,
+  content: 内容,
+  excerpt: 摘要（可选）
+}
+```
+
+#### 修改帖子
+```
+PUT /forum/post
+Body: {
+  id: 帖子ID,
+  title: 标题,
+  content: 内容,
+  ...
+}
+```
+
+#### 删除帖子
+```
+DELETE /forum/post/{ids}
+```
+
+#### 增加浏览量
+```
+PUT /forum/post/view/{id}
+```
+
+#### 点赞/取消点赞
+```
+PUT /forum/post/like/{id}
+返回: { isLiked: true/false }
+```
+
+#### 收藏/取消收藏
+```
+PUT /forum/post/favorite/{id}
+返回: { isFavorited: true/false }
+```
+
+#### 标记为已解决
+```
+PUT /forum/post/solved/{id}
+```
+
+## 数据库表说明
+
+### forum_category - 论坛分类表
+- id: 分类ID（主键）
+- name: 分类名称
+- description: 分类描述
+- sort_order: 排序顺序
+- status: 状态（0正常 1停用）
+- post_count: 帖子数量
+
+### forum_post - 论坛帖子表
+- id: 帖子ID（主键）
+- category_id: 分类ID
+- title: 标题
+- content: 内容
+- excerpt: 摘要
+- author_id: 作者ID
+- author_name: 作者名称
+- author_avatar: 作者头像
+- view_count: 浏览量
+- reply_count: 回复数
+- like_count: 点赞数
+- favorite_count: 收藏数
+- is_top: 是否置顶（0否 1是）
+- is_hot: 是否热门（0否 1是）
+- is_solved: 是否已解决（0否 1是）
+- status: 状态（0正常 1删除 2审核中）
+- last_reply_time: 最后回复时间
+
+### forum_reply - 论坛回复表
+- id: 回复ID（主键）
+- post_id: 帖子ID
+- parent_id: 父回复ID（0表示直接回复帖子）
+- content: 回复内容
+- author_id: 作者ID
+- author_name: 作者名称
+- like_count: 点赞数
+- status: 状态（0正常 1删除 2审核中）
+
+### forum_post_like - 帖子点赞表
+- id: ID（主键）
+- post_id: 帖子ID
+- user_id: 用户ID
+- create_time: 创建时间
+
+### forum_post_favorite - 帖子收藏表
+- id: ID（主键）
+- post_id: 帖子ID
+- user_id: 用户ID
+- create_time: 创建时间
+
+### forum_reply_like - 回复点赞表
+- id: ID（主键）
+- reply_id: 回复ID
+- user_id: 用户ID
+- create_time: 创建时间
+
+## 功能特性
+
+1. **帖子管理**
+   - 发布、编辑、删除帖子
+   - 分类管理
+   - 置顶、热门标记
+   - 已解决标记
+
+2. **互动功能**
+   - 点赞/取消点赞
+   - 收藏/取消收藏
+   - 回复功能（支持嵌套回复）
+   - 浏览量统计
+
+3. **搜索和排序**
+   - 关键词搜索
+   - 按最新、热门、回复数、浏览量排序
+   - 分类筛选
+
+4. **用户体验**
+   - 响应式设计
+   - 实时更新
+   - 友好的时间显示
+
+## 注意事项
+
+1. 确保用户认证系统正常工作
+2. 根据实际需求调整权限控制
+3. 建议添加内容审核功能
+4. 可以考虑添加图片上传功能
+5. 建议添加敏感词过滤
+
+## 后续扩展建议
+
+1. 添加帖子详情页面
+2. 添加回复功能页面
+3. 添加用户个人中心（我的帖子、我的回复）
+4. 添加管理员后台管理功能
+5. 添加消息通知功能
+6. 添加标签系统
+7. 添加附件上传功能
+