ssq-desk/docs/任务规划.md

# 任务规划

## 1. Phase 1：核心查询功能

### 1.1 数据库基础建设

#### 101 数据库连接模块
- **任务描述**：实现 MySQL 和 SQLite 数据库连接管理
- **技术要点**：
  - MySQL 连接池管理（远程数据库）
  - SQLite 本地数据库初始化
  - 连接配置管理
- **依赖**：无
- **优先级**：P0

#### 102 数据模型定义
- **任务描述**：定义 `ssq_history` 数据模型结构
- **技术要点**：
  - Go 结构体定义（对应数据库表）
  - 字段验证规则
  - 模型方法（查询、插入等）
- **依赖**：101
- **优先级**：P0

#### 103 Repository 层实现
- **任务描述**：实现数据访问层（MySQL 和 SQLite）
- **技术要点**：
  - MySQL Repository：远程数据查询
  - SQLite Repository：本地数据查询和写入
  - 统一接口抽象
- **依赖**：102
- **优先级**：P0

### 1.2 查询服务层

#### 104 查询服务实现
- **任务描述**：实现核心查询业务逻辑
- **技术要点**：
  - 红球匹配算法（支持部分匹配）
  - 蓝球筛选逻辑
  - 匹配结果分类统计（0-6个红球 + 蓝球组合）
- **依赖**：103
- **优先级**：P0

#### 105 查询结果处理
- **任务描述**：处理查询结果，生成分类统计和详细列表
- **技术要点**：
  - 匹配度计算
  - 结果分类（13种匹配类型）
  - 数据格式化
- **依赖**：104
- **优先级**：P0

### 1.3 Wails API 层

#### 106 API 接口定义
- **任务描述**：定义 Wails 绑定方法，供前端调用
- **技术要点**：
  - 查询接口：`QueryHistory(params)`
  - 参数结构体封装（红球、蓝球、筛选条件）
  - 返回结果结构体
- **依赖**：105
- **优先级**：P0

#### 107 API 实现
- **任务描述**：实现 API 方法，调用 Service 层
- **技术要点**：
  - 参数验证
  - 错误处理
  - 结果返回
- **依赖**：106
- **优先级**：P0

### 1.4 前端查询界面

#### 108 查询条件组件
- **任务描述**：实现查询条件输入界面
- **技术要点**：
  - 6个红球输入框（数字输入，范围1-33）
  - 1个蓝球输入框（数字输入，范围1-16）
  - 16个蓝球筛选复选框 + 全选功能
  - 查询按钮、重置按钮
- **依赖**：无
- **优先级**：P0

#### 109 查询结果展示组件
- **任务描述**：实现查询结果展示界面
- **技术要点**：
  - 左侧汇总列表（13种匹配类型统计）
  - 右侧详情列表（期号、红球、蓝球）
  - 数字颜色标识（匹配红球红色、匹配蓝球蓝色、未匹配黑色）
- **依赖**：108
- **优先级**：P0

#### 110 交互功能实现
- **任务描述**：实现查询交互逻辑
- **技术要点**：
  - 点击汇总项显示详细记录
  - 扩展查询功能（前后n期）
  - 扩展显示低匹配度结果（≤3个红球）
- **依赖**：109, 107
- **优先级**：P0

#### 111 前端与后端集成
- **任务描述**：前端调用 Wails API，完成查询流程
- **技术要点**：
  - Wails 绑定方法调用
  - 数据传递和格式化
  - 错误处理和提示
- **依赖**：110
- **优先级**：P0

---

## 2. Phase 2：数据管理

### 2.1 数据同步功能

#### 201 数据同步服务
- **任务描述**：实现 MySQL 到 SQLite 的数据同步逻辑
- **技术要点**：
  - 增量同步（基于 `issue_number`）
  - 数据校验和去重
  - 同步状态记录
- **依赖**：103
- **优先级**：P1

#### 202 同步触发机制
- **任务描述**：实现同步触发方式
- **技术要点**：
  - 应用启动时自动同步
  - 手动触发同步
  - 定时同步（可选）
