## ADDED Requirements

### Requirement: 总览统计查询

系统 SHALL 提供轮询系统总览统计接口，展示所有队列的汇总信息。

#### Scenario: 查询总览统计

- **WHEN** 管理员请求查询总览统计
- **THEN** 系统返回所有轮询队列（实名、流量、套餐）的汇总信息，包含总队列长度、总逾期任务数、总成功率、总平均耗时

#### Scenario: 总览包含各队列概览

- **WHEN** 查询总览统计
- **THEN** 系统返回各队列的简要信息，包含队列名称、队列长度、成功率、状态（正常/告警）

#### Scenario: 总览包含系统健康度

- **WHEN** 查询总览统计
- **THEN** 系统计算健康度评分（0-100），基于成功率、队列积压、平均耗时等指标

#### Scenario: 总览包含最后调度时间

- **WHEN** 查询总览统计
- **THEN** 系统返回各队列的最后调度时间，如果超过 30 秒未调度则标记异常

### Requirement: 队列状态查询

系统 SHALL 提供接口查询各轮询队列的详细状态。

#### Scenario: 查询实名检查队列状态

- **WHEN** 管理员请求查询实名检查队列状态
- **THEN** 系统返回队列长度（ZCARD polling:queue:realname）、逾期任务数（score < NOW()）、下个待处理任务的时间

#### Scenario: 查询流量检查队列状态

- **WHEN** 管理员请求查询流量检查队列状态
- **THEN** 系统返回队列长度、逾期任务数、下个待处理任务的时间

#### Scenario: 查询套餐检查队列状态

- **WHEN** 管理员请求查询套餐检查队列状态
- **THEN** 系统返回队列长度、逾期任务数、下个待处理任务的时间

#### Scenario: 查询手动触发队列

- **WHEN** 管理员请求查询手动触发队列
- **THEN** 系统返回各类型手动触发队列的长度（LLEN polling:manual:realname 等）

#### Scenario: 队列为空

- **WHEN** 查询队列状态，队列中没有任务
- **THEN** 系统返回队列长度为 0，逾期任务数为 0，下个待处理任务为 NULL

#### Scenario: 队列积压告警

- **WHEN** 查询队列状态，逾期任务数超过 1000
- **THEN** 系统返回告警标志，提示队列积压严重

### Requirement: 任务执行统计

系统 SHALL 提供接口查询各类型任务的执行统计。

#### Scenario: 查询实名检查统计

- **WHEN** 管理员请求查询实名检查统计（最近 1 小时）
- **THEN** 系统从 Redis Hash（polling:stats:realname）读取 success_count_1h、failure_count_1h、total_duration_1h，计算成功率和平均耗时

#### Scenario: 查询流量检查统计

- **WHEN** 管理员请求查询流量检查统计
- **THEN** 系统返回成功数、失败数、成功率、平均耗时

#### Scenario: 查询套餐检查统计

- **WHEN** 管理员请求查询套餐检查统计
- **THEN** 系统返回成功数、失败数、成功率、平均耗时

#### Scenario: 成功率计算

- **WHEN** 成功数为 950，失败数为 50
- **THEN** 系统计算成功率为 95%

#### Scenario: 平均耗时计算

- **WHEN** 总耗时为 120000 毫秒，成功数为 1000
- **THEN** 系统计算平均耗时为 120 毫秒

#### Scenario: 无数据时返回默认值

- **WHEN** 查询统计，Redis 中没有数据（首次启动）
- **THEN** 系统返回成功数 0、失败数 0、成功率 100%、平均耗时 0

#### Scenario: 成功率低于阈值告警

- **WHEN** 查询统计，成功率低于 90%
- **THEN** 系统返回告警标志，提示成功率过低

### Requirement: 实时并发数查询

系统 SHALL 提供接口查询各类型任务的实时并发数。

#### Scenario: 查询实名检查并发数

- **WHEN** 管理员请求查询实名检查并发数
- **THEN** 系统从 Redis 读取 polling:concurrency:current:realname 和 polling:concurrency:config:realname，返回当前并发数和最大并发数

#### Scenario: 查询所有类型并发数

- **WHEN** 管理员请求查询所有类型并发数
- **THEN** 系统返回实名、流量、套餐、停复机四种类型的并发情况

#### Scenario: 计算并发使用率

- **WHEN** 当前并发数为 30，最大并发数为 50
- **THEN** 系统计算使用率为 60%

#### Scenario: 并发满载标记

- **WHEN** 当前并发数等于最大并发数
- **THEN** 系统返回满载标志，提示可能需要提高并发数

### Requirement: 历史趋势查询

系统 SHALL 提供接口查询任务执行的历史趋势。

#### Scenario: 查询最近 24 小时趋势

- **WHEN** 管理员请求查询最近 24 小时的执行趋势
- **THEN** 系统从 Redis 或数据库读取每小时的成功数、失败数、平均耗时，返回 24 个数据点

