# auction

**Repository Path**: meicci/auction

## Basic Information

- **Project Name**: auction
- **Description**: 本项目是“抖音电商 AI 全栈挑战赛”的直播竞拍全栈系统
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2026-08-19
- **Last Updated**: 2026-08-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 实时竞拍大师 — 直播竞拍全栈系统

抖音电商 AI 全栈挑战赛参赛项目。面向直播电商竞拍场景，覆盖主播创建竞拍、用户 H5 实时出价、WebSocket 实时同步、AI 拍卖主持、自动延时、成交订单和后台回溯的完整闭环。

**在线 Demo**：http://49.233.186.235/

## 技术栈

| 层级 | 技术 |
| --- | --- |
| 前端 | React 18、TypeScript、Vite、WebSocket、Howler、Framer Motion |
| 后端 | Java 17、Spring Boot 3.4、Spring WebSocket、Sa-Token、MyBatis-Plus、Lombok |
| 数据层 | MySQL 8、Redis 7 |
| AI | 豆包 LLM、Minimax `speech-2.8-turbo` TTS、OSS 固定音频 manifest |
| 部署 | Docker Compose、腾讯云容器镜像 |

## 核心功能

- **主播 PC 管理端**：商品管理、竞拍规则配置、手动/定时开拍、取消竞拍、订单管理、实时指标和单场竞拍回溯
- **用户 H5 竞拍端**：抖音风格直播间、实时当前价、倒计时、排行榜、出价按钮、被超越提醒、成交结果和订单入口
- **高并发实时出价**：Redis Lua 原子出价，单次 EVAL 完成幂等检查、状态校验、金额校验、排行榜更新、自动延时和封顶成交判断
- **WebSocket 实时同步**：房间隔离广播 + seq 序列号 + HTTP 快照补偿，服务端为权威数据源
- **AI 拍卖主持**：固定预设音频 + 豆包 LLM + Minimax TTS 混合策略，异步执行、失败降级，不影响出价主链路
- **成交订单与可追溯后台**：成交后幂等生成模拟订单，主播可查看竞拍完整时间线（出价记录、AI 主持消息、延时、成交和订单）

## 本地启动

### 1. 启动 MySQL 和 Redis

```bash
docker compose up -d mysql redis
```

默认端口：MySQL `localhost:13306`（root/123456），Redis `localhost:16379`（database 6）。

### 2. 启动后端

```bash
cd backend
mvn spring-boot:run
```

后端运行在 `http://localhost:8080`，健康检查：`GET /api/health`。

### 3. 启动前端

```bash
cd frontend
npm install
npm run dev
```

前端运行在 `http://localhost:5173`，`/api` 自动代理到后端。

## Docker 部署

项目根目录提供 `docker-compose.yml`，包含 `frontend`、`backend`、`mysql`、`redis` 四个服务。

```bash
# 1. 准备 .env（参考 .env.example）
cp .env.example .env
# 编辑 .env 填入 MySQL 密码和 AI API Key

# 2. 启动全部服务
docker compose up -d
```

默认端口：前端 `80`，后端 `18080`。

## 项目结构

```text
backend/          Spring Boot 后端（模块化单体，包结构按微服务边界隔离）
frontend/         React + TypeScript 前端（Vite）
deploy/           MySQL 初始化脚本
docs/             需求、架构、开发任务、测试压测、答辩材料
```

后端包结构：`auth` / `product` / `auction` / `bid` / `realtime` / `order` / `ai` / `admin` / `comment`

## 文档索引

| 文档 | 路径 |
| --- | --- |
| 开发约定 | [AGENTS.md](./AGENTS.md) |
| 文档入口 | [docs/README.md](./docs/README.md) |
| MVP 需求 | [docs/01-需求/需求文档-MVP.md](./docs/01-需求/需求文档-MVP.md) |
| 系统架构 | [docs/02-总体架构/系统实现架构-v0.1.md](./docs/02-总体架构/系统实现架构-v0.1.md) |
| Demo 方案 | [docs/07-答辩材料/Demo方案文档-v1.0.md](./docs/07-答辩材料/Demo方案文档-v1.0.md) |
| 压测报告 | [docs/06-测试压测/在线与出价QPS压测综合报告-v2.0.md](./docs/06-测试压测/在线与出价QPS压测综合报告-v2.0.md) |
| 答辩提交文档 | [docs/07-答辩材料/成果演示DEMO提交文档-v1.0.md](./docs/07-答辩材料/成果演示DEMO提交文档-v1.0.md) |

## 仓库

- GitHub：https://github.com/dztyykxx/auction
- Gitee：https://gitee.com/dztyykxx/auction