# 校园二手书交易平台

**Repository Path**: zfy120541/book_cycle

## Basic Information

- **Project Name**: 校园二手书交易平台
- **Description**: 校园二手书交易平台，专为学生提供便捷的二手书籍交易服务，支持在线查询、预订及线下交易，促进资源循环利用。
本平台致力于为高校师生提供高效、安全的二手教材交易服务，通过简化非核心功能确保系统稳定性和可维护性。
包含商家与用户双端角色，严格遵循"发布-交易-履约"的核心业务闭环。
- 商家端提供教材信息发布、订单管理及物流操作功能；
- 用户端支持商品浏览、订单创建及签收确认。
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-01-04
- **Last Updated**: 2026-01-04

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 校园二手书交易平台

#### 介绍
校园二手书交易平台，专为学生提供便捷的二手书籍交易服务，支持在线查询、预订及线下交易，促进资源循环利用。
本平台致力于为高校师生提供高效、安全的二手教材交易服务，通过简化非核心功能确保系统稳定性和可维护性。
包含商家与用户双端角色，严格遵循"发布-交易-履约"的核心业务闭环。

- 商家端提供教材信息发布、订单管理及物流操作功能；
- 用户端支持商品浏览、订单创建及签收确认。

<img src="https://gitee.com/ryder_ryc/book_cycle/raw/master/images/首页.png" alt="首页" style="zoom:33%;" />
<img src="https://gitee.com/ryder_ryc/book_cycle/raw/master/images/个人信息.png" alt="个人信息" style="zoom:33%;" />
<img src="https://gitee.com/ryder_ryc/book_cycle/raw/master/images/商家主页.png" alt="商家主页" style="zoom:33%;" />

#### 软件架构

1. **后端技术栈**：
   - 核心框架：Spring Boot 3.5.3
   - 持久层：MyBatis-Plus 3.5.5
   - 数据库：MySQL 8.0+
   - 接口规范：RESTful JSON API
   - Java版本：17
2. **前端技术栈**：
   - 基础技术：HTML5 + CSS3 + JavaScript
   - 交互方式：Fetch API异步通信
   - 无任何前端框架依赖
   - 纯静态文件部署
3. **系统架构**：

```
前端(HTML/JS)
  ↓ (HTTP请求)
REST API(Spring Boot)
  ↓ 
MySQL数据库
```


#### 安装教程

1. **后端部署**：
   - 使用idea，打开book_cycle文件，静候依赖加载完成（File->open）
   - 初始化数据库，通过可视化工具等导入sql文件（src/main/resources/db/book_cycle.sql）
   - 修改application.yml中的数据库连接配置
   - 启动BookCycleApplication文件，点击绿色三角即可
2. **前端部署**：
   - 使用VS Code的Live Server插件
   - 生产环境建议使用Nginx部署

#### 使用说明

1.  快速启动：
    - 启动后端服务（配置端口3010，可以通过application.yml文件修改）
    - 使用VS Code的Live Server插件，打开前端`login.html`文件（账号在user_account表中，可以自己注册）
2.  **测试账号**：
    - 用户端：李三/123ABC
    - 商家端：王强/123ABC
3.  **开发调试**：
    - book_cycle_front/api_config.js同步修改后端地址
4.  **项目结构**：
    - src/main/java/com/ryder/
      ├── config/          # 全局配置
      ├── controller/      # 业务控制器
      ├── entity/          # 数据库实体
      ├── enums/           # 枚举常量
      ├── handler/         # 处理器
      ├── mapper/          # MyBatis映射
      └── service/         # 业务服务
          └── impl/        # 服务实现

#### 参与贡献

欢迎通过Pull Request贡献代码，请遵循以下规范：

1.  Fork 本仓库
    - 点击仓库右上角的Fork按钮，会生成独立的副本仓库，并克隆
2.  新建 Feat_xxx 分支
    - 克隆Fork后的仓库
    - 在Fork仓库中创建分支
3.  提交代码
    - 代码提交到Fork仓库中
4.  新建 Pull Request
    - 进入你Fork后的仓库页面
    - 点击 `Pull Request` → 选择你的分支 → 原仓库的`main`分支
    - 填写清晰的修改说明（模板会自动生成）