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/handler/admin/asset.go

@@ -5,9 +5,11 @@ import (
 
 	"github.com/gofiber/fiber/v2"
 
+	dto "github.com/break/junhong_cmp_fiber/internal/model/dto"
 	assetService "github.com/break/junhong_cmp_fiber/internal/service/asset"
 	deviceService "github.com/break/junhong_cmp_fiber/internal/service/device"
 	iotCardService "github.com/break/junhong_cmp_fiber/internal/service/iot_card"
+	pollingSvc "github.com/break/junhong_cmp_fiber/internal/service/polling"
 	"github.com/break/junhong_cmp_fiber/pkg/constants"
 	"github.com/break/junhong_cmp_fiber/pkg/errors"
 	"github.com/break/junhong_cmp_fiber/pkg/middleware"
@@ -15,11 +17,12 @@ import (
 )
 
 // AssetHandler 资产管理处理器
-// 提供统一的资产解析、实时状态、套餐查询、停复机等接口
+// 提供统一的资产解析、实时状态、套餐查询、停复机、轮询管控等接口
 type AssetHandler struct {
 	assetService      *assetService.Service
 	deviceService     *deviceService.Service
 	iotCardStopResume *iotCardService.StopResumeService
+	assetPolling      *pollingSvc.AssetPollingService
 }
 
 // NewAssetHandler 创建资产管理处理器
@@ -27,11 +30,13 @@ func NewAssetHandler(
 	assetSvc *assetService.Service,
 	deviceSvc *deviceService.Service,
 	iotCardStopResume *iotCardService.StopResumeService,
+	assetPolling *pollingSvc.AssetPollingService,
 ) *AssetHandler {
 	return &AssetHandler{
 		assetService:      assetSvc,
 		deviceService:     deviceSvc,
 		iotCardStopResume: iotCardStopResume,
+		assetPolling:      assetPolling,
 	}
 }
 
@@ -187,3 +192,40 @@ func (h *AssetHandler) StartCard(c *fiber.Ctx) error {
 
 	return response.Success(c, nil)
 }
+
+// UpdatePollingStatus 更新资产轮询状态
+// PATCH /api/admin/assets/:asset_type/:id/polling-status
+func (h *AssetHandler) UpdatePollingStatus(c *fiber.Ctx) error {
+	assetType := c.Params("asset_type")
+	idStr := c.Params("id")
+
+	if assetType == "" || idStr == "" {
+		return errors.New(errors.CodeInvalidParam)
+	}
+
+	id, err := strconv.ParseUint(idStr, 10, 64)
+	if err != nil {
+		return errors.New(errors.CodeInvalidParam)
+	}
+
+	var req dto.UpdateAssetPollingStatusRequest
+	if err := c.BodyParser(&req); err != nil {
+		return errors.New(errors.CodeInvalidParam)
+	}
+
+	_ = middleware.GetUserIDFromContext(c.UserContext())
+
+	if h.assetPolling == nil {
+		return errors.New(errors.CodeInternalError, "轮询管控服务未配置")
+	}
+
+	if err := h.assetPolling.UpdatePollingStatus(c.UserContext(), assetType, uint(id), req.EnablePolling); err != nil {
+		return err
+	}
+
+	return response.Success(c, &dto.UpdateAssetPollingStatusResponse{
+		AssetType:     assetType,
+		AssetID:       uint(id),
+		EnablePolling: req.EnablePolling,
+	})
+}

internal/handler/admin/polling_manual_trigger.go

@@ -152,12 +152,12 @@ func (h *PollingManualTriggerHandler) GetStatus(c *fiber.Ctx) error {
 		items = append(items, h.toLogResp(log))
 	}
 
-	// 获取各队列大小
 	queueSizes := make(map[string]int64)
 	for _, taskType := range []string{
 		constants.TaskTypePollingRealname,
 		constants.TaskTypePollingCarddata,
 		constants.TaskTypePollingPackage,
+		constants.TaskTypePollingProtect,
 	} {
 		size, _ := h.service.GetQueueSize(ctx, taskType)
 		queueSizes[taskType] = size
@@ -271,6 +271,8 @@ func (h *PollingManualTriggerHandler) getTaskTypeName(taskType string) string {
 		return "流量检查"
 	case constants.TaskTypePollingPackage:
 		return "套餐检查"
+	case constants.TaskTypePollingProtect:
+		return "保护期检查"
 	default:
 		return taskType
 	}