# 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`。