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.
40 lines
1.5 KiB
40 lines
1.5 KiB
21 hours ago
|
# 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` | 领星聚合适配器（多子平台） |
|
||
|
|
|
||
|
|
## 构建
|
||
|
|
|
||
|
|
```bash
|
||
|
|
mvn clean test
|
||
|
|
```
|
||
|
|
|
||
|
|
要求 JDK 1.8、Maven 3.6+。
|
||
|
|
|
||
|
|
## 设计文档
|
||
|
|
|
||
|
|
- `docs/01-architecture.md` 总体设计与边界
|
||
|
|
- `docs/02-testing.md` 测试分层与夹具约定
|
||
|
|
|
||
|
|
完整规格见 OMS 侧 `cross-border-fulfillment-sdk-design.md`。
|