# 双色球查询功能需求文档

## 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