# qiyu

**Repository Path**: ZhangXuanW/qiyu

## Basic Information

- **Project Name**: qiyu
- **Description**: 专高六奇遇项目小组
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-22
- **Last Updated**: 2025-12-23

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 奇遇二手交易平台 - 后端微服务

基于 Spring Cloud 的二手交易平台后端服务。

## 技术栈

- Spring Boot 2.7.6
- Spring Cloud 2021.0.5
- Spring Cloud Alibaba 2021.0.5.0
- Nacos 服务注册发现
- MyBatis-Plus 3.5.3
- MySQL 8.0
- Redis 7.0
- Redisson 分布式锁
- MinIO 对象存储

## 模块说明

| 模块 | 端口 | 说明 |
|------|------|------|
| adventure-common | - | 公共模块（工具类、实体、异常处理） |
| adventure-gateway | 8080 | 网关服务（路由、认证、限流） |
| adventure-auth | 8081 | 认证服务（登录、用户、地址） |
| adventure-home | 8082 | 首页服务（轮播图、分类、商品） |
| adventure-order | 8083 | 订单服务（订单、支付、物流、售后） |
| adventure-chat | 8084 | 聊天服务（即时通讯、消息） |
| adventure-service | 8085 | 客服服务（AI客服、AI估价） |

## 快速开始

### 1. 环境要求

- JDK 11+
- Maven 3.6+
- MySQL 8.0+
- Redis 7.0+
- Nacos 2.x

### 2. 配置修改

修改各模块 `application.yml` 中的数据库、Redis、Nacos 配置。

### 3. 启动顺序

1. 启动 Nacos
2. 启动 adventure-gateway
3. 启动其他服务（顺序不限）

### 4. 编译打包

```bash
cd adventure-parent
mvn clean package -DskipTests
```

## API 文档

启动服务后访问：
- 网关：http://localhost:8080
- 认证服务 API 文档：http://localhost:8081/doc.html
- 首页服务 API 文档：http://localhost:8082/doc.html
- 订单服务 API 文档：http://localhost:8083/doc.html
- 聊天服务 API 文档：http://localhost:8084/doc.html
- 客服服务 API 文档：http://localhost:8085/doc.html

## 主要功能

### 用户模块
- 微信登录 / 手机号登录
- 用户信息管理
- 收货地址管理
- 实名认证

### 商品模块
- 商品发布 / 编辑 / 删除
- 商品搜索（关键词、分类、价格、距离）
- 商品收藏 / 想要
- 热门商品 / 精选商品 / 同城商品

### 订单模块
- 订单创建（分布式锁防并发）
- 模拟支付
- 发货 / 收货
- 售后申请
- 超时自动取消 / 自动确认收货

### 聊天模块
- 会话管理
- 消息发送 / 接收
- 未读消息计数

### 客服模块
- AI 估价（基于分类、成色、时间计算）
- 估价历史记录

### 担保分与积分模块
- 担保分查询与变动记录
- 信用等级计算（优秀/良好/一般/较差）
- 积分查询与变动记录
- 每日签到获取积分
- 交易完成自动发放积分和担保分

### 系统消息模块
- 系统通知 / 交易提醒 / 活动消息
- 消息列表查询
- 未读消息计数
- 消息已读标记

### 风控模块
- 举报提交（商品/用户/聊天）
- 举报记录查询
- 违规用户黑名单
- 担保分自动扣减