feat(douyu): 新增客户领取与角色绑定工作台
This commit is contained in:
@@ -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 客户接口。
|
||||
Reference in New Issue
Block a user