# 二手交易平台2026毕业设计

**Repository Path**: zxj2022/second-hand-trading-platform

## Basic Information

- **Project Name**: 二手交易平台2026毕业设计
- **Description**: 1、研究Spring Cloud分布式架构和Nacos微服务架构，掌握Gateway/Sentinel组件的原理及应用开发技术；
2、研究MySQL数据库的数据定义和数据操纵方法；
3、研究前端与服务器端的通信原理；
4、设计并实现用户注册与登录、商品分类管理、商品发布及交易撮合、实名认证与信用体系管理等功能模块。
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-03-10
- **Last Updated**: 2026-05-02

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README



# 二手交易平台

一个基于微服务架构的校园二手商品交易平台，支持用户实名认证、商品发布、积分交易、订单管理和信用评价等功能。

## 技术栈

- **后端框架**: Spring Cloud + Spring Boot
- **服务治理**: Nacos + Gateway
- **数据库**: MySQL + MyBatis Plus
- **缓存**: Redis
- **文件存储**: 阿里云 OSS
- **认证授权**: JWT

## 系统架构

```
┌─────────────────────────────────────────────────────────────┐
│                      API 网关 (Gateway)                     │
└─────────────────────────────────────────────────────────────┘
            │                  │                  │
            ▼                  ▼                  ▼
┌──────────────────┐ ┌──────────────────┐ ┌──────────────────┐
│   用户中心服务    │ │   交易域服务     │ │   管理端服务     │
│  (user-service)  │ │ (trade-service)  │ │(system-service) │
│                  │ │                  │ │                  │
│ • 用户注册/登录  │ │ • 商品管理       │ │ • 商品分类管理   │
│ • 实名认证       │ │ • 商品分类       │ │ • 商品管理       │
│ • 信用体系       │ │ • 订单管理       │ │ • 订单查询       │
│ • 文件上传      │ │ • 积分账户       │ │ • 积分管理       │
│                  │ │ • 数据统计       │ │ • 用户管理       │
└──────────────────┘ └──────────────────┘ └──────────────────┘
```

## 模块说明

### 公共模块

| 模块 | 说明 |
|------|------|
| `second-hand-trading-platform-api` | Feign 客户端接口定义，供服务间调用 |
| `second-hand-trading-platform-common-core` | 核心工具类：R 响应、PageVO 分页、JWT、异常处理 |
| `second-hand-trading-platform-common-mybatis` | MyBatis Plus 自动填充配置 |
| `second-hand-trading-platform-common-redis` | Redis 封装服务 |
| `second-hand-trading-platform-common-security` | 安全模块：Token 拦截器、CORS、全局异常处理 |
| `second-hand-trading-platform-common-file` | OSS 文件上传服务 |
| `second-hand-trading-platform-common-swagger` | Swagger 配置 |

### 业务服务

| 模块 | 说明 |
|------|------|
| `second-hand-trading-platform-gateway` | API 网关：路由、权限校验、白名单 |
| `second-hand-trading-platform-user-center` | 用户中心：注册登录、实名认证、信用体系 |
| `second-hand-trading-platform-trade` | 交易域：商品、分类、订单、积分 |
| `second-hand-trading-platform-system` | 管理端：商品/订单/积分/用户管理、数据概览 |

## 核心功能

### 用户端 (C 端)

- **用户注册/登录**: 学号/邮箱 + 密码登录
- **实名认证**: 提交学号、姓名、学生证照片，管理员审核
- **商品浏览**: 按分类、标题搜索，仅显示已上架商品
- **商品发布**: 需实名认证通过，支持图片上传
- **积分交易**: 下单时冻结积分，确认收货后划扣
- **订单管理**: 我买的 / 我卖的
- **信用评价**: 订单完成后互相评价

### 管理端 (B 端)

- **商品分类管理**: 新增、编辑、删除、排序
- **商品管理**: 强制上下架、删除
- **订单查询**: 全量订单检索
- **积分管理**: 手动调整、流水查询
- **用户管理**: 禁用/启用、实名审核
- **数据概览**: 用户数、商品数、订单数、积分流水

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.8+
- MySQL 8.0+
- Redis 6.0+
- Nacos 2.x

### 配置说明

各服务的 `bootstrap.yml` 中需配置 Nacos：

```yaml
spring:
  cloud:
    nacos:
      server-addr: ${NACOS_SERVER:127.0.0.1:8848}
      namespace: ${NACOS_NAMESPACE:}
      config:
        group: ${NACOS_GROUP:DEFAULT_GROUP}
        file-extension: yaml
```

### 启动顺序

1. 启动 Nacos
2. 启动 Redis、MySQL
3. 依次启动服务：
   - `second-hand-trading-platform-user-center`
   - `second-hand-trading-platform-trade`
   - `second-hand-trading-platform-system`
   - `second-hand-trading-platform-gateway`

### 服务端口

| 服务 | 端口 |
|------|------|
| Gateway | 9200 |
| user-service | 9201 |
| trade-service | 9202 |
| system-service | 9203 |

## 数据库表

核心表包括：
- `tb_user` - 用户表
- `tb_user_certification` - 实名认证表
- `tb_goods_category` - 商品分类表
- `tb_goods` - 商品表
- `tb_goods_image` - 商品图片表
- `tb_order` - 订单表
- `tb_user_integral` - 用户积分账户
- `tb_integral_record` - 积分流水记录
- `tb_credit_record` - 信用评价记录
- `tb_sys_user` - 管理员表
- `tb_sys_operation` - 系统操作审计表

初始化 SQL 位于 `deploy/dev/sql/init.sql`。

## API 文档

详细接口文档见 `docs/api/` 目录：

- [用户中心 API](./docs/api/user-center/README.md)
- [交易域 API](./docs/api/trade/README.md)
- [管理端 API](./docs/api/system/README.md)

## 业务规则

1. **商品上架**: 用户需实名认证通过方可发布/上架商品
2. **积分下单**: 冻结买家积分 → 创建订单 → 标记商品已下单（同一事务）
3. **确认收货**: 解冻划扣积分给卖家 → 创建积分流水 → 标记订单完成
4. **商品删除**: 仅已下架商品可删除，管理员操作时需保证未关联订单
5. **强制上下架**: 管理员可强制操作，但已下单商品不可修改状态

## 积分体系

- **初始积分**: 实名认证通过赠送 1000 积分
- **交易收入**: 卖出商品获得积分
- **交易支出**: 购买商品消耗积分
- **手动调整**: 管理员可手动调整用户积分

## 信用体系

- **初始信用分**: 100 分
- **好评 +**: +2 分
- **差评 -**: -1 分
- **评价限制**: 同一订单每人仅可评价一次

## License

MIT