133 lines
3.2 KiB
Markdown
133 lines
3.2 KiB
Markdown
# 双色球查询业务模块
|
||
|
||
## 1. 业务概述
|
||
|
||
提供双色球历史开奖数据查询功能，支持按红球、蓝球条件查询，并展示匹配结果的分类统计和详细记录。
|
||
|
||
---
|
||
|
||
## 2. 业务规则
|
||
|
||
### 2.1 查询规则
|
||
|
||
#### 红球规则
|
||
- 红球范围：1-33
|
||
- 输入数量：可输入 0-6 个红球
|
||
- 匹配方式：完全匹配（必须6个红球全部在查询条件中）
|
||
|
||
#### 蓝球规则
|
||
- 蓝球范围：1-16
|
||
- 输入方式：单个蓝球输入框
|
||
- 筛选方式：复选框筛选范围（可多选）
|
||
|
||
#### 查询逻辑
|
||
- **完全匹配**：查询结果必须包含所有输入的红球和蓝球
|
||
- **部分匹配**：支持只输入部分红球（匹配到即显示）
|
||
- **蓝球筛选**：根据勾选的蓝球范围进行过滤
|
||
|
||
### 2.2 匹配统计规则
|
||
|
||
#### 统计分类
|
||
- 6个红球 + 1个蓝球：完全匹配
|
||
- 6个红球：红球全部匹配，蓝球不匹配
|
||
- 5个红球 + 1个蓝球：5个红球匹配且蓝球匹配
|
||
- 5个红球：5个红球匹配，蓝球不匹配
|
||
- ... 依此类推到 0个红球
|
||
|
||
#### 匹配计数
|
||
- 每条历史记录根据匹配情况归类到对应分类
|
||
- 统计每个分类的出现次数
|
||
- 支持扩展显示低匹配度结果（≤3个红球）
|
||
|
||
---
|
||
|
||
## 3. 数据展示规则
|
||
|
||
### 3.1 颜色标识
|
||
- **匹配的红球**：红色显示（#F53F3F）
|
||
- **匹配的蓝球**：蓝色显示（#165DFF）
|
||
- **未匹配的数字**：黑色显示（默认）
|
||
|
||
### 3.2 结果分类展示
|
||
|
||
#### 左侧汇总列表
|
||
- 显示各匹配级别的统计次数
|
||
- 每个汇总项提供 `[显示历史开奖]` 链接
|
||
- 点击链接，右侧显示对应的详细记录
|
||
|
||
#### 右侧详情列表
|
||
- 显示期号、红球号码、蓝球号码
|
||
- 支持扩展查询：查看前后 n 期数据
|
||
- 支持扩展显示：显示低匹配度结果
|
||
|
||
---
|
||
|
||
## 4. 数据来源
|
||
|
||
### 4.1 远程数据库（MySQL）
|
||
- **数据表**：`ssq_history`
|
||
- **数据内容**：完整历史开奖数据
|
||
- **更新频率**：定期更新（新增期号）
|
||
|
||
### 4.2 本地缓存（SQLite）
|
||
- **数据来源**：从 MySQL 同步
|
||
- **用途**：离线查询、快速查询
|
||
- **同步策略**：增量同步、手动刷新
|
||
|
||
---
|
||
|
||
## 5. 业务场景
|
||
|
||
### 5.1 查询场景
|
||
1. **完整查询**：输入6个红球+1个蓝球，查看完全匹配记录
|
||
2. **部分查询**：输入部分红球，查看匹配情况
|
||
3. **统计分析**：查看历史中不同匹配级别的出现频率
|
||
|
||
### 5.2 数据维护场景
|
||
1. **数据同步**：从远程数据库同步最新数据
|
||
2. **离线使用**：本地缓存数据，支持离线查询
|
||
3. **数据备份**：导出离线数据包，备份数据
|
||
|
||
---
|
||
|
||
## 6. 业务流程
|
||
|
||
### 6.1 查询流程
|
||
|
||
```
|
||
用户输入查询条件
|
||
↓
|
||
验证输入有效性（球号范围、数量）
|
||
↓
|
||
执行查询（本地优先）
|
||
↓
|
||
匹配结果并分类统计
|
||
↓
|
||
展示汇总列表（左侧）
|
||
↓
|
||
用户点击汇总项
|
||
↓
|
||
展示详细记录（右侧）
|
||
```
|
||
|
||
### 6.2 数据同步流程
|
||
|
||
```
|
||
触发同步（启动/手动/定时）
|
||
↓
|
||
连接远程数据库
|
||
↓
|
||
检查数据更新（基于 issue_number）
|
||
↓
|
||
增量同步新数据
|
||
↓
|
||
更新本地 SQLite
|
||
↓
|
||
记录同步日志
|
||
```
|
||
|
||
---
|
||
|
||
> 文档维护者：JueChen
|
||
> 创建时间：2026-01-07
|