跨境电商订单处理平台

项目背景

客户同时在多个跨境平台经营，订单分散在各平台后台，人工对账与发货效率低且易错。目标是做一个统一处理中枢。

架构思路

平台 A ─┐
平台 B ─┼─→ 适配层 → 订单聚合服务 → 队列 → 处理 Worker → 统一存储
平台 C ─┘                    ↑
                          定时同步 / 手动触发

关键设计：适配层隔离平台差异

各平台的订单结构与接口协议差异很大，若不隔离，业务代码会被平台细节淹没：

export interface PlatformAdapter {
  readonly platform: string
  fetchOrders(params: SyncParams): Promise<RawOrder[]>
  mapOrder(raw: RawOrder): UnifiedOrder
}

export class ShopeeAdapter implements PlatformAdapter {
  readonly platform = 'shopee'

  mapOrder(raw: RawOrder): UnifiedOrder {
    return {
      externalNo: raw.order_sn,
      buyerName: raw.recipient_address.name,
      amount: toDecimal(raw.total_amount, raw.currency),
      items: raw.item_list.map(toUnifiedItem),
      status: mapShopeeStatus(raw.order_status),
    }
  }
}

新增平台只需实现新的适配器，聚合与处理逻辑完全复用。

异步同步

订单同步耗时长，全部走队列异步处理，接口只负责入队并立即返回，避免超时。

交付内容

完整源码、接口文档、部署脚本（Docker Compose）、结构说明与技术支持。