q792602257andClaude Opus 5
63c41b61e7
自动登录（此前只能人工跑 scripts/login.py 再 /api/auth/reload）：
- 新增 POST /api/auth/login：动作顺序与下单前的 require_logged_in 一致（探测 →
未登录则按 account.yaml 登一次 → 再探测），已登录直接跳过不白起浏览器。
刻意**不抛 5001**：失败以 logged_in=false + 各站 detail 正常返回，调用方自己
决定是人工接管还是换账号。
- 新增 RAKUTEN_AUTO_LOGIN_ON_START（默认 false）：启动即准备登录态，为容器部署
而存在（镜像里没有落盘的 storage_state）。做成后台任务而非启动阻塞——登录最长
等 relogin_timeout_seconds（默认 300s，撞验证码时在等人工），阻塞会让 /health
在这段时间里连端口都不通；关服务时 cancel 掉在途的那次。
- 自动登录不绕过站点校验：凭据是用户自己配在 account.yaml 里的，代填进站点自己的
登录表单，撞 reCAPTCHA / 设备验证会停在有头浏览器等人工，等不到就超时失败。
容器化部署（新增 Dockerfile.trading + docker-compose.yml）：
- 有状态端单独出镜像不是为了整洁：下单/结算必须用**有头** Chromium（headless 会让
结算 SPA 失灵），镜像要带 Xvfb + 日文字体 + 给人工接管用的可选 x11vnc，抓取镜像
没有这些。网关复用同一镜像只换 command。
- Jenkinsfile 一条流水线产出两个镜像，BUILD_SCRAPING / BUILD_TRADING 两个开关控制。
- .dockerignore 补上 account.yaml / .auth/ / .browser-data/ / data/：明文密码+卡号、
可直接冒充账号的 cookie、带登录态的浏览器 profile、含真实 PII 的证据快照，都不该
进镜像也不该进 build context，运行时一律走挂载。
- .env.example 里 RAKUTEN_AUTO_LOGIN_ON_START 刻意留成注释：compose 的变量插值与
env_file 读的是同一个 ./.env，这里写成显式值会让 compose 的 `${...:-true}` 失效，
按 compose 文件头「cp .env.example .env」走反而不会自动登录。
openapi 导出（scripts/export_openapi.py）：三服务合并成一份可直接导入 Apifox /
Postman 的文档，每条接口带 operation 级 servers（不必手动切端口）。鉴权标注是遍历
FastAPI 依赖树认出真的挂了 require_bearer_token 的接口，不按路径猜。
openapi.json 本身仍是 gitignore 的本地生成物，因此 tests/test_openapi_export.py
只在内存里校验合并逻辑（三服务覆盖、operation 级 servers、除 /health 外全部标鉴权、
operationId 唯一、$ref 可解析），不断言「文件内容 == 当前导出结果」——CI 的全新
clone 里没有这个文件，那种断言必然失败。代价是「改了接口忘了重新导出」没有自动
兜底，得手动跑 --check，已在 README 里点明。
398 测试全绿；另单独验证过缺 openapi.json 时该文件 5 个用例仍通过（CI 场景）。
compose 的变量插值行为只按文档核对，本机没有 docker 未能实测。
Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
152 lines
4.2 KiB
Python
152 lines
4.2 KiB
Python
"""交易侧 API 数据模型：登录态、（后续的）加购、下单与订单监控
|
|
|
|
与抓取侧模型（app/scraping/models/scrape.py）分开的理由和服务本身拆开的理由
|
|
一致：抓取模型描述的是「站点上有什么」，这里描述的是「我们对某个账号做了什么、
|
|
现在处于哪一步」——后者有生命周期、有状态迁移，会持久化，不是一次请求的产物。
|
|
|
|
响应信封 `ApiResponse` 与抓取侧共用，在 app/shared/api.py。
|
|
"""
|
|
from __future__ import annotations
|
|
|
|
from enum import StrEnum
|
|
from typing import Any
|
|
|
|
from pydantic import BaseModel, Field
|
|
|
|
|
|
class AuthSite(StrEnum):
|
|
"""支持登录的站点
|
|
|
|
交易服务只管理乐天市场的购物车购买、支付与订单监控；ラクマ 不进入交易链路。
|
|
"""
|
|
|
|
RAKUTEN = "rakuten"
|
|
|
|
|
|
class AuthStatusRequest(BaseModel):
|
|
"""登录态查询请求"""
|
|
|
|
site: AuthSite | None = None # 不传则返回所有已配置站点
|
|
refresh: bool = True # 是否真实打一次请求探测；false 时只读缓存
|
|
|
|
|
|
class AuthSiteStatus(BaseModel):
|
|
"""单站登录态"""
|
|
|
|
site: str
|
|
state_file_exists: bool # 是否已跑过 scripts/login.py
|
|
logged_in: bool | None # None 表示尚未探测
|
|
checked_age_seconds: float | None = None
|
|
detail: str = ""
|
|
|
|
|
|
class AuthStatusData(BaseModel):
|
|
"""登录态查询响应"""
|
|
|
|
sites: list[AuthSiteStatus] = Field(default_factory=list)
|
|
|
|
|
|
class AuthReloadRequest(BaseModel):
|
|
"""重新加载登录态请求（人工登录完成后调用，免重启服务）"""
|
|
|
|
site: AuthSite | None = None # 不传则重载所有已配置站点
|
|
|
|
|
|
class AuthReloadData(BaseModel):
|
|
"""重新加载登录态响应"""
|
|
|
|
reloaded: dict[str, int] = Field(default_factory=dict) # site -> cookie 条数
|
|
sites: list[AuthSiteStatus] = Field(default_factory=list)
|
|
|
|
|
|
class AuthLoginRequest(BaseModel):
|
|
"""触发自动登录请求"""
|
|
|
|
site: AuthSite | None = None # 不传则对所有已配置站点各跑一次
|
|
|
|
|
|
class AuthLoginData(BaseModel):
|
|
"""触发自动登录响应
|
|
|
|
logged_in 是本次动作的最终结论（所有涉及站点都登录着才为 true）；
|
|
relogin_attempted 标出哪些站点真的跑了登录流程——已登录的站点直接跳过，
|
|
不会白起一次浏览器。
|
|
"""
|
|
|
|
logged_in: bool
|
|
relogin_attempted: dict[str, bool] = Field(default_factory=dict)
|
|
sites: list[AuthSiteStatus] = Field(default_factory=list)
|
|
|
|
|
|
class TradingHealthData(BaseModel):
|
|
"""交易服务健康检查响应数据
|
|
|
|
只读缓存的登录态，不触发网络探测——健康检查会被高频轮询，实时结果请用
|
|
POST /api/auth/status。
|
|
"""
|
|
|
|
status: str
|
|
auth: dict[str, Any] = Field(default_factory=dict)
|
|
|
|
|
|
# ---- 购物车接口（/api/cart/*）----
|
|
|
|
|
|
class CartAddRequest(BaseModel):
|
|
"""加购请求
|
|
|
|
item_url 必填；variant_id / choice 不传时由 SiteInteractor 按商品页
|
|
__INITIAL_STATE__.purchase 自动选（多规格选第一个非售罄，必填选项选第一个候选值）。
|
|
choice 接受字符串（"颜色:赤"）或字符串列表（["颜色:赤", "サイズ:M"]）。
|
|
"""
|
|
|
|
item_url: str
|
|
quantity: int = 1
|
|
variant_id: str | None = None
|
|
choice: str | list[str] | None = None
|
|
|
|
|
|
class CartStatusRequest(BaseModel):
|
|
"""购物车状态查询请求（无入参，保留结构对称）"""
|
|
|
|
|
|
class CartClearRequest(BaseModel):
|
|
"""清空购物车请求（无入参）"""
|
|
|
|
|
|
class CartRemoveRequest(BaseModel):
|
|
"""删除指定商品请求"""
|
|
|
|
item_id: str
|
|
|
|
|
|
class CartAddData(BaseModel):
|
|
"""加购响应数据"""
|
|
|
|
added: bool = True
|
|
item_id: str
|
|
shop_bid: str
|
|
cart_count: int # -1 表示加购成功但末尾 count 查询失败
|
|
|
|
|
|
class CartStatusData(BaseModel):
|
|
"""购物车状态响应数据"""
|
|
|
|
logged_in: bool
|
|
count: int
|
|
raw_status: str # 站点状态码字符串，"100" 表示正常
|
|
|
|
|
|
class CartClearData(BaseModel):
|
|
"""清空购物车响应数据"""
|
|
|
|
removed_count: int # 实际点击「削除」按钮的次数
|
|
cart_count: int # -1 表示末尾 count 查询失败
|
|
|
|
|
|
class CartRemoveData(BaseModel):
|
|
"""删除指定商品响应数据"""
|
|
|
|
removed: bool # 末尾 cart HTML 已不含 item_id 时为 true
|
|
item_id: str
|