优化(直播履约): 即时选号并收敛订单快照同步

This commit is contained in:
yml
2026-11-18 16:58:08 +08:00
parent b7b09c90bd
commit dc95d83b32
13 changed files with 933 additions and 70 deletions
+14 -6
View File
@@ -1,10 +1,10 @@
# 直播账号履约工作台
更新时间:2026-11-17
更新时间:2026-11-18
## 目标
从 `order_site` 只读获取人工渠道待履约订单,由系统选择内部斗鱼账号,
消费 `order_site` 事务 Outbox 推送的人工渠道订单项快照,由系统选择内部斗鱼账号,
客户扫码绑定游戏角色,运营人工完成精英宝典兑换。
首期边界:
@@ -20,7 +20,8 @@
## 数据边界
- `order_site` 是订单、支付、退款和人工履约状态的真源。
- `live-hub` 只通过 `external_order_source.py` 读取订单数据库。
- 正常建单只消费 `platform_fulfillment.order_snapshot` 事件;只读订单数据库仅用于
旧版事件按明确订单项 ID 定向兼容和人工显式补查。
- `live-hub` 的履约作业记录在 `platform_fulfillment_tasks`。
- 内部 SKU 与斗鱼商品必须显式配置 `platform_commodity_mappings`。
- CK 始终保存在原有账号字段中,不进入履约任务接口。
@@ -67,7 +68,7 @@
## 操作流程
1. 在“直播账号履约工作台”点击“同步待履约订单”。
1. 新订单由 `order_site` 事务 Outbox 自动进入;人工“同步待履约订单”只用于历史补查。
2. 为待映射商品选择斗鱼商品和积分价格。
3. 点击“自动选号”,系统实时检查 CK、租约、365 天限兑和换绑冷却;
积分与精英宝典开通状态只影响账号排序和后续处理提示。
@@ -88,7 +89,7 @@
## 环境
读取 `order_site` 需要:
旧版定向兼容或人工补查 `order_site` 时才需要:
```dotenv
ORDER_SITE_DATABASE_URL=postgresql://...
@@ -108,7 +109,14 @@ ORDER_SITE_LOOKUP_ENABLED=true
`X-Integration-Timestamp`、`X-Integration-Signature`;
- 签名值为 `sha256=HMAC-SHA256(timestamp + "." + rawBody)`;
- 接收方通过 `integration_inbox.event_id` 幂等,失败时整笔事务回滚;
- 15 分钟低频对账只作为 dead/漏单兜底,不再由列表请求或人工刷新承担主同步。
- `order_site → live-hub` 的订单事件携带订单项快照、稳定去重指纹和 `contractVersion=2`;
正常路径不回查待履约表,不存在“最近 500 条”正确性窗口;
- 旧版事件没有快照时只按明确订单项 ID 定向读取,不得退化为全表窗口;
- live-hub 新任务写入 `next_allocate_at=NOW()` 并主动唤醒选号 worker;首次选号不再等待
固定 45 秒,失败后才设置下一次重试时间;
- 回传 `order_site` 的快照携带单调 `stateVersion`,接收方拒绝旧版本覆盖;
- 15 分钟低频对账按任务 ID 游标分批补齐状态 Outbox,只作为 dead/漏单兜底;
批次限制吞吐,不形成永久扫描窗口。
`order_site` 客户页通过服务端接口调用 live-hub,不允许客户浏览器直接访问
live-hub 管理 API。同步客户会话接口位于: