# forum-backend

**Repository Path**: wszack/forum-backend

## Basic Information

- **Project Name**: forum-backend
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-11
- **Last Updated**: 2026-06-11

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Java 技术论坛 - 后端

基于 Spring Boot 3 构建的 RESTful API 后端服务。

## 技术栈

- **框架**: Spring Boot 3.5.14
- **ORM**: MyBatis-Plus
- **安全**: Spring Security + JWT
- **数据库**: MySQL 5.7 + Redis
- **API 文档**: Knife4j (Swagger)
- **文件存储**: MinIO
- **工具库**: Hutool, Lombok

## 功能特性

- 🔐 **用户认证** — JWT 登录/注册、Token 刷新
- 👤 **用户管理** — 个人信息、头像上传、积分系统
- 📝 **帖子系统** — CRUD、分页/排序/搜索、置顶/精华
- 💬 **评论系统** — 嵌套评论、点赞/取消
- ✉️ **私信系统** — 发送消息、会话列表、未读计数
- 🔔 **通知系统** — 系统通知、已读标记
- 🏷️ **分类/标签** — 帖子分类、标签关联
- 📊 **管理后台 API** — 仪表盘统计、用户/帖子/分类/标签管理

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.6+
- MySQL 5.7+
- Redis
- MinIO (文件存储)

### 配置

1. 复制 `application-dev.yml` 配置数据库、Redis、MinIO 连接信息
2. 执行 `sql/schema.sql` 初始化数据库表

### 启动

```bash
# 开发模式
mvn spring-boot:run -Dspring.profiles.active=dev

# 打包
mvn clean package -DskipTests

# 运行 jar
java -jar target/forum-backend.jar
```

### API 文档

启动后访问：http://localhost:8080/doc.html

## 项目结构

```
src/main/java/com/forum/
├── common/              # 公共模块
│   ├── config/          #   ├── WebMvc, MyBatis-Plus, Redis, Swagger, CORS
│   ├── exception/       #   ├── 全局异常处理
│   ├── interceptor/     #   ├── JWT 拦截器
│   ├── result/          #   ├── 统一响应封装
│   └── util/            #   └── JWT 工具、MinIO 工具
├── controller/          # 控制器层
│   └── admin/           # 管理后台控制器
├── service/
│   └── impl/            # 服务实现
├── mapper/              # MyBatis Mapper
├── entity/              # 实体类
├── dto/
│   ├── request/         # 请求 DTO
│   └── response/        # 响应 DTO
└── enums/               # 枚举定义
```

## API 概览

所有接口前缀：`/api/**`，认证方式：`Authorization: Bearer <JWT token>`

| 模块 | 路径 | 说明 |
|------|------|------|
| Auth | `/api/auth/**` | 注册、登录、登出 |
| User | `/api/user/**` | 个人信息、积分、通知、头像 |
| Post | `/api/posts/**` | 帖子 CRUD、列表、搜索 |
| Comment | `/api/comments/**` | 评论列表、发表、删除 |
| Like | `/api/likes/**` | 点赞、取消 |
| Category | `/api/categories/**` | 分类列表 |
| Tag | `/api/tags/**` | 标签列表 |
| Message | `/api/messages/**` | 私信、会话、未读 |


## 数据库

共 10 张表：

| 表名 | 说明 |
|------|------|
| user | 用户表 |
| category | 分类表 |
| tag | 标签表 |
| post | 帖子表 |
| post_tag | 帖子-标签关联 |
| comment | 评论表 (支持嵌套) |
| like_record | 点赞记录 |
| private_message | 私信表 |
| notification | 通知表 |
| user_points_log | 积分记录表 |