You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
1.5 KiB
1.5 KiB
common-ecommerce
多渠道电商履约对接 SDK。把亚马逊、沃尔玛、TikTok、Temu、领星聚合等渠道的商品、订单、履约、标发、面单、账单、售后统一成一套 API。
定位
纯 SDK 库，嵌入宿主（OMS）进程运行。不访问数据库、不访问 Redis、不访问 MQ、不私起线程或定时器。所有外部副作用通过 SPI 注入，由宿主实现。
① 统一入口 ChannelSdk / 各能力门面
② 能力接口 ProductCapable / SalesOrderCapable / FulfillmentCapable / ...
③ 平台适配 amazon-sc / walmart-sc / tiktok / temu / lingxing / ...
④ 基础设施 HttpTransport / Signer / TokenManager / RateLimiter / SyncEngine / Idempotency
⑤ 宿主 SPI AccountRepository / TokenStore / SyncCursorStore / Sink / Clock / LockProvider / ...
模块
| 模块 | 职责 |
|---|---|
common-ecommerce-core |
领域模型、能力接口、门面、管道、SPI。零第三方运行时依赖 |
common-ecommerce-http |
HTTP 传输、签名、令牌管理、JSON 编解码 |
common-ecommerce-testkit |
InMemory SPI、FakeTransport、夹具加载、断言工具 |
common-ecommerce-lingxing |
领星聚合适配器（多子平台） |
构建
mvn clean test
要求 JDK 1.8、Maven 3.6+。
设计文档
docs/01-architecture.md总体设计与边界docs/02-testing.md测试分层与夹具约定
完整规格见 OMS 侧 cross-border-fulfillment-sdk-design.md。