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:
@@ -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")
|
||||
Reference in New Issue
Block a user