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！⭐
|