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,
一次落空就把模块永久毒化成不可用,之后补上连接串也救不回来。
This commit is contained in:
yml2213
2026-10-02 22:50:20 +08:00
parent d6c6113112
commit afa5c815f6
9 changed files with 1001 additions and 3 deletions
@@ -0,0 +1,85 @@
"""订单快照缓存表(P0 订单读取适配层)。
用户提交订单号时,适配层会去 order_site 的 PostgreSQL 只读库查一次,把结果
落到这里:一来立即回显商品,二来在对方库不可用时还能降级用旧快照。
主键是 **platform_order_id + source_order_id** 两列,不是单列 —— 上机实测
(见规划 §6.5.1)同一个 platform_order_id 在 orders 表里有 541 组重复,形态
固定为「shop_id=91kaquan 的发货方内部行 + 一个真实店铺行」。按订单号单列存
会让这两行互相覆盖,且回显时可能取到内部行的 sku_code(如 suit_shadow_gothic)
而不是买家真正买的中文名。
缓存只是快照,不是业务数据:order_site 不可用时由此降级,24 小时后重查。
"""
from collections.abc import Sequence
import sqlalchemy as sa
from alembic import op
revision: str = "20261002_0039"
down_revision: str | None = "20261002_0038"
branch_labels: str | Sequence[str] | None = None
depends_on: str | Sequence[str] | None = None
def _tables(bind) -> set[str]:
return set(sa.inspect(bind).get_table_names())
def upgrade() -> None:
bind = op.get_bind()
if "external_order_cache" in _tables(bind):
return
op.create_table(
"external_order_cache",
# 用户/客服填入的快手订单号(order_site orders.platform_order_id)。
sa.Column("platform_order_id", sa.String(length=64), primary_key=True),
# 对应的 order_site orders.id —— 同一个订单号可能有两行,靠它区分。
sa.Column("source_order_id", sa.String(length=64), primary_key=True),
sa.Column("platform", sa.String(length=32), nullable=False, server_default=""),
sa.Column("provider", sa.String(length=32), nullable=False, server_default=""),
sa.Column("shop_id", sa.String(length=64), nullable=False, server_default=""),
sa.Column(
"order_status", sa.String(length=32), nullable=False, server_default=""
),
sa.Column("sku_code", sa.String(length=128), nullable=False, server_default=""),
sa.Column("sku_name", sa.String(length=512), nullable=False, server_default=""),
# SKU 定位键,取自 order_items.spec_json(规划 §3.6)。
sa.Column("seller_id", sa.String(length=64), nullable=False, server_default=""),
sa.Column(
"rel_item_id", sa.String(length=64), nullable=False, server_default=""
),
sa.Column(
"rel_sku_id", sa.String(length=64), nullable=False, server_default=""
),
sa.Column("sku_nick", sa.String(length=512), nullable=False, server_default=""),
sa.Column(
"item_title", sa.String(length=512), nullable=False, server_default=""
),
sa.Column("quantity", sa.Integer(), nullable=True),
# route ∈ {unhandled, auto_fulfilled, worker_platform};按订单号维度聚合得出。
sa.Column("route", sa.String(length=32), nullable=False, server_default=""),
sa.Column("payload", sa.JSON(), nullable=True),
sa.Column("fetched_at", sa.DateTime(), nullable=False),
)
# 按订单号查快照的入口(适配层唯一的查询形态)。
op.create_index(
"ix_external_order_cache_platform_order_id",
"external_order_cache",
["platform_order_id"],
)
op.create_index(
"ix_external_order_cache_fetched_at",
"external_order_cache",
["fetched_at"],
)
def downgrade() -> None:
bind = op.get_bind()
if "external_order_cache" not in _tables(bind):
return
# MySQL 删表会连同索引一起删,不必逐个 drop_index。
op.drop_table("external_order_cache")