feat(fulfillment): 新增直播账号履约工作台

This commit is contained in:
yml
2026-11-17 14:44:28 +08:00
parent f8a35ec224
commit 1ca768eba5
30 changed files with 3729 additions and 27 deletions
+1
View File
@@ -17,6 +17,7 @@
- [小X分身虎牙 CK 提取](虎牙/分身CK提取.md):ADB、WebView Cookie 与 cred0 解密提取流程。
- [精英宝典 HAR 提取](虎牙/HAR提取CK与积分中心.md):HAR 中的完整 CK、积分中心和商品结构。
- [皮肤准入映射分析](皮肤准入映射分析.md):快手皮肤订单到斗鱼商品的覆盖与映射边界。
- [直播账号履约工作台](直播账号履约工作台.md):order_site 人工订单、斗鱼账号租约、客户扫码绑定和人工兑换。
## 协议与逆向证据
+64
View File
@@ -0,0 +1,64 @@
# 直播账号履约工作台
更新时间:2026-11-17
## 目标
从 `order_site` 只读获取人工渠道待履约订单,由系统选择内部斗鱼账号,
客户扫码绑定游戏角色,运营人工完成精英宝典兑换。
首期边界:
- 只支持斗鱼精英宝典
- 每笔订单项固定 1 件
- 客户扫码绑定游戏角色
- 不做自动充值
- 不做自动兑换
- 不向 `order_site` 回写状态
- 退款、取消由运营人工处理
## 数据边界
- `order_site` 是订单、支付、退款和人工履约状态的真源。
- `live-hub` 只通过 `external_order_source.py` 读取订单数据库。
- `live-hub` 的履约作业记录在 `platform_fulfillment_tasks`。
- 内部 SKU 与斗鱼商品必须显式配置 `platform_commodity_mappings`。
- CK 始终保存在原有账号字段中,不进入履约任务接口。
## 操作流程
1. 在“直播账号履约工作台”点击“同步待履约订单”。
2. 为待映射商品选择斗鱼商品和积分价格。
3. 点击“自动选号”,系统按 CK、积分、开通状态、租约、365 天限兑和
换绑冷却筛选账号。
4. 点击“生成二维码”,让客户扫码绑定游戏角色。
5. 角色出现后点击“确认绑定”。
6. 点击“刷新兑换资格”,核对限兑、积分和精英宝典开通状态。
7. 运营在斗鱼侧人工完成兑换。
8. 回到工作台点击“完成”,系统释放账号租约并记录操作时间线。
## 环境
读取 `order_site` 需要:
```dotenv
ORDER_SITE_DATABASE_URL=postgresql://...
ORDER_SITE_LOOKUP_ENABLED=true
```
数据库账号必须是只读账号。跨库 SQL 只允许出现在
`web/backend/services/external_order_source.py`。
## 权限
- `platform_fulfillment:view`
- `platform_fulfillment:use`
- `platform_fulfillment:admin`
## 暂不实现
- `order_site` 状态回写接口
- 自动充值鱼翅
- 自动兑换
- 多数量拆分
- 电竞手册、和平小店、虎牙和微博