feat(轮询优先队列): AUG26-016 卡轮询优先队列、人工入队与读侧接口，归档并同步主 Spec 与证据矩阵

新增 000228 成对迁移 tb_polling_priority_item：卡、任务类型、状态、触发类型、来源订单/套餐使用记录、
触发次数与来源集合、尝试次数、失败原因、人工原因与操作者、店铺快照与各时间列；以活动项部分唯一索引
uq_polling_priority_item_active（仅 deleted_at IS NULL AND status IN ('pending','processing') 占键位）
表达「同卡同任务类型至多一条活动项」，另有状态/时间索引与全列注释；down 守卫在存在活动项或未终态行时
拒绝回滚并给出中文原因。

新增优先轮询请求可靠事件 polling.priority.requested（载荷版本 v1、事件键前缀 prio:）与消费者：只在原
业务事务内追加、幂等键稳定；消费者按卡 × 纳入任务类型（realname/carddata/card_status/package）逐条
建项并在提交后下发执行提示，重复投递只合并触发次数、来源集合与最近触发时间，不新建行也不重复调用。
触发点为四类自动场景 purchase_activated / renewal_activated（按同载体更早套餐使用记录判定）/
queue_activated / addon_activated 与「无有效套餐」no_valid_package（仅在普通套餐轮询来源且存在待生效
套餐使用记录时追加；事件通道显式拒绝 manual_trigger）；入队对象恒为卡，绑定设备资产在触发事务内冻结
在用卡快照逐卡建项，不使用设备当前卡槽口径。

轮询共享基类新增认领接缝：四个 Handler（realname/carddata/card_status/package）在并发信号量之后、调用
上游之前探测活动项——待执行条件认领、执行中且 90 秒租约未到期则跳过并延后、无活动项时行为与既有完全
等价；超租约允许相邻执行接管，尝试次数只在真正发起执行后累加，未达上限（3）回到活动态按既有间隔重排，
达上限或业务校验类失败进入失败终态并保留可安全展示原因；执行前校验卡自身与绑定设备的轮询开关。未引入
通用卡级锁与 Redis 活动标记，分片队列的出队、入队与移除路径未改动。

提示通道按任务类型独立键（polling:priority:{taskType}），与既有手动触发队列分离；调度器在同一周期内先
排空优先提示、再排空手动触发队列，提示排空不受分片背压跳过影响；未新建调度设施或异步任务类型。

新增人工优先入队与只读查询三条路由 POST /api/admin/polling-priority-items、
GET /api/admin/polling-priority-items、GET /api/admin/polling-priority-items/:id：人工入队复用既有轮询
权限判定（抽取为同包共享函数），原因必填，不受每日 500 次上限与 24 小时去重约束，重复抑制由活动项合并
承担；读侧按店铺快照下推数据范围，越权与不存在不可区分，不提供优先级分级、有效期或人工重触发入口。
新增 7 个审计动作（enqueue/claim/fail/retry/complete/dequeue/manual_denied）与资源
polling_priority_item，并按（操作者类型，来源）注册，人工侧与 Worker 侧均通过来源校验。

同步 OpenAPI 文档装配三处与路由注册；归档 Change 至
openspec/changes/archive/2026-09-17-add-priority-polling-queue/ 并同步主 Spec（新增
priority-polling-queue、polling-operations 追加单次执行互斥 Requirement 与三条路由索引）与上下文健康
证据（requirement-evidence 150 行、入口矩阵 http 403 / async 56）。

本机验证：junhong_cmp_test 与隔离 Redis DB 15，未连生产、未启动 Worker/API、未调用运营商上游；迁移
up/down/up 与 down 守卫实测（含 dirty=true 记账口径与 force 恢复），A–F 批 94 PASS、接缝 63 PASS、
提示通道 12 PASS、清理零残留 20 PASS。成功路径 Complete、真并发互斥、尝试上限第 3 次判定、HTTP 层权限
矩阵、通道阈值持锁复机边界与三类生效触发点生产集成留待测试部署验证（见
docs/verification/add-priority-polling-queue-verification.md 第 4 节）。自动化测试按项目决策为 N/A，
未新增 *_test.go。

internal/polling/lifecycle_service.go

