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:
@@ -151,6 +151,29 @@ class Settings(BaseSettings):
|
||||
# 正常 worker 每 30 秒来一次 lease,超过该阈值未来 lease 即视为异常。
|
||||
worker_offline_alert_seconds: int = 300
|
||||
|
||||
# ---- 账号只读查询通道(网关 + worker 两侧共用,见 docs/order-gateway.md §11)----
|
||||
# 查询单租约 TTL(秒)。worker 领走后必须在此时间内回结果,否则网关把它
|
||||
# **重投回 queued**——只读操作重复执行没有副作用,与下单任务的 stale 语义相反。
|
||||
query_lease_ttl_seconds: int = 180
|
||||
# 查询单整体存活上限(秒)。从创建算起,超过仍未拿到结果即置 expired
|
||||
# (多半是本地 worker 不在线)。上游据此判断「这张单不用再等了」。
|
||||
query_ttl_seconds: int = 900
|
||||
# 同一张查询单最多被领取几次。租约过期重投累计到这个次数仍无结果即置 failed,
|
||||
# 避免某条查询让 worker 反复卡死在同一个页面上。
|
||||
query_max_attempts: int = 3
|
||||
# 终态查询单的保留时长(秒)。结果里带站点原始 JSON,体积不小,超期由 sweep
|
||||
# 清掉;默认 7 天,够上游对账与排查。
|
||||
query_retention_seconds: int = 7 * 24 * 3600
|
||||
# worker 侧单次站点读取的耗时上限(秒)。查询与下单共用同一把账号锁,正在
|
||||
# 跑的下单会让查询排队等待,这个上限保证查询不会一直挂着——超时按失败回报,
|
||||
# 上游重发即可(只读,重发无副作用)。
|
||||
account_query_timeout_seconds: int = 120
|
||||
# 订单列表查询缺省翻页上限。上游可在 params.max_pages 覆盖(1..20)。
|
||||
account_query_default_max_pages: int = 3
|
||||
# 回报给网关的结果 JSON 体积上限(字节)。超过时丢掉站点原始 JSON、只回
|
||||
# 规范化字段并标记 raw_omitted——避免把几 MB 的页面状态塞进网关 SQLite。
|
||||
query_result_max_bytes: int = 1024 * 1024
|
||||
|
||||
# ---- 本地下单 worker(仅交易服务内的 worker 子模块使用)----
|
||||
# 网关 URL。**留空则不启动 worker**,交易服务只跑登录态接口。
|
||||
# 部署形态:本地机(NAT 后无公网入口)通过出站长轮询领任务,详见
|
||||
|
||||
Reference in New Issue
Block a user