feat(orders): P0 订单读取适配层——连 order_site 只读库查订单（默认关闭）

让运营能按订单号查到订单，作为后续资料收集（P2）与皮肤准入（P3/P4）的输入。 order_site 零改动：只读直连、独立极小连接池、可一键降级。上机核实推翻了规划两处假设（详见 §6.5.1）： - orders 表没有 order_no 列，只有 id 与 platform_order_id → 查询入口用后者； - platform_order_id 非唯一：541 组重复，形态固定为「91kaquan 内部行(已发货) + 真实店铺行(无人管)」。按规划原文的单行判据，这 540 个已发货订单会被误判成「没人管」而放行重复履约。改为**订单号维度聚合**：任一行已发货即 auto_fulfilled。真机验证（只读账号 livehub_ro）：三桶判定全对，重复组正确拦下并回显真实店铺行的中文名（狂沙舞者，而非内部码 suit_sand_dancer），单次查询 3.3ms。顺带修一个只在真机才暴露的 bug：_get_engine 先置 _INITIALIZED 再读 URL，一次落空就把模块永久毒化成不可用，之后补上连接串也救不回来。
2026-10-02 22:50:20 +08:00
parent d6c6113112
commit afa5c815f6
9 changed files with 1001 additions and 3 deletions
@@ -741,3 +741,38 @@ class AutomationRun(Base):
    skipped: Mapped[int] = mapped_column(Integer, default=0, server_default="0")
    message: Mapped[str] = mapped_column(String(512), default="", server_default="")
    detail: Mapped[dict | None] = mapped_column(JSON, nullable=True)
+
+
+class ExternalOrderCache(Base):
+    """order_site 订单快照（P0 适配层的本地缓存）。
+
+    主键是 (platform_order_id, source_order_id) 两列：同一个订单号在 order_site
+    里可能有两行（发货方内部行 + 真实店铺行，实测 541 组，见规划 §6.5.1），
+    按订单号单列存会互相覆盖。
+
+    只作快照与降级用，24 小时后重查；不参与任何写业务。
+    """
+
+    __tablename__ = "external_order_cache"
+
+    platform_order_id: Mapped[str] = mapped_column(
+        String(64), primary_key=True, index=True
+    )
+    source_order_id: Mapped[str] = mapped_column(String(64), primary_key=True)
+    platform: Mapped[str] = mapped_column(String(32), default="", server_default="")
+    provider: Mapped[str] = mapped_column(String(32), default="", server_default="")
+    shop_id: Mapped[str] = mapped_column(String(64), default="", server_default="")
+    order_status: Mapped[str] = mapped_column(String(32), default="", server_default="")
+    sku_code: Mapped[str] = mapped_column(String(128), default="", server_default="")
+    sku_name: Mapped[str] = mapped_column(String(512), default="", server_default="")
+    seller_id: Mapped[str] = mapped_column(String(64), default="", server_default="")
+    rel_item_id: Mapped[str] = mapped_column(String(64), default="", server_default="")
+    rel_sku_id: Mapped[str] = mapped_column(String(64), default="", server_default="")
+    sku_nick: Mapped[str] = mapped_column(String(512), default="", server_default="")
+    item_title: Mapped[str] = mapped_column(String(512), default="", server_default="")
+    quantity: Mapped[int | None] = mapped_column(Integer, nullable=True)
+    route: Mapped[str] = mapped_column(String(32), default="", server_default="")
+    payload: Mapped[dict | None] = mapped_column(JSON, nullable=True)
+    fetched_at: Mapped[datetime] = mapped_column(
+        UTCDateTime, default=_utcnow, index=True
+    )