feat: 卡网关按运营商账户限流并记录停复机调用
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m33s
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m33s
- 新增网关限流:按本系统运营商账户(卡 carrier_id)→ 限流组 → 操作限制每秒请求数,每次 HTTP 尝试计量,默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免;支持只统计与拦截两种模式,默认只统计 - Asynq 遇限流不计失败、固定短延迟重试;轮询任务与停复机业务重试遇限流短延迟重排 - 停机、复机不再使用网关内部重试,只发一次请求 - 网关返回结构化错误;新增上游错误分类规则表与测试接口 - 新增按月分区的停复机记录表:系统自动停复机只写记录,不再写统一审计与集成日志;普通轮询查询不再写集成日志 - 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口 - 迁移 000243~000246;同步 OpenSpec 提案(含后续 6 个 change)与技术方案、工程约束
This commit is contained in:
@@ -0,0 +1,2 @@
|
||||
schema: spec-driven
|
||||
created: 2026-10-24
|
||||
40
openspec/changes/finalize-unified-stop-resume-rule/design.md
Normal file
40
openspec/changes/finalize-unified-stop-resume-rule/design.md
Normal file
@@ -0,0 +1,40 @@
|
||||
## Context
|
||||
|
||||
依据 `docs/engineering/轮询按运营商账户限流技术方案.md` 第三部分第 12 节、第五部分第 3 节前置条件与"上线前演练"。
|
||||
|
||||
现状:
|
||||
|
||||
- `internal/service/iot_card/stop_resume_unified.go`:`unifiedStopResumeEnabled()` 读 `cfg.StopResume.UnifiedRuleEnabled`;`autoResumableStopReason`、`autoControlSuspended`、`unifiedRealnameOK` 在开关开启时生效,关闭时走 `isRealnameOK` 旧分支与 `isPollingStopReason`。
|
||||
- 迁移 242:`tb_carrier.realname_control_enabled` 默认 0;生产库仍为迁移 240(未上线)。
|
||||
- `internal/task/polling_realname_handler.go:70`:行业卡跳过实名查询。
|
||||
- `internal/domain/cardobservation/network.go:88` `ShouldStopPollingForRisk` 要求 `isStandalone`;生产 8,420 张风险停机或已销户卡均为独立卡且已关闭轮询。
|
||||
- 停复机调用返回终态时只按失败处理,不关闭轮询。
|
||||
|
||||
## Goals / Non-Goals
|
||||
|
||||
**Goals:** 停复机只有一套口径;实名轮询与实名管控口径一致;风险停机与已销户无论如何发现都关闭轮询;开启前可预演影响。
|
||||
|
||||
**Non-Goals:** 不改停复机触发路径与执行方式(第 6 个 Change);不改暂停轮询的套餐失效停机与自动恢复轮询(第 6、7 个 Change);不改激活状态计算口径。
|
||||
|
||||
## Decisions
|
||||
|
||||
1. **先演练开启、再删除开关**:保留开关会长期双口径,但演练必须早于开启;故第一次发布只加演练与补齐、不改口径,开启并稳定后第二次发布删除开关。
|
||||
2. **复机含 `carrier_stopped`**:用户已定"只看本系统规则"。上游终态卡由关闭轮询兜底,不进入自动复机;未识别的终态由错误分类在复机失败时识别并关闭轮询。
|
||||
3. **关闭轮询只作用于卡自身**:设备下其他卡仍可能正常使用;`autoControlSuspended` 按卡判断,该卡不再参与自动停复机,设备维度判断对其余卡照常。
|
||||
4. **终态关闭轮询由规则标记驱动**:在错误分类表加 `auto_disable_polling`,而不是在代码里写死关键字,符合"数值与分组由配置决定"。关闭时同事务回写 `gateway_extend`,并写不轮询清单(第 7 个 Change 上线后;之前只改 `enable_polling` 并写审计)。
|
||||
5. **演练用读侧 Query**:复用统一判断函数,输入卡与资产当前数据和可选的假设实名管控配置,输出目标状态;按批读取、只读,不经聚合根写状态。明细导出复用统一导出任务。
|
||||
|
||||
## Risks / Trade-offs
|
||||
|
||||
- [开启实名管控后行业卡被停] → 已知口径变化;演练可按假设配置预演,运营按结果决定是否开启。
|
||||
- [演练全量扫描较慢] → 按账户分批、只读;导出走异步任务。
|
||||
- [删除开关后无法快速回到旧口径] → 前置要求新规则已在生产稳定运行;必要时代码回退。
|
||||
|
||||
## Migration Plan
|
||||
|
||||
演练必须在新规则开启之前可用,因此分两次发布:
|
||||
|
||||
1. 第一次发布:迁移(错误分类表加列)、演练接口、风险停机与已销户关闭轮询补齐;总开关仍关闭,停复机行为不变。演练始终按新规则判断,不受总开关影响。
|
||||
2. 运营:设置需要实名的账户;生产执行演练并导出核对;需保持停机的卡关闭轮询。维护者开启总开关并重启全部进程,首日监控。
|
||||
3. 第二次发布(新规则稳定后):删除总开关、旧口径与部署环境变量,实名轮询改按账户实名管控跳过。
|
||||
4. 回退:第一次发布后可直接关闭总开关回到旧口径;第二次发布后需代码回退。
|
||||
@@ -0,0 +1,35 @@
|
||||
## Why
|
||||
|
||||
`Iteration/8-11` 已实现停复机新规则,但靠总开关与旧口径并存:代码里同时保留两套实名判断与复机条件,实名轮询仍按行业卡跳过,与"按运营商账户实名管控"的新口径不一致。后续停复机指令队列(第 6 个 Change)需要唯一口径。另一方面,生产 2026-10-24 实查:停机、开启轮询且有生效套餐的卡中,`not_realname` 15,059 张、`carrier_stopped` 998 张、停因为空 83 张、`manual` 22 张;所有账户实名管控默认 0,新规则开启即可能批量复机,必须先演练。本 Change 是《轮询按运营商账户限流技术方案》第五部分第 3 节第 4 步。
|
||||
|
||||
## What Changes
|
||||
|
||||
- **BREAKING** 新规则转正:删除总开关 `stop_resume.unified_rule_enabled`(`JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED`)及其配置、部署变量与全部分支;删除旧口径(行业卡放行、卡或设备 `realname_policy` 放行、只对轮询停因自动复机、`ListByDeviceIDAndPollingStopReasons`)。
|
||||
- 复机不看停机原因,包括运营商侧主动停机 `carrier_stopped`:是否复机只由本系统规则决定。
|
||||
- **BREAKING** 实名轮询改为:卡所属运营商账户未开实名管控时跳过查实名;不再按行业卡跳过。
|
||||
- 风险停机、已销户必须关闭轮询:保留现有查状态自动关闭;补齐绑定设备的卡(只关该卡自身,不级联设备)与停复机调用直接返回终态两种情况;错误分类规则增加"自动关闭轮询"标记,只允许终态类别勾选。
|
||||
- 新增停复机规则演练接口:对全部停机与开机卡按规则只判断不执行,按运营商账户 × 停机原因 × 判断结果输出汇总与明细,可传入假设的实名管控配置预演,明细可导出。
|
||||
- 通道阈值新周期解锁后的复机条件随转正去掉总开关表述;同时去掉已下线的"保护期强制复机"表述。
|
||||
- 上线前演练作为发布前置步骤写入任务。
|
||||
|
||||
## Capabilities
|
||||
|
||||
### New Capabilities
|
||||
|
||||
(无)
|
||||
|
||||
### Modified Capabilities
|
||||
|
||||
- `card-stop-resume`:删除总开关要求;停机、复机、实名管控要求去掉"总开关开启时"前提;复机明确包含 `carrier_stopped`;新增实名轮询按账户实名管控跳过、风险停机与已销户关闭轮询补齐、规则演练。(该能力由 `rebuild-card-traffic-metering-and-stop-resume` 引入,本 Change 要求其先归档。)
|
||||
- `polling-operations`:删除"停复机遵循实际生效实名策略"(旧口径)。
|
||||
- `carrier-channel-traffic-threshold`:"通道阈值停机与周期恢复"去掉总开关与保护期表述,复机条件固定为 `card-stop-resume` 的复机条件。
|
||||
- `gateway-call-observability`:错误分类规则增加"自动关闭轮询"标记(该能力由第 1 个 Change 引入)。
|
||||
|
||||
## Impact
|
||||
|
||||
- 依赖:`rebuild-card-traffic-metering-and-stop-resume` 已归档并上线生产(总开关可仍关闭);第 1 个 Change(错误分类)与第 3 个 Change(去掉保护期)已上线。
|
||||
- **分两次发布**:第一次发布演练接口与关闭轮询补齐,总开关仍关闭、停复机行为不变;运营为需要实名的账户设置 `realname_control_enabled = 1`,用演练核对"将被复机 / 将被停机"的卡并导出确认,需保持停机的卡先关闭轮询,然后维护者开启总开关;新规则稳定运行后第二次发布删除总开关与旧口径、实名轮询改口径。
|
||||
- 数据库:新增成对迁移,`tb_gateway_error_classification` 增加 `auto_disable_polling` 列并为"已销户""风险停机"类规则置位。
|
||||
- 代码:`internal/service/iot_card/stop_resume_unified.go` 并入主逻辑;`stop_resume_service.go` 删除旧分支;`internal/task/polling_realname_handler.go:70`;`internal/domain/cardobservation/network.go` `ShouldStopPollingForRisk` 去掉独立卡限制;停复机失败处理接入"自动关闭轮询";`pkg/config/config.go`、`loader.go`、`defaults/config.yaml`、`.gitea/workflows/deploy.yaml`、`docker-compose.prod.yml` 删除总开关;新增演练 Query 与接口。
|
||||
- 接口:新增 `GET /stop-resume-rule/dry-run` 与导出场景 `stop_resume_rule_dry_run`;错误分类接口增加 `auto_disable_polling` 字段。
|
||||
- 行为:开启实名管控的账户下,行业卡未实名也会被停机;未开实名管控的账户不再查实名。
|
||||
@@ -0,0 +1,109 @@
|
||||
## 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 将停机的未实名开机卡数,实际配置不变
|
||||
@@ -0,0 +1,36 @@
|
||||
## MODIFIED Requirements
|
||||
|
||||
### Requirement: 通道阈值停机与周期恢复
|
||||
系统 SHALL 为每个已启用运营商通道按通道既有的上游流量重置日(与网关计数器清零同一事实,上海时区周期边界)判断运营商回传的每张卡当前周期累计流量,累计流量仅取网关累计读数换算,不使用本地用量统计或套餐真流量;每张卡独立判断,不扩散到设备维度,不进入既有停复机的设备扩散路径。达到或超过阈值时,系统为当前周期创建通道阈值停机锁并创建可靠停机任务;同一周期重复判定、并发或任务重放不得重复创建锁或重复发起停机。改阈值不生效于当前周期已持锁卡:当前周期维持拒绝复机,新周期按新阈值判断。
|
||||
|
||||
持锁卡在当前周期内 MUST 拒绝一切复机,包括自动复机、手动复机和机卡分离复机;拒绝时保留锁并记录拒绝事实。停机调用失败或结果未知时保留锁与任务状态,由本能力新增的恢复扫描处理:只查询运营商状态回填、确认成功后补写卡状态;自提交起超过约定窗口仍无法确认结果的,标记异常并转人工处理,不自动删除锁。本能力新增停因 `channel_threshold`,不参与既有自动复机判定,复机仅由周期处理发起。
|
||||
|
||||
新周期开始时,系统 SHALL 对仍持锁卡解除通道锁;复机条件为 `card-stop-resume` 的复机条件:有套餐、流量未用完、卡已实名或卡所属通道未开启实名管控,且卡与其绑定设备未暂停轮询;不以其他停机原因或网关扩展状态阻止复机,条件满足时创建自动复机任务,不满足时只解锁不调用运营商。复机失败或结果未知同样由恢复扫描处理。卡更换运营商后,旧周期锁保留,新周期按新运营商的重置日计算。
|
||||
|
||||
#### Scenario: 达量后人工复机
|
||||
- **WHEN** 当前计费周期内持有通道阈值停机锁的卡请求复机
|
||||
- **THEN** 系统拒绝复机且保留该锁
|
||||
|
||||
#### Scenario: 达量后机卡分离复机被拒
|
||||
- **WHEN** 当前计费周期内的持锁卡触发机卡分离复机
|
||||
- **THEN** 系统拒绝复机、保留该锁并记录拒绝事实
|
||||
|
||||
#### Scenario: 停机结果未知恢复确认
|
||||
- **WHEN** 通道阈值停机调用后结果未知,恢复扫描向运营商查询确认卡已停机
|
||||
- **THEN** 系统补写卡停机状态并将任务结果记为已确认
|
||||
|
||||
#### Scenario: 停机结果未知超期转人工
|
||||
- **WHEN** 通道阈值停机任务自提交起超过约定窗口仍无法确认结果
|
||||
- **THEN** 系统标记异常并留存安全失败原因转人工处理,不自动删除锁
|
||||
|
||||
#### Scenario: 换运营商后周期归属
|
||||
- **WHEN** 持锁卡更换运营商后到达新计费周期
|
||||
- **THEN** 旧周期锁保留,新周期按新运营商的上游流量重置日计算并处理
|
||||
|
||||
#### Scenario: 新周期存在其他停因
|
||||
- **WHEN** 新周期开始的持锁卡停因记录为人工停机,有套餐、流量未用完、实名条件满足且未暂停轮询
|
||||
- **THEN** 系统解除通道阈值锁并创建自动复机任务
|
||||
|
||||
#### Scenario: 新周期卡已暂停轮询
|
||||
- **WHEN** 新周期开始的持锁卡已被暂停轮询
|
||||
- **THEN** 系统解除通道阈值锁但不调用运营商复机
|
||||
@@ -0,0 +1,13 @@
|
||||
## ADDED Requirements
|
||||
|
||||
### Requirement: 终态规则可标记自动关闭轮询
|
||||
|
||||
系统 SHALL 允许错误分类规则标记"自动关闭轮询",且只允许类别为"终态不可操作"的规则勾选;保存其他类别的规则并勾选时 MUST 拒绝。初始数据中"已销户""风险停机"类终态规则 MUST 置位,"物联网号码封存"等其他终态不置位。
|
||||
|
||||
#### Scenario: 非终态规则勾选
|
||||
- **WHEN** 维护者为"频率限制"类规则勾选自动关闭轮询
|
||||
- **THEN** 系统拒绝保存
|
||||
|
||||
#### Scenario: 号码封存
|
||||
- **WHEN** 停机返回"用户状态是物联网号码封存,禁止办理物联网停机"
|
||||
- **THEN** 该次归为终态不可操作,不自动关闭轮询,按失败告警处理
|
||||
@@ -0,0 +1,5 @@
|
||||
## REMOVED Requirements
|
||||
|
||||
### Requirement: 停复机遵循实际生效实名策略
|
||||
**Reason**: 停复机新规则转正,实名门槛唯一由 `card-stop-resume` 的通道实名管控决定,行业卡与卡、设备实名策略不再参与停复机。
|
||||
**Migration**: 需要实名的运营商账户设置 `realname_control_enabled = 1`;发布前用停复机规则演练核对受影响卡。
|
||||
51
openspec/changes/finalize-unified-stop-resume-rule/tasks.md
Normal file
51
openspec/changes/finalize-unified-stop-resume-rule/tasks.md
Normal file
@@ -0,0 +1,51 @@
|
||||
## 0. 前置确认
|
||||
|
||||
- [ ] 0.1 确认 `rebuild-card-traffic-metering-and-stop-resume` 已归档并上线生产(总开关可仍为关闭);第 1、3 个 Change 已上线。
|
||||
|
||||
## 第一次发布:演练与口径补齐(总开关仍关闭,行为不变)
|
||||
|
||||
## 1. 迁移
|
||||
|
||||
- [ ] 1.1 新增成对迁移:`tb_gateway_error_classification` 增加 `auto_disable_polling boolean not null default false`,为"已销户""风险停机"类终态规则置位;down 删列。
|
||||
|
||||
## 2. 规则演练
|
||||
|
||||
- [ ] 2.1 新增演练 Query:按批读取卡与资产数据,复用新规则判断函数(不受总开关影响,始终按新规则判断),支持假设的实名管控配置;只读。
|
||||
- [ ] 2.2 `GET /stop-resume-rule/dry-run`(运营商账户、停机原因筛选,汇总 + 分页明细),仅超级管理员与平台用户;导出场景 `stop_resume_rule_dry_run`。
|
||||
- [ ] 2.3 同步路由与文档生成入口,重新生成接口文档。
|
||||
|
||||
## 3. 风险停机与已销户关闭轮询
|
||||
|
||||
- [ ] 3.1 `ShouldStopPollingForRisk` 去掉独立卡限制,只关闭该卡自身 `enable_polling`,不级联设备。
|
||||
- [ ] 3.2 停复机调用失败时按错误分类查 `auto_disable_polling`:置位则不重试、关闭该卡轮询、回写 `gateway_extend`、写审计。
|
||||
- [ ] 3.3 错误分类接口增加 `auto_disable_polling` 字段,非终态类别勾选时拒绝。
|
||||
|
||||
## 4. 第一次发布的编译与验证
|
||||
|
||||
- [ ] 4.1 `gofmt -w`;`go build ./cmd/api ./cmd/worker` 通过;`openspec validate finalize-unified-stop-resume-rule` 通过。
|
||||
- [ ] 4.2 测试环境:演练不改任何状态;开启总开关后抽取 `not_realname`、`carrier_stopped`、`manual`、停因为空各若干张,实际评估结果与演练一致。
|
||||
- [ ] 4.3 测试环境:绑定设备的卡返回已销户时只关该卡轮询;复机返回风险停机时不重试并关闭轮询;号码封存不关闭轮询。
|
||||
|
||||
## 5. 开启新规则(运营与维护者,第一次发布上线后)
|
||||
|
||||
- [ ] 5.1 为需要实名的运营商账户设置 `realname_control_enabled = 1`。
|
||||
- [ ] 5.2 生产执行演练并导出明细,运营确认"将被复机 / 将被停机"清单;需保持停机的卡先关闭轮询。
|
||||
- [ ] 5.3 维护者在生产开启 `JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED` 并重启全部进程;首日监控复机成功率与终态错误数,确认稳定运行。
|
||||
|
||||
## 第二次发布:转正(新规则在生产稳定运行后)
|
||||
|
||||
## 6. 删除总开关与旧口径
|
||||
|
||||
- [ ] 6.1 `stop_resume_unified.go` 并入主逻辑:删除 `unifiedStopResumeEnabled` 与各分支,`autoResumableStopReason` 恒为真,`autoControlSuspended`、`unifiedRealnameOK` 无条件生效。
|
||||
- [ ] 6.2 `stop_resume_service.go` 删除旧口径:`isRealnameOK` 行业卡与 `realname_policy` 分支、`isPollingStopReason` 限定、`ListByDeviceIDAndPollingStopReasons` 的调用。
|
||||
- [ ] 6.3 删除 `pkg/config/config.go`、`loader.go`、`defaults/config.yaml` 的总开关,`.gitea/workflows/deploy.yaml` 与 `docker-compose.prod.yml` 中的 `JUNHONG_STOP_RESUME_UNIFIED_RULE_ENABLED`。
|
||||
- [ ] 6.4 通道阈值新周期复机条件去掉开关分支,固定为新规则复机条件。
|
||||
|
||||
## 7. 实名轮询
|
||||
|
||||
- [ ] 7.1 `polling_realname_handler.go`:删除按行业卡跳过;卡所属账户未开实名管控时跳过查询并按正常间隔重入队;账户查询失败按可恢复失败处理。
|
||||
|
||||
## 8. 第二次发布的编译与验证
|
||||
|
||||
- [ ] 8.1 `gofmt -w`;`go build ./cmd/api ./cmd/worker` 通过;全仓检索无 `UnifiedRuleEnabled` 残留;`openspec validate` 与 `openspec doctor --json` 通过。
|
||||
- [ ] 8.2 测试环境:未开管控账户不查实名;开启管控账户的行业卡查实名并按未实名停机;通道阈值新周期解锁后按新规则复机或只解锁;停复机行为与第一次发布开启总开关后一致。
|
||||
Reference in New Issue
Block a user