Files
junhong_cmp_fiber/openspec/changes/remove-device-protect-period/tasks.md
邹进 42e881576d
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m33s
feat: 卡网关按运营商账户限流并记录停复机调用
- 新增网关限流:按本系统运营商账户(卡 carrier_id)→ 限流组 → 操作限制每秒请求数,每次 HTTP 尝试计量,默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免;支持只统计与拦截两种模式,默认只统计
- Asynq 遇限流不计失败、固定短延迟重试;轮询任务与停复机业务重试遇限流短延迟重排
- 停机、复机不再使用网关内部重试,只发一次请求
- 网关返回结构化错误;新增上游错误分类规则表与测试接口
- 新增按月分区的停复机记录表:系统自动停复机只写记录,不再写统一审计与集成日志;普通轮询查询不再写集成日志
- 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口
- 迁移 000243~000246;同步 OpenSpec 提案(含后续 6 个 change)与技术方案、工程约束
2026-10-24 15:06:41 +09:00

2.1 KiB
Raw Blame History

1. 迁移

  • 1.1 新增成对迁移:更新 tb_polling_config.protect_check_interval、tb_iot_card.last_protect_check_at 列注释为"已废弃";down 恢复原注释。

2. 设备与单卡停复机

  • 2.1 internal/service/device/service.go:设备停机、复机不再设置保护期,不再因保护期拒绝相反操作。
  • 2.2 internal/service/iot_card/stop_resume_service.go:手动停复机单卡(第 969、1036 行附近)去掉保护期检查。
  • 2.3 删除 RedisDeviceProtectKey、DeviceProtectPeriodDuration;保留 StopReasonProtectPeriod 并在注释说明不再产生新值。

3. 下线保护期轮询

  • 3.1 删除 internal/task/polling_protect_handler.go;pkg/queue/handler.go 对 polling:protect 改为空处理函数直接成功(下一次发布再移除)。
  • 3.2 调度器、初始化器、生命周期、监控与统计去掉 protect 类型;删除 ProtectCheckSkipsForRealname。
  • 3.3 轮询并发配置与任务类型名称去掉 protect,提交 protect 时拒绝。
  • 3.4 PollingConfig 模型与 DTO 去掉 ProtectCheckInterval;config_manager.go 匹配去掉保护期;IotCard 模型去掉 LastProtectCheckAt 的读写。

4. 资产接口兼容

  • 4.1 后台与 C 端资产详情的 device_protect_status 固定返回 none,DTO 说明标记已废弃;internal/service/asset/service.go 不再读取保护期 key。
  • 4.2 重新生成接口文档。

5. 编译与规范校验

  • 5.1 gofmt -w;go build ./cmd/api ./cmd/worker 通过;全仓检索无残留的保护期 key 读写。
  • 5.2 openspec validate remove-device-protect-period 与 openspec doctor --json 通过。

6. 测试环境验证(自动化测试为 N/A,按 ENG-TEST-001)

  • 6.1 设备停机后立即复机成功,不被保护期拒绝;单卡手动停复机同样。
  • 6.2 不再产生 polling:protect 任务与 protect_period 停机原因;历史 protect_period 记录正常展示。
  • 6.3 资产详情 device_protect_status 恒为 none;轮询配置接口不含保护期间隔;并发配置不含 protect。