Files
邹进 96771a204f
Some checks failed
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Has been cancelled
feat: 卡流量改为日快照计量并统一停复机规则
卡流量计量(按名单灰度,默认 off):
- 新增卡日快照与切换水位表(000241),按通道上游流量重置日换算自然月、重置日防旧值
- 已切换的卡按月对账产生增量,无生效中套餐只结算不发事件;第一次切换写水位
- 已切换卡读数有效即判定通道阈值,卡表本月用量用快照覆盖,日流量读快照
- 配置 JUNHONG_TRAFFIC_CALC_MODE/CARDS、JUNHONG_TRAFFIC_FLOW_SNAPSHOT_ENABLED

停复机规则(总开关 JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED,默认关闭):
- 复机不看停机原因,持通道阈值锁仍拒绝;暂停轮询的卡不自动停复机
- 通道新增实名管控 realname_control_enabled(000242,默认 0),开启后不区分行业卡与实名策略
- 实名管控从 0 改 1 需确认,修改并入通道更新审计

OpenSpec Change: rebuild-card-traffic-metering-and-stop-resume
2026-10-20 17:49:26 +09:00

6.2 KiB
Raw Blame History

ADDED Requirements

Requirement: 停复机新规则总开关

系统 SHALL 提供停复机新规则总开关 JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED,默认关闭。关闭时自动停机、自动复机、设备复机、人工复机与保护期一致性检查 MUST 与本变更前完全一致,通道实名管控配置不参与判断。开启后按本能力其余要求执行。API 与全部 Worker 进程 MUST 使用一致的开关值。

Scenario: 总开关关闭

  • WHEN 总开关关闭,外部停机(停因 carrier_stopped)的卡有套餐且流量未用完
  • THEN 系统与变更前一致,不自动复机

Scenario: 总开关开启

  • WHEN 维护者开启总开关并重启全部进程
  • THEN 后续每次停复机评估按本能力的停机与复机条件执行

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 复用通道现有的实名链接类型等字段;存量通道全部为 0,不迁移、不修改任何卡或设备数据。开启时,通道下所有卡停复机只按卡是否已实名判断,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 NOT 新增按这些状态自动暂停轮询的处理;现有独立卡风险停机、已销户自动暂停轮询的处理保持不变。未暂停轮询的卡,不论运营商扩展状态如何,均按停机与复机条件处理,上游拒绝复机时按现有失败处理。

Scenario: 暂停轮询的卡充值后

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

Scenario: 恢复轮询后

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

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

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