4.7 KiB
ADDED Requirements
Requirement: PollingBase 支持 verboseLog 标志
PollingBase 结构体 SHALL 新增 verboseLog bool 字段，NewPollingBase 函数 SHALL 接受 verboseLog bool 参数并赋值。cmd/worker/main.go SHALL 从 cfg.Polling.VerboseLog 读取并传入。
Scenario: verboseLog 为 true 时详细日志启用
- WHEN
cfg.Polling.VerboseLog = true且 Worker 启动 - THEN
PollingBase.verboseLog = true，所有 handler 在成功查询上游时输出 Info 日志
Scenario: verboseLog 为 false 时详细日志不输出
- WHEN
cfg.Polling.VerboseLog = false（默认） - THEN 成功查询上游时不输出额外日志，行为与修改前相同
Requirement: 配置文件包含 polling.verbose_log 字段
pkg/config/config.go SHALL 新增 PollingConfig struct 含 VerboseLog bool，并加入 Config 结构体。pkg/config/defaults/config.yaml SHALL 包含 polling.verbose_log: false。
Scenario: 默认配置 verbose_log 为 false
- WHEN 未设置
JUNHONG_POLLING_VERBOSE_LOG环境变量 - THEN
cfg.Polling.VerboseLog = false
Scenario: 环境变量覆盖开启 verbose_log
- WHEN 设置
JUNHONG_POLLING_VERBOSE_LOG=true - THEN
cfg.Polling.VerboseLog = true
Requirement: realname handler 成功查询后输出 verbose 日志
PollingRealnameHandler.Handle SHALL 在 gateway.QueryRealnameStatus 成功返回后，当 h.base.verboseLog 为 true 时，以 Info 级别记录日志，包含：card_id、iccid、real_status（bool）、new_status（int）、changed（bool）。
Scenario: verboseLog 开启时实名查询成功输出日志
- WHEN
verboseLog = true且QueryRealnameStatus成功返回 - THEN 输出包含 iccid + real_status + new_status + changed 的 Info 日志
Scenario: verboseLog 关闭时实名查询成功不输出额外日志
- WHEN
verboseLog = false且QueryRealnameStatus成功返回（状态未变） - THEN 不输出 verbose 日志
Requirement: carddata handler 成功查询后输出 verbose 日志
PollingCarddataHandler.Handle SHALL 在 gateway.QueryFlow 成功返回后，当 h.base.verboseLog 为 true 时，以 Info 级别记录日志，包含：card_id、iccid、gateway_flow_mb（float64）、increment_mb（float64）、is_cross_month（bool）。
Scenario: verboseLog 开启时流量查询成功输出日志
- WHEN
verboseLog = true且QueryFlow成功返回 - THEN 输出包含 iccid + gateway_flow_mb + increment_mb + is_cross_month 的 Info 日志
Scenario: verboseLog 关闭时流量查询成功不输出额外日志
- WHEN
verboseLog = false且QueryFlow成功返回（流量无增量） - THEN 不输出 verbose 日志
Requirement: package handler 成功加载卡信息后输出 verbose 日志
PollingPackageHandler.Handle SHALL 在 GetByID 成功返回 freshCard 后、调用 EvaluateAndAct 之前，当 h.base.verboseLog 为 true 时，以 Info 级别记录日志，包含：card_id、iccid、network_status（int）、stop_reason（string）。
注：package handler 不查询 Gateway，verbose log 记录的是本次评估时读取到的本地卡状态，便于排查"停复机评估为何结果不符预期"类问题。
Scenario: verboseLog 开启时套餐检查加载卡成功输出日志
- WHEN
verboseLog = true且iotCardStore.GetByID成功返回freshCard - THEN 输出包含 iccid + network_status + stop_reason 的 Info 日志
Scenario: verboseLog 关闭时套餐检查不输出额外日志
- WHEN
verboseLog = false - THEN 不输出 verbose 日志（现有 "套餐检查：执行停复机评估" Info 日志保持不变）
Requirement: protect handler 成功执行保护期检查后输出 verbose 日志
PollingProtectHandler.Handle SHALL 在 switch 块执行完毕、调用 UpdateFields(last_protect_check_at) 之前，当 h.base.verboseLog 为 true 时，以 Info 级别记录日志，包含：card_id、iccid、stop_protect（bool）、start_protect（bool）、network_status（int）。
注：该日志在 switch 的所有分支（强制停机、强制复机、EvaluateAndAct、无操作）均成功执行后输出；若某分支因 Gateway 失败提前 return，则不输出（已有 Error 日志覆盖）。
Scenario: verboseLog 开启时保护期检查成功输出日志
- WHEN
verboseLog = true且 switch 块各分支均执行成功（未提前 return） - THEN 输出包含 iccid + stop_protect + start_protect + network_status 的 Info 日志
Scenario: verboseLog 关闭时保护期检查不输出额外日志
- WHEN
verboseLog = false - THEN 不输出 verbose 日志