perf(platform-fulfillment): 优化本地选号与失败任务调度
This commit is contained in:
+25
-19
@@ -55,33 +55,39 @@
|
||||
完整的斗鱼绑定字段、`actAlias` 多来源规则、pending 判定原因和日志检索方式见
|
||||
[斗鱼协议总览](斗鱼/DOUYU_PROTOCOL_OVERVIEW.md)。
|
||||
|
||||
选号前会调用 `web/backend/services/douyu_account_state.py` 实时刷新账号:
|
||||
2026-11-22 起,默认选号是**纯本地数据库操作**:
|
||||
|
||||
- 不依赖 `status`、`ck_check_status`、`elite_opened`、`points` 等缓存结论;
|
||||
- 只要账号有 CK、允许自动管理且未停用/归档,就进入实时检测;
|
||||
- 每次选号最多检测 5 个账号,结果写回 `ck_check_*`、生命周期状态、
|
||||
精英宝典、积分、限兑、绑定状态、换绑冷却和账号概览快照;
|
||||
- 下一次点击会优先检测尚未检测或最久未检测的下一批账号;
|
||||
- 实时刷新完成后才判断是否创建租约,失败事件会记录每个账号的具体原因。
|
||||
- `hybrid` / `capability` 只读取新鲜 `account_commodity_states` 和账号主表,
|
||||
不再在分配热路径串行请求斗鱼官网;
|
||||
- 一个账号的 `storehome` 商品列表会一次写入全部商品能力,不需要逐商品查询;
|
||||
- 分配阶段只做账号硬过滤、候选排序和数据库租约抢占,通常应在毫秒级完成;
|
||||
- 绑定二维码阶段会校验 CK/角色,兑换前“刷新兑换资格”仍会实时访问官网,
|
||||
因此本地选号只负责快速占号,不替代最终业务校验;
|
||||
- `legacy` 保留旧实时扫号逻辑,仅用于故障回滚和对比,不再是生产默认路径。
|
||||
|
||||
2026-11-18 起增加“能力索引优先”的混合匹配:
|
||||
能力索引与调度规则:
|
||||
|
||||
- 一键查询或资料刷新把官方 `storehome` 商品状态写入 `account_commodity_states`;
|
||||
- `storehome` 一次返回账号可见的全部商品,逐商品写状态,但每个账号只需一次列表请求;
|
||||
- 同时保存 `timeLimited`、`specTimes` 和起止时间,未开始/已结束与账号限兑分别处理;
|
||||
- `PLATFORM_FULFILLMENT_MATCH_MODE=hybrid` 时先查新鲜能力索引,没有结果再回退旧扫号;
|
||||
- `capability` 模式只读能力索引,不执行全量候选扫描;
|
||||
- `legacy` 模式保留旧逻辑,用于快速回滚;
|
||||
- 能力索引命中后仍只对最终候选做一次实时确认,避免缓存过期直接分配;
|
||||
- 可兑换、未开放等稳定能力默认缓存 6 小时,库存 15 分钟,未知状态 5 分钟;
|
||||
否则 3 万账号池不可能在 15 分钟内刷新一遍,能力索引会长期处于过期状态;
|
||||
- 有 pending 履约需求时,`account_capability_refresh` 作业优先刷新对应商品的过期能力;
|
||||
作业消息只报告本轮结果,不再每轮执行会扫描全账号的精确剩余量统计。
|
||||
- 能力刷新和外部请求由 `account_sync_queue` 独立执行槽消费,不占用选号 worker;
|
||||
- 本地能力池缺失时,选号失败只向该独立队列补入最多 20 个账号,
|
||||
可用 `PLATFORM_FULFILLMENT_CACHE_REFRESH_SEED_COUNT` 调整;
|
||||
- 自动选号按 `next_allocate_at` 轮转,而不是永久按订单时间排在最前;
|
||||
- “未开放”任务直接排到商品开放时间,“无库存”至少退避 5 分钟,
|
||||
“能力快照缺失”退避 2 分钟,避免失败任务每 45 秒占满执行槽;
|
||||
- 单轮默认处理 20 个本地任务,可用 `PLATFORM_FULFILLMENT_AUTO_ALLOCATE_BATCH` 调整。
|
||||
|
||||
能力快照默认 15 分钟有效,可用 `ACCOUNT_COMMODITY_STATE_TTL_SECONDS` 调整。
|
||||
过期能力不会直接参与自动匹配。真正创建租约仍然依赖账号租约唯一约束,
|
||||
因此并发 worker 不会把同一账号分配给两张订单。
|
||||
能力 TTL 可分别用 `ACCOUNT_COMMODITY_STABLE_TTL_SECONDS`、
|
||||
`ACCOUNT_COMMODITY_NO_STOCK_TTL_SECONDS` 和
|
||||
`ACCOUNT_COMMODITY_UNKNOWN_TTL_SECONDS` 调整。过期能力不会参与自动匹配。
|
||||
真正创建租约仍然依赖账号租约唯一约束,因此并发 worker 不会把同一账号分配给两张订单。
|
||||
|
||||
选号硬条件只保留:CK 实时有效、未达到该商品官方限兑上限、角色换绑冷却已结束、
|
||||
无有效租约。积分不足和精英宝典未开通属于**软条件**:
|
||||
选号硬条件只保留:本地 CK 结论有效、未达到该商品官方限兑上限、角色换绑冷却已结束、
|
||||
无有效租约。CK 与兑换资格会在绑码/兑换阶段再次实时校验;积分不足和精英宝典未开通属于**软条件**:
|
||||
|
||||
- 不会淘汰账号,也不会阻止生成绑定二维码;
|
||||
- 优先选择已开通且积分足够的账号,其次选择只需充值或只需开通的账号;
|
||||
@@ -92,7 +98,7 @@
|
||||
|
||||
1. 新订单由 `order_site` 事务 Outbox 自动进入;人工“同步待履约订单”只用于历史补查。
|
||||
2. 为待映射商品选择斗鱼商品和积分价格。
|
||||
3. 点击“自动选号”,系统实时检查 CK、租约、365 天限兑和换绑冷却;
|
||||
3. 点击“自动选号”,系统从本地能力池检查租约、365 天限兑和换绑冷却;
|
||||
积分与精英宝典开通状态只影响账号排序和后续处理提示。
|
||||
4. 点击“生成二维码”,让客户扫码绑定游戏角色。
|
||||
5. 角色出现后点击“确认绑定”。
|
||||
|
||||
Reference in New Issue
Block a user