Files
邹进 1214181e78
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 16m2s
feat: 轮询观测入库异步化,调网关与入库分离,采集记录经消息攒批写入
- 轮询步骤异步模式下只调网关并发布 card.ingest 入库消息,入库消费者固定并发 30、按采集 ID 去重、可重试错误不限次数退避重投
- 采集记录经 card.collection 攒批写入,失败整批重投,新增 (observation_id, observed_at) 唯一索引
- 网络、实名观测增加乱序保护;轮询读查询走缓存,套餐状态查询各自计时且失败不缓存
- 入库积压告警与反压;系统配置 polling.ingest.mode 默认 sync 可回退;测试环境 nsqd 消息全部落盘

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-06 16:33:29 +09:00

2.0 KiB
Raw Blame History

MODIFIED Requirements

Requirement: 卡任务串行执行检查步骤

系统 SHALL 对一张卡的一个卡任务按配置的步骤顺序(默认卡状态 → 流量 → 实名 → 套餐)串行执行本次已到期的检查类型。每步 MUST 有单独超时;某步失败只影响该步,后续步骤照常执行;限流等待超时时该步按短延迟重排且不计失败。卡任务总时长 MUST 不超过各步超时之和加余量,到达后取消剩余步骤并按失败收尾。同一张卡的不同检查类型 MUST NOT 并行执行。

入库模式为异步时,卡状态、流量、实名步骤 SHALL 只读取缓存、调用网关并发布入库消息,MUST NOT 在卡任务内写观测结果;步骤结果只反映网关调用是否成功,入库成败不计入该步的失败与退避。网关未返回有效结果的采集,步骤 SHALL 直接发布采集失败记录消息。套餐步骤 SHALL 依据入库段写入的流量评估标记决定是否跳过:标记存在时本轮套餐步骤按成功跳过。

Scenario: 流量步骤失败

  • WHEN 卡任务中流量查询超时
  • THEN 实名、套餐步骤照常执行,流量按退避间隔重试

Scenario: 同卡不同类型

  • WHEN 卡的状态检查与流量检查同时到期
  • THEN 系统在同一个卡任务中先查状态再查流量,不并行发起

Scenario: 网关成功后只发消息

  • WHEN 入库模式为异步,流量步骤拿到有效网关响应
  • THEN 步骤发布一条流量入库消息后按成功结束,不在卡任务内写日快照与采集记录

Scenario: 入库失败不影响步骤退避

  • WHEN 网关调用成功,但该消息入库时数据库超时
  • THEN 该卡的流量检查按成功计算下次到期时间,入库由入库消费者重试

Scenario: 流量已触发评估时跳过套餐步骤

  • WHEN 入库段处理流量消息后产生了流量增量并写入流量评估标记,标记有效期内该卡套餐检查到期
  • THEN 本轮套餐步骤按成功跳过