Files
cpzs-frontend/lottery-app/README.md
2025-08-01 19:03:57 +08:00

135 lines
3.5 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 双色球智能推测系统
这是一个基于Vue 3开发的双色球智能推测前端应用提供智能算法分析、开奖信息查询等功能。
## 功能特性
### 🎯 主要功能
- **智能推测**: 5步推测流程包含首球算法、跟随球分析、蓝球分析
- **开奖查询**: 支持期号查询和日期范围查询
- **用户中心**: 个人信息管理和会员权益展示
### 📱 页面结构
1. **首页** - 智能推测功能
- 选择算法级别(高位/中位/低位)
- 输入上期开奖号码
- 首球算法分析
- 跟随球分析
- 蓝球分析
- 最终号码确认
2. **开奖信息** - 查询历史开奖
- 期号精确查询
- 日期范围查询
- 近期开奖记录展示
3. **我的页面** - 用户信息管理
- 用户信息展示
- 会员权益介绍
- 功能菜单导航
- 使用统计数据
## 技术栈
- **框架**: Vue 3
- **路由**: Vue Router 4
- **HTTP客户端**: Axios
- **构建工具**: Vite
- **CSS**: 原生CSS + Scoped Styles
## 后端接口
应用连接到SpringBoot后端服务接口前缀`http://localhost:8123/api`
### 主要接口
- `GET /ball-analysis/recent-draws` - 获取近期开奖信息
- `GET /ball-analysis/query-draws` - 按日期范围查询
- `GET /ball-analysis/draw/{drawId}` - 根据期号查询
- `POST /ball-analysis/analyze` - 首球算法分析
- `POST /ball-analysis/fallow` - 跟随球分析
- `POST /ball-analysis/blue-ball` - 蓝球分析
- `POST /ball-analysis/create-predict` - 创建推测记录
## 快速开始
### 安装依赖
```bash
npm install
```
### 开发环境运行
```bash
npm run dev
```
### 构建生产版本
```bash
npm run build
```
### 预览生产构建
```bash
npm run preview
```
## 项目结构
```
src/
├── api/
│ └── index.js # API接口封装
├── components/ # 公共组件
├── router/
│ └── index.js # 路由配置
├── views/
│ ├── Home.vue # 主页 - 智能推测
│ ├── LotteryInfo.vue # 开奖信息页
│ └── Profile.vue # 我的页面
├── App.vue # 根组件
└── main.js # 入口文件
```
## 使用说明
### 推测流程
1. **第一步**: 选择推测级别(高位/中位/低位),输入开奖期号、日期和上期中奖号码
2. **第二步**: 查看首球算法推荐的11个红球号码选择1个首球和2个随球
3. **第三步**: 查看跟随球分析推荐的8个号码组合完整的6个红球
4. **第四步**: 选择2个蓝球进行分析获得4个推荐蓝球选择最终蓝球
5. **第五步**: 确认推测号码并提交
### 开奖查询
- **期号查询**: 输入具体期号如2025056进行精确查询
- **日期查询**: 设置日期范围进行批量查询
- **历史记录**: 自动加载最近15期开奖信息
## 注意事项
⚠️ **重要提醒**: 彩票开奖系统随机,本应用提供的推测结果仅供参考,不保证中奖。投注需谨慎,请理性购彩。
## 浏览器支持
- Chrome >= 87
- Firefox >= 78
- Safari >= 14
- Edge >= 88
## 开发指南
### 代码规范
- 使用ES6+语法
- 组件采用SFCSingle File Component格式
- CSS使用scoped样式避免污染
- 遵循Vue 3 Composition API最佳实践
### API集成
所有API调用都封装在`src/api/index.js`中,统一处理请求和响应。
### 样式规范
- 采用移动端优先的响应式设计
- 主色调:红色(#e53e3e),蓝色(#3182ce)
- 遵循Material Design设计原则