feat: 轮询系统重构（分片队列 + 停复机统一 + Handler 拆分）

【核心变更】

1. 停复机逻辑统一（StopResumeService）
   - 新增 EvaluateAndAct 统一入口，封装三条件停复机判断
   - 停机条件：无套餐(no_package) / 流量耗尽(traffic_exhausted) / 未实名(not_realname)
   - 复机条件：stop_reason 合规 + 有套餐且未耗尽 + 已实名或行业卡
   - 修复设备套餐 Bug：hasValidPackage 按 device_id 查套餐，而非仅 iot_card_id
   - 设备维度停复机加幂等锁（Redis SetNX，TTL 30s），防止多卡并发重复调 Gateway

2. Redis 分片队列（PollingQueueManager）
   - 新建 queue_manager.go，封装所有轮询 Redis 操作
   - 16 分片 Sorted Set，Key 格式：polling:shard:{shardID}:queue:{taskType}
   - Lua 脚本原子出队（ZRANGEBYSCORE + 分批 ZREM），消除竞态窗口
   - 新增背压检测：队列深度超 50 万时 Scheduler 跳过该分片
   - RemoveFromAllQueues 覆盖 4 种任务类型（含 protect）

3. Handler 拆分（polling_handler.go 1360行 → 5个专注文件）
   - polling_base.go：共享基类（并发控制/卡缓存/重入队）
   - polling_realname_handler.go：实名采集，实名 0→1 时立即触发复机
   - polling_carddata_handler.go：流量采集，保留跨月边界检测逻辑
   - polling_package_handler.go：套餐采集，委托 EvaluateAndAct 决策
   - polling_protect_handler.go：保护期一致性检查，保护期内强制修正

4. 配置管理（PollingConfigManager）
   - 新建 config_manager.go，从 scheduler.go 提取配置职责
   - 内存缓存 + 5 分钟定时刷新，刷新失败保留原缓存
   - 修复 getCardCondition：停机卡返回 suspended，不再错配 activated 配置

5. 渐进式初始化（CardInitializer）
   - 新建 initializer.go，分批加载（每批 10 万），批次间 sleep 500ms
   - 过滤 enable_polling=false 的卡，初始化完成前 Scheduler 不出队

6. 卡生命周期服务（PollingLifecycleService）
   - 新建 lifecycle_service.go，替代已删除的 callbacks.go 和 api_callback.go
   - OnCardCreated/OnCardEnabled/OnCardStatusChanged 入队前检查 enable_polling

7. Scheduler 精简（1000+行 → 227行）
   - 保留纯调度循环：scheduleLoop + processShardSchedule + enqueueBatch
   - 保留每 10 秒触发套餐过期检测和流量重置
   - 移除所有 DB 操作、配置加载、卡初始化逻辑

8. 轮询管控 API（enable_polling）
   - 新增 PUT /api/admin/assets/:id/polling-status 接口
   - 支持对设备/卡维度开关轮询，关闭后从所有分片队列移除

9. 数据库迁移
   - 000103：tb_device 新增 enable_polling 字段（boolean, NOT NULL, DEFAULT true）
   - 000104：新增 suspended 轮询配置，为 activated 配置补全 protect_check_interval

【文件统计】
- 新增：19 个文件（handler × 5、polling 组件 × 4、迁移 × 3 等）
- 修改：20 个文件（bootstrap 注入、store 接口、monitoring 适配分片等）
- 删除：3 个文件（polling_handler.go、callbacks.go、api_callback.go）

Ultraworked with [Sisyphus](https://github.com/code-yeongyu/oh-my-openagent)

Co-authored-by: Sisyphus <clio-agent@sisyphuslabs.ai>

internal/polling/package_activation_handler.go

@@ -113,8 +113,11 @@ func (h *PackageActivationHandler) findExpiredMainPackages(ctx context.Context)
 }
 
 // processExpiredPackage 处理单个过期套餐
