.

docs/04-功能迭代/双色球查询功能需求.md

@@ -0,0 +1,215 @@
+# 双色球查询功能需求文档
+
+## 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