All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 9m33s
- 新增网关限流:按本系统运营商账户(卡 carrier_id)→ 限流组 → 操作限制每秒请求数,每次 HTTP 尝试计量,默认限流、仅后台人工点击/通道阈值/自动续费/手动刷新豁免;支持只统计与拦截两种模式,默认只统计 - Asynq 遇限流不计失败、固定短延迟重试;轮询任务与停复机业务重试遇限流短延迟重排 - 停机、复机不再使用网关内部重试,只发一次请求 - 网关返回结构化错误;新增上游错误分类规则表与测试接口 - 新增按月分区的停复机记录表:系统自动停复机只写记录,不再写统一审计与集成日志;普通轮询查询不再写集成日志 - 新增限流组、错误分类、停复机记录、按账户调用统计与枚举后台接口 - 迁移 000243~000246;同步 OpenSpec 提案(含后续 6 个 change)与技术方案、工程约束
4.2 KiB
4.2 KiB
0. 前置确认
- 0.1 确认
rebuild-card-traffic-metering-and-stop-resume已完成并归档,日快照计量已在生产开启并核对结算结果;确认第 1 个 Change 已上线。
1. 迁移与模型
- 1.1 新增成对迁移:
tb_polling_config增加package_state、asset_status、pre_reset_window、pre_reset_carddata_interval(均可空);down 删列。 - 1.2
model.PollingConfig增加字段;修正间隔字段注释为"正数按间隔、0 不检查、空继承"。
2. 配置合并与分层匹配
- 2.1
config_manager.go:配置加载按priority, id排序;MergedTaskIntervals采用第一个非空取值,0表示不检查。 - 2.2 新增套餐状态与资产状态匹配;
package_usage_store增加按资产查询套餐状态(单个与批量),设备卡按设备计算。 - 2.3
initializer.go(批量)、lifecycle_service.go、执行收尾重入队处传入套餐状态与资产状态。 - 2.4 已销售无套餐、在库卡未匹配任何配置时告警且不入队。
3. 重置日前加密
- 3.1 统一"计算下次到期"函数:窗口内间隔、越过重置时刻改为"重置时刻 − 收尾提前量"、窗口前截断到窗口起点、越过后恢复正常;初始化、收尾、生命周期共用。
- 3.2 收尾提前量写入系统参数。
4. 配置接口
- 4.1
/polling-configsDTO 增加 4 个字段,间隔校验改为"0 或不小于最小间隔",说明文字按三态;保存校验无套餐已销售与在库层卡状态必须为正数;优先级重复且条件可能重叠时返回提示。 - 4.2
PUT /polling-configs/priorities:事务内整体重排,写统一审计,发配置变更通知。 - 4.3
GET /polling-configs/match-preview?iccid=(可带config_overrides):返回维度取值、命中配置、每类最终间隔与来源;只读。 - 4.4
POST /polling-configs/recalculate-due(可选运营商账户)与GET /polling-configs/recalculate-due/:task_id:异步分批,只提前不推后,不调网关。 - 4.5
GET /polling-stats/tiers、GET /polling-stats/pre-reset。 - 4.6 同步路由、
cmd/api/docs.go、cmd/gendocs/main.go并重新生成接口文档。
5. 流量按观测时间归属
- 5.1 观测携带
observed_at;traffic_flow.go判断可扣套餐时只认activated_at ≤ observed_at的生效主套餐,否则只记已结算。
6. 激活前结算与统一激活锁
- 6.1 实名激活与订单购买即生效补上
RedisPackageActivationLockKey;各入口锁 TTL 调整为大于结算总超时 + 事务耗时;抢锁失败沿用现有冲突处理。 - 6.2 锁内、激活事务前:判断资产当前无生效主套餐且卡已切换日快照计量时执行结算(独立卡一次、设备逐张),使用限流等待模式;单步超时与总超时为系统参数。
- 6.3 结算观测带"激活前结算"标记,入账后不触发停复机评估。
- 6.4 结算失败、超时或被跳过的卡写告警(卡、资产、错误);不阻塞激活。
7. 编译与规范校验
- 7.1
gofmt -w;go build ./cmd/api ./cmd/worker通过。 - 7.2
openspec validate add-tiered-polling-and-pre-activation-settlement与openspec doctor --json通过。
8. 测试环境验证(自动化测试为 N/A,按 ENG-TEST-001)
- 8.1 现有配置在升级后各卡最终间隔不变(用匹配预览抽查)。
- 8.2 间隔
0停止继承、空值继承、相同优先级按 ID 稳定。 - 8.3 无套餐已销售、在库层卡状态为空或 0 时保存被拒;未匹配告警出现。
- 8.4 整体排序后匹配结果按新顺序;重算到期时间只提前不推后。
- 8.5 重置日前窗口:最后一次查询落在"重置时刻 − 收尾提前量",越过后恢复正常间隔。
- 8.6 二次销售卡购买即生效:先结算再激活,新套餐不承担上一用户本月用量;结算不产生停机。
- 8.7 构造结算慢返回且另一入口先激活:激活前用量只记已结算。
- 8.8 实名激活与订单购买并发:串行执行,无重复结算;结算超时照常激活并告警。