Files
junhong_cmp_fiber/openspec/changes/reliable-order-commission-dispatch/tasks.md
break 7e7f1cbb67
All checks were successful
构建并部署到测试环境(无 SSH) / build-and-deploy (push) Successful in 53s
更新
2026-08-13 16:09:38 +08:00

1.5 KiB

1. 可靠投递事件

  • 1.1 定义订单佣金计算 Outbox 事件、稳定业务键及消费者注册,并复用现有 Relay 投递 commission:calculate
  • 1.2 将各已支付订单路径的佣金请求改为在订单事实事务内写入唯一 Outbox 事件,移除事务后裸 Asynq 投递。
  • 1.3 保持任务载荷关联 ID 与现有佣金计算终态幂等语义,补齐中文结构化日志和审计关联。

2. 退款可靠后处理

  • 2.1 定义退款佣金回扣与资产后处理 Outbox 事件及消费者,在退款审批成功事务内原子写入并移除裸 goroutine。
  • 2.2 保持退款回扣流水、佣金记录失效、退款完成标记与资产后处理的既有幂等语义和审计关联。

3. 遗留事实补偿

  • 3.1 实现有界分页的待计算已支付订单扫描,为缺失或失败的投递事实幂等恢复事件。
  • 3.2 实现有界分页的已退款未完成后处理扫描,为佣金未回扣或资产未处理退款单幂等恢复事件。
  • 3.3 将补偿扫描接入 Worker 的既有启动/调度边界,输出订单和退款的已补发、无需补发及失败计数。

4. 验证与文档

  • 4.1 对订单事件写入、退款事件写入、Relay 重试、重复消费及两类历史补偿执行最小可复现验证,并保留 .lh-harness/ 外的必要命令证据。
  • 4.2 运行 gofmt、go build ./cmd/api ./cmd/workeropenspec validate --all./scripts/context-health.sh,记录结果。