feat(gateway): 账号只读查询通道——从已登录账号取真实订单
上游要的不只是网关记的任务状态镜像，还有「已登录账号在站点上的真实订单」，
但账号只在 NAT 后本地机上，只能经网关队列走。新增独立查询通道（§11）：
- gateway 单开 account_queries 表 + QueryStatus 状态机，接口
POST /api/account/queries（幂等）/ lease / {id}/result / {id}
- 不复用下单任务队列：查询是只读，租约过期可安全重投（与下单「绝不自动
重投」相反），且不该被全局并发度 1 堵死、task_reports 是订单镜像不能污染
- 本地交易服务起第二条常驻循环 query_runner，领到即调 SiteInteractor 真读：
order_list 复用已实测的 list_recent_orders（规范化字段 + 站点
orderListData 原文），order_detail 复用 fetch_order_detail（配送阶段 +
页面 __INITIAL_STATE__ 原样透传，结构未经真实样本，不抽字段）
- 账号级串行仍由 SiteInteractor 的锁保证；每次执行套超时按失败回报
- 错误码 6005/6006（查询通道，可重试只读区别于 6001-6004）；/health 暴露
queued_query_count；结果体积上限先丢原始 JSON
openapi.json 重导，docs/order-gateway.md §11、README、.env.example 补全
配置与实测边界。全量测试 404→454 通过。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Claude Opus 5
@@ -146,8 +146,15 @@ PC UA 在搜索页、详情页、店铺页上都能拿到完整模板。因此
|
||||
| `POST /api/orders/{id}/reclaim` | 把 stale 任务重新租给 worker（**绝不自动重投**） |
|
||||
| `GET /api/orders/{id}` | 任务详情 + 完整状态历史 |
|
||||
| `GET /api/orders` | 任务列表（运维与上游对账用） |
|
||||
| `POST /api/account/queries` | 提交**账号只读查询**（订单列表 / 单笔详情，幂等） |
|
||||
| `GET /api/account/queries/lease` | 本地 worker 领取查询单（可安全重投，与下单任务相反） |
|
||||
| `POST /api/account/queries/{id}/result` | 本地回报查询结果（站点真实订单数据） |
|
||||
| `GET /api/account/queries/{id}` | 取查询单状态与结果 |
|
||||
| `GET /api/account/queries` | 查询单列表（运维排查） |
|
||||
|
||||
网关的契约与状态机详见 [docs/order-gateway.md](docs/order-gateway.md)
|
||||
（账号只读查询通道见该文档 §11，用于「从已登录账号拉取真实订单」）。
|
||||
|
||||
网关的契约与状态机详见 [docs/order-gateway.md](docs/order-gateway.md)。
|
||||
|
||||
三个服务共用同一个 Bearer Token，错误码表也是同一份。
|
||||
启动后分别在 `http://127.0.0.1:31107/docs`、`:31108/docs`、`:31109/docs` 查看 OpenAPI 文档。
|
||||
@@ -635,12 +642,16 @@ trading 加购时的字段选择策略：多规格挑第一个非售罄的 varia
|
||||
| 6002 | 租约无效：不是持有者、已过期或任务已终结（网关） | 409 |
|
||||
| 6003 | 任务状态不允许该操作（如对已终结任务 reclaim）（网关） | 409 |
|
||||
| 6004 | 已有任务在执行中，本次不发放（正常返回空，仅诊断用） | 200 |
|
||||
| 6005 | 查询单不存在（网关，账号只读查询通道） | 404 |
|
||||
| 6006 | 查询单租约无效（网关，账号只读查询通道） | 409 |
|
||||
|
||||
错误码在两站、三个服务之间通用。ラクマ 链路不会出现 `3002`（无反爬拦截行为）
|
||||
与 `4002`（无子站跳转）；`5xxx` 只会来自交易服务——抓取服务全程匿名，不会有登录态问题。
|
||||
`5001` 与 `5004` 都标记为不可重试：前者要人工重新登录，后者要调用方改入参。
|
||||
`6xxx` 只会来自网关，全部标记为不可重试——任务编排侧重试无意义，部分场景
|
||||
（如租约过期）重试可能变成重复下单。
|
||||
`6xxx` 只会来自网关：`6001`–`6004`（下单任务通道）全部标记为不可重试——任务编排侧
|
||||
重试无意义，部分场景（如租约过期）重试可能变成重复下单；`6005`–`6006`
|
||||
（账号只读查询通道）**可以重试**——查询只读，重发没有副作用
|
||||
（见 [docs/order-gateway.md §11](docs/order-gateway.md#11-账号只读查询通道)）。
|
||||
|
||||
## 常用环境变量
|
||||
|
||||
@@ -651,6 +662,7 @@ trading 加购时的字段选择策略：多规格挑第一个非售罄的 varia
|
||||
- 抓取服务：`RAKUTEN_APP_HOST`、`RAKUTEN_APP_PORT`（默认 `31107`）、`RAKUTEN_APP_ENV`
|
||||
- 交易服务：`RAKUTEN_TRADING_HOST`、`RAKUTEN_TRADING_PORT`（默认 `31108`）、`RAKUTEN_AUTH_STATE_DIR`（默认 `.auth`）、`RAKUTEN_ORDER_MAX_TOTAL_YEN`（默认 `30000`）
|
||||
- 下单任务网关：`RAKUTEN_GATEWAY_HOST`、`RAKUTEN_GATEWAY_PORT`（默认 `31109`）、`RAKUTEN_GATEWAY_DB_PATH`（默认 `data/gateway.db`）、`RAKUTEN_LEASE_TTL_SECONDS`（默认 `300`）、`RAKUTEN_WORKER_OFFLINE_ALERT_SECONDS`（默认 `300`）
|
||||
- 账号只读查询通道（网关 + 本地 worker 两侧共用）：`RAKUTEN_QUERY_LEASE_TTL_SECONDS`（默认 `180`）、`RAKUTEN_QUERY_TTL_SECONDS`（默认 `900`）、`RAKUTEN_QUERY_MAX_ATTEMPTS`（默认 `3`）、`RAKUTEN_QUERY_RETENTION_SECONDS`（默认 `604800`）、`RAKUTEN_ACCOUNT_QUERY_TIMEOUT_SECONDS`（默认 `120`）、`RAKUTEN_ACCOUNT_QUERY_DEFAULT_MAX_PAGES`（默认 `3`）、`RAKUTEN_QUERY_RESULT_MAX_BYTES`（默认 `1048576`）
|
||||
- 本地下单 worker（在交易服务内，按 `RAKUTEN_ORDER_GATEWAY_URL` 是否配置决定是否启动）：`RAKUTEN_ORDER_GATEWAY_URL`、`RAKUTEN_WORKER_ID`、`RAKUTEN_TRADING_DB_PATH`（默认 `data/trading.db`）、`RAKUTEN_EVIDENCE_DIR`（默认 `data/evidence`）、`RAKUTEN_SCRAPER_BASE_URL`
|
||||
- 鉴权：`RAKUTEN_BEARER_TOKEN`（三个服务共用）
|
||||
- 抓取：`RAKUTEN_MAX_SITE_CONCURRENCY`（默认 `8`，两站各自独立计数）、`RAKUTEN_HTTP_MAX_ATTEMPTS`（默认 `3`）、`RAKUTEN_SESSION_TTL_SECONDS`（默认 `1800`，仅乐天）
|
||||
|
||||
Reference in New Issue
Block a user