加 /api/cart/* 接口；加购链路完全归 trading

trading 新增 4 条购物车接口（POST /api/cart/{add,status,clear,remove}），
全部 Bearer 鉴权、走 SiteInteractor（Playwright + storage_state）。同步把
SiteInteractor 从 gateway URL 解耦——lifespan 总是构造与启停，container
字段 worker_site → site，加 asyncio.Lock 让 HTTP 与 worker 共用同一把锁
（同账号串行硬约束）。clear/remove 用 UI 点击 button[aria-label="削除"]，
探针回报这是稳定 selector；真账号实测前先用此路径。

抽 ichiba 加购字段解析到 app/shared/purchase_contract.py（常量 +
inventory_flag_for + basket_domain_of + base_form_fields），原本 scraping
与 trading 重复实现同一段 __INITIAL_STATE__.purchase 解析。进一步发现
README 写的「purchase 块是两服务契约」实际未落地——trading 必须 Playwright
开页（httpx 被 TLS 指纹拦死），本地抽比再调 /api/item_detail 更快更新鲜。
删除 scraping 端 PurchaseInfo/PurchaseOption/PurchaseOptionValue 模型、
各站 _purchase_info 函数、tests/test_purchase.py。ItemDetailData 保留
purchase_condition / is_sold_out / purchase_unit / sku 等商品状态字段。
README「加购与下单」段重写。

328 测试全绿（含架构测试守住三方互不 import）。

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

app/scraping/models/scrape.py

@@ -347,56 +347,15 @@ class Breadcrumb(BaseModel):
     url: str = ""
 
 
-class PurchaseOptionValue(BaseModel):
-    """商品选项的一个可选值"""
-
-    value_id: str = ""
-    name: str = ""
-
-
-class PurchaseOption(BaseModel):
-    """商品选项（選択肢），如「名入れ」「ラッピング」
-
-    加购时需要按 `名称:取值` 的形式拼进 options_field 指定的字段。
-    """
-
-    option_id: str = ""
-    name: str = ""
-    type: str = ""  # select 单选 / check 多选 / text 自由文本
-    is_required: bool = False
-    values: list[PurchaseOptionValue] = Field(default_factory=list)  # type=text 时为空
-
-
-class PurchaseInfo(BaseModel):
-    """构造加购请求所需的信息
-
-    本服务只提供数据、不执行加购——加购需要已登录的乐天账号会话，由持有登录态的
-    下游负责。四个来源的加购端点与字段名各不相同，因此这里不写死字段，而是把
-    「提交到哪里、固定字段是什么、数量/规格/选项各该用哪个字段名」显式描述出来：
-
-        payload = {**form_fields}
-        payload[quantity_field] = 数量                      # quantity_field 为空表示不支持指定数量
-        payload[variant_field] = 选中的 sku.variants[].variant_id   # variant_field 为空表示无规格
-        payload[options_field] = ["选项名:取值", ...]         # options_field 为空表示无选项
-
-    然后以 cart_method 提交到 cart_url。
-    """
-
-    cart_url: str = ""
-    cart_method: str = "POST"
-    form_fields: dict[str, str] = Field(default_factory=dict)
-    quantity_field: str = ""
-    variant_field: str = ""
-    options_field: str = ""
-    options: list[PurchaseOption] = Field(default_factory=list)
-    has_required_options: bool = False
-
-
 class ItemDetailData(BaseModel):
     """商品详情数据
 
     部分乐天官方店的商品页会跳转到独立子站，各子站页面结构不同、可提供的字段也
     不同。source 标明这条数据由哪个站点解析而来，字段覆盖差异见 README。
+
+    加购（构造 cart 请求）不在本服务范围内——加购需要已登录的乐天账号会话，
+    归 trading 服务（app.trading）。本响应只描述「商品状态」：能不能买
+    （purchase_condition / is_sold_out）、规格（sku.variants）、起订单位等。
     """
 
     source: str = "ichiba"  # ichiba / books / brandavenue / biccamera
@@ -421,7 +380,6 @@ class ItemDetailData(BaseModel):
     breadcrumbs: list[Breadcrumb] = Field(default_factory=list)
     shipping: ShippingInfo = Field(default_factory=ShippingInfo)
     sku: SkuInfo = Field(default_factory=SkuInfo)
-    purchase: PurchaseInfo = Field(default_factory=PurchaseInfo)
 
 
 class HealthData(BaseModel):

app/scraping/parsers/item.py

@@ -14,9 +14,6 @@ from app.shared.errors import ScrapeParseError
 from app.scraping.models.scrape import (
     Breadcrumb,
     ItemDetailData,
-    PurchaseInfo,
-    PurchaseOption,
-    PurchaseOptionValue,
     ReviewSummary,
     ShippingInfo,
     ShopSummary,
@@ -31,12 +28,7 @@ from app.scraping.utils.coerce import as_dict, as_float, as_int, as_list, as_str
 # purchase.sellType 下表示「可正常购买」的状态值
 _PURCHASABLE_CONDITION = "enabled"
 
-# 普通购买的事件标识，站点前端构造加购表单时固定带上
-_NORMAL_PURCHASE_EVENT = "ES01_003_001"
-
-# 库存类型 → 加购表单里的 inventory_flag
-_INVENTORY_FLAG = {"multiple": 2}
-_DEFAULT_INVENTORY_FLAG = 1
+# 库存类型 → 加购表单里的 inventory_flag（常量与基础字段构造在 app.shared.purchase_contract）
 
 
 def _parse_attributes(raw: Any) -> list[SkuAttribute]:
@@ -91,72 +83,6 @@ def _parse_variants(raw: Any) -> list[SkuVariant]:
     return variants
 
 
-def parse_purchase_options(raw: Any) -> list[PurchaseOption]:
-    """解析商品选项（選択肢）
-
-    结构为 {id, name, type: select|check|text, isRequired, values:[{id, name}]}；
-    type=text 的选项没有候选值，由买家自由填写（如刻字内容）。
-    """
-    options: list[PurchaseOption] = []
-    for option in as_list(raw):
-        if not isinstance(option, dict):
-            continue
-        options.append(
-            PurchaseOption(
-                option_id=str(as_int(option.get("id"))) if option.get("id") is not None else "",
-                name=as_str(option.get("name")),
-                type=as_str(option.get("type")),
-                is_required=bool(option.get("isRequired")),
-                values=[
-                    PurchaseOptionValue(
-                        value_id=str(as_int(value.get("id"))) if value.get("id") is not None else "",
-                        name=as_str(value.get("name")),
-                    )
-                    for value in as_list(option.get("values"))
-                    if isinstance(value, dict)
-                ],
-            )
-        )
-    return options
-
-
-def _purchase_info(
-    *,
-    sell_type: dict[str, Any],
-    raw_sku: dict[str, Any],
-    information: dict[str, Any],
-    shop_id: int,
-    item_id: str,
-    item_variant_id: str,
-) -> PurchaseInfo:
-    """组装加购所需的端点与字段
-
-    字段名与取值来自站点前端构造加购表单的逻辑（getPurchaseFormData）。
-    basketDomain 逐商品不同（不同店铺落在不同的 basket 集群），不能写死。
-    """
-    inventory_flag = _INVENTORY_FLAG.get(as_str(raw_sku.get("inventoryType")), _DEFAULT_INVENTORY_FLAG)
-    form_fields = {
-        "shop_bid": str(shop_id),
-        "item_id": item_id,
-        "inventory_flag": str(inventory_flag),
-        "__event": _NORMAL_PURCHASE_EVENT,
-    }
-    # 单一库存商品的规格是固定的，直接填好，调用方无需再选
-    if inventory_flag == _DEFAULT_INVENTORY_FLAG and item_variant_id:
-        form_fields["variant_id"] = item_variant_id
-
-    options = parse_purchase_options(information.get("options"))
-    return PurchaseInfo(
-        cart_url=as_str(sell_type.get("basketDomain")),
-        form_fields=form_fields,
-        quantity_field="units",
-        variant_field="variant_id",
-        options_field="choice" if options else "",
-        options=options,
-        has_required_options=any(option.is_required for option in options),
-    )
-
-
 def _pick_sell_type(sell_type: dict[str, Any]) -> dict[str, Any]:
     """取售卖方式信息，优先普通购买，其次任意一种带价格的方式（如定期购）"""
     normal = as_dict(sell_type.get("normalPurchase"))
@@ -270,12 +196,4 @@ def parse_item_detail(
         breadcrumbs=breadcrumbs,
         shipping=shipping,
         sku=sku,
-        purchase=_purchase_info(
-            sell_type=sell_type,
-            raw_sku=raw_sku,
-            information=as_dict(purchase.get("information")),
-            shop_id=as_int(shop_information.get("shopId")),
-            item_id=item_id,
-            item_variant_id=as_str(item.get("variantId")),
-        ),
     )

app/scraping/parsers/subsites/biccamera.py

@@ -15,7 +15,6 @@ from app.shared.errors import ScrapeParseError
 from app.scraping.models.scrape import (
     Breadcrumb,
     ItemDetailData,
-    PurchaseInfo,
     ShippingInfo,
     ShopSummary,
     SkuInfo,
@@ -50,22 +49,6 @@ def _extract_nuxt(html: str) -> dict:
     return state
 
 
-def _purchase_info(state: dict, item: dict) -> PurchaseInfo:
-    """该站加购走自己的 JSON 接口，字段与市场完全不同（没有 shop_bid）
-
-    选项（choices）的取值结构未取到样本验证，因此只如实回报「有没有选项」，
-    不给出可能不准确的选项定义——带选项的商品需要调用方另行处理。
-    """
-    choices = as_list(state.get("choices"))
-    return PurchaseInfo(
-        cart_url=as_str(item.get("add_cart_api_url")),
-        form_fields={"item_id": str(as_int(item.get("item_id")))},
-        quantity_field="units",
-        options_field="choice" if choices else "",
-        has_required_options=bool(choices),
-    )
-
-
 def parse(page: SubsitePage) -> ItemDetailData:
     """解析ビックカメラ商品页"""
     nuxt = _extract_nuxt(page.html)
@@ -128,5 +111,4 @@ def parse(page: SubsitePage) -> ItemDetailData:
             show_inventory=inventory > 0,
             delivery_message=delivery,
         ),
-        purchase=_purchase_info(as_dict(nuxt.get("state")), item),
     )

app/scraping/parsers/subsites/books.py

@@ -17,7 +17,6 @@ from app.shared.errors import ScrapeParseError
 from app.scraping.models.scrape import (
     Breadcrumb,
     ItemDetailData,
-    PurchaseInfo,
     ReviewSummary,
     ShippingInfo,
     ShopSummary,
@@ -120,27 +119,21 @@ def _parse_genres(html: str) -> tuple[str, list[Breadcrumb]]:
     return genre_id, crumbs
 
 
-def _parse_purchase(tree: HTMLParser) -> PurchaseInfo:
-    """加购信息直接取页面上的购物车表单
+def _extract_cart_form_item_id(tree: HTMLParser) -> str:
+    """从购物车表单里抽 item_id
 
-    注意表单里的 item_id 与商品 URL 上的编号不是一回事，加购必须用表单里的值。
-    该表单没有数量字段，无法在加购时指定件数。
+    楽天ブックス 的站内 item_id 与 URL 上的商品编号不是一回事（URL 17065211 →
+    item_id 20600328）。下单要用表单里的 item_id，所以这里专门抽它。
+    加购表单本身不再解析成 PurchaseInfo——加购由 trading 内部完成。
     """
     for form in tree.css("form"):
         action = form.attributes.get("action") or ""
         if "/bs/Cart" not in action:
             continue
-        fields = {
-            name: inp.attributes.get("value") or ""
-            for inp in form.css("input")
-            if (name := inp.attributes.get("name"))
-        }
-        return PurchaseInfo(
-            cart_url=action,
-            cart_method=(form.attributes.get("method") or "POST").upper(),
-            form_fields=fields,
-        )
-    return PurchaseInfo()
+        for inp in form.css("input"):
+            if inp.attributes.get("name") == "item_id":
+                return inp.attributes.get("value") or ""
+    return ""
 
 
 def parse(page: SubsitePage) -> ItemDetailData:
@@ -158,13 +151,13 @@ def parse(page: SubsitePage) -> ItemDetailData:
     status = _text(tree, ".status")
     genre_id, breadcrumbs = _parse_genres(page.html)
     review_count = _text(tree, '[itemprop="reviewCount"]')
-    purchase = _parse_purchase(tree)
+    # 站内 item_id 与 URL 编号不同，下单要用表单里的——保留抽取，但不构 PurchaseInfo
+    item_id = _extract_cart_form_item_id(tree) or page.item_code
 
     return ItemDetailData(
         source=SOURCE,
         source_url=page.final_url,
-        # 站内商品 ID 与 URL 上的编号不同，以购物车表单里的为准（下单要用它）
-        item_id=purchase.form_fields.get("item_id", "") or page.item_code,
+        item_id=item_id,
         item_code=page.item_code,
         item_name=name,
         description=_parse_description(tree),
@@ -183,5 +176,4 @@ def parse(page: SubsitePage) -> ItemDetailData:
         # 图书统一由楽天ブックス发货，页面只给库存措辞，不给运费明细
         shipping=ShippingInfo(delivery_message=status),
         sku=SkuInfo(inventory_type="single", attributes=_parse_spec(tree), delivery_message=status),
-        purchase=purchase,
     )

app/scraping/parsers/subsites/brandavenue.py

@@ -18,7 +18,6 @@ from app.shared.errors import ScrapeParseError
 from app.scraping.models.scrape import (
     Breadcrumb,
     ItemDetailData,
-    PurchaseInfo,
     ShopSummary,
     SkuAttribute,
     SkuAxis,
@@ -37,44 +36,6 @@ SHOP_NAME = "Rakuten Fashion"
 _COLOR_AXIS = "カラー"
 _SIZE_AXIS = "サイズ"
 
-# cart_info.cart_url_type → 加购端点。站点前端用同名映射表（resolveCartUrl）解析；
-# 若该字段本身已经是一个 URL，则直接使用。
-_CART_URL_BY_TYPE = {
-    "1": "https://ts.basket.step.rakuten.co.jp/rms/mall/bs/cartadd/set",
-    "2": "https://ts.sp.basket.step.rakuten.co.jp/rms/mall/bss/cartadd/set",
-    "3": "https://t2.basket.step.rakuten.co.jp/rms/mall/bs/cartadd/set",
-    "4": "https://t2.sp.basket.step.rakuten.co.jp/rms/mall/bss/cartadd/set",
-    "5": "https://basket.step.rakuten.co.jp/rms/mall/bs/cartadd/set",
-    "6": "https://sp.basket.step.rakuten.co.jp/rms/mall/bss/cartadd/set",
-}
-_DEFAULT_PURCHASE_EVENT = "ES01_003_001"
-
-
-def _resolve_cart_url(cart_url_type: str) -> str:
-    if cart_url_type.startswith("http"):
-        return cart_url_type
-    return _CART_URL_BY_TYPE.get(cart_url_type, "")
-
-
-def _purchase_info(product: dict) -> PurchaseInfo:
-    """加购字段与市场是同一套契约，差别只在端点由 cart_url_type 映射得到"""
-    cart_info = as_dict(as_dict(product.get("rms_info")).get("cart_info"))
-    if not cart_info:
-        return PurchaseInfo()
-    return PurchaseInfo(
-        cart_url=_resolve_cart_url(as_str(cart_info.get("cart_url_type"))),
-        form_fields={
-            "shop_bid": as_str(cart_info.get("shop_bid")),
-            "item_id": as_str(cart_info.get("item_id")),
-            "inventory_flag": as_str(cart_info.get("inventory_type")),
-            "__event": as_str(cart_info.get("event")) or _DEFAULT_PURCHASE_EVENT,
-            "encode": "utf8",
-        },
-        quantity_field="units",
-        variant_field="variant_id",
-    )
-
-
 def validate(html: str) -> str | None:
     if "window.__INITIAL_STATE__" in html:
         return None
@@ -206,5 +167,4 @@ def parse(page: SubsitePage) -> ItemDetailData:
         genre_id=as_str(rms.get("genre_id")),
         breadcrumbs=_breadcrumbs(product),
         sku=_sku(product, include_variants=page.include_sku_variants),
-        purchase=_purchase_info(product),
     )