feat(douyu): 落地账号平台同步与登录配额
This commit is contained in:
@@ -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`
|
||||
|
||||
|
||||
+30
-15
@@ -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` 继续保存不可变事实:
|
||||
|
||||
Reference in New Issue
Block a user