## Scope - 迭代编号:`AUG26-016`。 ## Why 紧急卡状态查询与普通轮询竞争,无法保证处理顺序或追踪加急事实。 ## What Changes - 新增受限管理的卡轮询优先队列:以持久化事实记录触发来源、次数、最近时间与执行结果;同一卡同一轮询任务类型至多一条活动优先项。 - 触发来源:主套餐购买后立即生效、排队主套餐顺延生效、加油包生效、资产无有效套餐且存在待生效套餐使用记录、具备既有人工触发权限的账号人工入队。 - Worker 复用既有轮询任务类型与既有轮询内容优先领取执行;同一卡同一任务类型只允许一次上游调用,优先项不以任何方式使卡退出普通轮询。 - 复用既有手动队列式的执行提示通道(独立提示键,调度周期内先排空),不新建调度设施、异步任务类型或队列。 - 新增最小可读接口(列表与详情,支持筛选与分页),权限与人工入队一致并按数据范围下推。 ## 非目标 - 不做优先级分级(P0/P1/P2)与优先级规则配置。 - 不做有效期字段与过期出队语义。 - 不做独立异常记录页、人工重触发入口,以及资产/卡详情的优先轮询状态展示。 - 不新增可维护的参数配置项;不改普通轮询内容、并发上限、失败重试与外部调用保护。 - 不做普通轮询异常补偿场景(现状无判据,登记为后续独立 Change)。 - 不改人工触发 API 的任务类型白名单、每日次数上限与 24 小时去重规则。 ## Capabilities ### New Capabilities - `priority-polling-queue`: 卡轮询加急队列:触发场景与入队事实、同卡同任务类型唯一活动项与合并、优先调度与执行提示通道、认领与租约、尝试上限与出队、事实与查询的可追溯。 ### Modified Capabilities - `polling-operations`: 新增「优先轮询项与普通轮询的单次执行互斥」行为要求;既有人工触发的任务类型白名单、每日次数上限与 24 小时去重保持不变。 ## Impact - 路由与文档装配:新增后台路由与 Handler,并同步文档工厂、API 组装与文档生成入口三处装配。 - Worker:新增可靠事件消费者注册;调度器新增优先提示排空。 - 轮询执行:纳入执行集合的轮询任务类型增加认领接缝(无活动项时行为与当前完全一致)。 - 触发写入:订单与套餐生效事务新增优先请求事件追加(同事务写入,提交后投递)。 - Schema:新增成对迁移与优先项表(含活动项部分唯一索引)。 - 常量与审计:新增触发类型、状态与尝试上限常量,以及轮询优先队列的审计动作与资源常量。