# AI Writing Graduation Design

**Repository Path**: WTBU_CS/ai-writing-graduation-design

## Basic Information

- **Project Name**: AI Writing Graduation Design
- **Description**: AI写毕设
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-27
- **Last Updated**: 2025-11-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园二手书交易与知识共享平台

## 项目概述

校园二手书交易与知识共享平台是一个专为大学生设计的综合性平台，旨在解决校园内二手书流通问题并促进知识共享。该平台提供二手书发布与交易、学习资料分享、学术交流等功能，帮助学生们高效利用资源、降低学习成本并拓展知识交流。

## 技术栈

### 前端技术
- **框架**: Vue 3.5.24
- **路由**: Vue Router 4.6.3
- **状态管理**: Pinia 3.0.4
- **HTTP客户端**: Axios 1.13.2
- **构建工具**: Vite 7.2.4

### 后端技术
- **框架**: Spring Boot 3.3.4
- **数据库**: MySQL 8.0.33
- **ORM框架**: MyBatis-Plus 3.5.14
- **认证**: JWT (JSON Web Token) 0.11.5
- **Java版本**: Java 21
- **工具库**: Lombok, Commons Codec

## 项目结构

```
CampusSecondhandBook/
├── backend/                # 后端项目
│   ├── src/                # 源代码目录
│   │   ├── main/java/com/example/demo/  # Java源代码
│   │   │   ├── controller/  # 控制器层
│   │   │   ├── service/     # 服务层
│   │   │   ├── mapper/      # 数据访问层
│   │   │   ├── entity/      # 实体类
│   │   │   ├── dto/         # 数据传输对象
│   │   │   ├── vo/          # 视图对象
│   │   │   ├── common/      # 通用组件
│   │   │   ├── config/      # 配置类
│   │   │   ├── enums/       # 枚举类
│   │   │   └── util/        # 工具类
│   │   └── main/resources/  # 资源文件
│   │       ├── application.yml  # 配置文件
│   │       ├── static/      # 静态资源
│   │       └── templates/   # 模板文件
│   ├── pom.xml             # Maven配置文件
│   └── README.md           # 后端项目文档
├── frontend/               # 前端项目
│   ├── src/                # 源代码目录
│   │   ├── views/          # 页面组件
│   │   ├── components/     # 通用组件
│   │   ├── router/         # 路由配置
│   │   ├── stores/         # 状态管理
│   │   ├── services/       # API服务
│   │   ├── assets/         # 静态资源
│   │   └── main.js         # 入口文件
│   ├── package.json        # npm配置文件
│   └── vite.config.js      # Vite配置文件
└── docs/                   # 项目文档
    ├── 0.校园二手书交易与知识共享平台 - 核心功能模块梳理.md
    ├── 1. 用户认证与权限模块设计.md
    ├── 2.商品管理模块设计.md
    ├── 3. 订单交易模块设计.md
    ├── 4. 论坛及知识共享模块设计.md
    ├── 5. 搜索与推荐模块设计.md
    ├── 6. 后台管理模块设计.md
    └── 7. 文件上传模块设计.md
```

## 核心功能模块

### 1. 用户认证与权限模块
- 用户注册：邮箱/学号验证注册
- 用户登录：基于JWT的登录认证
- 个人信息管理：编辑昵称、头像、联系方式等
- 权限控制：基于角色的访问控制（普通用户/管理员）
- 登录状态维护：前端路由守卫，后端Token校验与刷新

### 2. 商品管理模块
- 发布商品：上传图片、填写书籍信息
- 编辑商品：修改已发布但未售出的商品信息
- 上下架商品：手动控制商品出售状态
- 商品列表与详情：分页展示和查看商品
- 我的在售商品：个人中心管理

### 3. 订单交易模块
- 生成订单：从购物车选择商品或直接购买
- 订单状态管理：完整的订单状态流转
- 支付模拟：点击即返回成功的模拟支付接口
- 订单列表与详情：按状态查看订单信息

### 4. 论坛/知识共享模块
- 发布帖子：分享学习笔记、经验和资料
- 帖子列表：分页展示所有帖子，支持排序
- 帖子详情与互动：评论、点赞、收藏功能
- 帖子管理：编辑、删除自己的帖子

### 5. 搜索与推荐模块
- 全局搜索：支持关键词模糊搜索
- 商品筛选：按价格区间、分类、新旧程度筛选
- 简单商品推荐：基于分类标签的相关商品推荐

### 6. 后台管理模块
- 用户管理：查看所有用户，禁用/启用账号
- 商品管理：查看、搜索、强制下架所有商品
- 帖子管理：审核、查看、删除所有社区帖子
- 订单管理：查看所有订单记录
- 数据统计：简单的数据可视化

### 7. 文件上传模块
- 图片上传：商品图片、帖子插图
- 文件上传：帖子附件（PDF、Word等）
- 存储管理：服务器本地存储

## 快速开始

### 环境要求
- JDK 21+
- Node.js 16+
- MySQL 8.0+

### 后端启动步骤
1. 克隆项目代码
2. 配置MySQL数据库
3. 修改`backend/src/main/resources/application.yml`中的数据库连接信息
4. 在项目根目录下执行以下命令：
   ```bash
   cd backend
   mvn spring-boot:run
   ```

### 前端启动步骤
1. 在项目根目录下执行以下命令：
   ```bash
   cd frontend
   npm install
   npm run dev
   ```
2. 访问 http://localhost:5173

## 开发说明

### 数据库配置
- 数据库脚本位于 `backend/docs/all.sql`
- 导入脚本到MySQL数据库
- 修改 `application.yml` 中的数据库连接信息

### API文档
- API接口文档位于 `backend/api-documentation.md`

### 注意事项
- 确保数据库连接配置正确
- 前端默认连接后端地址为 http://localhost:8080
- 上传文件大小限制为10MB

## 许可证

本项目仅供学习和参考使用。