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

3.9 KiB

MODIFIED Requirements

Requirement: 通道阈值停机与周期恢复

系统 SHALL 为每个已启用运营商通道按通道既有的上游流量重置日(与网关计数器清零同一事实,上海时区周期边界)判断运营商回传的每张卡当前周期累计流量,累计流量仅取网关累计读数换算,不使用本地用量统计或套餐真流量;每张卡独立判断,不扩散到设备维度,不进入既有停复机的设备扩散路径。达到或超过阈值时,系统为当前周期创建通道阈值停机锁并创建可靠停机任务;同一周期重复判定、并发或任务重放不得重复创建锁或重复发起停机。改阈值不生效于当前周期已持锁卡:当前周期维持拒绝复机,新周期按新阈值判断。

持锁卡在当前周期内 MUST 拒绝一切复机,包括自动复机、手动复机、保护期强制复机和机卡分离复机;拒绝时保留锁并记录拒绝事实。停机调用失败或结果未知时保留锁与任务状态,由本能力新增的恢复扫描处理:只查询运营商状态回填、确认成功后补写卡状态;自提交起超过约定窗口仍无法确认结果的,标记异常并转人工处理,不自动删除锁。本能力新增停因 channel_threshold,不参与既有自动复机判定,复机仅由周期处理发起。

新周期开始时,系统 SHALL 对仍持锁卡解除通道锁;仅存在有效主套餐、流量未耗尽、实名满足、不存在风险停机、销户或其他停机锁时创建自动复机任务,任一条件不满足时只解锁不调用运营商。其他停机锁指卡停机原因为非空且非通道阈值的其他停因,或网关扩展状态为风险停机、销户。停复机新规则总开关(JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED)开启时,新周期解锁后的复机条件改为 card-stop-resume 的复机条件:有套餐、流量未用完、卡已实名或卡所属通道未开启实名管控,且卡与其绑定设备未暂停轮询;不再以其他停机原因或网关扩展状态阻止复机,条件不满足时只解锁不调用运营商。复机失败或结果未知同样由恢复扫描处理。卡更换运营商后,旧周期锁保留,新周期按新运营商的重置日计算。

Scenario: 达量后人工复机

  • WHEN 当前计费周期内持有通道阈值停机锁的卡请求复机
  • THEN 系统拒绝复机且保留该锁

Scenario: 新周期仍有其他停机锁

  • WHEN 新周期开始的持锁卡没有风险停机但存在其他停机锁
  • THEN 系统解除通道阈值锁但不调用运营商复机

Scenario: 达量后强制复机被拒

  • WHEN 当前计费周期内的持锁卡触发保护期强制复机或机卡分离复机
  • THEN 系统拒绝复机、保留该锁并记录拒绝事实

Scenario: 停机结果未知恢复确认

  • WHEN 通道阈值停机调用后结果未知,恢复扫描向运营商查询确认卡已停机
  • THEN 系统补写卡停机状态并将任务结果记为已确认

Scenario: 停机结果未知超期转人工

  • WHEN 通道阈值停机任务自提交起超过约定窗口仍无法确认结果
  • THEN 系统标记异常并留存安全失败原因转人工处理,不自动删除锁

Scenario: 换运营商后周期归属

  • WHEN 持锁卡更换运营商后到达新计费周期
  • THEN 旧周期锁保留,新周期按新运营商的上游流量重置日计算并处理

Scenario: 总开关开启后新周期存在其他停因

  • WHEN 停复机新规则总开关开启,新周期开始的持锁卡停因记录为人工停机,有套餐、流量未用完、实名条件满足且未暂停轮询
  • THEN 系统解除通道阈值锁并创建自动复机任务

Scenario: 总开关开启后新周期卡已暂停轮询

  • WHEN 停复机新规则总开关开启,新周期开始的持锁卡已被暂停轮询
  • THEN 系统解除通道阈值锁但不调用运营商复机