+// triggerStopAfterExpiry 在事务提交后才调用，避免 goroutine 在 TX 提交前读到脏数据
 func (h *PackageActivationHandler) processExpiredPackage(ctx context.Context, pkg *model.PackageUsage) error {
-	return h.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
+	carrierType, carrierID := h.getCarrierInfo(pkg)
+
+	err := h.db.WithContext(ctx).Transaction(func(tx *gorm.DB) error {
 		// 任务 19.3: 更新过期主套餐状态为 Expired (status=3)
 		if err := tx.Model(pkg).Update("status", constants.PackageUsageStatusExpired).Error; err != nil {
 			return err
@@ -129,11 +132,9 @@ func (h *PackageActivationHandler) processExpiredPackage(ctx context.Context, pk
 			h.logger.Warn("加油包级联失效失败",
 				zap.Uint("master_usage_id", pkg.ID),
 				zap.Error(err))
-			// 不返回错误，继续处理
 		}
 
 		// 任务 19.5: 查询并激活下一个待生效主套餐
-		carrierType, carrierID := h.getCarrierInfo(pkg)
 		if carrierType != "" && carrierID > 0 {
 			if err := h.activateNextPackage(ctx, tx, carrierType, carrierID); err != nil {
 				h.logger.Warn("激活下一个待生效套餐失败",
@@ -148,13 +149,21 @@ func (h *PackageActivationHandler) processExpiredPackage(ctx context.Context, pk
 					zap.Uint("carrier_id", carrierID),
 					zap.Error(err))
 			}
-
-			// 套餐过期后主动触发停机，消除依赖 carddata 轮询兜底的 60s 延迟窗口
-			h.triggerStopAfterExpiry(ctx, carrierType, carrierID)
 		}
 
 		return nil
 	})
+
+	if err != nil {
+		return err
+	}
+
+	// 事务提交后再触发异步停机，确保 CheckAndStopCard 读到最新的套餐状态
+	if carrierType != "" && carrierID > 0 {
+		h.triggerStopAfterExpiry(ctx, carrierType, carrierID)
+	}
+
+	return nil
 }
 
 // invalidateAddons 任务 19.4: 加油包级联失效
@@ -439,67 +448,43 @@ func (h *PackageActivationHandler) HandlePackageQueueActivation(ctx context.Cont
 }
 
 // HandlePackageFirstActivation 处理首次实名激活任务（Asynq Handler）
-// 任务 22: 由 Asynq 调用，执行首次实名后的套餐激活
+// 由 polling_realname_handler 在检测到首次实名时触发。
+// payload 中仅需 carrier_type + carrier_id，ActivateByRealname 内部自行查找
+// pending_realname_activation=true 的套餐，无需外部指定 PackageUsageID。
 func (h *PackageActivationHandler) HandlePackageFirstActivation(ctx context.Context, t *asynq.Task) error {
 	var payload PackageActivationPayload
 	if err := sonic.Unmarshal(t.Payload(), &payload); err != nil {
 		h.logger.Error("解析首次实名激活任务载荷失败", zap.Error(err))
-		return nil // 不重试
+		return nil
+	}
+
+	if payload.CarrierType == "" || payload.CarrierID == 0 {
+		h.logger.Error("首次实名激活任务 carrier 信息缺失",
+			zap.String("carrier_type", payload.CarrierType),
+			zap.Uint("carrier_id", payload.CarrierID))
+		return nil
 	}
 
 	h.logger.Info("开始执行首次实名激活",
-		zap.Uint("package_usage_id", payload.PackageUsageID),
 		zap.String("carrier_type", payload.CarrierType),
 		zap.Uint("carrier_id", payload.CarrierID))
 
-	// 任务 22.4: 幂等性检查
-	var pkg model.PackageUsage
-	if err := h.db.First(&pkg, payload.PackageUsageID).Error; err != nil {
-		if err == gorm.ErrRecordNotFound {
-			h.logger.Warn("套餐使用记录不存在", zap.Uint("package_usage_id", payload.PackageUsageID))
-			return nil
-		}
+	if h.activationService == nil {
+		h.logger.Warn("ActivationService 未注入，跳过首次实名激活")
+		return nil
+	}
+
+	if err := h.activationService.ActivateByRealname(ctx, payload.CarrierType, payload.CarrierID); err != nil {
+		h.logger.Error("首次实名激活失败",
+			zap.String("carrier_type", payload.CarrierType),
+			zap.Uint("carrier_id", payload.CarrierID),
+			zap.Error(err))
 		return err
 	}
 
-	// 检查 pending_realname_activation 是否已为 false（已处理过）
-	if !pkg.PendingRealnameActivation {
-		h.logger.Info("套餐已处理过首次实名激活，跳过",
-			zap.Uint("package_usage_id", payload.PackageUsageID))
-		return nil
-	}
-
-	// 如果已经是生效状态，跳过
-	if pkg.Status == constants.PackageUsageStatusActive {
-		h.logger.Info("套餐已激活，跳过",
-			zap.Uint("package_usage_id", payload.PackageUsageID))
-		return nil
-	}
-
-	// 任务 22.3: 调用 ActivationService.ActivateByRealname 激活套餐
-	if h.activationService != nil {
-		if err := h.activationService.ActivateByRealname(ctx, payload.CarrierType, payload.CarrierID); err != nil {
-			h.logger.Error("首次实名激活失败",
-				zap.Uint("package_usage_id", payload.PackageUsageID),
-				zap.String("carrier_type", payload.CarrierType),
-				zap.Uint("carrier_id", payload.CarrierID),
-				zap.Error(err))
-			return err
-		}
-	} else {
-		// ActivationService 未注入，直接更新状态（备用逻辑）
-		now := time.Now()
-		if err := h.db.Model(&pkg).Updates(map[string]any{
-			"status":                      constants.PackageUsageStatusActive,
-			"activated_at":                now,
-			"pending_realname_activation": false,
-		}).Error; err != nil {
-			return err
-		}
-	}
-
 	h.logger.Info("首次实名激活成功",
-		zap.Uint("package_usage_id", payload.PackageUsageID))
+		zap.String("carrier_type", payload.CarrierType),
+		zap.Uint("carrier_id", payload.CarrierID))
 
 	return nil
 }