#### Scenario: 查询最近 7 天趋势

- **WHEN** 管理员请求查询最近 7 天的执行趋势
- **THEN** 系统从数据库聚合每日的统计数据，返回 7 个数据点

#### Scenario: 趋势数据格式

- **WHEN** 返回趋势数据
- **THEN** 系统返回数组，每个元素包含时间戳、成功数、失败数、成功率、平均耗时

#### Scenario: 趋势数据缺失补零

- **WHEN** 某个时间点没有数据
- **THEN** 系统补充该时间点，成功数和失败数为 0

### Requirement: 配置匹配统计

系统 SHALL 提供接口查询轮询配置的匹配统计。

#### Scenario: 查询配置匹配卡数

- **WHEN** 管理员请求查询配置ID为 1 的匹配卡数
- **THEN** 系统从 Redis Set（polling:config:cards:1）读取卡数量（SCARD），或从数据库实时计算

#### Scenario: 查询所有配置匹配统计

- **WHEN** 管理员请求查询所有配置的匹配统计
- **THEN** 系统返回每个配置的匹配卡数、占比、启用状态

#### Scenario: 未匹配卡统计

- **WHEN** 查询配置匹配统计
- **THEN** 系统额外返回未匹配任何配置的卡数量

#### Scenario: 配置匹配卡数为 0

- **WHEN** 某配置没有匹配的卡
- **THEN** 系统返回匹配卡数为 0，建议禁用或删除该配置

### Requirement: 最近任务详情

系统 SHALL 提供接口查询最近执行的任务详情。

#### Scenario: 查询最近 100 个任务

- **WHEN** 管理员请求查询最近执行的任务
- **THEN** 系统从 Asynq 或数据库读取最近 100 个任务的详情，包含任务ID、类型、状态、开始时间、结束时间、耗时、错误信息

#### Scenario: 筛选失败任务

- **WHEN** 管理员请求查询最近失败的任务
- **THEN** 系统只返回状态为失败的任务

#### Scenario: 筛选特定类型任务

- **WHEN** 管理员请求查询实名检查的最近任务
- **THEN** 系统只返回任务类型为 iot:realname:check 的任务

#### Scenario: 任务详情包含卡信息

- **WHEN** 返回任务详情
- **THEN** 每个任务包含关联的卡ID、ICCID、卡状态等上下文信息

#### Scenario: 任务详情包含错误堆栈

- **WHEN** 任务失败，返回任务详情
- **THEN** 任务详情包含完整的错误信息和堆栈

### Requirement: 初始化进度查询

系统 SHALL 提供接口查询轮询系统的初始化进度。

#### Scenario: 查询初始化状态

- **WHEN** 管理员请求查询初始化进度
- **THEN** 系统从 Redis（polling:init:progress）读取初始化状态，包含已处理卡数、总卡数、百分比、预计完成时间

#### Scenario: 初始化未开始

- **WHEN** Worker 刚启动，初始化未开始
- **THEN** 系统返回状态为"未开始"，进度为 0%

#### Scenario: 初始化进行中

- **WHEN** 初始化任务正在后台运行，已处理 300 万张卡，总数 1000 万
- **THEN** 系统返回状态为"进行中"，进度为 30%，预计剩余时间约 14 分钟

#### Scenario: 初始化已完成

- **WHEN** 初始化任务完成
- **THEN** 系统返回状态为"已完成"，进度为 100%，完成时间

#### Scenario: 初始化失败

- **WHEN** 初始化任务因错误中断
- **THEN** 系统返回状态为"失败"，包含错误信息

### Requirement: 监控数据实时性

系统 SHALL 确保监控数据的实时性和准确性。

#### Scenario: 队列长度实时查询

- **WHEN** 查询队列状态
- **THEN** 系统实时执行 Redis 命令（ZCARD）获取最新数据，不使用缓存

#### Scenario: 统计数据允许延迟

- **WHEN** 查询任务执行统计
- **THEN** 系统从 Redis Hash 读取数据，允许 1-2 秒延迟（更新由任务处理器异步写入）

#### Scenario: 并发数实时查询

- **WHEN** 查询实时并发数
- **THEN** 系统实时读取 Redis 计数器，不使用缓存

#### Scenario: 趋势数据可缓存

- **WHEN** 查询历史趋势
- **THEN** 系统可缓存结果 5 分钟，减少数据库查询

### Requirement: 日志记录

系统 SHALL 记录监控接口的访问日志。

#### Scenario: 记录查询操作

- **WHEN** 管理员调用监控接口
- **THEN** 系统记录 Info 日志，包含接口名称、查询参数、响应时间

#### Scenario: 记录异常查询

- **WHEN** 监控接口查询失败（如 Redis 连接断开）
- **THEN** 系统记录 Error 日志，包含错误详情