feat(fulfillment): 增加账号商品能力索引与生命周期事件

This commit is contained in:
yml
2026-11-18 19:30:59 +08:00
parent dc95d83b32
commit 667634a8df
35 changed files with 3076 additions and 82 deletions
+15
View File
@@ -58,6 +58,21 @@
- 下一次点击会优先检测尚未检测或最久未检测的下一批账号;
- 实时刷新完成后才判断是否创建租约,失败事件会记录每个账号的具体原因。
2026-11-18 起增加“能力索引优先”的混合匹配:
- 一键查询或资料刷新把官方 `storehome` 商品状态写入 `account_commodity_states`;
- `storehome` 一次返回账号可见的全部商品,逐商品写状态,但每个账号只需一次列表请求;
- 同时保存 `timeLimited`、`specTimes` 和起止时间,未开始/已结束与账号限兑分别处理;
- `PLATFORM_FULFILLMENT_MATCH_MODE=hybrid` 时先查新鲜能力索引,没有结果再回退旧扫号;
- `capability` 模式只读能力索引,不执行全量候选扫描;
- `legacy` 模式保留旧逻辑,用于快速回滚;
- 能力索引命中后仍只对最终候选做一次实时确认,避免缓存过期直接分配;
- 有 pending 履约需求时,`account_capability_refresh` 作业优先刷新对应商品的过期能力。
能力快照默认 15 分钟有效,可用 `ACCOUNT_COMMODITY_STATE_TTL_SECONDS` 调整。
过期能力不会直接参与自动匹配。真正创建租约仍然依赖账号租约唯一约束,
因此并发 worker 不会把同一账号分配给两张订单。
选号硬条件只保留:CK 实时有效、未达到该商品官方限兑上限、角色换绑冷却已结束、
无有效租约。积分不足和精英宝典未开通属于**软条件**:
+30 -2
View File
@@ -72,6 +72,7 @@ CK 本体和健康结果都在账号上:
- `lifecycle`:状态变迁;
- `auth`:登录、CK 失效、CK 清除;
- `business`:充值、兑换、积分、到期、开通、鱼翅消耗;
- `activity`:查询、绑定、开通、充值等账号任务的创建与终态;
- `ops`:分配、标签、备注、人工操作。
`source_ref` 是可选幂等键。重复查询官方记录或重复发射事件时,唯一键冲突按幂等命中处理,
@@ -92,8 +93,34 @@ CK 本体和健康结果都在账号上:
不返回整份快照,避免响应体积膨胀。
`high_value_checked_at` 是“最近一次形成高价值结论”的时钟,结论本身可以为
`unknown`;它不表示每次执行都成功读到了可用的官方 `status`。
一键查询本身是只读聚合,不直接修改生命周期状态;官方兑换记录会以
`source=official_sync` 幂等补入事件流。
一键查询不修改账号生命周期状态;官方兑换记录会以
`source=official_sync` 幂等补入事件流。查询任务本身会由统一执行器写入
`activity` 分类的 `task_started / task_succeeded / task_failed / task_stopped`
事件,因此账号详情能查到“某次查询/绑定是否执行、何时完成、失败原因是什么”,
但不会把扫码轮询的每一次请求都写成事件。
## 账号商品能力索引
账号“是否可登录”和“能否兑换某件商品”是两层状态。前者继续存 `accounts`,
后者存 `account_commodity_states`:
- `availability`:`available / limited / no_stock / not_open / expired / not_offered / unknown`;
- `observed_at` / `valid_until` / `next_check_at`:区分最后确认时间和可用期限;
- `time_limited` / `available_from` / `available_until` / `schedule_json`:
保存 `storehome.timeLimited`、`startTime/endTime` 与 `specTimes`,区分未开始、进行中和已结束;
- `last_exchange_at` / `exchange_count_365d`:从 `account_events` 派生的兑换摘要;
- 真正发生过的兑换仍然只追加到 `account_events.exchange`。
一键查询拿到完整 `storehome` 商品列表后,会在同一个事务里更新账号快照和商品能力。
商品接口失败时**不更新**能力,避免把“没查到”写成“不可兑换”。CK 由好变坏时,
该账号所有 `available` 能力立即作废为 `unknown`。
官方 `storehome` 一次返回完整商品列表,因此一个账号一次请求即可写入全部商品状态,
不需要按商品逐个请求。账号级 `status=1` 表示达到限兑上限;`timeLimited/specTimes`
是商品开放窗口。时间窗口优先判断:未开始、已结束不会被误写成“该账号已兑换”。
履约匹配只读取新鲜的能力索引,并对最终选中的账号做一次实时确认。能力索引不是
第二套账号主数据,而是账号当前状态和商品目录的查询投影。
## 高价值套装的准入判定
@@ -148,6 +175,7 @@ CK 本体和健康结果都在账号上:
- 高价值账号优先巡检,其余按最久未检测排序。
- 非鉴权失败计入 `error`,失败率过高时自动暂停作业。
- 资料刷新只处理 `ck_check_status=valid`、允许自动管理且非人工态的账号。
- 履约商品能力刷新只处理“有 pending 任务且快照已过期”的账号,避免无条件全量轮询。
- “从未查询过”的账号优先于“查询结果已过期”的账号。
- **高价值结论有自己的时钟**:资料刷新除了看 `overview_queried_at`,
还看 `high_value_checked_at`。两者会脱钩 —— 一键查询里商品接口单独失败时