85 lines
2.3 KiB
Markdown
85 lines
2.3 KiB
Markdown
# 🎯 互动竞猜开宝箱系统
|
||
|
||
[](https://github.com/your-repo)
|
||
[](https://www.python.org/)
|
||
[](https://www.typescriptlang.org/)
|
||
|
||
一个基于奖池制的直播互动竞猜系统，支持主播创建宝箱、用户下注竞猜、实时开奖等核心功能。
|
||
|
||
## ✨ 核心特性
|
||
|
||
### 🎮 游戏功能
|
||
- ✅ 宝箱竞猜系统（二选一竞猜模式）
|
||
- ✅ 实时奖池更新（WebSocket推送）
|
||
- ✅ 倒计时机制
|
||
- ✅ 自动结算和奖金分配
|
||
|
||
### 👥 用户管理
|
||
- ✅ 用户注册/登录（JWT认证）
|
||
- ✅ 角色管理（普通用户/主播/管理员）
|
||
- ✅ 喵币系统（余额管理）
|
||
- ✅ 低保机制
|
||
- ✅ 交易流水记录
|
||
|
||
### 🎤 主播功能
|
||
- ✅ 主播身份认证
|
||
- ✅ 创建和管理宝箱
|
||
- ✅ 抽成比例设置
|
||
- ✅ 宝箱数量限制
|
||
- ✅ 收益统计
|
||
|
||
### 🛠️ 管理后台
|
||
- ✅ **用户管理** - 搜索、筛选、批量操作、余额调整
|
||
- ✅ **主播管理** - 配置管理、状态控制、详细统计
|
||
- ✅ **系统设置** - 灵活的配置管理（支持多数据类型）
|
||
- ✅ **公告管理** - 发布公告、置顶、优先级设置
|
||
|
||
## 🚀 快速开始
|
||
|
||
### 1. 启动后端服务
|
||
```bash
|
||
cd backend
|
||
pip install -r requirements.txt
|
||
python init_database.py
|
||
python run.py
|
||
```
|
||
|
||
后端服务将在 http://localhost:8000 启动
|
||
|
||
### 2. 启动前端项目
|
||
```bash
|
||
cd frontend
|
||
npm install
|
||
npm run dev
|
||
```
|
||
|
||
前端应用将在 http://localhost:5173 启动
|
||
|
||
## 📚 文档导航
|
||
|
||
- [重构总结报告](./重构总结.md) - 详细的重构过程和成果
|
||
- [最终交付总结](./最终交付总结.md) - 完整的交付清单
|
||
- [快速启动指南](./快速启动.md) - 快速上手指南
|
||
- [前后端整合指南](./前后端整合指南.md) - 前后端整合步骤
|
||
|
||
## 🏗️ 技术架构
|
||
|
||
### 后端技术栈
|
||
- **框架**: FastAPI 0.104+ (Python 3.8+)
|
||
- **ORM**: SQLAlchemy 2.0
|
||
- **数据库**: MySQL 8.0
|
||
- **缓存**: Redis 7.0
|
||
- **认证**: JWT
|
||
|
||
### 前端技术栈
|
||
- **框架**: React 18 + TypeScript
|
||
- **构建**: Vite
|
||
- **路由**: React Router 6
|
||
- **状态管理**: Context API
|
||
|
||
## 📞 联系我们
|
||
|
||
- **技术负责人**: Claude Code (阿里P9级别)
|
||
|
||
⭐ 如果这个项目对您有帮助，请给我们一个Star！⭐
|