5.0 KiB
5.0 KiB
双色球查询功能需求文档
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（双色球历史开奖数据表）
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：核心查询功能
- 查询条件界面
- 基础查询功能
- 结果展示（列表+分类）
Phase 2：数据管理
- 数据同步功能
- 本地数据管理
Phase 3：其他功能
- 版本更新
- 离线数据包
- 授权管理
文档维护者：JueChen
创建时间：2026-01-07