Files
邹进 f49baff7c2
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m35s
feat: 停复机新规则转正,删除总开关与旧口径
- 删除总开关 stop_resume.unified_rule_enabled(配置、加载、部署工作流与 docker-compose.prod.yml 环境变量)
- 复机不看停机原因:删除只对轮询停因复机的旧分支与 ListByDeviceIDAndPollingStopReasons;设备复机取全部停机卡
- 实名门槛只按卡所属通道实名管控判断,删除行业卡与卡/设备实名策略放行;暂停轮询的卡不自动停复机无条件生效
- 通道阈值新周期解锁后的复机条件固定为新规则复机条件
- 资产自动续费复机同步新规则:不看停因、暂停轮询不复机、设备取全部停机卡、复机成功清除停因
- 实名轮询不再按行业卡跳过;所属运营商账户未开启实名管控时跳过查询,但卡未实名且所在资产有等待实名激活的套餐时照常查询,避免囤货套餐无法激活
2026-10-25 18:13:51 +09:00

8.5 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 再按卡类别(行业卡)跳过实名查询。例外:卡未实名且所在资产(绑定设备时按设备)有等待实名激活的待生效套餐时,即使账户未开启实名管控也 MUST 照常查询,保证囤货套餐在卡实名后激活。查询账户实名管控失败时按可恢复失败处理并重入队。

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

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

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 将停机的未实名开机卡数,实际配置不变