- **依赖**：201
- **优先级**：P1

#### 203 同步状态展示
- **任务描述**：前端展示同步状态和进度
- **技术要点**：
  - 同步进度条
  - 同步日志显示
  - 同步结果提示
- **依赖**：202
- **优先级**：P1

### 2.2 本地数据管理

#### 204 数据统计功能
- **任务描述**：展示本地数据统计信息
- **技术要点**：
  - 数据总量统计
  - 最新期号显示
  - 数据更新时间
- **依赖**：103
- **优先级**：P1

#### 205 数据刷新功能
- **任务描述**：手动刷新本地数据
- **技术要点**：
  - 刷新按钮
  - 刷新进度提示
  - 刷新结果反馈
- **依赖**：202
- **优先级**：P1

#### 206 数据备份与恢复
- **任务描述**：实现数据备份和恢复功能
- **技术要点**：
  - 导出 SQLite 数据包
  - 导入数据包
  - 备份文件管理
- **依赖**：103
- **优先级**：P2

---

## 3. Phase 3：其他功能

### 3.1 版本更新

#### 301 更新检查功能
- **任务描述**：实现版本更新检查
- **技术要点**：
  - 版本号管理（语义化版本格式）
  - 远程版本检查接口（JSON 格式）
  - 版本号比较逻辑
  - 更新提示界面
  - 检查触发机制（启动检查、手动检查）
- **依赖**：无
- **优先级**：P2
- **参考文档**：`docs/04-功能迭代/版本更新/任务规划.md`

#### 302 更新下载和安装
- **任务描述**：实现更新包下载和安装
- **技术要点**：
  - 更新包下载（支持断点续传）
  - 下载进度展示
  - 文件校验（MD5/SHA256）
  - 自动/手动安装
  - 安装前备份和失败回滚
  - 更新日志展示
- **依赖**：301
- **优先级**：P2
- **参考文档**：`docs/04-功能迭代/版本更新/任务规划.md`

### 3.2 离线数据包

#### 303 离线数据包管理
- **任务描述**：离线数据包的下载、导入、更新
- **技术要点**：
  - 数据包下载
  - 数据包导入
  - 数据包更新检查
- **依赖**：206
- **优先级**：P2

### 3.3 授权管理

#### 304 授权码管理
- **任务描述**：实现设备授权码管理
- **技术要点**：
  - 设备标识生成（基于主机名、用户目录、操作系统）
  - 授权码输入和格式验证
  - 授权码与设备ID绑定
  - 授权状态存储（SQLite 本地数据库）
  - 授权信息查询接口
- **依赖**：无
- **优先级**：P2
- **参考文档**：`docs/04-功能迭代/授权码功能/授权码功能设计.md`

#### 305 激活验证
- **任务描述**：实现激活状态验证
- **技术要点**：
  - 应用启动时自动验证授权状态
  - 授权信息展示
  - 授权失效处理
  - 设备ID查询接口
- **依赖**：304
- **优先级**：P2
- **参考文档**：`docs/04-功能迭代/授权码功能/授权码功能设计.md`

---

## 4. 任务优先级说明

- **P0**：核心功能，必须完成，Phase 1 所有任务
- **P1**：重要功能，Phase 2 主要任务
- **P2**：辅助功能，Phase 3 所有任务

---

## 5. 开发顺序建议

### 第一阶段（核心功能）
1. 101 → 102 → 103（数据库基础）
2. 104 → 105（查询服务）
3. 106 → 107（API 层）
4. 108 → 109 → 110 → 111（前端界面）

### 第二阶段（数据管理）
1. 201 → 202 → 203（数据同步）
2. 204 → 205（数据管理）
3. 206（数据备份，可选）

### 第三阶段（其他功能）
1. 301 → 302（版本更新）
2. 303（离线数据包）
3. 304 → 305（授权管理）

---

> 文档维护者：JueChen  
> 创建时间：2026-01-07