feat(douyu): 落地账号平台同步与登录配额

This commit is contained in:
yml
2026-11-21 21:27:14 +08:00
parent 72bc346c9b
commit 1d262cdfd9
30 changed files with 3087 additions and 85 deletions
@@ -263,6 +263,12 @@ AND force_refresh=false
已有 pending/running 工作项时复用,不创建第二条。
成功响应除了写当前投影,还保存官方原始字段:
- `account_sync_states.raw_payload_json`:账号最近一次完整原始响应;
- `account_commodity_states.raw_json`:商品级原始字段;
- 任务 `result` 只保留摘要,避免把任务表当数据库。
## 商品快照
`StorehomeSnapshot` 至少包含:
@@ -274,6 +280,8 @@ AND force_refresh=false
- `items[]`
- `by_commodity`
- `limited_ids`
- `available_from / available_until / schedule_json`
- `raw`
- `success`
- `raw`
@@ -117,7 +117,7 @@ GET /wgapi/ordnc/activity/peace/storehome
| `storeStatus=0` | 官方商城当前不可售 | `availability=no_stock` |
| `openStatus=0` | 活动尚未开放 | `availability=not_open` |
| `count<=0` | 当前库存不足 | `availability=no_stock` |
| `startTime/endTime` | 商品外层开放窗口 | 与本地时间比较 |
| `startTime/endTime` | 商品外层开放窗口 | 与本地时间比较,投影到 `available_from/available_until` |
| `timeLimited` | 是否限时开放 | `time_limited` |
| `specTimes` | 一天多场或分段开放计划 | `schedule_json` |
| `eliteLimited=1` | 商品要求精英手册资格 | 单独保存为门槛,不能写成账号限兑 |
@@ -186,6 +186,18 @@ POST /wgapi/ordnc/activity/peace/batchExchangeLimit
只在确定商品 `batchExchange=1` 且准备执行批量兑换时调用。
限时商品不是“查到 `status=0` 就可以换”。自动选号和最终复核都必须同时满足:
```text
availability = available
AND (available_from IS NULL OR available_from <= now)
AND (available_until IS NULL OR available_until >= now)
AND valid_until > now
```
`next_check_at` 会落在窗口边界或能力 TTL 两者中更早的时间点。跨过边界后必须先重新
查询官方,不能把上一时段形成的 `available` 继续当作可兑换。
## 当前代码路径
### 单次 HTTP 入口
@@ -199,31 +211,31 @@ POST /wgapi/ordnc/activity/peace/batchExchangeLimit
### 当前只读包装
`web/backend/services/douyu_activity_query.py` 当前有两个包装:
`web/backend/services/douyu_activity_query.py` 提供:
- `query_activity_goods()`:返回完整商品列表;
- `query_activity_goods_result()`:返回完整商品列表和顶层原始响应;
- `query_limited_goods_result()`:返回受限商品和原始响应。
两者底层都是同一个 `storehome` 请求,但调用方可能在不同分支重复请求。
底层都是同一个 `storehome` 请求。调用方不再逐礼包查询。
### 当前正确路径
### 当前实现
`query_account_overview` 获取完整商品列表后调用
`sync_account_goods_states()`,可一次写入全部商品状态。
`storehome_snapshot_from_result()` 把一次官方响应归一成 `StorehomeSnapshot`;
`sync_storehome_snapshot()` 一次写入全部商品能力,并保存:
### 当前缺口
- `account_commodity_states.raw_json`:每个商品的完整原始字段;
- `account_sync_states.raw_payload_json`:该账号最近一次官方查询的完整原始响应;
- `account_sync_states.payload_hash`:原始响应 SHA-256,用于判断是否真的发生变化;
- `available_from / available_until / schedule_json`:限时窗口;
- `account_sync_runs`:本次同步的输入条数、变更数、耗时和结果。
1. `query_limited_goods` 任务拿到完整 `storehome` 响应,但目前只处理受限商品和
高价值套装,没有把全部商品写入 `account_commodity_states`。
2. 履约实时检测 `refresh_douyu_account_state()` 请求了完整 `storehome`,但只提取
`limited_ids`,仅为当前订单商品更新一条能力记录,其余商品状态被丢弃。
3. `probe_account()` 的 `with_eligibility` 和 `with_goods` 是独立分支。未来同时开启
两者时,会各请求一次同一个 `storehome`。
4. 没有统一的快照对象约束所有调用方共享一次响应。
`query_account_overview`、`query_limited_goods`、`refresh_goods` 和履约实时检测都
走这条路径,任务 JSON 只保留结果摘要,不再承担账号数据库职责。
## 目标快照契约
建议建立唯一快照入口:
唯一快照入口:
```text
fetch_storehome_snapshot(account, manual_id, rid)
@@ -243,6 +255,9 @@ goods_query_ok
raw
```
保留原始响应是有意设计:限时窗口、库存、开放状态和账号资格字段由斗鱼控制,后续可能
新增字段。归一化投影用于快速筛选,原始字段用于回溯、重放和修复解析规则。
以下能力全部从同一快照派生:
- 完整商品列表;
@@ -108,6 +108,7 @@ CK 生命周期、账号库存目标、覆盖率、查询同步契约和防重
- `availability`:`available / limited / no_stock / not_open / expired /
not_offered / unknown`;
- `raw_status`:官网原始账号级状态;
- `raw_json`:该商品最近一次官方原始字段;
- `observed_at`:最近一次观察时间;
- `valid_until`:当前结论的匹配有效期;
- `next_check_at`:下次建议检查时间;
@@ -117,6 +118,9 @@ CK 生命周期、账号库存目标、覆盖率、查询同步契约和防重
这张表保存的是当前投影,不是只用于 15 分钟缓存的临时数据。过期记录仍然可以被账号
管理查询和展示,只是不能直接作为自动分配依据。
`storehome` 顶层完整响应保存在 `account_sync_states.raw_payload_json`。一层保存最新
顶层响应供协议回溯,一层保存商品级原始字段供精确重放;两者都不替代规范化匹配条件。
### 事件账本
`account_events` 继续保存不可变事实: