All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m33s
- 新增网关限流:按本系统运营商账户(卡 carrier_id)→ 限流组 → 操作限制每秒请求数,每次 HTTP 尝试计量,默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免;支持只统计与拦截两种模式,默认只统计 - Asynq 遇限流不计失败、固定短延迟重试;轮询任务与停复机业务重试遇限流短延迟重排 - 停机、复机不再使用网关内部重试,只发一次请求 - 网关返回结构化错误;新增上游错误分类规则表与测试接口 - 新增按月分区的停复机记录表:系统自动停复机只写记录,不再写统一审计与集成日志;普通轮询查询不再写集成日志 - 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口 - 迁移 000243~000246;同步 OpenSpec 提案(含后续 6 个 change)与技术方案、工程约束
3.5 KiB
3.5 KiB
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:88ShouldStopPollingForRisk要求isStandalone;生产 8,420 张风险停机或已销户卡均为独立卡且已关闭轮询。- 停复机调用返回终态时只按失败处理,不关闭轮询。
Goals / Non-Goals
Goals: 停复机只有一套口径;实名轮询与实名管控口径一致;风险停机与已销户无论如何发现都关闭轮询;开启前可预演影响。
Non-Goals: 不改停复机触发路径与执行方式(第 6 个 Change);不改暂停轮询的套餐失效停机与自动恢复轮询(第 6、7 个 Change);不改激活状态计算口径。
Decisions
- 先演练开启、再删除开关:保留开关会长期双口径,但演练必须早于开启;故第一次发布只加演练与补齐、不改口径,开启并稳定后第二次发布删除开关。
- 复机含
carrier_stopped:用户已定"只看本系统规则"。上游终态卡由关闭轮询兜底,不进入自动复机;未识别的终态由错误分类在复机失败时识别并关闭轮询。 - 关闭轮询只作用于卡自身:设备下其他卡仍可能正常使用;
autoControlSuspended按卡判断,该卡不再参与自动停复机,设备维度判断对其余卡照常。 - 终态关闭轮询由规则标记驱动:在错误分类表加
auto_disable_polling,而不是在代码里写死关键字,符合"数值与分组由配置决定"。关闭时同事务回写gateway_extend,并写不轮询清单(第 7 个 Change 上线后;之前只改enable_polling并写审计)。 - 演练用读侧 Query:复用统一判断函数,输入卡与资产当前数据和可选的假设实名管控配置,输出目标状态;按批读取、只读,不经聚合根写状态。明细导出复用统一导出任务。
Risks / Trade-offs
- [开启实名管控后行业卡被停] → 已知口径变化;演练可按假设配置预演,运营按结果决定是否开启。
- [演练全量扫描较慢] → 按账户分批、只读;导出走异步任务。
- [删除开关后无法快速回到旧口径] → 前置要求新规则已在生产稳定运行;必要时代码回退。
Migration Plan
演练必须在新规则开启之前可用,因此分两次发布:
- 第一次发布:迁移(错误分类表加列)、演练接口、风险停机与已销户关闭轮询补齐;总开关仍关闭,停复机行为不变。演练始终按新规则判断,不受总开关影响。
- 运营:设置需要实名的账户;生产执行演练并导出核对;需保持停机的卡关闭轮询。维护者开启总开关并重启全部进程,首日监控。
- 第二次发布(新规则稳定后):删除总开关、旧口径与部署环境变量,实名轮询改按账户实名管控跳过。
- 回退:第一次发布后可直接关闭总开关回到旧口径;第二次发布后需代码回退。