@@ -48,7 +48,7 @@ func (s *PollingLifecycleService) OnCardCreated(ctx context.Context, card *model
 	if card == nil {
 		return
 	}
-	if !s.shouldEnqueue(ctx, card) {
+	if !s.ShouldEnqueue(ctx, card) {
 		s.logger.Debug("卡禁用轮询，跳过入队", zap.Uint("card_id", card.ID))
 		return
 	}
@@ -75,7 +75,7 @@ func (s *PollingLifecycleService) OnCardStatusChanged(ctx context.Context, cardI
 		s.logger.Error("卡状态变化：加载卡信息失败", zap.Uint("card_id", cardID), zap.Error(err))
 		return
 	}
-	if !s.shouldEnqueue(ctx, card) {
+	if !s.ShouldEnqueue(ctx, card) {
 		return
 	}
 	s.enqueueCard(ctx, card)
@@ -98,7 +98,7 @@ func (s *PollingLifecycleService) OnBatchCardsStatusChanged(ctx context.Context,
 		return
 	}
 	for _, card := range cards {
-		if !s.shouldEnqueue(ctx, card) {
+		if !s.ShouldEnqueue(ctx, card) {
 			continue
 		}
 		s.enqueueCard(ctx, card)
@@ -120,7 +120,7 @@ func (s *PollingLifecycleService) OnCardEnabled(ctx context.Context, cardID uint
 		s.logger.Error("卡启用：加载卡信息失败", zap.Uint("card_id", cardID), zap.Error(err))
 		return
 	}
-	if !s.shouldEnqueue(ctx, card) {
+	if !s.ShouldEnqueue(ctx, card) {
 		return
 	}
 	s.enqueueCard(ctx, card)
@@ -134,10 +134,10 @@ func (s *PollingLifecycleService) OnCardDisabled(ctx context.Context, cardID uin
 	s.queueMgr.InvalidateCardCache(ctx, cardID)
 }
 
-// shouldEnqueue M3 修复：检查卡或其绑定设备是否允许轮询
+// ShouldEnqueue M3 修复：检查卡或其绑定设备是否允许轮询（同时被轮询优先项的执行前范围校验复用）
 // 两层检查：先查卡级 enable_polling，再查设备级 enable_polling（IsStandalone=false 时）
 // 直接查 device.enable_polling，不依赖级联同步正确性，防止同步失败时生命周期事件绕过设备级禁用
-func (s *PollingLifecycleService) shouldEnqueue(ctx context.Context, card *model.IotCard) bool {
+func (s *PollingLifecycleService) ShouldEnqueue(ctx context.Context, card *model.IotCard) bool {
 	if !card.EnablePolling {
 		return false
 	}

internal/polling/queue_manager.go

@@ -153,6 +153,14 @@ func (m *PollingQueueManager) EnqueueManual(ctx context.Context, cardID uint, ta
 	return m.redis.RPush(ctx, key, fmt.Sprintf("%d", cardID)).Err()
 }
 
+// EnqueuePriority 优先轮询提示下发（List RPUSH，与手动触发队列分离）。
+// 使用 RPUSH 与调度器的 LPopCount 组成先进先出；提示通道不是权威，丢失或缓存服务重启时
+// 库内活动优先项仍在，后续普通轮询执行按条件认领仍会执行，只退化为延迟一个普通轮询周期。
+func (m *PollingQueueManager) EnqueuePriority(ctx context.Context, cardID uint, taskType string) error {
+	key := constants.RedisPollingPriorityQueueKey(taskType)
+	return m.redis.RPush(ctx, key, fmt.Sprintf("%d", cardID)).Err()
+}
+
 // OnCardDeleted 卡删除事件处理（移除所有队列 + 清理卡信息缓存）
 func (m *PollingQueueManager) OnCardDeleted(ctx context.Context, cardID uint) error {
 	// 从所有分片队列移除

internal/polling/scheduler.go

@@ -156,7 +156,12 @@ func (s *Scheduler) scheduleLoop(ctx context.Context) {
 // processShardSchedule 处理手动队列和分片定时队列（每 1 秒触发）
 // 使用 90% 的 tick 间隔作为超时，确保单分片 Redis 挂起时不阻塞下一个 tick
 func (s *Scheduler) processShardSchedule(ctx context.Context) {
-	// 手动队列不受 Init 影响（ConfigManager 已就绪即可）
+	// 优先提示与手动队列都不受 Init 影响（ConfigManager 已就绪即可）。
+	// 同一调度周期内先排空优先提示、再排空手动触发队列：优先的强度边界仅为调度入口领先，
+	// 提示排空不参与分片背压判断，因此分片积压不会抑制加急入队。
+	for _, taskType := range allTaskTypes {
+		s.processPriorityQueue(ctx, taskType, s.cfg.MaxManualBatchSize)
+	}
 	for _, taskType := range allTaskTypes {
 		s.processManualQueue(ctx, taskType, s.cfg.MaxManualBatchSize)
 	}
@@ -243,7 +248,16 @@ func (s *Scheduler) processActivationTasks(ctx context.Context) {
 
 // processManualQueue 处理手动触发队列
 func (s *Scheduler) processManualQueue(ctx context.Context, taskType string, maxBatch int) {
-	key := constants.RedisPollingManualQueueKey(taskType)
+	s.drainPollingQueue(ctx, constants.RedisPollingManualQueueKey(taskType), taskType, maxBatch)
+}
+
+// processPriorityQueue 处理优先轮询提示通道：与手动触发队列分离，且不参与分片背压判断。
+func (s *Scheduler) processPriorityQueue(ctx context.Context, taskType string, maxBatch int) {
+	s.drainPollingQueue(ctx, constants.RedisPollingPriorityQueueKey(taskType), taskType, maxBatch)
+}
+
+// drainPollingQueue 从指定提示通道批量取出卡，并复用既有批量提交逻辑提交到同一 Asynq 任务类型与队列。
+func (s *Scheduler) drainPollingQueue(ctx context.Context, key, taskType string, maxBatch int) {
 	cardIDs, err := s.redis.LPopCount(ctx, key, maxBatch).Result()
 	if err != nil || len(cardIDs) == 0 {
 		return