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

8.0 KiB
Raw Blame History

REMOVED Requirements

Requirement: 停复机新规则总开关

Reason: 新规则转正为唯一口径,不再保留旧口径与总开关。 Migration: 删除配置项与部署变量 JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED;发布前完成实名管控配置与规则演练。

MODIFIED Requirements

Requirement: 自动停机条件

系统 SHALL 对开机的卡在满足任一条件时自动停机:卡(绑定设备时按设备)没有套餐;流量已用完;卡所属通道开启实名管控且卡未实名。停机原因按命中条件分别记为 no_package、traffic_exhausted、not_realname。无套餐与流量用完扩散到设备下全部开机卡,未实名只停该卡。系统 MUST NOT 因卡当前开机是由外部、人工或其他原因造成而改变判断。

Scenario: 套餐到期

  • WHEN 开机卡绑定的设备没有套餐
  • THEN 系统停机设备下全部开机卡,停因为 no_package

Scenario: 通道开启实名管控的未实名卡

  • WHEN 卡所属通道开启实名管控,卡未实名且开机
  • THEN 系统只停这张卡,停因为 not_realname

Scenario: 通道未开启实名管控的未实名卡

  • WHEN 卡所属通道未开启实名管控,卡未实名、有套餐、流量未用完且开机
  • THEN 系统不停机

Requirement: 自动复机条件不看停机原因

系统 SHALL 对停机的卡在同时满足以下条件时自动复机:卡(绑定设备时按设备)有套餐;流量未用完;卡已实名或卡所属通道未开启实名管控。系统 MUST NOT 以停机原因决定是否复机:运营商侧主动停机(carrier_stopped)、卡管人工停机(manual)、历史保护期停机(protect_period)、未实名、无套餐、流量耗尽及停因为空的卡满足条件都复机,是否复机只由本系统规则决定。持有本周期通道阈值锁的卡 MUST 拒绝复机。设备复机时系统 SHALL 逐张判断设备下全部停机卡,不满足实名条件的卡跳过并记停因 not_realname,其他卡照常复机。外部反复停机时,系统每次评估均按上述条件复机,不设次数上限。停机原因只用于展示与审计。上游对复机返回终态时,按"风险停机与已销户关闭轮询"处理,不重试。

Scenario: 外部停机后满足条件

  • WHEN 卡被外部停机后记为 carrier_stopped,有套餐、流量未用完、实名条件满足
  • THEN 下一次评估时系统自动复机并清空停因

Scenario: 人工停机后满足条件

  • WHEN 管理员手动停机的卡有套餐、流量未用完、实名条件满足
  • THEN 下一次评估时系统自动复机

Scenario: 开启实名管控的通道中未实名的停机卡

  • WHEN 卡所属通道开启实名管控,卡未实名、停机、有套餐
  • THEN 系统不复机;卡实名后下一次评估复机

Scenario: 持有通道阈值锁

  • WHEN 停机卡在本周期持有通道阈值锁,其他条件均满足
  • THEN 系统拒绝复机并保留锁

Requirement: 通道实名管控配置、权限与审计

系统 SHALL 在运营商通道上提供独立的实名管控开关 realname_control_enabled(0 不管控、1 管控),默认 0,MUST NOT 复用通道现有的实名链接类型等字段。开启时,通道下所有卡停复机只按卡是否已实名判断,MUST NOT 以行业卡身份或卡、设备上的实名策略放行;实名策略仍只用于购买与首次实名激活流程。仅超级管理员和平台用户 SHALL 在通道新建或编辑时配置该开关,非平台账号提交该字段 MUST 被拒绝;修改并入通道更新审计。从 0 改为 1 时,管理端 MUST 二次确认并提示该通道未实名的开机卡数。查询卡所属通道的实名管控失败时,系统本次不对该卡发起停复机并记录日志。人工复机同样按本要求判断实名。

Scenario: 默认不管控

  • WHEN 通道未修改实名管控,非行业卡未实名、卡实名策略为 after_order、有套餐且流量未用完
  • THEN 系统不因未实名停机,人工复机不因未实名被拒

