fix(douyu): 修正绑定刷新与自动启动交互

This commit is contained in:
yml
2026-11-20 22:03:20 +08:00
parent 0982993a6d
commit 38155ca1c3
7 changed files with 128 additions and 38 deletions
+16 -2
View File
@@ -1,6 +1,6 @@
# 斗鱼客户领取与角色绑定
更新时间:2026-11-17
更新时间:2026-11-20
## 入口
@@ -27,7 +27,8 @@ https://order.khhao.com/coll/d/COLLD-E2E-001
1. 打开 `/coll/d/<订单号>`。
2. 填写游戏角色名、微信/QQ、苹果/安卓。
3. `order_site` 通过服务端接口通知 live-hub 准备订单和内部账号。
4. live-hub 返回安全绑定状态和二维码。
4. 分配完成后 live-hub 自动启动二维码任务;客户页通过 SSE 重读权威快照,
不在“准备中”重复调用开始绑定。
5. 客户微信扫码选择和平精英角色。
6. 平台角色与客户资料一致后,客户确认绑定。
7. 绑定完成后等待运营在 live-hub 人工兑换。
@@ -52,6 +53,19 @@ cancelled
最终绑定只认 `bindAct=1`。`bindRole=1, bindAct=0` 表示已识别角色但尚未最终确认。
绑定启动是幂等异步接口:新建排队返回 `202`,已有有效二维码或已完成返回 `200`;
`mapping_missing`、尚未分配账号和租约失效都是正常业务状态,不通过重复 409
驱动客户端重试。
客户页上的两个刷新动作含义固定:
- “刷新状态”只读取/同步绑定快照,不启动绑定;
- “刷新二维码”先读取最新状态,未过期直接复用,只有过期或失败才请求新二维码。
二维码生成完成后,live-hub 释放执行 Worker,扫码等待由数据库定时调度;
角色识别和绑定确认写入事务 Outbox,经签名 Webhook 到 order_site 后通过 SSE
通知客户页重读。15 分钟对账只作为漏事件兜底,不是正常状态更新路径。
## 环境变量
`order_site`: