recycle3/backend

废品回收APP后端服务

基于 Spring Boot 3.2 + MyBatis-Plus 的后端 API 服务。

技术栈

• 框架: Spring Boot 3.2.0
• ORM: MyBatis-Plus 3.5.5
• 数据库: MySQL 8.x
• 文档: Knife4j (Swagger)
• 工具: Hutool, Lombok
• 认证: JWT

项目结构

backend/
├── src/main/java/com/recycle/
│   ├── common/          # 通用类（Result, PageResult）
│   ├── config/          # 配置类
│   ├── controller/      # 控制器
│   │   ├── client/      # C端接口
│   │   ├── business/    # B端接口
│   │   └── government/  # G端接口
│   ├── dto/             # 数据传输对象
│   ├── entity/          # 实体类
│   ├── exception/       # 异常处理
│   ├── interceptor/     # 拦截器
│   ├── mapper/          # MyBatis Mapper
│   ├── service/         # 服务层
│   └── util/            # 工具类
└── src/main/resources/
    ├── application.yml  # 配置文件
    └── mapper/          # XML映射文件

快速开始

1. 环境要求

• JDK 17+
• Maven 3.8+
• MySQL 8.x

2. 配置数据库

编辑 src/main/resources/application.yml，修改数据库连接信息：

spring:
  datasource:
    url: jdbc:mysql://localhost:3306/recycle_app?...
    username: root
    password: your_password  # 修改为你的密码

3. 启动项目

# 方式一：Maven命令
mvn spring-boot:run

# 方式二：打包后运行
mvn clean package -DskipTests
java -jar target/recycle-app-backend-1.0.0.jar

# 方式三：IDE中运行
# 直接运行 RecycleAppApplication.java 的 main 方法

4. 访问API文档

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

API接口概览

C端接口 /api/c/

模块	路径	说明
认证	/api/c/auth/*	登录、注册
用户	/api/c/user/*	用户信息、地址管理
订单	/api/c/orders/*	回收订单
分类	/api/c/categories/*	废品分类
回收员	/api/c/collectors/*	回收员列表
商品	/api/c/products/*	积分商城

B端接口 /api/b/

模块	路径	说明
认证	/api/b/auth/*	企业登录
订单	/api/b/orders/*	订单管理

G端接口 /api/g/

模块	路径	说明
认证	/api/g/auth/*	政府用户登录
统计	/api/g/statistics/*	数据统计

请求示例

用户注册

POST /api/c/auth/register
Content-Type: application/json

{
  "phone": "13800138000",
  "password": "123456"
}

用户登录

POST /api/c/auth/login
Content-Type: application/json

{
  "phone": "13800138000",
  "password": "123456"
}

响应：

{
  "code": 200,
  "message": "操作成功",
  "data": {
    "token": "eyJhbGciOiJIUzI1NiJ9...",
    "user": { ... }
  }
}

创建回收订单

POST /api/c/orders
Authorization: Bearer <token>
Content-Type: application/json

{
  "categoryId": 1,
  "categoryName": "纸类",
  "estimatedWeight": 5.0,
  "contactName": "张三",
  "contactPhone": "13800138000",
  "address": "北京市朝阳区xxx",
  "recycleMethod": "pickup",
  "timeOption": "immediate"
}

注意事项

1. 需要先执行 database/ 目录下的 SQL 文件创建数据库
2. 默认端口 8080，可在 application.yml 中修改
3. Redis 配置可选，如不使用请移除相关依赖