Files
邹进 42e881576d
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m33s
feat: 卡网关按运营商账户限流并记录停复机调用
- 新增网关限流:按本系统运营商账户(卡 carrier_id)→ 限流组 → 操作限制每秒请求数,每次 HTTP 尝试计量,默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免;支持只统计与拦截两种模式,默认只统计
- Asynq 遇限流不计失败、固定短延迟重试;轮询任务与停复机业务重试遇限流短延迟重排
- 停机、复机不再使用网关内部重试,只发一次请求
- 网关返回结构化错误;新增上游错误分类规则表与测试接口
- 新增按月分区的停复机记录表:系统自动停复机只写记录,不再写统一审计与集成日志;普通轮询查询不再写集成日志
- 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口
- 迁移 000243~000246;同步 OpenSpec 提案(含后续 6 个 change)与技术方案、工程约束
2026-10-24 15:06:41 +09:00

2.3 KiB
Raw Blame History

ADDED Requirements

Requirement: 流量按观测时间归属

系统 SHALL 为每次流量观测记录网关返回时的观测时间;入账时若资产已有生效主套餐但观测时间早于该套餐的激活时间,本次增量 MUST 只记为已结算、不扣减该套餐。该规则 MUST 对全部流量观测生效(轮询、激活前结算、手动刷新)。

Scenario: 慢返回的结算晚于另一入口激活

  • GIVEN 资产无生效套餐,激活前结算 10:00:00 发出查询,另一入口 10:00:02 激活了套餐
  • WHEN 结算结果 10:00:05 返回并入账,观测时间早于激活时间
  • THEN 本次增量只记已结算,不扣新套餐

Scenario: 激活后的观测正常扣减

  • WHEN 观测时间晚于套餐激活时间
  • THEN 增量按现有规则扣减套餐

Requirement: 激活前流量结算

对已切换日快照计量的卡,系统 SHALL 在资产从"无生效主套餐"变为"有生效主套餐"之前(实名激活、排队激活、指定激活、队首激活、订单购买即生效),对独立卡查一次流量、对设备逐张查设备下各卡,并按现有观测入账(此时无套餐,增量只记已结算),然后再执行激活。已有生效主套餐(续费、排队衔接)与流量重置 MUST NOT 执行结算。结算观测 MUST 携带"激活前结算"标记,入账照常但 MUST NOT 触发停复机评估;激活提交后的评估是激活链路唯一一次评估。结算查询 MUST 受运营商账户限流约束;单卡限流等待超过单步超时、查询失败或整次结算达到总超时时,系统 MUST 跳过剩余结算、照常激活,并按卡写告警。未切换日快照计量的卡 MUST 不做结算。

Scenario: 二次销售激活

  • GIVEN 卡上一用户本月已用 3 GB,当前无生效套餐
  • WHEN 新用户购买套餐即生效
  • THEN 系统先查流量并把 3 GB 记为已结算,再激活,新套餐不承担这 3 GB

Scenario: 结算不触发停机

  • WHEN 结算观测入账时资产无套餐
  • THEN 系统不生成"无有效套餐"停机,激活提交后再评估一次停复机

Scenario: 结算超时

  • WHEN 设备下第 3 张卡结算时整次结算达到总超时
  • THEN 系统跳过剩余卡、照常激活,并为未结算的卡写告警