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/task/polling_base.go

@@ -0,0 +1,118 @@
+package task
+
+import (
+	"context"
+	"time"
+
+	"github.com/redis/go-redis/v9"
+	"go.uber.org/zap"
+
+	"github.com/break/junhong_cmp_fiber/internal/polling"
+	"github.com/break/junhong_cmp_fiber/internal/store/postgres"
+	"github.com/break/junhong_cmp_fiber/pkg/constants"
+)
+
+// acquireConcurrencyScript 原子获取并发信号量的 Lua 脚本
+// INCR + EXPIRE 合并为单个服务端操作，消除二者之间的崩溃窗口：
+// 若 Worker 在 INCR 后、EXPIRE 前崩溃，key 将永久留在 Redis 导致计数器卡死。
+// KEYS[1]: 当前并发计数 key
+// ARGV[1]: 最大并发数；ARGV[2]: key TTL（秒）
+// 返回 -1 表示超额拒绝，>0 表示成功获取后的计数值
+var acquireConcurrencyScript = redis.NewScript(`
+    local current = redis.call('INCR', KEYS[1])
+    if tonumber(current) > tonumber(ARGV[1]) then
+        redis.call('DECR', KEYS[1])
+        return -1
+    end
+    redis.call('EXPIRE', KEYS[1], tonumber(ARGV[2]))
+    return current
+`)
+
+// PollingBase 轮询共享基类
+// 封装并发控制、卡缓存、重入队、配置间隔查询等公共方法，4 个 Handler 共享
+type PollingBase struct {
+	redis        *redis.Client
+	queueMgr     *polling.PollingQueueManager
+	configMgr    *polling.PollingConfigManager
+	iotCardStore *postgres.IotCardStore
+	logger       *zap.Logger
+}
+
+// NewPollingBase 创建轮询共享基类
+func NewPollingBase(
+	redisClient *redis.Client,
+	queueMgr *polling.PollingQueueManager,
+	configMgr *polling.PollingConfigManager,
+	iotCardStore *postgres.IotCardStore,
+	logger *zap.Logger,
+) *PollingBase {
+	return &PollingBase{
+		redis:        redisClient,
+		queueMgr:     queueMgr,
+		configMgr:    configMgr,
+		iotCardStore: iotCardStore,
+		logger:       logger,
+	}
+}
+
+// acquireConcurrency 原子获取并发信号量
+// 使用 Lua 脚本将 INCR 与 EXPIRE 合并为单个服务端操作，消除非原子窗口：
+// 旧实现中若 Worker 在 INCR 后、EXPIRE 前崩溃，key 永久留在 Redis，计数器卡死。
+func (b *PollingBase) acquireConcurrency(ctx context.Context, taskType string) bool {
+	shortType := shortTaskType(taskType)
+	configKey := constants.RedisPollingConcurrencyConfigKey(shortType)
+	currentKey := constants.RedisPollingConcurrencyCurrentKey(taskType)
+
+	maxConcurrency, err := b.redis.Get(ctx, configKey).Int()
+	if err != nil {
+		maxConcurrency = constants.PollingDefaultMaxConcurrency
+	}
+
+	result, err := acquireConcurrencyScript.Run(
+		ctx, b.redis, []string{currentKey},
+		maxConcurrency, constants.PollingConcurrencyKeyTTL,
+	).Int64()
+	if err != nil {
+		b.logger.Warn("获取并发计数失败，放行任务", zap.Error(err))
+		return true
+	}
+
+	return result != -1
+}
+
+// releaseConcurrency 释放并发信号量
+func (b *PollingBase) releaseConcurrency(ctx context.Context, taskType string) {
+	currentKey := constants.RedisPollingConcurrencyCurrentKey(taskType)
+	if err := b.redis.Decr(ctx, currentKey).Err(); err != nil {
+		b.logger.Warn("释放并发计数失败", zap.Error(err))
+	}
+}
+
+// requeueCard 将卡按匹配配置间隔重新入队分片 Sorted Set
+// ⚠️ 关键：Lua 脚本原子出队后卡已从队列移除，若并发满时直接 return 会导致卡永久丢失
+// 调用方必须在 acquireConcurrency 返回 false 时调用此方法入队后再返回
+func (b *PollingBase) requeueCard(ctx context.Context, cardID uint, taskType string) error {
+	card, err := b.getCardWithCache(ctx, cardID)
+	if err != nil {
+		b.logger.Warn("重入队：获取卡信息失败", zap.Uint("card_id", cardID), zap.Error(err))
+		// 获取卡失败时立即重入队（下次仍然尝试处理）
+		return b.queueMgr.Requeue(ctx, cardID, taskType, time.Now().Add(30*time.Second))
+	}
+
+	cfg := b.configMgr.MatchConfig(card)
+	if cfg == nil {
+		// 兜底：配置未加载（DB 暂时不可达）时延迟 30 秒重入队，防止卡从轮询永久消失
+		b.logger.Warn("无匹配轮询配置，30秒后重入队（配置可能未加载）",
+			zap.Uint("card_id", cardID), zap.String("task_type", taskType))
+		return b.queueMgr.Requeue(ctx, cardID, taskType, time.Now().Add(30*time.Second))
+	}
+
+	interval := getIntervalByTaskType(cfg, taskType)
+	if interval <= 0 {
+		b.logger.Debug("轮询间隔为 NULL，不入队", zap.Uint("card_id", cardID), zap.String("task_type", taskType))
+		return nil
+	}
+
+	nextCheckAt := time.Now().Add(time.Duration(interval) * time.Second)
+	return b.queueMgr.Requeue(ctx, cardID, taskType, nextCheckAt)
+}