feat(轮询优先队列): AUG26-016 卡轮询优先队列、人工入队与读侧接口，归档并同步主 Spec 与证据矩阵
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 14m13s
All checks were successful
构建并部署到测试环境（无 SSH） / build-and-deploy (push) Successful in 14m13s
新增 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。
This commit is contained in:
@@ -4192,5 +4192,311 @@
|
||||
"验证口径：停复机执行的运营商回执以本机 stub 端点驱动，真实运营商成功回执路径未端到端验证"
|
||||
]
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "优先轮询触发场景与入队事实",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"/api/admin/polling-priority-items",
|
||||
"constants.OutboxEventTypePollingPriorityRequested"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/service/package/priority.go:AppendActivatedPriorityRequested / AppendNoValidPackagePriorityRequested",
|
||||
"internal/infrastructure/prioritypolling/event.go:PriorityEventWriter.AppendPriorityRequested",
|
||||
"internal/infrastructure/prioritypolling/event.go:PriorityRequestedConsumer.Consume"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/service/order/service.go:AppendActivatedPriorityRequested(...)（主套餐购买生效分支）",
|
||||
"internal/service/package/activation_service.go:AppendActivatedPriorityRequested(...)（排队顺延生效）",
|
||||
"internal/task/auto_purchase.go:AppendActivatedPriorityRequested(...)",
|
||||
"internal/service/iot_card/stop_resume_service.go:AppendNoValidPackagePriorityRequested(...)"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"pkg/constants/polling.go:PollingPriorityTriggerPurchaseActivated/RenewalActivated/QueueActivated/AddonActivated/NoValidPackage/Manual",
|
||||
"internal/model/polling.go:PollingPriorityItem.TriggerType/TriggerTypes/TriggerCount"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"migrations/000228_add_polling_priority_queue.up.sql",
|
||||
"internal/store/postgres/polling_priority_item_store.go:InsertOrMerge"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"pkg/constants/polling.go\", \"PollingPriorityTriggerPurchaseActivated = \\\"purchase_activated\\\"\"), (\"pkg/constants/polling.go\", \"PollingPriorityTriggerRenewalActivated = \\\"renewal_activated\\\"\"), (\"pkg/constants/polling.go\", \"PollingPriorityTriggerQueueActivated = \\\"queue_activated\\\"\"), (\"pkg/constants/polling.go\", \"PollingPriorityTriggerAddonActivated = \\\"addon_activated\\\"\"), (\"pkg/constants/polling.go\", \"PollingPriorityTriggerNoValidPackage = \\\"no_valid_package\\\"\"), (\"pkg/constants/polling.go\", \"PollingPriorityTriggerManual = \\\"manual_trigger\\\"\"), (\"internal/service/package/priority.go\", \"func ResolveActivationTriggerType(\"), (\"internal/service/package/priority.go\", \"func HasEarlierPackageUsage(\"), (\"internal/service/order/service.go\", \"AppendActivatedPriorityRequested(ctx, tx, s.priorityEvents\"), (\"internal/service/package/activation_service.go\", \"AppendActivatedPriorityRequested(ctx, tx, s.priorityEvents\"), (\"internal/task/auto_purchase.go\", \"packagepkg.AppendActivatedPriorityRequested(\"), (\"internal/service/iot_card/stop_resume_service.go\", \"packagepkg.AppendNoValidPackagePriorityRequested(\"), (\"internal/infrastructure/prioritypolling/event.go\", \"func (w *PriorityEventWriter) AppendPriorityRequested(\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::优先轮询触发场景与入队事实\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::优先轮询触发场景与入队事实"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "入队执行对象为资产当前在用卡",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"constants.OutboxEventTypePollingPriorityRequested"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/infrastructure/prioritypolling/event.go:PriorityRequestedConsumer.Consume（逐卡 × 逐任务类型建项）"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/service/package/priority.go:filterPackageUsageByCarrier（载体口径与卡的既有有效套餐判定一致）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"internal/application/prioritypolling/event.go:PriorityRequestedEvent.ResourceIDs（触发事务内冻结的绑定卡快照）",
|
||||
"internal/model/polling.go:PollingPriorityItem.CardID/ShopIDSnapshot"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"migrations/000228_add_polling_priority_queue.up.sql:tb_polling_priority_item.card_id 列注释「执行对象恒为卡，多卡资产逐卡建项」"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"internal/application/prioritypolling/event.go\", \"ResourceIDs\"), (\"internal/infrastructure/prioritypolling/event.go\", \"cardIDs = event.ResourceIDs\"), (\"internal/infrastructure/prioritypolling/event.go\", \"taskTypes := constants.PollingPriorityTaskTypes()\"), (\"pkg/constants/polling.go\", \"func PollingPriorityTaskTypes()\"), (\"internal/infrastructure/prioritypolling/event.go\", \"loadCardShopSnapshots\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) ListActiveByCards(\"), (\"internal/infrastructure/prioritypolling/event.go\", \"!CurrentSlotNo\"), (\"internal/application/prioritypolling/event.go\", \"!CurrentSlotNo\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::入队执行对象为资产当前在用卡\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::入队执行对象为资产当前在用卡"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "同卡同任务类型的唯一活动项与合并",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"constants.OutboxEventTypePollingPriorityRequested"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/infrastructure/prioritypolling/event.go:PriorityRequestedConsumer.Consume（重复投递只合并，不新建行）"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/service/polling/priority_enqueue_service.go:Enqueue（人工侧同一 InsertOrMerge 语义）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"internal/model/polling.go:PollingPriorityItem.Status/TriggerTypes/TriggerCount/LastTriggeredAt"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"migrations/000228_add_polling_priority_queue.up.sql:CREATE UNIQUE INDEX uq_polling_priority_item_active ... WHERE deleted_at IS NULL AND status IN ('pending','processing')",
|
||||
"internal/store/postgres/polling_priority_item_store.go:InsertOrMerge/mergeActive/isPollingPriorityActiveConflict"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"migrations/000228_add_polling_priority_queue.up.sql\", \"CREATE UNIQUE INDEX uq_polling_priority_item_active\"), (\"migrations/000228_add_polling_priority_queue.up.sql\", \"活动项唯一键必须是「部分唯一索引」\"), (\"migrations/000228_add_polling_priority_queue.up.sql\", \"WHERE deleted_at IS NULL AND status IN (\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) InsertOrMerge(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) mergeActive(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"pgErr.ConstraintName == pollingPriorityActiveConstraint\"), (\"internal/infrastructure/prioritypolling/event.go\", \"created, insertErr := store.InsertOrMerge(ctx, item)\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::同卡同任务类型的唯一活动项与合并\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::同卡同任务类型的唯一活动项与合并"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "优先调度与执行提示通道",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"constants.TaskTypePollingRealname",
|
||||
"constants.TaskTypePollingCarddata",
|
||||
"constants.TaskTypePollingCardStatus",
|
||||
"constants.TaskTypePollingPackage"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/polling/queue_manager.go:PollingQueueManager.EnqueuePriority",
|
||||
"cmd/worker/main.go:registerPriorityPollingOutboxConsumer"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/application/prioritypolling/event.go:PromptPublisher.EnqueuePriority（提示不是权威，失败只退化为延迟一个周期）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"pkg/constants/redis.go:RedisPollingPriorityQueueKey（每任务类型独立键，不复用手动触发队列键）"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"internal/polling/scheduler.go:Scheduler.processPriorityQueue（同一调度周期先排空优先提示、再排空手动触发队列，且不参与分片背压判断）"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"internal/polling/queue_manager.go\", \"func (m *PollingQueueManager) EnqueuePriority(\"), (\"pkg/constants/redis.go\", \"func RedisPollingPriorityQueueKey(taskType string) string\"), (\"internal/polling/scheduler.go\", \"func (s *Scheduler) processShardSchedule(ctx context.Context)\"), (\"internal/polling/scheduler.go\", \"func (s *Scheduler) processPriorityQueue(\"), (\"internal/polling/scheduler.go\", \"s.processPriorityQueue(ctx, taskType, s.cfg.MaxManualBatchSize)\"), (\"internal/application/prioritypolling/event.go\", \"type PromptPublisher interface\"), (\"cmd/worker/main.go\", \"registerPriorityPollingOutboxConsumer\"), (\"pkg/constants/polling.go\", \"!TaskTypePollingPriority\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::优先调度与执行提示通道\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::优先调度与执行提示通道"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "优先项认领、租约与执行前校验",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"constants.TaskTypePollingRealname",
|
||||
"constants.TaskTypePollingCarddata",
|
||||
"constants.TaskTypePollingCardStatus",
|
||||
"constants.TaskTypePollingPackage"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/task/polling_priority_claim.go:PollingBase.beginPollingPriority（接缝入口）",
|
||||
"internal/task/polling_realname_handler.go / polling_carddata_handler.go / polling_cardstatus_handler.go / polling_package_handler.go:Handle 调用 beginPollingPriority"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/task/polling_priority_claim.go:pollingPriorityRound + priorityInPollingScope（执行前校验卡自身与绑定设备的轮询开关）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"internal/model/polling.go:PollingPriorityItem.Status/ClaimedAt",
|
||||
"pkg/constants/polling.go:PollingPriorityClaimLease = 90"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"internal/store/postgres/polling_priority_item_store.go:ClaimPending/TakeOverExpiredClaim"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"pkg/constants/polling.go\", \"const PollingPriorityClaimLease = 90\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) ClaimPending(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) TakeOverExpiredClaim(\"), (\"internal/task/polling_priority_claim.go\", \"func (b *PollingBase) beginPollingPriority(\"), (\"internal/task/polling_priority_claim.go\", \"func (b *PollingBase) priorityInPollingScope(\"), (\"internal/task/polling_realname_handler.go\", \"h.base.beginPollingPriority(ctx, cardID, constants.TaskTypePollingRealname)\"), (\"internal/task/polling_carddata_handler.go\", \"h.base.beginPollingPriority(ctx, cardID, constants.TaskTypePollingCarddata)\"), (\"internal/task/polling_cardstatus_handler.go\", \"h.base.beginPollingPriority(ctx, cardID, constants.TaskTypePollingCardStatus)\"), (\"internal/task/polling_package_handler.go\", \"h.base.beginPollingPriority(ctx, cardID, constants.TaskTypePollingPackage)\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::优先项认领、租约与执行前校验\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::优先项认领、租约与执行前校验"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "优先项尝试次数与出队",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"constants.TaskTypePollingRealname",
|
||||
"constants.TaskTypePollingCarddata",
|
||||
"constants.TaskTypePollingCardStatus",
|
||||
"constants.TaskTypePollingPackage"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/task/polling_priority_claim.go:pollingPriorityRound.MarkExecution/FailRetryable/FailFinal/Complete"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/task/polling_priority_claim.go:pollingPriorityRound.FailRetryable（与 PollingPriorityMaxAttempts 比较后决定回活动态或失败出队）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"internal/model/polling.go:PollingPriorityItem.AttemptCount/FailureReason/Status/Result",
|
||||
"pkg/constants/polling.go:PollingPriorityMaxAttempts = 3"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"internal/store/postgres/polling_priority_item_store.go:IncrementAttempt/ReturnToPending/MarkFailed/MarkCompleted"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"pkg/constants/polling.go\", \"const PollingPriorityMaxAttempts = 3\"), (\"internal/task/polling_priority_claim.go\", \"if r.attempts < constants.PollingPriorityMaxAttempts {\"), (\"internal/task/polling_priority_claim.go\", \"func (r *pollingPriorityRound) FailRetryable(\"), (\"internal/task/polling_priority_claim.go\", \"func (r *pollingPriorityRound) FailFinal(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) IncrementAttempt(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) ReturnToPending(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) MarkFailed(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) MarkCompleted(\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::优先项尝试次数与出队\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::优先项尝试次数与出队"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "优先轮询事实与查询的可追溯",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"/api/admin/polling-priority-items",
|
||||
"/api/admin/polling-priority-items/{id}"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/handler/admin/polling_priority.go:PriorityPollingHandler.Enqueue/ListPriorityItems/GetPriorityItem",
|
||||
"internal/routes/polling_priority.go:registerPollingPriorityRoutes"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/query/prioritypolling/query.go:Query.List/Detail + priorityPollingShopScope（数据权限下推）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"pkg/constants/audit.go:AuditActionPollingPriority{Enqueued,Claimed,Failed,Retried,Completed,Dequeued,ManualDenied}",
|
||||
"pkg/constants/audit.go:AuditResourcePollingPriorityItem"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"internal/store/postgres/polling_priority_item_store.go:List/GetByIDScoped/applyPollingPriorityShopScope"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"pkg/constants/audit.go\", \"AuditActionPollingPriorityEnqueued = \\\"polling_priority.enqueue\\\"\"), (\"pkg/constants/audit.go\", \"AuditActionPollingPriorityClaimed = \\\"polling_priority.claim\\\"\"), (\"pkg/constants/audit.go\", \"AuditActionPollingPriorityFailed = \\\"polling_priority.fail\\\"\"), (\"pkg/constants/audit.go\", \"AuditActionPollingPriorityRetried = \\\"polling_priority.retry\\\"\"), (\"pkg/constants/audit.go\", \"AuditActionPollingPriorityCompleted = \\\"polling_priority.complete\\\"\"), (\"pkg/constants/audit.go\", \"AuditActionPollingPriorityDequeued = \\\"polling_priority.dequeue\\\"\"), (\"pkg/constants/audit.go\", \"AuditActionPollingPriorityManualDenied = \\\"polling_priority.manual_denied\\\"\"), (\"internal/query/prioritypolling/query.go\", \"func (q *Query) List(ctx context.Context, req dto.PriorityPollingItemListRequest)\"), (\"internal/query/prioritypolling/query.go\", \"func (q *Query) Detail(ctx context.Context, id uint)\"), (\"internal/query/prioritypolling/query.go\", \"func priorityPollingShopScope(ctx context.Context)\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) GetByIDScoped(\"), (\"internal/handler/admin/polling_priority.go\", \"func (h *PriorityPollingHandler) Enqueue(c *fiber.Ctx) error\"), (\"internal/handler/admin/polling_priority.go\", \"func (h *PriorityPollingHandler) ListPriorityItems(c *fiber.Ctx) error\"), (\"internal/handler/admin/polling_priority.go\", \"func (h *PriorityPollingHandler) GetPriorityItem(c *fiber.Ctx) error\"), (\"internal/routes/polling_priority.go\", \"router.Group(\\\"/polling-priority-items\\\")\"), (\"internal/model/dto/polling_priority_dto.go\", \"!PriorityLevel\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::优先轮询事实与查询的可追溯\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::优先轮询事实与查询的可追溯"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "人工优先入队不受人工触发防滥用配额约束",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"/api/admin/polling-priority-items"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/handler/admin/polling_priority.go:PriorityPollingHandler.Enqueue"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/service/polling/priority_enqueue_service.go:PriorityEnqueueService.Enqueue",
|
||||
"internal/service/polling/permission.go:canManagePollingCard（与既有人工触发共用同一权限判定）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"internal/model/polling.go:PollingPriorityItem.ManualReason/ManualOperatorID/ManualOperatorName",
|
||||
"pkg/constants/polling.go:PollingPriorityManualReasonMaxLength = 500"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"migrations/000228_add_polling_priority_queue.up.sql:manual_reason 列注释「人工入队必填，与事实一同保存」"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"internal/service/polling/priority_enqueue_service.go\", \"func (s *PriorityEnqueueService) Enqueue(\"), (\"internal/service/polling/priority_enqueue_service.go\", \"constants.PollingPriorityTriggerManual\"), (\"internal/service/polling/priority_enqueue_service.go\", \"人工优先入队原因不能为空\"), (\"internal/service/polling/priority_enqueue_service.go\", \"!已达到每日触发次数上限\"), (\"internal/service/polling/priority_enqueue_service.go\", \"!RedisPollingManualDedupeKey\"), (\"internal/service/polling/priority_enqueue_service.go\", \"canManagePollingCard(ctx, s.iotCardStore, cardID)\"), (\"internal/service/polling/priority_enqueue_service.go\", \"AuditActionPollingPriorityEnqueued\"), (\"internal/service/polling/permission.go\", \"func canManagePollingCard(\"), (\"internal/service/polling/manual_trigger_service.go\", \"已达到每日触发次数上限\"), (\"internal/service/polling/manual_trigger_service.go\", \"RedisPollingManualDedupeKey\"), (\"pkg/constants/polling.go\", \"const PollingPriorityManualReasonMaxLength = 500\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::人工优先入队不受人工触发防滥用配额约束\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::人工优先入队不受人工触发防滥用配额约束"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "priority-polling-queue",
|
||||
"requirement": "与运营商通道阈值停机的边界",
|
||||
"spec": "openspec/specs/priority-polling-queue/spec.md",
|
||||
"entries": [
|
||||
"constants.TaskTypePollingRealname",
|
||||
"constants.TaskTypePollingCarddata",
|
||||
"constants.TaskTypePollingCardStatus",
|
||||
"constants.TaskTypePollingPackage"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/task/polling_priority_claim.go:PollingBase.priorityInPollingScope（优先轮次仍走既有轮询范围校验）"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/service/iot_card/channel_threshold.go:StopResumeService.channelThresholdBlocked（持锁拒绝复机，优先执行不绕过）",
|
||||
"internal/service/iot_card/stop_resume_service.go:5 处自动/手动/强制复机入口调用 channelThresholdBlocked"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"internal/service/iot_card/stop_resume_service.go:ChannelThresholdLockGuard（可选的通道阈值持锁判定能力）"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"internal/service/iot_card/channel_threshold.go:recordChannelThresholdDenial（保留既有持锁拒绝事实）"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"internal/service/iot_card/channel_threshold.go\", \"func (s *StopResumeService) channelThresholdBlocked(ctx context.Context, card *model.IotCard) (bool, error)\"), (\"internal/service/iot_card/channel_threshold.go\", \"func (s *StopResumeService) recordChannelThresholdDenial(ctx context.Context, card *model.IotCard, actionCode, summary string)\"), (\"internal/service/iot_card/channel_threshold.go\", \"func channelThresholdDenyError() error\"), (\"internal/service/iot_card/stop_resume_service.go\", \"blocked, err := s.channelThresholdBlocked(ctx, card)\"), (\"internal/service/iot_card/stop_resume_service.go\", \"channelThresholdDenyError()\"), (\"internal/task/polling_priority_claim.go\", \"func (b *PollingBase) priorityInPollingScope(\"), (\"internal/task/polling_priority_claim.go\", \"!channelThreshold\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: priority-polling-queue::与运营商通道阈值停机的边界\")'",
|
||||
"literal_output": [
|
||||
"OK: priority-polling-queue::与运营商通道阈值停机的边界"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
},
|
||||
{
|
||||
"capability": "polling-operations",
|
||||
"requirement": "优先轮询项与普通轮询的单次执行互斥",
|
||||
"spec": "openspec/specs/polling-operations/spec.md",
|
||||
"entries": [
|
||||
"constants.TaskTypePollingRealname",
|
||||
"constants.TaskTypePollingCarddata",
|
||||
"constants.TaskTypePollingCardStatus",
|
||||
"constants.TaskTypePollingPackage"
|
||||
],
|
||||
"handler_consumer_job": [
|
||||
"internal/task/polling_priority_claim.go:PollingBase.beginPollingPriority（无活动项返回跳过标志 false，行为完全等价既有路径）",
|
||||
"四个轮询 Handler：beginPollingPriority 返回 skip 时按既有间隔延后，不发起上游调用"
|
||||
],
|
||||
"application_service_query": [
|
||||
"internal/task/polling_priority_claim.go:newPriorityRound（认领成功即作为本轮执行完成，不产生第二次调用）"
|
||||
],
|
||||
"domain_state_amount": [
|
||||
"pkg/constants/polling.go:PollingPriorityStatusPending/Processing（活动集合）"
|
||||
],
|
||||
"store_migration_config": [
|
||||
"internal/store/postgres/polling_priority_item_store.go:FindActive/ClaimPending/TakeOverExpiredClaim"
|
||||
],
|
||||
"verification": {
|
||||
"command": "python3 -c 'from pathlib import Path; checks=[(\"internal/task/polling_priority_claim.go\", \"if b == nil || b.priorityStore == nil\"), (\"internal/task/polling_priority_claim.go\", \"case constants.PollingPriorityStatusPending:\"), (\"internal/task/polling_priority_claim.go\", \"case constants.PollingPriorityStatusProcessing:\"), (\"internal/task/polling_priority_claim.go\", \"now.Before(item.ClaimedAt.Add(time.Duration(constants.PollingPriorityClaimLease)*time.Second))\"), (\"internal/task/polling_priority_claim.go\", \"func (b *PollingBase) newPriorityRound(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) FindActive(\"), (\"internal/store/postgres/polling_priority_item_store.go\", \"func (s *PollingPriorityItemStore) ClaimPending(\")]; miss=[p+\" :: \"+t for p,t in checks if ((t[1:] if t.startswith(\"!\") else t) in Path(p).read_text()) != (not t.startswith(\"!\"))]; print(\"MISSING: \"+\" | \".join(miss)) if miss else print(\"OK: polling-operations::优先轮询项与普通轮询的单次执行互斥\")'",
|
||||
"literal_output": [
|
||||
"OK: polling-operations::优先轮询项与普通轮询的单次执行互斥"
|
||||
],
|
||||
"exit_status": 0
|
||||
}
|
||||
}
|
||||
]
|
||||
]
|
||||
|
||||
Reference in New Issue
Block a user