perf(douyu): 拆分任务槽并改造绑定扫码调度
This commit is contained in:
+39
-2
@@ -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`
|
||||
|
||||
Reference in New Issue
Block a user