216 lines
5.0 KiB
Markdown
216 lines
5.0 KiB
Markdown
# 双色球查询功能需求文档
|
||
|
||
## 1. 功能概述
|
||
|
||
双色球桌面查询应用，提供历史开奖数据查询、统计分析等功能。
|
||
|
||
---
|
||
|
||
## 2. 查询功能
|
||
|
||
### 2.1 查询条件
|
||
|
||
#### 2.1.1 红球输入
|
||
- 6个红色球输入框，依次为：
|
||
- 红球1
|
||
- 红球2
|
||
- 红球3
|
||
- 红球4
|
||
- 红球5
|
||
- 红球6
|
||
|
||
#### 2.1.2 蓝球输入
|
||
- 1个蓝色球输入框：蓝球
|
||
|
||
#### 2.1.3 蓝球筛选
|
||
- 17个复选框：
|
||
- 蓝球1 至 蓝球16（16个选项）
|
||
- 全选复选框（1个）
|
||
|
||
#### 2.1.4 操作按钮
|
||
- **查询按钮**：执行查询
|
||
- **重置按钮**：清空所有输入，默认勾选全选复选框
|
||
|
||
### 2.2 查询逻辑
|
||
|
||
- 根据输入的6个红球和1个蓝球进行匹配查询
|
||
- 支持部分匹配（如只输入部分红球）
|
||
- 蓝球筛选：根据勾选的蓝球范围进行过滤
|
||
|
||
### 2.3 查询结果展示
|
||
|
||
#### 2.3.1 结果列表
|
||
显示字段：
|
||
- 期数
|
||
- 红球1
|
||
- 红球2
|
||
- 红球3
|
||
- 红球4
|
||
- 红球5
|
||
- 红球6
|
||
- 蓝球
|
||
|
||
#### 2.3.2 数字颜色标识
|
||
- **匹配的红球**：红色数字显示
|
||
- **匹配的蓝球**：蓝色数字显示
|
||
- **未匹配的数字**：黑色数字显示
|
||
|
||
#### 2.3.3 查询结果分类
|
||
|
||
**左侧汇总区域**：
|
||
- 开出过6个红球与1个蓝球：X次
|
||
- 开出过6个红球：X次
|
||
- 开出过5个红球与1个蓝球：X次
|
||
- 开出过5个红球：X次
|
||
- 开出过4个红球与1个蓝球：X次
|
||
- 开出过4个红球：X次
|
||
- 开出过3个红球与1个蓝球：X次
|
||
- 开出过3个红球：X次
|
||
- 开出过2个红球与1个蓝球：X次
|
||
- 开出过2个红球：X次
|
||
- 开出过1个红球与1个蓝球：X次
|
||
- 开出过1个红球：X次
|
||
- 开出过0个红球与1个蓝球：X次
|
||
- 开出过0个红球：X次
|
||
- 每个汇总项提供 `[显示历史开奖]` 链接
|
||
|
||
**右侧详情区域**：
|
||
- 点击左侧汇总项的 `[显示历史开奖]`，右侧显示对应的详细开奖记录
|
||
- 每条记录显示：期号、红球号码、蓝球号码
|
||
- 支持扩展查询：`[再扩展查询对比结果上下n期]` 按钮
|
||
|
||
**扩展功能**：
|
||
- 底部提供：`[扩展显示≤3个红球的对比结果]` 按钮
|
||
|
||
---
|
||
|
||
## 3. 数据维护功能
|
||
|
||
### 3.1 数据同步
|
||
- 从远程数据库同步历史数据
|
||
- 支持增量更新
|
||
- 数据校验和去重
|
||
|
||
### 3.2 数据管理
|
||
- 查看本地数据统计
|
||
- 手动刷新数据
|
||
- 数据备份与恢复
|
||
|
||
---
|
||
|
||
## 4. 其他功能
|
||
|
||
### 4.1 版本更新
|
||
- 检查更新
|
||
- 自动/手动更新
|
||
- 更新日志展示
|
||
|
||
### 4.2 离线数据
|
||
- 离线数据包管理
|
||
- 离线数据包更新
|
||
- 数据包下载与导入
|
||
|
||
### 4.3 授权管理
|
||
- 设备授权码管理
|
||
- 激活状态验证
|
||
- 授权信息显示
|
||
|
||
---
|
||
|
||
## 5. 数据库设计
|
||
|
||
### 5.1 数据库信息
|
||
- **地址**：39.99.243.191:3306
|
||
- **账号**：u_ssq
|
||
- **密码**：u_ssq@260106
|
||
- **数据库名**：ssq_dev
|
||
|
||
### 5.2 数据表结构
|
||
|
||
#### ssq_history（双色球历史开奖数据表）
|
||
|
||
```sql
|
||
CREATE TABLE IF NOT EXISTS `ssq_history` (
|
||
`id` INT NOT NULL COMMENT '主键ID',
|
||
`issue_number` VARCHAR(20) NOT NULL COMMENT '期号（如2025145）',
|
||
`open_date` DATE NULL COMMENT '开奖日期（允许为空）',
|
||
`red_ball_1` TINYINT NOT NULL COMMENT '红球1',
|
||
`red_ball_2` TINYINT NOT NULL COMMENT '红球2',
|
||
`red_ball_3` TINYINT NOT NULL COMMENT '红球3',
|
||
`red_ball_4` TINYINT NOT NULL COMMENT '红球4',
|
||
`red_ball_5` TINYINT NOT NULL COMMENT '红球5',
|
||
`red_ball_6` TINYINT NOT NULL COMMENT '红球6',
|
||
`blue_ball` TINYINT NOT NULL COMMENT '蓝球',
|
||
`created_at` DATETIME NOT NULL COMMENT '创建时间',
|
||
`updated_at` DATETIME NOT NULL COMMENT '更新时间',
|
||
PRIMARY KEY (`id`)
|
||
) ENGINE=InnoDB DEFAULT CHARSET=utf8mb4 COMMENT='双色球历史开奖数据';
|
||
```
|
||
|
||
#### 字段说明
|
||
- `id`：主键，唯一标识
|
||
- `issue_number`：期号，格式如 "2025145"
|
||
- `open_date`：开奖日期，可为空
|
||
- `red_ball_1` 至 `red_ball_6`：6个红球号码（1-33）
|
||
- `blue_ball`：蓝球号码（1-16）
|
||
- `created_at`：记录创建时间
|
||
- `updated_at`：记录更新时间
|
||
|
||
---
|
||
|
||
## 6. 界面设计要求
|
||
|
||
### 6.1 布局
|
||
- 顶部：查询条件区域
|
||
- 中间左侧：查询汇总列表
|
||
- 中间右侧：查询结果详情
|
||
- 底部：扩展功能按钮
|
||
|
||
### 6.2 样式规范
|
||
- 使用 Arco Design 组件库
|
||
- 红球数字：红色标识（#F53F3F）
|
||
- 蓝球数字：蓝色标识（#165DFF）
|
||
- 未匹配数字：黑色（默认）
|
||
- 保持主题兼容性
|
||
|
||
---
|
||
|
||
## 7. 技术实现
|
||
|
||
### 7.1 技术栈
|
||
- **前端**：Vue 3 + Arco Design + TypeScript
|
||
- **后端**：Go + Wails
|
||
- **数据库**：MySQL（远程）+ SQLite（本地缓存）
|
||
|
||
### 7.2 数据存储策略
|
||
- 远程 MySQL：完整历史数据
|
||
- 本地 SQLite：缓存查询结果，离线支持
|
||
|
||
### 7.3 性能优化
|
||
- 分页加载查询结果
|
||
- 本地数据缓存
|
||
- 异步数据同步
|
||
|
||
---
|
||
|
||
## 8. 开发优先级
|
||
|
||
### Phase 1：核心查询功能
|
||
1. 查询条件界面
|
||
2. 基础查询功能
|
||
3. 结果展示（列表+分类）
|
||
|
||
### Phase 2：数据管理
|
||
1. 数据同步功能
|
||
2. 本地数据管理
|
||
|
||
### Phase 3：其他功能
|
||
1. 版本更新
|
||
2. 离线数据包
|
||
3. 授权管理
|
||
|
||
---
|
||
|
||
> 文档维护者：JueChen
|
||
> 创建时间：2026-01-07
|