Scenario: 开启后行业卡不再放行

  • WHEN 通道开启实名管控,行业卡未实名且开机
  • THEN 系统停机该卡,停因为 not_realname

Scenario: 越权修改实名管控

  • WHEN 非超级管理员、非平台用户提交通道实名管控字段
  • THEN 系统拒绝请求且不修改配置

Scenario: 查询通道失败

  • WHEN 停复机评估时卡所属通道的实名管控查询失败
  • THEN 系统本次不对该卡发起停复机命令并记录日志

Requirement: 暂停轮询的卡不自动停复机

卡或其绑定设备暂停轮询的,系统 SHALL NOT 对该卡发起自动停机或自动复机,包括套餐激活、套餐重置、充值等非轮询触发的复机;人工停机与人工复机照常执行。网关扩展状态为风险停机或已销户的卡 MUST 关闭该卡自身轮询,不论是否绑定设备:查卡状态返回该扩展状态时关闭;停复机调用直接返回命中"自动关闭轮询"规则的终态时,同样关闭并回写网关扩展状态。关闭只作用于该卡,MUST NOT 级联关闭设备与设备下其他卡。机卡分离停机等其他运营商异常状态 MUST NOT 自动关闭轮询,由人工判断。未暂停轮询的卡,不论运营商扩展状态如何,均按停机与复机条件处理,上游拒绝复机时按现有失败处理。

Scenario: 暂停轮询的卡充值后

  • WHEN 已被人工暂停轮询的停机卡充值并激活套餐
  • THEN 系统不自动复机;人工复机照常可用

Scenario: 恢复轮询后

  • WHEN 维护者为该卡恢复轮询
  • THEN 下一次评估起系统按停机与复机条件正常处理

Scenario: 设备卡出现机卡分离停机

  • WHEN 设备下的卡运营商扩展状态为机卡分离停机且未被暂停轮询
  • THEN 系统不自动暂停轮询,按停机与复机条件处理

Scenario: 设备下的卡被销户

  • WHEN 查卡状态返回绑定设备的某张卡扩展状态为已销户
  • THEN 系统关闭该卡轮询,设备与设备下其他卡的轮询不变

Scenario: 复机返回风险停机

  • WHEN 复机调用返回"当前卡为风险停机状态,仅支持风险复机"且该规则标记自动关闭轮询
  • THEN 系统不重试,关闭该卡轮询并回写扩展状态为风险停机

ADDED Requirements

Requirement: 实名轮询按通道实名管控跳过

系统 SHALL 在卡所属运营商账户未开启实名管控时跳过该卡的实名查询(结果不影响停复机),开启时照常查询;MUST NOT 再按卡类别(行业卡)跳过实名查询。

Scenario: 未开管控账户的普通卡

  • WHEN 卡所属账户 realname_control_enabled = 0,实名检查到期
  • THEN 系统不调用网关查实名,按正常间隔安排下次检查

Scenario: 开启管控账户的行业卡

  • WHEN 卡所属账户开启实名管控,行业卡实名检查到期
  • THEN 系统调用网关查实名

Requirement: 停复机规则演练

系统 SHALL 提供只判断不执行的停复机规则演练:对停机卡与开机卡按本能力规则判断目标状态,按运营商账户 × 停机原因 × 判断结果(将复机、将停机、不动作及不动作原因)返回汇总与明细,可按运营商账户与停机原因筛选,可传入假设的通道实名管控配置预演。演练 MUST NOT 调用网关、MUST NOT 写任何卡、指令或调度状态。明细 SHALL 可通过统一导出任务导出。接口仅超级管理员与平台用户可用。

Scenario: 开启前预演

  • WHEN 运营在所有账户实名管控为 0 时执行演练
  • THEN 系统返回各账户将被复机的 not_realname 卡数与明细,卡状态不变

Scenario: 假设开启管控

  • WHEN 运营假设账户 A 开启实名管控执行演练
  • THEN 系统按假设配置返回账户 A 将停机的未实名开机卡数,实际配置不变