huang
8b5cd50576
Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent) Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>
3.4 KiB
3.4 KiB
Why
停复机与套餐生命周期引擎存在多处系统性缺陷：停机时 stop_reason 字段写入不一致导致自动复机链路断裂；已耗尽（Depleted）套餐在到期时无法触发下一个排队套餐激活；流量重置后停机卡不自动复机；设备类型载体完全缺失复机逻辑；ResumeCardIfStopped 未检查实名状态。这些问题直接影响用户续费后无法正常上网的核心业务场景。
What Changes
- 停机原因标准化：
stopCards（套餐超额停机）补写stop_reason=traffic_exhausted+stopped_at，与其他停机路径对齐 - 购买套餐后自动复机：
order/service.go支付回调激活套餐后，调用复机回调 - Depleted 套餐到期处理：
findExpiredMainPackages扩展为同时查status IN (1,2)，使已耗尽套餐在到期日触发下一个 Pending 套餐激活与复机 - 流量重置后自动复机：
reset_service注入复机回调，重置后对满足条件的卡自动复机 - 设备类型复机覆盖：
ResumeCardIfStopped扩展签名支持carrierType，设备类型时遍历绑定的已实名卡逐一复机 - 未实名不自动复机：
ResumeCardIfStopped内部统一检查real_name_status，未实名卡静默跳过 - 并发保护：
ResumeCardIfStopped加 Redis 分布式锁，防止同一张卡并发触发多次gateway.StartCard - 告警日志：Gateway 成功但 DB 更新失败时记录 ERROR 日志便于人工排查
- 常量化：
HandleProtectConsistencyCheck停机原因提取为constants.StopReasonProtectPeriod常量
Capabilities
New Capabilities
auto-resume-on-purchase：购买套餐（支付回调激活）后触发停机卡自动复机的能力auto-resume-on-reset：流量周期重置（日/月/年）后触发停机卡自动复机的能力
Modified Capabilities
auto-stop-resume：扩展复机前置条件（未实名不复机）、添加设备类型支持、添加并发保护package-queue-activation：扩展过期套餐检测逻辑，将 Depleted 套餐纳入到期检测范围
Impact
修改文件：
internal/task/polling_handler.go：stopCards补写stop_reason+stopped_at；HandleProtectConsistencyCheck使用StopReasonProtectPeriod常量internal/service/package/activation_service.go：更新ResumeCallback接口签名（增加carrierType参数）；两处调用点更新传参internal/service/iot_card/stop_resume_service.go：ResumeCardIfStopped扩展支持carrierType；内部加未实名检查；加 Redis 分布式锁；设备类型时遍历复机绑定卡internal/service/order/service.go：注入ResumeCallback；HandlePaymentCallback事务后调用复机internal/service/package/reset_service.go：注入ResumeCallback；三个重置方法结束后异步调用复机internal/polling/package_activation_handler.go：findExpiredMainPackages查询改为status IN (1,2)pkg/constants/iot.go：新增StopReasonProtectPeriod常量pkg/constants/redis.go：新增RedisCardResumeLockKey(cardID)Key 生成函数internal/bootstrap/worker_services.go：为orderService、resetService注入stopResumeService
不在本次范围：
enterprise_device/service.go：SuspendCard/ResumeCard 缺失 Gateway 调用（单独立 Issue 跟踪）- Gateway + DB 双阶段补偿机制（后期迭代）