perf(douyu): 拆分任务槽并改造绑定扫码调度

This commit is contained in:
yml
2026-11-20 22:03:20 +08:00
parent 8869e427d2
commit 071d45ad1d
40 changed files with 1635 additions and 245 deletions
+39 -2
View File
@@ -1,6 +1,6 @@
# 直播账号履约工作台
更新时间:2026-11-18
更新时间:2026-11-20
## 目标
@@ -14,7 +14,7 @@
- 客户扫码绑定游戏角色
- 不做自动充值
- 不做自动兑换
- 不向 `order_site` 回写状态
- 状态变化通过事务 Outbox 回写 `order_site`
- 退款、取消由运营人工处理
## 数据边界
@@ -167,6 +167,43 @@ live-hub 管理 API。同步客户会话接口位于:
`PLATFORM_BINDING_QR_TTL_SECONDS` 调整。过期、失败或客户主动刷新时会在
live-hub 创建新的绑定任务。
## 后台任务槽与扫码轮询
后台任务按业务域使用独立有界任务槽,不再共用一个全局执行器:
- `interactive_binding`:绑定预检、二维码生成和确认提交;
- `binding_poll`:每次只执行一次扫码角色查询;
- `login`、`account_check`:登录、检测与重登;
- `automation`:定时自动化作业;
- `query_batch`:账号概览、商品和角色查询;
- `payment_wait`:二维码生成后的支付/到账等待;
- `ops_write`:兑换、支付、锁单和送礼;
- `huya_batch`、`huya_register`、`integration`、`maintenance`:各自独立。
批次只负责向对应任务槽投递和收集结果,不能在批次内部再创建一个 Worker 池。
新增任务类型必须显式映射到任务域;任务槽和后台数据库池状态可在自动化页面的
运行时信息中查看。
扫码绑定拆成两个阶段:
1. 二维码任务只做预检和出码,出码后写入 `queue_lane=binding_poll`、
`next_run_at` 和 `run_deadline_at`,立即释放 Worker;
2. `binding-poll-scheduler` 从数据库领取到期任务,每次只查询一次角色,
查到待确认角色或到期后收敛状态。
`douyu_tasks.active_binding_key` 在数据库层保证同一履约任务最多只有一个
活动二维码任务。进程重启后,未到期的扫码任务继续由数据库调度,不会因内存
批次丢失而终止。
客户绑定接口是幂等异步契约:
- 新建排队返回 `202`,已存在有效二维码或已完成返回 `200`;
- `mapping_missing`、尚未分配账号、租约失效都返回当前业务快照,不使用 409
驱动客户端重复提交;
- 绑定任务创建时写入 `platform_task_id`,二维码就绪、角色识别和确认完成都会
在状态事务内写 Outbox,由 order_site Webhook 和 SSE 推动页面重读;
- “刷新状态”不启动绑定,“刷新二维码”先读取权威状态,有效期内直接复用。
## 权限
- `platform_fulfillment:view`