merge(douyu): 合入客户领取与直播账号履约

- 合入斗鱼客户资料收集、角色绑定和半自动履约工作台
- 合入事务 Outbox、签名 Webhook 与低频对账链路
- 合入双角色识别、绑定重置、取消释放账号和已分配状态修复
- 将斗鱼履约数据库变更合并为单个 171 迁移文件
- 更新拆分后的客户样式测试入口并适配最新 main 客户页样式
This commit is contained in:
yml
2026-11-18 11:10:04 +08:00
67 changed files with 8854 additions and 3980 deletions
+79
View File
@@ -0,0 +1,79 @@
# 斗鱼客户领取与角色绑定
更新时间:2026-11-17
## 入口
客户领取链接固定为:
```text
<域名>/coll/d/<订单号>
```
例如:
```text
https://order.khhao.com/coll/d/COLLD-E2E-001
```
## 职责
- `order_site`:订单读取、客户资料、客户领取页、运营工作台和状态时间线。
- `live-hub`:内部斗鱼账号、CK、二维码生成、角色识别、绑定确认、积分和兑换。
- 客户不提交 CK,也不会看到内部账号、积分、租约或限兑信息。
## 客户流程
1. 打开 `/coll/d/<订单号>`。
2. 填写游戏角色名、微信/QQ、苹果/安卓。
3. `order_site` 通过服务端接口通知 live-hub 准备订单和内部账号。
4. live-hub 返回安全绑定状态和二维码。
5. 客户微信扫码选择和平精英角色。
6. 平台角色与客户资料一致后,客户确认绑定。
7. 绑定完成后等待运营在 live-hub 人工兑换。
斗鱼接口没有游戏 UID / 角色 ID。资料核对只使用角色名、平台和系统区服。
## 状态
```text
waiting_profile
preparing
qr_pending
role_ready
bound
waiting_operator
processing
completed
failed
manual_required
cancelled
```
最终绑定只认 `bindAct=1`。`bindRole=1, bindAct=0` 表示已识别角色但尚未最终确认。
## 环境变量
`order_site`:
```env
LIVE_HUB_PLATFORM_FULFILLMENT_URL=http://127.0.0.1:8800
PLATFORM_FULFILLMENT_INTEGRATION_KEY=<共享密钥>
```
`live-hub`:
```env
PLATFORM_FULFILLMENT_INTEGRATION_KEY=<共享密钥>
PLATFORM_FULFILLMENT_INTEGRATION_ACTOR_ID=
PLATFORM_BINDING_QR_TTL_SECONDS=600
```
集成操作人不填时,live-hub 使用最早创建的有效超级管理员。
## 数据边界
- `douyu_fulfillment_tasks` 只保存客户资料和 live-hub 安全状态投影。
- `live_session_id` 指向 live-hub 履约任务。
- 二维码原始 URL 由 live-hub 返回,不在 order_site 数据库长期保存。
- 内部账号、Cookie、积分和租约不得进入 order_site 客户接口。