# 🎯 互动竞猜开宝箱系统

[![版本](https://img.shields.io/badge/版本-v2.0.0-blue.svg)](https://github.com/your-repo)
[![Python](https://img.shields.io/badge/Python-3.8+-green.svg)](https://www.python.org/)
[![TypeScript](https://img.shields.io/badge/TypeScript-4.9+-blue.svg)](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！⭐