# 彩票数据分析系统使用指南

## 🚀 快速开始

### 1. 启动系统
```bash
# 一键启动（推荐）
python start_system.py

# 或者手动启动
# 后端：cd backend && uvicorn app.main:app --reload --host 0.0.0.0 --port 8000
# 前端：cd frontend && npm run dev
```

### 2. 访问系统
- 前端界面：http://localhost:5173
- 后端API文档：http://localhost:8000/docs

## 📊 主要功能

### 1. 数据更新功能 ⭐ 新功能

#### 位置
- 在首页顶部可以看到"数据更新"卡片
- 包含三个按钮：更新双色球、更新大乐透、更新全部

#### 使用方法
1. **更新双色球数据**
   - 点击"更新双色球"按钮
   - 系统会自动从API获取最新开奖数据
   - 只添加数据库中不存在的新记录
   - 更新完成后会显示新增记录数量

2. **更新大乐透数据**
   - 点击"更新大乐透"按钮
   - 功能与双色球更新类似

3. **更新全部数据**
   - 点击"更新全部"按钮
   - 同时更新双色球和大乐透数据
   - 适合批量更新场景

#### 更新逻辑
- 自动去重：只添加数据库中未存在的开奖日期
- 数据验证：验证开奖号码的格式和范围
- 实时反馈：显示更新进度和结果
- 自动刷新：更新完成后自动刷新首页最新开奖信息

### 2. 数据查看功能

#### 最新开奖信息
- 首页显示双色球和大乐透的最新开奖记录
- 包含期号、开奖时间、开奖号码
- 支持手动刷新功能

#### 历史数据查询
- 进入"双色球数据"或"大乐透数据"页面
- 支持按期号、日期范围查询
- 分页显示，每页20条记录

### 3. 统计分析功能

#### 基础统计
- 号码出现频率统计
- 热门号码和冷门号码分析
- 数据可视化展示

#### 高级分析 ⭐ 新功能
- **遗漏值分析**：分析各号码的遗漏期数
- **和值分析**：统计红球和值的分布规律
- **AC值分析**：邻号差值分析
- **质合比分析**：质数与合数的比例分析
- **012路分析**：除3余数分析
- **跨度分析**：最大最小号码差值分析
- **综合分析**：多维度数据整合分析

### 4. 智能预测功能 ⭐ 新功能

#### 预测方法
- **机器学习预测**：基于AI算法的预测
- **模式预测**：基于统计模式的预测
- **集成预测**：多方法综合预测

#### 使用步骤
1. 进入"智能预测"页面
2. 选择彩票类型（双色球/大乐透）
3. 设置训练期数（建议100-500期）
4. 点击"训练模型"按钮
5. 选择预测方法并查看结果

### 5. 智能选号功能

#### 选号策略
- 随机选号
- 频率选号
- 热门号码选号
- 冷门号码选号
- 自定义选号策略

## 🔧 技术特性

### 数据管理
- **自动去重**：避免重复数据导入
- **数据验证**：确保数据格式正确
- **批量处理**：支持大量数据的高效处理
- **事务安全**：数据库操作支持回滚

### 性能优化
- **API缓存**：减少重复请求
- **分页查询**：提高大数据量查询性能
- **异步处理**：支持并发请求处理
- **错误重试**：网络请求自动重试机制

### 用户体验
- **响应式设计**：支持各种屏幕尺寸
- **实时反馈**：操作状态实时显示
- **错误提示**：友好的错误信息展示
- **加载状态**：长时间操作的进度提示

## 🛠️ 故障排除

### 常见问题

#### 1. 系统启动失败
**问题**：运行 `python start_system.py` 后系统无法启动
**解决**：
- 检查Python版本是否为3.8+
- 检查Node.js版本是否为16+
- 确保已安装所有依赖包

#### 2. 数据更新失败
**问题**：点击更新按钮后显示错误
**解决**：
- 检查网络连接
- 确认API密钥是否有效
- 查看后端日志获取详细错误信息

#### 3. 前端页面无法访问
**问题**：浏览器无法打开 http://localhost:5173
**解决**：
- 确认前端服务是否正常启动
- 检查端口5173是否被占用
- 查看前端控制台错误信息

#### 4. 数据库连接失败
**问题**：后端启动时显示数据库连接错误
**解决**：
- 检查数据库服务是否启动
- 确认数据库连接配置是否正确
- 验证数据库用户权限

### 日志查看
- 后端日志：查看终端输出或日志文件
- 前端日志：打开浏览器开发者工具查看控制台
- 数据库日志：查看数据库服务器日志

## 📞 技术支持

如果遇到问题，请：
1. 查看本文档的故障排除部分
2. 检查系统日志获取详细错误信息
3. 确认系统环境配置是否正确
4. 联系技术支持团队

## 🔄 更新日志

### v1.0.0 (最新版本)
- ✅ 新增数据更新功能
- ✅ 新增高级分析功能
- ✅ 新增智能预测功能
- ✅ 优化用户界面和用户体验
- ✅ 提升系统性能和稳定性