From c9d60153c7cc3dfb12a289a974cecb4ecd6a4c0c Mon Sep 17 00:00:00 2001
From: chenchuchuan <13554600537@163.com>
Date: Wed, 4 Nov 2026 17:19:30 +0800
Subject: [PATCH] =?UTF-8?q?test:=20=E6=AF=8F=E4=B8=AA=E5=B9=B3=E5=8F=B0?=
=?UTF-8?q?=E8=A1=A5=20listing=20/=20=E5=94=AE=E5=90=8E=E5=A5=91=E7=BA=A6?=
=?UTF-8?q?=E6=B5=8B=E8=AF=95=EF=BC=8C=E6=96=B0=E5=A2=9E=20SDK=20=E9=97=A8?=
=?UTF-8?q?=E9=9D=A2=E8=B0=83=E7=94=A8=E6=B5=8B=E8=AF=95?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
testkit(测试支撑):
- RecordingTransport:记录全部请求、按 URL 路由响应;令牌请求自动返回最小成功响应,
业务请求可断言
- JsonFixture:classpath 夹具加载
- Responses:恢复快捷响应构造
- FakeDirectAdapter:补 AfterSaleCapable,支持 afterSales(count)
lingxing(每平台一套):
- 9 个 listing 测试:walmart / ebay / temu / shein / tiktok / target /
aliexpress / amazon sc / amazon vc
覆盖请求参数(店铺、时间窗、分页、搜索编码)与响应映射
- 售后:ListSource(请求构造、过滤、上限、时间窗校验、行展开)+ Mapper(10 例)
- LingxingTestSupport:测试公共样板(账户/调用/断言)
- 夹具:每平台一套 success.json
testkit(门面调用):
- SdkFacadeCallTest:products / afterSales / salesOrders 的完整调用、分页、
参数校验、能力检查、账户缺失等错误路径
清理:
- 删除 ProductCallExampleTest、SdkCallGuideTest 与两份 AmazonScProductLiveTest
(已被上述测试覆盖)
- 探针改为 -Dlingxing.probe=true 才运行,避免真实凭证让 mvn test 变红
修复:
- TargetProductSource 的 store_ids 被误注释,恢复
- AmazonVcProductSource 传搜索条件时显式抛异常,不再静默忽略
Co-Authored-By: Claude
---
.../amazon/vc/product/AmazonVcProductSource.java | 6 +
.../target/product/TargetProductSource.java | 8 +-
.../ecommerce/lingxing/ProductCallExampleTest.java | 182 ----------------
.../ecommerce/lingxing/SdkCallGuideTest.java | 212 -------------------
.../aftersale/LingxingAfterSaleListSourceTest.java | 204 +++++++++---------
.../product/AliexpressProductSourceTest.java | 76 +++++++
.../platform/amazon/AmazonScProductLiveTest.java | 229 ---------------------
.../amazon/sc/AmazonScProductLiveTest.java | 229 ---------------------
.../sc/product/AmazonScProductSourceTest.java | 75 +++++++
.../vc/product/AmazonVcProductSourceTest.java | 60 ++++++
.../ebay/product/EbayProductSourceTest.java | 62 ++++++
.../shein/product/SheinProductSourceTest.java | 56 +++++
.../temu/product/TemuProductSourceTest.java | 67 ++++++
.../tiktok/product/TiktokProductSourceTest.java | 49 +++++
.../walmart/product/WalmartProductSourceTest.java | 85 ++++++++
.../lingxing/probe/SearchFieldProbeTest.java | 4 +
.../lingxing/probe/ShopListProbeTest.java | 4 +
.../lingxing/support/LingxingTestSupport.java | 122 +++++++++++
.../lingxing/aliexpressListing/success.json | 8 +
.../fixtures/lingxing/amazonScListing/success.json | 7 +
.../fixtures/lingxing/amazonVcListing/success.json | 6 +
.../fixtures/lingxing/ebayListing/success.json | 10 +
.../fixtures/lingxing/sheinListing/success.json | 7 +
.../fixtures/lingxing/targetListing/success.json | 10 +
.../fixtures/lingxing/temuListing/success.json | 11 +
.../fixtures/lingxing/tiktokListing/success.json | 7 +
.../fixtures/lingxing/walmartListing/success.json | 10 +
.../ecommerce/testkit/FakeDirectAdapter.java | 39 +++-
.../java/common/ecommerce/testkit/JsonFixture.java | 38 ++++
.../ecommerce/testkit/RecordingTransport.java | 108 ++++++++++
.../java/common/ecommerce/testkit/Responses.java | 34 +++
.../ecommerce/testkit/SdkFacadeCallTest.java | 181 ++++++++++++++++
32 files changed, 1246 insertions(+), 960 deletions(-)
delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java
delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java
delete mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
create mode 100644 lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json
create mode 100644 lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json
create mode 100644 testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java
create mode 100644 testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java
create mode 100644 testkit/src/main/java/common/ecommerce/testkit/Responses.java
create mode 100644 testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
index 80057e2..9100a35 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
@@ -54,6 +54,12 @@ public final class AmazonVcProductSource implements LingxingProductSource {
if (storeId != null && !storeId.trim().isEmpty()) {
body.put("vc_store_ids", Collections.singletonList(storeId));
}
+ // 该接口文档没有搜索参数,传了搜索条件必须显式失败,不能静默返回全量
+ if (query.hasSearch()) {
+ throw new UnsupportedOperationException(
+ "amazon vc listing does not support search field " + query.searchField());
+ }
+
HttpRequest req = call.signed(LingxingApi.LISTING_AMAZON_VC, body, "products.pull");
HttpResponse resp = call.execute(req);
LingxingEnvelope envelope = call.envelope(resp, "products.pull");
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
index c193149..ab4986f 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
@@ -55,10 +55,10 @@ public final class TargetProductSource implements LingxingProductSource {
body.put("offset", offset);
body.put("length", length);
// store_ids 非必填:账户配了才传,由平台侧校验是否必填
-// String storeId = call.ctx().account().externalStoreId();
-// if (storeId != null && !storeId.trim().isEmpty()) {
-// body.put("store_ids", Collections.singletonList(storeId));
-// }
+ String storeId = call.ctx().account().externalStoreId();
+ if (storeId != null && !storeId.trim().isEmpty()) {
+ body.put("store_ids", Collections.singletonList(storeId));
+ }
applyTimeWindow(body, query);
// 按 SKU 搜索:平台不支持的维度直接报错,不静默忽略
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java
deleted file mode 100644
index 8567e14..0000000
--- a/lingxing/src/test/java/common/ecommerce/lingxing/ProductCallExampleTest.java
+++ /dev/null
@@ -1,182 +0,0 @@
-package common.ecommerce.lingxing;
-
-import common.ecommerce.http.HttpResponse;
-import common.ecommerce.http.HttpTransport;
-import common.ecommerce.lingxing.adapter.LingxingAdapter;
-import common.ecommerce.model.ChannelProvider;
-import common.ecommerce.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelSdk;
-import common.ecommerce.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryAccounts;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
-import org.junit.jupiter.api.Test;
-
-import java.time.Clock;
-import java.time.Instant;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-
-/**
- * 从 ChannelSdk 拉商品的完整示例。
- *
- * 这是用法文档,不是契约测试。传输层返回一页固定的领星 Listing 响应,
- * 目的是让你看清:三段配置分别是什么、拼出来的请求长什么样、结果如何映射成统一模型。
- */
-class ProductCallExampleTest {
-
- /** 领星生产域名。SDK 不保存它,每次调用通过 ChannelConnection 传入。 */
- private static final String ENDPOINT = "https://openapi.lingxing.com";
-
- // ==================== 第 1 段:账户 ====================
-
- /** 你自己的店铺 ID,业务归属维度。 */
- private static final String OMS_STORE_ID = "oms-wm-001";
-
- /** 领星侧的店铺 ID(store_id)。 */
- private static final String LINGXING_STORE_ID = "1108413237731";
-
- /** 领星平台码:10008 = Walmart,10001 = Amazon SC。 */
- private static final int PLATFORM_CODE = 10008;
-
- /**
- * 领星 AppID。同时作为签名用的 AES 密钥,长度必须是 16/24/32 字节,
- * 否则 LingxingSigner 会直接拒绝。
- */
- private static final String APP_KEY = "test-app-id-1234";
-
- /** 领星 AppSecret。 */
- private static final String APP_SECRET = "test-app-secret";
-
- /** 账户:告诉 SDK「这是哪个店铺」,SDK 用它校验归属、拼请求参数。 */
- private static ChannelAccount account() {
- return ChannelAccount.builder()
- // provider + platform + omsStoreId:三个一起决定用哪个适配器
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID))
- // 领星 store_id,会拼进请求体的 store_ids
- .externalStoreId(LINGXING_STORE_ID)
- // 领星 platform_code,会拼进请求体的 platform_code
- .platformCode(PLATFORM_CODE)
- // 密钥引用;本 SDK 目前不使用(密钥从 ChannelConnection 传)
- .credentialRef("kms://test/lingxing")
- // 市场时区,必须能被 ZoneId.of 解析;影响返回时间的当地视图
- .marketplaceZone("America/Los_Angeles")
- // 店铺币种
- .currency("USD")
- .build();
- }
-
- // ==================== 第 2 段:连接 ====================
-
- /** 连接:告诉 SDK「这次连哪里、用谁的身份」。每次调用都可以不同(换环境、换 app)。 */
- private static ChannelConnection connection() {
- return ChannelConnection.of(ENDPOINT, ChannelSecret.builder()
- .appKey(APP_KEY) // 领星 AppID
- .appSecret(APP_SECRET) // 领星 AppSecret
- .build());
- }
-
- // ==================== 第 3 段:构建 SDK ====================
-
- /** 构建 SDK:账户仓库 + 适配器。写操作才需要幂等存储。 */
- private static ChannelSdk buildSdk(HttpTransport transport) {
- InMemoryAccounts accounts = new InMemoryAccounts().put(account());
-
- // 生产写法是 .register(new LingxingAdapterFactory(tokenStore, lockProvider, clock)),
- // 工厂内部会 new OkHttpTransport;这里为了接管网络层,直接注册适配器实例。
- LingxingAdapter adapter = new LingxingAdapter(transport,
- new common.ecommerce.http.JacksonJsonCodec(),
- new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC());
-
- return ChannelSdk.builder()
- .accountRepository(accounts) // 必需:按 AccountKey 找账户
- .register(adapter) // 必需:至少一个适配器
- .build();
- }
-
- // ==================== 调用 ====================
-
- @Test
- void pullProductsThroughSdk() {
- FixedResponseTransport transport = new FixedResponseTransport();
- ChannelSdk sdk = buildSdk(transport);
-
- // 每次调用都传 AccountKey + ChannelConnection
- AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID);
-
- Page page = sdk.products(key, connection()).pull(ProductQuery.builder()
- .updatedAfter(Instant.parse("2026-11-01T00:00:00Z")) // 可选
- .updatedBefore(Instant.parse("2026-11-04T00:00:00Z")) // 可选,不传则用 SDK 时钟
- .pageSize(20) // 平台上限内自动截断
- .build());
-
- // 解析结果:领星字段 → 统一模型
- assertEquals(1, page.size());
- ProductListing p = page.items().get(0);
- assertEquals("wal-0726-102", p.platformSku()); // ← msku
- assertEquals("FBSPORT Round Inflatable", p.title()); // ← title
- assertEquals(Platform.WALMART_SC, p.platform());
- assertEquals(OMS_STORE_ID, p.omsStoreId());
- assertEquals("USD", p.currency()); // ← currency_icon "$" 映射
- assertEquals("139.90", p.price().amount().toPlainString());
- assertNotNull(p.attributes().get("store_name")); // 未标准化的原始字段
- }
-
- @Test
- void requestBodyCarriesAccountParameters() {
- FixedResponseTransport transport = new FixedResponseTransport();
- ChannelSdk sdk = buildSdk(transport);
- AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID);
-
- sdk.products(key, connection()).pull(ProductQuery.builder().pageSize(20).build());
-
- // 第一次是换 token,第二次是拉商品
- assertEquals(2, transport.requests.size());
- String productBody = transport.requests.get(1).body();
-
- // 账户里的四个参数分别落到请求里
- assertTrueContains(productBody, "\"store_ids\":[\"" + LINGXING_STORE_ID + "\"]");
- assertTrueContains(productBody, "\"offset\":0");
- assertTrueContains(productBody, "\"length\":20");
- // 时间窗按 UTC 日期发送
- assertTrueContains(transport.requests.get(1).url(), "/basicOpen/multiplatform/walmart/list");
- }
-
- private static void assertTrueContains(String haystack, String needle) {
- org.junit.jupiter.api.Assertions.assertTrue(haystack.contains(needle),
- "期望包含 " + needle + ",实际:" + haystack);
- }
-
- /**
- * 固定响应传输层:令牌请求返回最小 token 响应,商品请求返回一页沃尔玛 Listing。
- */
- static final class FixedResponseTransport implements HttpTransport {
-
- final java.util.List requests =
- new java.util.ArrayList();
-
- @Override
- public HttpResponse execute(common.ecommerce.http.HttpRequest request) {
- requests.add(request);
- if (request.url().contains("/oauth/access-token")) {
- return HttpResponse.of(200, java.util.Collections.emptyMap(),
- "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"tok-1\","
- + "\"refresh_token\":\"ref-1\",\"expires_in\":7199}}", 1);
- }
- return HttpResponse.of(200, java.util.Collections.emptyMap(),
- "{\"code\":0,\"message\":\"success\",\"total\":1,\"data\":{\"list\":[{"
- + "\"item_id\":\"wal-0726-102\",\"msku\":\"wal-0726-102\","
- + "\"title\":\"FBSPORT Round Inflatable\",\"picture_url\":\"\","
- + "\"status_name\":\"PUBLISHED\",\"store_id\":\"" + LINGXING_STORE_ID + "\","
- + "\"store_name\":\"测试店铺\",\"currency_icon\":\"$\",\"price\":\"139.90\","
- + "\"gtin\":\"00723849594300\"}]}}", 1);
- }
- }
-}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java
deleted file mode 100644
index 5775914..0000000
--- a/lingxing/src/test/java/common/ecommerce/lingxing/SdkCallGuideTest.java
+++ /dev/null
@@ -1,212 +0,0 @@
-package common.ecommerce.lingxing;
-
-import common.ecommerce.capability.CapabilityReport;
-import common.ecommerce.error.ChannelException;
-import common.ecommerce.http.HttpRequest;
-import common.ecommerce.http.HttpResponse;
-import common.ecommerce.http.HttpTransport;
-import common.ecommerce.lingxing.adapter.LingxingAdapterFactory;
-import common.ecommerce.model.Capability;
-import common.ecommerce.model.ChannelProvider;
-import common.ecommerce.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.model.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelSdk;
-import common.ecommerce.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryAccounts;
-import common.ecommerce.testkit.InMemoryIdempotencyStore;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
-import org.junit.jupiter.api.Test;
-
-import java.time.Clock;
-import java.time.Instant;
-import java.time.ZoneOffset;
-import java.util.ArrayList;
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-/**
- * 从 ChannelSdk 调用领星的完整写法演示。
- *
- * 这不是契约测试,而是用法说明:每一段代码对应操作手册里的一节。
- * 网络层用 {@link RecordingTransport} 记录请求后中断,不联网、不伪造响应。
- */
-class SdkCallGuideTest {
-
- private static final String ENDPOINT = "https://openapi.lingxing.com";
- private static final String OMS_STORE_ID = "oms-wm-001";
- /** 领星 appId 同时作为签名 AES 密钥,长度必须是 16/24/32 字节。 */
- private static final String APP_KEY = "test-app-id-1234";
- private static final String APP_SECRET = "test-app-secret";
-
- /** ---------------------------------------------------------------- 第 1 步:账户 */
- private static ChannelAccount walmartAccount() {
- return ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID))
- .externalStoreId("1108413237731") // 领星 store_id
- .platformCode(10008) // 领星 platform_code:10008 = Walmart
- .credentialRef("kms://test/lingxing") // 只存引用(本 SDK 目前不用它取密钥)
- .marketplaceZone("America/Los_Angeles") // 必须是合法 IANA 时区
- .currency("USD")
- .build();
- }
-
- /** ---------------------------------------------------------------- 第 2 步:连接信息 */
- private static ChannelConnection connection() {
- return ChannelConnection.of(ENDPOINT, ChannelSecret.builder().appKey(APP_KEY).appSecret(APP_SECRET).build());
- }
-
- /** ---------------------------------------------------------------- 第 3 步:构建 SDK */
- private static ChannelSdk buildSdk(HttpTransport transport, ChannelAccount account) {
- InMemoryAccounts accounts = new InMemoryAccounts().put(account);
-
- ChannelSdk.Builder builder = ChannelSdk.builder()
- .accountRepository(accounts) // 必需:按 AccountKey 查账户
- .idempotencyStore(new InMemoryIdempotencyStore()) // 写操作用;本用例不写
- .idempotencyOwner("test-node")
- .clock(Clock.fixed(Instant.parse("2026-11-04T00:00:00Z"), ZoneOffset.UTC));
-
- // 工厂内部会 new OkHttpTransport,所以这里直接注册适配器实例以便注入测试传输层。
- // 生产环境用 .register(new LingxingAdapterFactory(tokenStore, lockProvider, clock))。
- return builder.register(new common.ecommerce.lingxing.adapter.LingxingAdapter(
- transport,
- new common.ecommerce.http.JacksonJsonCodec(),
- new InMemoryTokenStore(),
- new InMemoryLockProvider(),
- Clock.systemUTC())).build();
- }
-
- @Test
- void step3_factoryStyleRegistration() {
- // 生产写法:注册工厂,SDK 在 build() 时调用 factory.create(...)
- LingxingAdapterFactory factory = new LingxingAdapterFactory(
- new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC());
-
- assertNotNull(factory);
- assertEquals("lingxing", factory.adapterId());
- assertEquals(ChannelProvider.LINGXING, factory.provider());
- assertTrue(factory.platforms().contains(Platform.WALMART_SC));
- }
-
- /** ---------------------------------------------------------------- 第 4 步:查能力(不发请求) */
- @Test
- void step4_capabilitiesDoNotCallNetwork() {
- RecordingTransport transport = new RecordingTransport();
- ChannelSdk sdk = buildSdk(transport, walmartAccount());
-
- AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID);
- CapabilityReport caps = sdk.capabilities(key);
-
- assertTrue(caps.supports(Capability.SALES_ORDER));
- assertTrue(caps.supports(Capability.PRODUCT));
- assertFalse(caps.supports(Capability.REFUND));
- assertTrue(transport.recorded.isEmpty(), "capabilities() 不应发起网络请求");
- }
-
- /** ---------------------------------------------------------------- 第 5 步:拉订单 */
- @Test
- void step5_pullOrdersShowsRequestParameters() {
- RecordingTransport transport = new RecordingTransport();
- ChannelSdk sdk = buildSdk(transport, walmartAccount());
- AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID);
-
- // 请求构造完成后 RecordingTransport 会抛 StopException 中断,这里接住
- assertThrows(RecordingTransport.Stop.class, () -> sdk.salesOrders(key, connection()).pull(
- SalesOrderQuery.builder()
- .updatedAfter(Instant.parse("2026-11-01T00:00:00Z"))
- .updatedBefore(Instant.parse("2026-11-02T00:00:00Z"))
- .pageSize(50)
- .build()));
-
- // 两次请求:先换 token,再拉订单
- assertEquals(2, transport.recorded.size());
- HttpRequest tokenReq = transport.recorded.get(0);
- HttpRequest orderReq = transport.recorded.get(1);
-
- assertTrue(tokenReq.url().endsWith("/api/auth-server/oauth/access-token"), tokenReq.url());
- assertTrue(tokenReq.body().contains("name=\"appId\"\r\n\r\n" + APP_KEY), tokenReq.body());
- assertTrue(tokenReq.body().contains("name=\"appSecret\"\r\n\r\n" + APP_SECRET), tokenReq.body());
-
- assertTrue(orderReq.url().startsWith(ENDPOINT + "/pb/mp/order/v2/list"), orderReq.url());
- assertTrue(orderReq.url().contains("app_key=" + APP_KEY), orderReq.url());
- assertTrue(orderReq.url().contains("sign="), orderReq.url());
- assertTrue(orderReq.body().contains("\"platform_code\":[10008]"), orderReq.body());
- assertTrue(orderReq.body().contains("\"store_id\":[\"1108413237731\"]"), orderReq.body());
- assertTrue(orderReq.body().contains("\"offset\":0"), orderReq.body());
- assertTrue(orderReq.body().contains("\"length\":50"), orderReq.body());
- assertTrue(orderReq.body().contains("\"start_time\":1793491200"), orderReq.body());
- assertEquals("Bearer ", orderReq.headers().get("Authorization").substring(0, 7));
- }
-
- /** ---------------------------------------------------------------- 第 6 步:参数不对时的报错 */
- @Test
- void step6_unknownAccountFailsFast() {
- ChannelSdk sdk = buildSdk(new RecordingTransport(), walmartAccount());
- AccountKey missing = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, "oms-not-exists");
-
- IllegalStateException ex = assertThrows(IllegalStateException.class,
- () -> sdk.salesOrders(missing, connection()));
- assertTrue(ex.getMessage().contains("channel account not configured"), ex.getMessage());
- }
-
- @Test
- void step6_unsupportedCapabilityFailsFast() {
- ChannelSdk sdk = buildSdk(new RecordingTransport(), walmartAccount());
- AccountKey key = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, OMS_STORE_ID);
-
- // 能力检查发生在调用动作时(pull/submit),不是取视图时
- ChannelException.UnsupportedCapabilityException ex =
- assertThrows(ChannelException.UnsupportedCapabilityException.class,
- () -> sdk.settlements(key, connection()).pull(
- common.ecommerce.model.settlement.SettlementQuery.builder().build()));
- assertEquals(Capability.BILLING, ex.capability());
- }
-
- @Test
- void step6_unregisteredPlatformFailsFast() {
- ChannelSdk sdk = buildSdk(new RecordingTransport(), walmartAccount());
- // 账户仓库里只有沃尔玛 SC 的账户,用 EBAY 的 key 会先卡在账户查询
- AccountKey ebay = AccountKey.of(ChannelProvider.LINGXING, Platform.EBAY, OMS_STORE_ID);
-
- IllegalStateException ex = assertThrows(IllegalStateException.class,
- () -> sdk.salesOrders(ebay, connection()));
- assertTrue(ex.getMessage().contains("channel account not configured"), ex.getMessage());
- }
-
- /**
- * 记录请求后中断的传输层。
- *
- * 令牌请求返回一个最小的成功响应,让流程能走到业务请求;
- * 业务请求记录后中断,用来看请求是怎么构造的。
- */
- static final class RecordingTransport implements HttpTransport {
-
- final List recorded = new ArrayList();
-
- @Override
- public HttpResponse execute(HttpRequest request) {
- recorded.add(request);
- if (request.url().contains("/api/auth-server/oauth/access-token")) {
- return HttpResponse.of(200, java.util.Collections.emptyMap(),
- "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{"
- + "\"access_token\":\"tok-1\",\"refresh_token\":\"ref-1\","
- + "\"expires_in\":7199}}", 1);
- }
- throw new Stop();
- }
-
- /** 用于中断调用链,不是错误。 */
- static final class Stop extends RuntimeException {
- private static final long serialVersionUID = 1L;
- }
- }
-}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
index eedd592..9ab95cc 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
@@ -1,134 +1,134 @@
package common.ecommerce.lingxing.platform.aftersale;
-import common.ecommerce.http.HttpRequest;
-import common.ecommerce.http.HttpResponse;
-import common.ecommerce.http.HttpTransport;
-import common.ecommerce.http.JacksonJsonCodec;
+import common.ecommerce.error.ChannelException;
+import common.ecommerce.error.ValidationException;
import common.ecommerce.lingxing.LingxingApi;
-import common.ecommerce.lingxing.auth.LingxingTokenClient;
-import common.ecommerce.lingxing.http.LingxingRateLimiter;
-import common.ecommerce.lingxing.http.LingxingRequestFactory;
-import common.ecommerce.lingxing.platform.LingxingCall;
-import common.ecommerce.model.ChannelProvider;
import common.ecommerce.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
import common.ecommerce.model.aftersale.AfterSale;
import common.ecommerce.model.aftersale.AfterSaleQuery;
import common.ecommerce.model.aftersale.AfterSaleType;
import common.ecommerce.model.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
-import common.ecommerce.spi.AccessToken;
-import common.ecommerce.spi.ChannelSecret;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
import org.junit.jupiter.api.Test;
-import java.time.Clock;
import java.time.LocalDate;
-import java.util.ArrayList;
import java.util.Arrays;
-import java.util.Collections;
-import java.util.List;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.ENDPOINT;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyNotContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertUrlStartsWith;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastUrl;
import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertTrue;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
-/**
- * 领星售后列表接口的请求构造测试。
- *
- * 传输层返回录制报文后直接断言请求体,不联网。
- */
+/** 领星售后订单列表:请求构造 + 响应映射 + 边界校验。 */
class LingxingAfterSaleListSourceTest {
- private static final Clock CLOCK = Clock.fixed(java.time.Instant.parse("2026-11-04T00:00:00Z"),
- java.time.ZoneOffset.UTC);
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.AFTER_SALE_LIST.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/afterSale/success.json")));
@Test
- void requestCarriesTimeWindowAndFilters() throws Exception {
- RecordingTransport transport = new RecordingTransport();
- LingxingAfterSaleListSource source = new LingxingAfterSaleListSource();
+ void requestCarriesTimeWindowAndFilters() {
+ Page page = new LingxingAfterSaleListSource().pull(
+ call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-10-01"))
+ .endDate(LocalDate.parse("2026-11-01"))
+ .dateType(AfterSaleQuery.DateType.UPDATE_TIME)
+ .types(Arrays.asList(AfterSaleType.REFUND, AfterSaleType.RETURN))
+ .channelOrderIds(Arrays.asList("113-1", "113-2"))
+ .pageSize(200)
+ .build());
- Page page = source.pull(call(transport, "1105"), AfterSaleQuery.builder()
- .startDate(LocalDate.parse("2026-10-01"))
- .endDate(LocalDate.parse("2026-11-01"))
- .dateType(AfterSaleQuery.DateType.UPDATE_TIME)
- .types(Arrays.asList(AfterSaleType.REFUND, AfterSaleType.RETURN))
- .channelOrderIds(Arrays.asList("113-1", "113-2"))
- .pageSize(200)
- .build());
+ assertUrlStartsWith(lastUrl(transport), ENDPOINT + LingxingApi.AFTER_SALE_LIST.path());
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"start_date\":\"2026-10-01\"");
+ assertBodyContains(body, "\"end_date\":\"2026-11-01\"");
+ assertBodyContains(body, "\"date_type\":3");
+ assertBodyContains(body, "\"after_type\":\"1,2\"");
+ assertBodyContains(body, "\"amazon_order_id_list\":[\"113-1\",\"113-2\"]");
+ assertBodyContains(body, "\"sid\":\"1099\"");
+ assertBodyContains(body, "\"length\":200");
- // 两条请求:先换 token,再拉售后
- assertEquals(2, transport.requests.size());
- HttpRequest req = transport.requests.get(1);
- assertTrue(req.url().startsWith("https://openapi.lingxing.com"
- + LingxingApi.AFTER_SALE_LIST.path()), req.url());
+ // 一条记录含 2 个商品行 → 2 条统一模型;游标按记录数推进
+ assertEquals(2, page.size());
+ assertNull(page.nextCursor());
+ }
- String body = req.body();
- assertTrue(body.contains("\"start_date\":\"2026-10-01\""), body);
- assertTrue(body.contains("\"end_date\":\"2026-11-01\""), body);
- assertTrue(body.contains("\"date_type\":3"), body);
- assertTrue(body.contains("\"after_type\":\"1,2\""), body);
- assertTrue(body.contains("\"amazon_order_id_list\":[\"113-1\",\"113-2\"]"), body);
- assertTrue(body.contains("\"sid\":\"1105\""), body);
- assertTrue(body.contains("\"length\":200"), body);
- assertTrue(body.contains("\"offset\":0"), body);
+ @Test
+ void defaultDateTypeIsAfterSaleTime() {
+ new LingxingAfterSaleListSource().pull(
+ call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-10-01"))
+ .endDate(LocalDate.parse("2026-11-02"))
+ .build());
+ assertBodyContains(lastBody(transport), "\"date_type\":1");
+ }
- // 一条筛选记录含 2 个商品行 → 2 条统一模型;游标按记录数推进
- assertEquals(2, page.size());
- assertEquals(null, page.nextCursor());
+ @Test
+ void noFiltersWhenListsEmpty() {
+ new LingxingAfterSaleListSource().pull(
+ call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-10-01"))
+ .endDate(LocalDate.parse("2026-11-02"))
+ .build());
+ assertBodyNotContains(lastBody(transport), "after_type");
+ assertBodyNotContains(lastBody(transport), "amazon_order_id_list");
}
- private static LingxingCall call(HttpTransport transport, String storeId) throws Exception {
- JacksonJsonCodec json = new JacksonJsonCodec();
- ChannelAccount account = ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-001"))
- .externalStoreId(storeId)
- .platformCode(10001)
- .credentialRef("test")
- .marketplaceZone("America/Los_Angeles")
- .currency("USD")
- .build();
- ChannelSecret secret = ChannelSecret.builder()
- .appKey("test-app-id-1234").appSecret("test-app-secret").build();
- ChannelConnection conn = ChannelConnection.of("https://openapi.lingxing.com", secret);
- ChannelContext ctx = ChannelContext.of(account, conn, "req-1", CLOCK);
- AccessToken token = new LingxingTokenClient(transport, json, CLOCK)
- .fetch("https://openapi.lingxing.com", "test-app-id-1234", "test-app-secret");
- return new LingxingCall(ctx, token, new LingxingRequestFactory(json, CLOCK),
- new LingxingRateLimiter(), json, transport);
+ @Test
+ void orderIdLimitIsEnforced() {
+ String[] ids = new String[51];
+ for (int i = 0; i < ids.length; i++) {
+ ids[i] = "order-" + i;
+ }
+ assertThrows(IllegalArgumentException.class,
+ () -> new LingxingAfterSaleListSource().pull(
+ call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-10-01"))
+ .endDate(LocalDate.parse("2026-11-02"))
+ .channelOrderIds(Arrays.asList(ids))
+ .build()));
}
- /** 令牌返回最小成功响应;售后请求返回文档示例夹具。 */
- static final class RecordingTransport implements HttpTransport {
+ @Test
+ void timeWindowMustBeLeftClosedRightOpen() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-11-02"))
+ .endDate(LocalDate.parse("2026-11-02"))
+ .build());
+ }
- final List requests = new ArrayList();
+ @Test
+ void mapsRowsIntoUnifiedModel() {
+ Page page = new LingxingAfterSaleListSource().pull(
+ call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-10-01"))
+ .endDate(LocalDate.parse("2026-11-02"))
+ .build());
- @Override
- public HttpResponse execute(HttpRequest request) {
- requests.add(request);
- if (request.url().contains("/oauth/access-token")) {
- return HttpResponse.of(200, Collections.emptyMap(),
- "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"tok\","
- + "\"refresh_token\":\"ref\",\"expires_in\":7199}}", 1);
- }
- try {
- return HttpResponse.of(200, Collections.emptyMap(),
- load("fixtures/lingxing/afterSale/success.json"), 1);
- } catch (Exception e) {
- throw new IllegalStateException(e);
- }
- }
+ AfterSale ret = page.items().get(0);
+ assertEquals(Platform.AMAZON_SC, ret.platform());
+ assertEquals(AfterSaleType.RETURN, ret.type());
+ assertEquals("113-9870855-8214638", ret.channelOrderId());
+ assertEquals("D5LCqzJZRRMA", ret.rmaNumber());
- private static String load(String path) throws Exception {
- java.io.InputStream in = LingxingAfterSaleListSourceTest.class.getClassLoader()
- .getResourceAsStream(path);
- java.io.ByteArrayOutputStream out = new java.io.ByteArrayOutputStream();
- byte[] buf = new byte[4096];
- int n;
- while ((n = in.read(buf)) >= 0) {
- out.write(buf, 0, n);
- }
- return new String(out.toByteArray(), "UTF-8");
- }
+ AfterSale refund = page.items().get(1);
+ assertEquals(AfterSaleType.REFUND, refund.type());
+ assertEquals("USD", refund.refundAmount().currencyCode());
+ assertEquals("-4.700", refund.refundAmount().amount().toPlainString());
}
}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
new file mode 100644
index 0000000..0df02d3
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
@@ -0,0 +1,76 @@
+package common.ecommerce.lingxing.platform.aliexpress.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import java.time.Instant;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyNotContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/**
+ * AliExpress 在线商品。
+ *
+ * 覆盖两处踩过的坑:接口不接受 storeIds;本地 SKU 的搜索编码是 5 而不是文档写的 3。
+ */
+class AliexpressProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_ALIEXPRESS.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/aliexpressListing/success.json")));
+
+ @Test
+ void requestOmitsStoreIdsAndUsesIsChild() {
+ new AliexpressProductSource().products(call(transport, account(Platform.ALIEXPRESS, 0, "8888")),
+ ProductQuery.builder()
+ .updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
+ .updatedBefore(Instant.parse("2026-10-08T00:00:00Z"))
+ .build());
+
+ String body = lastBody(transport);
+ // 该接口不需要 storeIds
+ assertBodyNotContains(body, "storeIds");
+ assertBodyContains(body, "\"isParent\":0");
+ assertBodyContains(body, "\"start\":\"2026-10-01\"");
+ assertBodyContains(body, "\"end\":\"2026-10-08\"");
+ }
+
+ @Test
+ void platformSkuUsesField1LocalSkuUsesField5() {
+ AliexpressProductSource source = new AliexpressProductSource();
+ source.products(call(transport, account(Platform.ALIEXPRESS, 0, "8888")),
+ ProductQuery.builder().searchField(ProductSearchField.PLATFORM_SKU).searchValue("AE-MSKU-1").build());
+ assertBodyContains(lastBody(transport), "\"searchField\":1");
+
+ new AliexpressProductSource().products(call(transport, account(Platform.ALIEXPRESS, 0, "8888")),
+ ProductQuery.builder().searchField(ProductSearchField.LOCAL_SKU).searchValue("AE-LOCAL-1").build());
+ // 实测:本地 SKU 是 5,不是文档写的 3
+ assertBodyContains(lastBody(transport), "\"searchField\":5");
+ }
+
+ @Test
+ void mapsResponseWithCentsPrice() {
+ ProductListing p = new AliexpressProductSource().products(
+ call(transport, account(Platform.ALIEXPRESS, 0, "8888")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.ALIEXPRESS, p.platform());
+ assertEquals("AE-MSKU-1", p.platformSku());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("USD", p.currency());
+ // price=5999 分 → 59.99
+ assertEquals("59.99", p.price().amount().toPlainString());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java
deleted file mode 100644
index 1b945df..0000000
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/AmazonScProductLiveTest.java
+++ /dev/null
@@ -1,229 +0,0 @@
-package common.ecommerce.lingxing.platform.amazon;
-
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
-import common.ecommerce.http.HttpRequest;
-import common.ecommerce.http.HttpResponse;
-import common.ecommerce.http.HttpTransport;
-import common.ecommerce.http.JacksonJsonCodec;
-import common.ecommerce.http.OkHttpTransport;
-import common.ecommerce.lingxing.LingxingConstants;
-import common.ecommerce.lingxing.adapter.LingxingAdapter;
-import common.ecommerce.model.ChannelProvider;
-import common.ecommerce.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
-import common.ecommerce.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
-import org.junit.jupiter.api.Test;
-
-import java.time.Clock;
-import java.time.Duration;
-import java.time.Instant;
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-
-/**
- * 领星 · 亚马逊 SC 真实环境测试:先查店铺列表拿 sid,再用 sid 拉 Listing。
- *
- * 跑之前填 APP_KEY / APP_SECRET 即可;SID 留空时会自动从店铺列表取第一个。
- *
- * mvn -pl lingxing -am test -Dtest=AmazonScProductLiveTest
- *
- *
- * 调用前确认出口 IP 已加入领星白名单。本类只用于联调,不要把真实凭证提交到仓库。
- *
- * 两个接口的令牌桶容量都是 1,且按「账户 + path」共享,必须串行调用。
- */
-class AmazonScProductLiveTest {
-
- // ==================== 填写这里 ====================
- /** 领星 ERP 开放接口的 AppID。 */
- private static final String APP_KEY = "在这里填 AppID";
- /** 领星 ERP 开放接口的 AppSecret。 */
- private static final String APP_SECRET = "在这里填 AppSecret";
- /**
- * 亚马逊店铺的领星 sid。
- * 留空则自动调用店铺列表接口,取第一个正常状态的店铺。
- */
- private static final String SID = "";
- // ================================================
-
- private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL;
-
- private final JacksonJsonCodec json = new JacksonJsonCodec();
- private final LoggingTransport transport =
- new LoggingTransport(new OkHttpTransport("common-ecommerce-smoke"));
-
- /**
- * 店铺列表:一次性返回企业已授权到领星的全部亚马逊 SC 店铺。
- *
- * 接口 {@code GET /erp/sc/data/seller/lists},非分页。打印每个店铺的 sid 与名称,
- * 同时打印请求与响应原始报文(见 LoggingTransport),便于核对字段名。
- */
- @Test
- void listsAmazonShops() {
- requireConfigured();
-
- List channels = adapter().listSubChannels(shopListContext());
- System.out.println("[shops] subChannels size=" + channels.size());
- for (SubChannel c : channels) {
- System.out.println(" platformCode=" + c.platformCode()
- + " sid=" + c.externalStoreId()
- + " platform=" + c.platform()
- + " name=" + c.name());
- }
- assertNotNull(channels);
- }
-
- /** 拿第一个正常店铺的 sid,调 Listing 接口。 */
- @Test
- void pullsOnePageOfListings() {
- requireConfigured();
-
- String sid = resolveSid();
- System.out.println("[listings] 使用 sid=" + sid);
-
- ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(),
- "smoke-" + System.currentTimeMillis(), Clock.systemUTC());
-
- Instant to = Instant.now();
- Instant from = to.minus(Duration.ofDays(7));
-
- Page page = adapter().pull(ctx, ProductQuery.builder()
- .updatedAfter(from)
- .updatedBefore(to)
- .pageSize(20)
- .build());
-
- System.out.println("[listings] window=" + from + " .. " + to
- + " items=" + page.size() + " nextCursor=" + page.nextCursor());
- for (ProductListing p : page.items()) {
- System.out.println(" sku=" + p.platformSku()
- + " title=" + p.title()
- + " status=" + p.status()
- + " images=" + p.imageUrls().size()
- + " updatedAt=" + (p.updatedAt() == null ? null : p.updatedAt().utc()));
- }
- assertFalse(page.size() > 20, "pageSize 未被平台遵守");
- }
-
- /** 不带时间窗,确认默认分页与解析也能走通。 */
- @Test
- void pullsFirstPageWithoutTimeWindow() {
- requireConfigured();
-
- String sid = resolveSid();
- ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(),
- "smoke-" + System.currentTimeMillis(), Clock.systemUTC());
-
- Page page = adapter().pull(ctx, ProductQuery.builder().pageSize(10).build());
-
- System.out.println("[listings/no-window] sid=" + sid + " items=" + page.size()
- + " nextCursor=" + page.nextCursor());
- for (ProductListing p : page.items()) {
- System.out.println(" sku=" + p.platformSku() + " status=" + p.status());
- }
- // 店铺可能没有商品,空列表也算通过
- assertNotNull(page);
- }
-
- // ---------------------------------------------------------------- helpers
-
- private static void requireConfigured() {
- org.junit.jupiter.api.Assumptions.assumeTrue(
- !APP_KEY.startsWith("在这里填") && !APP_SECRET.startsWith("在这里填"),
- "请先填写 AmazonScProductLiveTest 顶部的 APP_KEY / APP_SECRET");
- }
-
- /** 优先用常量里的 SID;留空则从店铺列表取第一个。 */
- private String resolveSid() {
- if (SID != null && !SID.trim().isEmpty() && !SID.startsWith("在这里填")) {
- return SID.trim();
- }
- List channels = adapter().listSubChannels(shopListContext());
- if (channels.isEmpty()) {
- throw new AssertionError("店铺列表为空:该企业没有已授权且状态正常的亚马逊 SC 店铺");
- }
- return channels.get(0).externalStoreId();
- }
-
- private LingxingAdapter adapter() {
- return new LingxingAdapter(transport, json,
- new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC());
- }
-
- private ChannelConnection connection() {
- return ChannelConnection.of(BASE_URL, ChannelSecret.builder()
- .appKey(APP_KEY).appSecret(APP_SECRET).build());
- }
-
- /** 店铺列表所用的上下文:店铺维度此时还不存在,用占位 omsStoreId。 */
- private ChannelContext shopListContext() {
- return ChannelContext.of(placeholderAccount(), connection(),
- "smoke-shops-" + System.currentTimeMillis(), Clock.systemUTC());
- }
-
- private ChannelAccount placeholderAccount() {
- return ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-discovery"))
- .externalStoreId("discovery")
- .platformCode(10001)
- .credentialRef("smoke")
- .marketplaceZone("America/Los_Angeles")
- .currency("USD")
- .build();
- }
-
- private ChannelAccount amazonAccount(String sid) {
- return ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-smoke"))
- .externalStoreId(sid)
- .platformCode(10001)
- .credentialRef("smoke")
- .marketplaceZone("America/Los_Angeles")
- .currency("USD")
- .build();
- }
-
- /** 打印真实请求与响应,签名/字段名不对时靠这个定位。Authorization 只打指纹。 */
- static final class LoggingTransport implements HttpTransport {
-
- private static final int MAX_BODY = 2000;
-
- private final HttpTransport delegate;
-
- LoggingTransport(HttpTransport delegate) {
- this.delegate = delegate;
- }
-
- @Override
- public HttpResponse execute(HttpRequest request) {
- System.out.println("--> " + request.method() + " " + request.url());
- System.out.println(" headers " + mask(request.headers().toString()));
- System.out.println(" body " + truncate(request.body()));
- HttpResponse response = delegate.execute(request);
- System.out.println("<-- " + response.statusCode() + " (" + response.latencyMillis() + " ms) "
- + truncate(response.body()));
- return response;
- }
-
- private static String mask(String headers) {
- return headers.replaceAll("(?i)(bearer\\s+)[^,\\]]+", "$1***");
- }
-
- private static String truncate(String body) {
- if (body == null) {
- return "null";
- }
- return body.length() <= MAX_BODY ? body : body.substring(0, MAX_BODY) + "...(" + body.length() + " chars)";
- }
- }
-}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java
deleted file mode 100644
index 2e5d9df..0000000
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/AmazonScProductLiveTest.java
+++ /dev/null
@@ -1,229 +0,0 @@
-package common.ecommerce.lingxing.platform.amazon.sc;
-
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
-import common.ecommerce.http.HttpRequest;
-import common.ecommerce.http.HttpResponse;
-import common.ecommerce.http.HttpTransport;
-import common.ecommerce.http.JacksonJsonCodec;
-import common.ecommerce.http.OkHttpTransport;
-import common.ecommerce.lingxing.LingxingConstants;
-import common.ecommerce.lingxing.adapter.LingxingAdapter;
-import common.ecommerce.model.ChannelProvider;
-import common.ecommerce.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
-import common.ecommerce.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
-import org.junit.jupiter.api.Test;
-
-import java.time.Clock;
-import java.time.Duration;
-import java.time.Instant;
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.assertFalse;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-
-/**
- * 领星 · 亚马逊 SC 真实环境测试:先查店铺列表拿 sid,再用 sid 拉 Listing。
- *
- * 跑之前填 APP_KEY / APP_SECRET 即可;SID 留空时会自动从店铺列表取第一个。
- *
- * mvn -pl lingxing -am test -Dtest=AmazonScProductLiveTest
- *
- *
- * 调用前确认出口 IP 已加入领星白名单。本类只用于联调,不要把真实凭证提交到仓库。
- *
- * 两个接口的令牌桶容量都是 1,且按「账户 + path」共享,必须串行调用。
- */
-class AmazonScProductLiveTest {
-
- // ==================== 填写这里 ====================
- /** 领星 ERP 开放接口的 AppID。 */
- private static final String APP_KEY = "ak_MWoHJz2tcIwKF";
- /** 领星 ERP 开放接口的 AppSecret。 */
- private static final String APP_SECRET = "YOUkd5efWJSK71jLvDyz+g==";
- /**
- * 亚马逊店铺的领星 sid。
- * 留空则自动调用店铺列表接口,取第一个正常状态的店铺。
- */
- private static final String SID = "13839";
- // ================================================
-
- private static final String BASE_URL = LingxingConstants.PRODUCTION_BASE_URL;
-
- private final JacksonJsonCodec json = new JacksonJsonCodec();
- private final LoggingTransport transport =
- new LoggingTransport(new OkHttpTransport("common-ecommerce-smoke"));
-
- /**
- * 店铺列表:一次性返回企业已授权到领星的全部亚马逊 SC 店铺。
- *
- * 接口 {@code GET /erp/sc/data/seller/lists},非分页。打印每个店铺的 sid 与名称,
- * 同时打印请求与响应原始报文(见 LoggingTransport),便于核对字段名。
- */
- @Test
- void listsAmazonShops() {
- requireConfigured();
-
- List channels = adapter().listSubChannels(shopListContext());
- System.out.println("[shops] subChannels size=" + channels.size());
- for (SubChannel c : channels) {
- System.out.println(" platformCode=" + c.platformCode()
- + " sid=" + c.externalStoreId()
- + " platform=" + c.platform()
- + " name=" + c.name());
- }
- assertNotNull(channels);
- }
-
- /** 拿第一个正常店铺的 sid,调 Listing 接口。 */
- @Test
- void pullsOnePageOfListings() {
- requireConfigured();
-
- String sid = resolveSid();
- System.out.println("[listings] 使用 sid=" + sid);
-
- ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(),
- "smoke-" + System.currentTimeMillis(), Clock.systemUTC());
-
- Instant to = Instant.now();
- Instant from = to.minus(Duration.ofDays(7));
-
- Page page = adapter().pull(ctx, ProductQuery.builder()
- .updatedAfter(from)
- .updatedBefore(to)
- .pageSize(20)
- .build());
-
- System.out.println("[listings] window=" + from + " .. " + to
- + " items=" + page.size() + " nextCursor=" + page.nextCursor());
- for (ProductListing p : page.items()) {
- System.out.println(" sku=" + p.platformSku()
- + " title=" + p.title()
- + " status=" + p.status()
- + " images=" + p.imageUrls().size()
- + " updatedAt=" + (p.updatedAt() == null ? null : p.updatedAt().utc()));
- }
- assertFalse(page.size() > 20, "pageSize 未被平台遵守");
- }
-
- /** 不带时间窗,确认默认分页与解析也能走通。 */
- @Test
- void pullsFirstPageWithoutTimeWindow() {
- requireConfigured();
-
- String sid = resolveSid();
- ChannelContext ctx = ChannelContext.of(amazonAccount(sid), connection(),
- "smoke-" + System.currentTimeMillis(), Clock.systemUTC());
-
- Page page = adapter().pull(ctx, ProductQuery.builder().pageSize(10).build());
-
- System.out.println("[listings/no-window] sid=" + sid + " items=" + page.size()
- + " nextCursor=" + page.nextCursor());
- for (ProductListing p : page.items()) {
- System.out.println(" sku=" + p.platformSku() + " status=" + p.status());
- }
- // 店铺可能没有商品,空列表也算通过
- assertNotNull(page);
- }
-
- // ---------------------------------------------------------------- helpers
-
- private static void requireConfigured() {
- org.junit.jupiter.api.Assumptions.assumeTrue(
- !APP_KEY.startsWith("在这里填") && !APP_SECRET.startsWith("在这里填"),
- "请先填写 AmazonScProductLiveTest 顶部的 APP_KEY / APP_SECRET");
- }
-
- /** 优先用常量里的 SID;留空则从店铺列表取第一个。 */
- private String resolveSid() {
- if (SID != null && !SID.trim().isEmpty() && !SID.startsWith("在这里填")) {
- return SID.trim();
- }
- List channels = adapter().listSubChannels(shopListContext());
- if (channels.isEmpty()) {
- throw new AssertionError("店铺列表为空:该企业没有已授权且状态正常的亚马逊 SC 店铺");
- }
- return channels.get(0).externalStoreId();
- }
-
- private LingxingAdapter adapter() {
- return new LingxingAdapter(transport, json,
- new InMemoryTokenStore(), new InMemoryLockProvider(), Clock.systemUTC());
- }
-
- private ChannelConnection connection() {
- return ChannelConnection.of(BASE_URL, ChannelSecret.builder()
- .appKey(APP_KEY).appSecret(APP_SECRET).build());
- }
-
- /** 店铺列表所用的上下文:店铺维度此时还不存在,用占位 omsStoreId。 */
- private ChannelContext shopListContext() {
- return ChannelContext.of(placeholderAccount(), connection(),
- "smoke-shops-" + System.currentTimeMillis(), Clock.systemUTC());
- }
-
- private ChannelAccount placeholderAccount() {
- return ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-discovery"))
- .externalStoreId("discovery")
- .platformCode(10001)
- .credentialRef("smoke")
- .marketplaceZone("America/Los_Angeles")
- .currency("USD")
- .build();
- }
-
- private ChannelAccount amazonAccount(String sid) {
- return ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-smoke"))
- .externalStoreId(sid)
- .platformCode(10001)
- .credentialRef("smoke")
- .marketplaceZone("America/Los_Angeles")
- .currency("USD")
- .build();
- }
-
- /** 打印真实请求与响应,签名/字段名不对时靠这个定位。Authorization 只打指纹。 */
- static final class LoggingTransport implements HttpTransport {
-
- private static final int MAX_BODY = 2000;
-
- private final HttpTransport delegate;
-
- LoggingTransport(HttpTransport delegate) {
- this.delegate = delegate;
- }
-
- @Override
- public HttpResponse execute(HttpRequest request) {
- System.out.println("--> " + request.method() + " " + request.url());
- System.out.println(" headers " + mask(request.headers().toString()));
- System.out.println(" body " + truncate(request.body()));
- HttpResponse response = delegate.execute(request);
- System.out.println("<-- " + response.statusCode() + " (" + response.latencyMillis() + " ms) "
- + truncate(response.body()));
- return response;
- }
-
- private static String mask(String headers) {
- return headers.replaceAll("(?i)(bearer\\s+)[^,\\]]+", "$1***");
- }
-
- private static String truncate(String body) {
- if (body == null) {
- return "null";
- }
- return body.length() <= MAX_BODY ? body : body.substring(0, MAX_BODY) + "...(" + body.length() + " chars)";
- }
- }
-}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
new file mode 100644
index 0000000..d109bc3
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
@@ -0,0 +1,75 @@
+package common.ecommerce.lingxing.platform.amazon.sc.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/**
+ * 亚马逊 SC 在线商品。
+ *
+ * 搜索字段是字符串(seller_sku / sku),搜索值是数组 + exact_search 开关,
+ * 与其它平台的数字枚举不同。
+ */
+class AmazonScProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_AMAZON_SC.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/amazonScListing/success.json")));
+
+ @Test
+ void platformSkuSearchUsesStringFieldAndExactSwitch() {
+ new AmazonScProductSource().products(call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ ProductQuery.builder()
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValue("AMZ-MSKU-1")
+ .build());
+
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"sid\":\"1099\"");
+ assertBodyContains(body, "\"search_field\":\"seller_sku\"");
+ // 单值模糊:数组 + exact_search=0
+ assertBodyContains(body, "\"search_value\":[\"AMZ-MSKU-1\"]");
+ assertBodyContains(body, "\"exact_search\":0");
+ }
+
+ @Test
+ void multiValueSearchUsesExactSwitch() {
+ new AmazonScProductSource().products(call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ ProductQuery.builder()
+ .searchField(ProductSearchField.LOCAL_SKU)
+ .searchValues(java.util.Arrays.asList("A", "B"))
+ .build());
+
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"search_field\":\"sku\"");
+ assertBodyContains(body, "\"search_value\":[\"A\",\"B\"]");
+ assertBodyContains(body, "\"exact_search\":1");
+ }
+
+ @Test
+ void mapsResponse() {
+ ProductListing p = new AmazonScProductSource().products(
+ call(transport, account(Platform.AMAZON_SC, 10001, "1099")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.AMAZON_SC, p.platform());
+ assertEquals("AMZ-MSKU-1", p.platformSku());
+ assertEquals("Amazon Item", p.title());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("USD", p.currency());
+ assertEquals("29.99", p.price().amount().toPlainString());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
new file mode 100644
index 0000000..b0ed2c8
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
@@ -0,0 +1,60 @@
+package common.ecommerce.lingxing.platform.amazon.vc.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+
+/** 亚马逊 VC 在线商品:请求构造 + 响应映射;不支持搜索。 */
+class AmazonVcProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_AMAZON_VC.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/amazonVcListing/success.json")));
+
+ @Test
+ void requestCarriesVcStoreIds() {
+ new AmazonVcProductSource().products(call(transport, account(Platform.AMAZON_VC, 10035, "1342")),
+ ProductQuery.builder().pageSize(20).build());
+
+ assertBodyContains(lastBody(transport), "\"vc_store_ids\":[\"1342\"]");
+ assertBodyContains(lastBody(transport), "\"length\":20");
+ }
+
+ @Test
+ void searchUnsupportedFailsLoudly() {
+ assertThrows(UnsupportedOperationException.class,
+ () -> new AmazonVcProductSource().products(
+ call(transport, account(Platform.AMAZON_VC, 10035, "1342")),
+ ProductQuery.builder()
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValue("VC-MSKU-1")
+ .build()));
+ }
+
+ @Test
+ void mapsResponse() {
+ ProductListing p = new AmazonVcProductSource().products(
+ call(transport, account(Platform.AMAZON_VC, 10035, "1342")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.AMAZON_VC, p.platform());
+ assertEquals("VC-MSKU-1", p.platformSku());
+ assertEquals("B0BG2CMB5J", p.asin());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("USD", p.currency());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
new file mode 100644
index 0000000..62e6cd1
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
@@ -0,0 +1,62 @@
+package common.ecommerce.lingxing.platform.ebay.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import java.time.Instant;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+/** eBay 在线商品:请求构造 + 响应映射。 */
+class EbayProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_EBAY.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/ebayListing/success.json")));
+
+ @Test
+ void requestCarriesStoreAndTimeWindow() {
+ new EbayProductSource().products(call(transport, account(Platform.EBAY, 10003, "1106")),
+ ProductQuery.builder()
+ .updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
+ .updatedBefore(Instant.parse("2026-10-08T00:00:00Z"))
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValue("EBAY-MSKU-1")
+ .build());
+
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"store_ids\":[\"1106\"]");
+ assertBodyContains(body, "\"listing_time_field\":1");
+ assertBodyContains(body, "\"searchField\":1");
+ assertBodyContains(body, "\"searchSingleValue\":\"EBAY-MSKU-1\"");
+ }
+
+ @Test
+ void mapsResponseAndStatus() {
+ ProductListing p = new EbayProductSource().products(
+ call(transport, account(Platform.EBAY, 10003, "1106")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.EBAY, p.platform());
+ assertEquals("EBAY-MSKU-1", p.platformSku());
+ assertEquals("123943065211", p.listingId());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("在售", p.rawStatus());
+ // 接口不返回币种 → 金额为空
+ assertNull(p.price());
+ assertNull(p.currency());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
new file mode 100644
index 0000000..f337302
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
@@ -0,0 +1,56 @@
+package common.ecommerce.lingxing.platform.shein.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyNotContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/** SHEIN 在线商品:请求构造 + 响应映射。 */
+class SheinProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_SHEIN.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/sheinListing/success.json")));
+
+ @Test
+ void requestCarriesStoreAndSearch() {
+ new SheinProductSource().products(call(transport, account(Platform.SHEIN, 10028, "1105")),
+ ProductQuery.builder()
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValue("SHEIN-MSKU-1")
+ .build());
+
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"storeIds\":[\"1105\"]");
+ assertBodyContains(body, "\"searchField\":9");
+ assertBodyContains(body, "\"searchSingleValue\":\"SHEIN-MSKU-1\"");
+ // 该接口没有时间窗参数
+ assertBodyNotContains(body, "updateStartTime");
+ }
+
+ @Test
+ void mapsResponseWithSalePrice() {
+ ProductListing p = new SheinProductSource().products(
+ call(transport, account(Platform.SHEIN, 10028, "1105")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.SHEIN, p.platform());
+ assertEquals("SHEIN-MSKU-1", p.platformSku());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("USD", p.currency());
+ assertEquals("19.8", p.price().amount().toPlainString());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
new file mode 100644
index 0000000..88321a7
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
@@ -0,0 +1,67 @@
+package common.ecommerce.lingxing.platform.temu.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import java.util.Arrays;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+/** Temu 在线商品:请求构造 + 响应映射。 */
+class TemuProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_TEMU.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/temuListing/success.json")));
+
+ @Test
+ void requestUsesCursorFalseAndPagedBody() {
+ new TemuProductSource().products(call(transport, account(Platform.TEMU, 10024, "1105")),
+ ProductQuery.builder().pageSize(30)
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValues(Arrays.asList("A", "B"))
+ .build());
+
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"useCursor\":false");
+ assertBodyContains(body, "\"storeIds\":[\"1105\"]");
+ assertBodyContains(body, "\"length\":30");
+ // Temu 的平台 SKU 是 9
+ assertBodyContains(body, "\"searchField\":9");
+ assertBodyContains(body, "\"searchValues\":[\"A\",\"B\"]");
+ }
+
+ @Test
+ void localSkuUsesField8() {
+ new TemuProductSource().products(call(transport, account(Platform.TEMU, 10024, "1105")),
+ ProductQuery.builder().searchField(ProductSearchField.LOCAL_SKU).searchValue("x").build());
+ assertBodyContains(lastBody(transport), "\"searchField\":8");
+ }
+
+ @Test
+ void mapsResponseToUnifiedModel() {
+ ProductListing p = new TemuProductSource().products(
+ call(transport, account(Platform.TEMU, 10024, "1105")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.TEMU, p.platform());
+ assertEquals("TEMU-MSKU-1", p.platformSku());
+ assertEquals("Temu Item", p.title());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ // Temu 商品接口没有独立价格字段,金额为空
+ assertNull(p.price());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
new file mode 100644
index 0000000..14dd72f
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
@@ -0,0 +1,49 @@
+package common.ecommerce.lingxing.platform.tiktok.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+
+/** TikTok 在线商品:请求构造 + 响应映射。 */
+class TiktokProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_TIKTOK.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/tiktokListing/success.json")));
+
+ @Test
+ void requestCarriesStore() {
+ new TiktokProductSource().products(call(transport, account(Platform.TIKTOK, 10011, "1104")),
+ ProductQuery.builder().pageSize(20).build());
+
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"storeIds\":[\"1104\"]");
+ assertBodyContains(body, "\"length\":20");
+ }
+
+ @Test
+ void mapsPlatformStatusString() {
+ ProductListing p = new TiktokProductSource().products(
+ call(transport, account(Platform.TIKTOK, 10011, "1104")),
+ ProductQuery.builder().build()).items().get(0);
+
+ assertEquals(Platform.TIKTOK, p.platform());
+ assertEquals("TT-MSKU-1", p.platformSku());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("ACTIVATE", p.rawStatus());
+ assertEquals("USD", p.currency());
+ assertEquals("117.50", p.price().amount().toPlainString());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
new file mode 100644
index 0000000..72497e3
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
@@ -0,0 +1,85 @@
+package common.ecommerce.lingxing.platform.walmart.product;
+
+import common.ecommerce.lingxing.LingxingApi;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.model.support.Page;
+import common.ecommerce.testkit.JsonFixture;
+import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.testkit.Responses;
+import org.junit.jupiter.api.Test;
+
+import java.time.Instant;
+
+import static common.ecommerce.lingxing.support.LingxingTestSupport.ENDPOINT;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertBodyContains;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.assertUrlStartsWith;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.call;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastBody;
+import static common.ecommerce.lingxing.support.LingxingTestSupport.lastUrl;
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+
+/** 沃尔玛在线商品:请求构造 + 响应映射。 */
+class WalmartProductSourceTest {
+
+ private final RecordingTransport transport = RecordingTransport.create()
+ .route(LingxingApi.LISTING_WALMART.path(),
+ r -> Responses.ok(JsonFixture.load("fixtures/lingxing/walmartListing/success.json")));
+
+ @Test
+ void requestCarriesStoreTimeWindowAndSearch() {
+ new WalmartProductSource().products(call(transport, account(Platform.WALMART_SC, 10008, "1108")),
+ ProductQuery.builder()
+ .updatedAfter(Instant.parse("2026-10-01T00:00:00Z"))
+ .updatedBefore(Instant.parse("2026-10-08T00:00:00Z"))
+ .pageSize(50)
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValue("WM-MSKU-1")
+ .build());
+
+ assertUrlStartsWith(lastUrl(transport), ENDPOINT + LingxingApi.LISTING_WALMART.path());
+ String body = lastBody(transport);
+ assertBodyContains(body, "\"store_ids\":[\"1108\"]");
+ assertBodyContains(body, "\"offset\":0");
+ assertBodyContains(body, "\"length\":50");
+ assertBodyContains(body, "\"listing_time_field\":2");
+ assertBodyContains(body, "\"listing_start_time\":\"2026-10-01\"");
+ assertBodyContains(body, "\"searchField\":1");
+ assertBodyContains(body, "\"searchSingleValue\":\"WM-MSKU-1\"");
+ }
+
+ @Test
+ void localSkuSearchUsesField3() {
+ new WalmartProductSource().products(call(transport, account(Platform.WALMART_SC, 10008, "1108")),
+ ProductQuery.builder()
+ .searchField(ProductSearchField.LOCAL_SKU)
+ .searchValue("WM-LOCAL-1")
+ .build());
+
+ assertBodyContains(lastBody(transport), "\"searchField\":3");
+ }
+
+ @Test
+ void mapsResponseToUnifiedModel() {
+ Page page = new WalmartProductSource().products(
+ call(transport, account(Platform.WALMART_SC, 10008, "1108")),
+ ProductQuery.builder().build());
+
+ assertEquals(1, page.size());
+ ProductListing p = page.items().get(0);
+ assertEquals(Platform.WALMART_SC, p.platform());
+ assertEquals("WM-MSKU-1", p.platformSku());
+ assertEquals("Walmart Item", p.title());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("PUBLISHED", p.rawStatus());
+ assertEquals("USD", p.currency());
+ assertEquals("139.90", p.price().amount().toPlainString());
+ assertEquals("00723849594300", p.gtin());
+ assertNull(page.nextCursor());
+ }
+}
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
index d6e49b7..a9f1e79 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
@@ -19,6 +19,7 @@ import common.ecommerce.spi.AccessToken;
import common.ecommerce.spi.ChannelSecret;
import org.junit.jupiter.api.Assumptions;
import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIfSystemProperty;
import java.time.Clock;
import java.util.ArrayList;
@@ -30,6 +31,8 @@ import java.util.Map;
/**
* 只读探针:实测各平台商品列表接口的 {@code searchField} 枚举值含义。
*
+ * 默认跳过;用 {@code -Dlingxing.probe=true} 显式开启。
+ *
* 只做查询,不创建、不修改任何数据。
*
* 用法:填好下面四个常量后运行
@@ -41,6 +44,7 @@ import java.util.Map;
* 命中时返回的是 {@code msku} 还是 {@code sku}。
* 拿到结果后再去写正式的平台映射表。
*/
+@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true")
class SearchFieldProbeTest {
// ==================== 填写这里 ====================
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
index a3091a9..c94977a 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
@@ -21,6 +21,7 @@ import common.ecommerce.spi.AccessToken;
import common.ecommerce.spi.ChannelSecret;
import org.junit.jupiter.api.Assumptions;
import org.junit.jupiter.api.Test;
+import org.junit.jupiter.api.condition.EnabledIfSystemProperty;
import java.time.Clock;
import java.util.ArrayList;
@@ -36,6 +37,8 @@ import java.util.TreeMap;
* 用途:文档里没有 AliExpress 的 platform_code,
* 这个测试直接从店铺列表接口读出来。
*
+ * 默认跳过;用 {@code -Dlingxing.probe=true} 显式开启。
+ *
* 只做查询,不创建、不修改数据。
*
* 用法:填好 APP_KEY / APP_SECRET,然后
@@ -53,6 +56,7 @@ import java.util.TreeMap;
* ...
*
*/
+@EnabledIfSystemProperty(named = "lingxing.probe", matches = "true")
class ShopListProbeTest {
// ==================== 填写这里 ====================
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java b/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
new file mode 100644
index 0000000..5b4abde
--- /dev/null
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
@@ -0,0 +1,122 @@
+package common.ecommerce.lingxing.support;
+
+import common.ecommerce.http.JacksonJsonCodec;
+import common.ecommerce.lingxing.LingxingConstants;
+import common.ecommerce.lingxing.auth.LingxingTokenClient;
+import common.ecommerce.lingxing.http.LingxingRateLimiter;
+import common.ecommerce.lingxing.http.LingxingRequestFactory;
+import common.ecommerce.lingxing.platform.LingxingCall;
+import common.ecommerce.model.ChannelProvider;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.account.AccountKey;
+import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.sdk.ChannelConnection;
+import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.spi.AccessToken;
+import common.ecommerce.spi.ChannelSecret;
+import common.ecommerce.testkit.RecordingTransport;
+
+import java.time.Clock;
+import java.time.Instant;
+import java.time.ZoneOffset;
+
+/**
+ * 领星测试的公共样板:固定时钟、固定账户、组装 {@link LingxingCall}。
+ *
+ * 各平台的契约测试只需要关心「请求怎么拼」和「响应怎么映射」,
+ * 不用重复写 token、签名、限流的装配。
+ */
+public final class LingxingTestSupport {
+
+ /**
+ * 领星 appId 同时作为签名 AES 密钥,长度必须是 16/24/32 字节,
+ * 所以测试值固定 16 个字符。
+ */
+ public static final String APP_KEY = "test-app-id-1234";
+
+ public static final String APP_SECRET = "test-app-secret";
+
+ public static final String ENDPOINT = LingxingConstants.PRODUCTION_BASE_URL;
+
+ public static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-04T00:00:00Z"), ZoneOffset.UTC);
+
+ private static final JacksonJsonCodec JSON = new JacksonJsonCodec();
+
+ private LingxingTestSupport() {
+ }
+
+ /** 亚马逊 SC 账户;其它平台用 {@link #account(Platform, int, String)}。 */
+ public static ChannelAccount amazonScAccount() {
+ return account(Platform.AMAZON_SC, 10001, "1099");
+ }
+
+ /**
+ * @param platform 业务平台(与 AccountKey 的 platform 一致)
+ * @param platformCode 领星 platform_code;为 0 时不设置
+ * @param storeId 领星 store_id;为空时不设置
+ */
+ public static ChannelAccount account(Platform platform, int platformCode, String storeId) {
+ return ChannelAccount.builder()
+ .key(AccountKey.of(ChannelProvider.LINGXING, platform, "oms-" + platform.name().toLowerCase()))
+ .externalStoreId(storeId == null || storeId.trim().isEmpty() ? "probe" : storeId)
+ .platformCode(platformCode == 0 ? null : platformCode)
+ .credentialRef("test")
+ .marketplaceZone("America/Los_Angeles")
+ .currency("USD")
+ .build();
+ }
+
+ /**
+ * 组装一次调用的上下文,并先换一次 token。
+ *
+ * token 请求走 {@link RecordingTransport} 的默认响应,不占业务路由。
+ */
+ public static LingxingCall call(RecordingTransport transport, ChannelAccount account) {
+ ChannelSecret secret = ChannelSecret.builder().appKey(APP_KEY).appSecret(APP_SECRET).build();
+ ChannelConnection conn = ChannelConnection.of(ENDPOINT, secret);
+ ChannelContext ctx = ChannelContext.of(account, conn, "req-1", CLOCK);
+ AccessToken token = new LingxingTokenClient(transport, JSON, CLOCK)
+ .fetch(ENDPOINT, APP_KEY, APP_SECRET);
+ return new LingxingCall(ctx, token, new LingxingRequestFactory(JSON, CLOCK),
+ new LingxingRateLimiter(), JSON, transport);
+ }
+
+ /** 取最后一次业务请求的请求体;没有业务请求时报错。 */
+ public static String lastBody(RecordingTransport transport) {
+ common.ecommerce.http.HttpRequest req = transport.lastDataRequest();
+ if (req == null) {
+ throw new AssertionError("no data request was made");
+ }
+ return req.body();
+ }
+
+ /** 取最后一次业务请求的 URL。 */
+ public static String lastUrl(RecordingTransport transport) {
+ common.ecommerce.http.HttpRequest req = transport.lastDataRequest();
+ if (req == null) {
+ throw new AssertionError("no data request was made");
+ }
+ return req.url();
+ }
+
+ /** 断言 JSON 体包含某片段。 */
+ public static void assertBodyContains(String body, String snippet) {
+ if (!body.contains(snippet)) {
+ throw new AssertionError("期望请求体包含 " + snippet + ",实际:" + body);
+ }
+ }
+
+ /** 断言请求体不包含某片段。 */
+ public static void assertBodyNotContains(String body, String snippet) {
+ if (body.contains(snippet)) {
+ throw new AssertionError("期望请求体不包含 " + snippet + ",实际:" + body);
+ }
+ }
+
+ /** 断言 URL 以某路径开头。 */
+ public static void assertUrlStartsWith(String url, String prefix) {
+ if (!url.startsWith(prefix)) {
+ throw new AssertionError("期望 URL 以 " + prefix + " 开头,实际:" + url);
+ }
+ }
+}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json
new file mode 100644
index 0000000..ace60ed
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/aliexpressListing/success.json
@@ -0,0 +1,8 @@
+{"code":0,"data":{"count":1,"list":[{
+ "id":100001,"productUniqueId":1234567890,"msku":"AE-MSKU-1","sku":"AE-LOCAL-1",
+ "pname":"品名","title":"AliExpress Item","productId":"32987654321","itemId":"ITEM1",
+ "status":2,"statusName":"可售","currencyCode":"USD","effectiveSupplyPrice":"59.99",
+ "price":5999,"storeId":8888,"storeName":"AE 测试店","platformCode":"aliexpress",
+ "createTime":"2024-01-15 10:30:00","imageUrls":"https://img/ae.jpg",
+ "supplyPriceList":[{"beginStr":"2024-01-01","currency":"USD","endStr":null,"price":49.99}]
+}]}}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json
new file mode 100644
index 0000000..2d4d077
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/amazonScListing/success.json
@@ -0,0 +1,7 @@
+{"code":0,"message":"success","total":1,"data":[{
+ "sid":1099,"seller_sku":"AMZ-MSKU-1","asin":"B0B4WP82XX","parent_asin":"B0B4WP82XX",
+ "item_name":"Amazon Item","small_image_url":"https://img/amz.jpg","status":1,"is_delete":0,
+ "currency_code":"USD","price":"29.99","listing_update_date":"2023-06-28 17:44:14",
+ "listing_id":"0623ZI1F5EF11","local_sku":"AMZ-LOCAL-1","local_name":"品名",
+ "fulfillment_channel_type":"FBM","marketplace":"美国"
+}]}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json
new file mode 100644
index 0000000..5a279ba
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/amazonVcListing/success.json
@@ -0,0 +1,6 @@
+{"code":0,"message":"success","total":1,"data":[{
+ "vc_store_id":"134225003201380864","small_min_image_url":"https://img/vc.jpg",
+ "asin":"B0BG2CMB5J","msku":"VC-MSKU-1","item_name":"VC Item","parent_asin":"",
+ "local_sku":"VC-LOCAL-1","local_name":"品名","status":1,"price":"123",
+ "price_currency_icon":"$","on_sale_time":"1970-01-01"
+}]}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json
new file mode 100644
index 0000000..ec40250
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/ebayListing/success.json
@@ -0,0 +1,10 @@
+{"code":0,"message":"success","total":1,"data":[{
+ "item_url":"https://www.ebay.com/itm/353943065214","picture_url":"https://img/ebay.jpg",
+ "item_id":"123943065211","msku":"EBAY-MSKU-1","attribute":"Black/Regular/S",
+ "title":"Cotton T Shirt","local_name":null,"local_sku":"EBAY-LOCAL-1",
+ "listing_status":1,"listing_status_name":"在售","store_id":"1106","store_name":"EBA 测试店",
+ "site_code":"10003-US","site_name":"美国","listing_type":3,"listing_type_name":"多属性",
+ "price":"0.99","start_price":"0.00","accept_price":"0.00","quantity":1,
+ "location":"Shenzhen","dispatch_time_max":20,
+ "listing_start_time":"2022-03-07 14:41:01","listing_end_time":"2022-04-03 14:41:01"
+}]}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json
new file mode 100644
index 0000000..f3de494
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/sheinListing/success.json
@@ -0,0 +1,7 @@
+{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{
+ "id":"145","productUniqueId":"901458096084689408","storeId":"1105","storeName":"SHEIN 测试店",
+ "platformCode":"10028","mskuId":"m-1","msku":"SHEIN-MSKU-1","pname":"品名","sku":"SHEIN-LOCAL-1",
+ "pid":"5761","title":"SHEIN Item","cid":"12","bid":"10","status":1,
+ "imgUrl":"https://img/shein.jpg","skc":"SKC","spu":"SPU","attribute":"白色",
+ "salePrice":19.8,"saleCurrency":"$","inventoryQuantity":50,"usableInventory":5
+}]}}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json
new file mode 100644
index 0000000..876a4f1
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/targetListing/success.json
@@ -0,0 +1,10 @@
+{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{
+ "item_id":"6768632430804","item_url":"","product_unique_id":"9012162617856",
+ "variant_unique_id":"9019162671616","company_id":"9011","parent_picture_url":"",
+ "picture_url":"https://img/target.jpg","parent_msku":null,"msku":"TGT-MSKU-1",
+ "parent_attribute":"Size","attribute":"EU / Blue","title":"Target Item",
+ "local_sku":"TGT-LOCAL-1","pid":null,"local_name":"本地品名","store_id":"1106",
+ "store_name":"Target 测试店","price":"27.99","quantity":"17","currency_icon":"$",
+ "has_variant":false,"listing_start_time":"2021-09-10 15:40:51",
+ "listing_end_time":"2022-04-12 11:46:56","status":1,"status_name":"active"
+}]}}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json
new file mode 100644
index 0000000..3673ada
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/temuListing/success.json
@@ -0,0 +1,11 @@
+{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{
+ "id":"11","productUniqueId":"901457813888","storeId":"1105","storeName":"TEMU 测试店",
+ "platformCode":"10024","mskuId":"2712","msku":"TEMU-MSKU-1","pname":"品名","pmsku":"P-1",
+ "sku":"TEMU-LOCAL-1","pid":"5858","title":"Temu Item","cid":"16","bid":"1",
+ "status":2,"attribute":"红色","jitMode":2,"catName":"项链","selectStatus":"12",
+ "virtualQuantity":150,"bname":"品牌","cname":"分类","imgUrl":"https://img/temu.jpg",
+ "skcId":"2024","skc":"SKC-1","spuId":"2528",
+ "supplyPriceList":[{"price":77,"currency":"$","beginStr":"2024-08-07","endStr":null}],
+ "promotionalPriceDataList":[{"activeStatus":"2","activeType":"限时促销","currency":"USD",
+ "promotionalPrice":"69.00","result":"2","uniqueId":"a-1"}]
+}]}}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json
new file mode 100644
index 0000000..2ff347e
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/tiktokListing/success.json
@@ -0,0 +1,7 @@
+{"code":0,"message":"success","total":0,"data":{"count":1,"list":[{
+ "id":"6","productUniqueId":"901457808378","storeId":"1104","storeName":"TikTok 测试店",
+ "platformCode":"10011","mskuId":"10002","msku":"TT-MSKU-1","pname":"品名","sku":"TT-LOCAL-1",
+ "pid":"5793","title":"TikTok Item","cid":"8","bid":"8","imgUrl":"https://img/tt.jpg",
+ "spu":"1729","spuId":"1729","platformStatus":"ACTIVATE","categoryName":"分类",
+ "usableInventory":101,"siteCode":"US","salesPrice":"117.50","currency":"$"
+}]}}
diff --git a/lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json b/lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json
new file mode 100644
index 0000000..bc974db
--- /dev/null
+++ b/lingxing/src/test/resources/fixtures/lingxing/walmartListing/success.json
@@ -0,0 +1,10 @@
+{"code":0,"message":"success","total":1,"data":{"list":[{
+ "item_id":"wal-1","item_url":"https://www.walmart.com/ip/1","picture_url":"https://img/1.jpg",
+ "msku":"WM-MSKU-1","title":"Walmart Item","local_name":"本地品名","local_sku":"WM-LOCAL-1",
+ "status_name":"PUBLISHED","store_id":"1108","store_name":"WMT 测试店",
+ "currency_icon":"$","price":"139.90","available_quantity":12,"wfs_available_quantity":32,
+ "gtin":"00723849594300","upc":"723849594300","brand":"FBsport",
+ "fulfillment_type":2,"fulfillment_type_name":"Seller Fulfilled",
+ "listing_start_time":"2021-03-25 00:00:00","listing_end_time":"2022-02-23 00:00:00",
+ "variant_unique_id":"901209431054963712"
+}]}}
diff --git a/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java b/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java
index 1b618f7..147cc48 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java
+++ b/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java
@@ -1,10 +1,14 @@
package common.ecommerce.testkit;
+import common.ecommerce.capability.AfterSaleCapable;
import common.ecommerce.capability.ProductCapable;
import common.ecommerce.capability.SalesOrderCapable;
import common.ecommerce.error.ChannelException;
import common.ecommerce.model.account.AccountKey;
import common.ecommerce.model.Capability;
+import common.ecommerce.model.aftersale.AfterSale;
+import common.ecommerce.model.aftersale.AfterSaleQuery;
+import common.ecommerce.model.aftersale.AfterSaleType;
import common.ecommerce.model.account.ChannelAccount;
import common.ecommerce.model.ChannelProvider;
import common.ecommerce.model.support.Money;
@@ -44,7 +48,7 @@ import java.util.Set;
* .build();
*
*/
-public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapable {
+public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapable, AfterSaleCapable {
/** 游标格式:{@code item:序号},仅用于测试分页。 */
private static final String CURSOR_PREFIX = "item:";
@@ -54,6 +58,7 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
private final EnumSet capabilities;
private final List orders;
private final List products;
+ private final List afterSales;
private final int pageSize;
private final List orderQueries = new ArrayList();
private final List productQueries = new ArrayList();
@@ -65,6 +70,7 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
this.capabilities = b.capabilities;
this.orders = b.orders;
this.products = b.products;
+ this.afterSales = b.afterSales;
this.pageSize = b.pageSize;
}
@@ -150,6 +156,12 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
return null;
}
+ @Override
+ public Page pull(ChannelContext ctx, AfterSaleQuery query) {
+ requireCapability(Capability.RETURNS);
+ return slice(afterSales, query.cursor());
+ }
+
/** 模拟一次写操作,如标发;带 IdempotencyGuard 的测试用它确认平台只被真正调用一次。 */
public String markShipped(String packageId, String trackingNumber) {
writeCalls.add(packageId + ':' + trackingNumber);
@@ -229,9 +241,11 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
private String adapterId = "fake-direct";
private Platform platform = Platform.WALMART_SC;
- private EnumSet capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT);
+ private EnumSet capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT,
+ Capability.RETURNS);
private List orders = new ArrayList();
private List products = new ArrayList();
+ private List afterSales = new ArrayList();
private int pageSize = 100;
public Builder adapterId(String adapterId) {
@@ -276,6 +290,27 @@ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapabl
return this;
}
+ /** 生成 count 条售后行,类型在退款/退货/换货之间轮转。 */
+ public Builder afterSales(int count) {
+ this.afterSales = new ArrayList(count);
+ AfterSaleType[] types = AfterSaleType.values();
+ for (int i = 1; i <= count; i++) {
+ AfterSaleType type = types[(i - 1) % 3];
+ this.afterSales.add(AfterSale.builder()
+ .platform(platform)
+ .omsStoreId("oms-test-001")
+ .afterSaleId("AS-" + i)
+ .channelOrderId("FAKE-" + i)
+ .type(type)
+ .rawType(type.name())
+ .quantity(1)
+ .platformSku("SKU-" + i)
+ .sourceProvider(ChannelProvider.DIRECT)
+ .build());
+ }
+ return this;
+ }
+
public Builder pageSize(int pageSize) {
if (pageSize <= 0) {
throw new IllegalArgumentException("pageSize must be positive");
diff --git a/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java b/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java
new file mode 100644
index 0000000..6f82274
--- /dev/null
+++ b/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java
@@ -0,0 +1,38 @@
+package common.ecommerce.testkit;
+
+import java.io.ByteArrayOutputStream;
+import java.io.InputStream;
+
+/**
+ * 夹具加载:从 classpath 读一个 UTF-8 文本文件。
+ *
+ *
+ * String json = JsonFixture.load("fixtures/lingxing/orderList/success.json");
+ *
+ *
+ * 路径相对 classpath 根;找不到直接抛异常,不返回空串。
+ */
+public final class JsonFixture {
+
+ private JsonFixture() {
+ }
+
+ public static String load(String path) {
+ String normalized = path.startsWith("/") ? path.substring(1) : path;
+ InputStream in = JsonFixture.class.getClassLoader().getResourceAsStream(normalized);
+ if (in == null) {
+ throw new IllegalStateException("fixture not found: " + normalized);
+ }
+ try (InputStream stream = in) {
+ ByteArrayOutputStream out = new ByteArrayOutputStream();
+ byte[] buf = new byte[4096];
+ int n;
+ while ((n = stream.read(buf)) >= 0) {
+ out.write(buf, 0, n);
+ }
+ return new String(out.toByteArray(), "UTF-8");
+ } catch (Exception e) {
+ throw new IllegalStateException("read fixture failed: " + normalized, e);
+ }
+ }
+}
diff --git a/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java b/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java
new file mode 100644
index 0000000..02f6ecc
--- /dev/null
+++ b/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java
@@ -0,0 +1,108 @@
+package common.ecommerce.testkit;
+
+import common.ecommerce.http.HttpRequest;
+import common.ecommerce.http.HttpResponse;
+import common.ecommerce.http.HttpTransport;
+
+import java.util.ArrayList;
+import java.util.Collections;
+import java.util.LinkedHashMap;
+import java.util.List;
+import java.util.Map;
+import java.util.function.Function;
+
+/**
+ * 录制型传输层:记录每一次请求,按 URL 子串返回编排好的响应。
+ *
+ * 与真实的令牌流程配合:{@code /oauth/access-token} 默认返回一个最小成功响应,
+ * 其它请求走 {@link #route(String, String, Function)} 注册的响应。
+ * 这样一次调用链里的「先换 token、再拉数据」两次请求都能断言到。
+ *
+ * 没有匹配路由时抛 {@link IllegalStateException},不静默返回空响应——
+ * 免得测试断言了一个根本不存在的请求。
+ */
+public final class RecordingTransport implements HttpTransport {
+
+ private static final String TOKEN_PATH = "/oauth/access-token";
+
+ private static final String DEFAULT_TOKEN_BODY =
+ "{\"code\":\"200\",\"msg\":\"OK\",\"data\":{\"access_token\":\"test-token\","
+ + "\"refresh_token\":\"test-refresh\",\"expires_in\":7199}}";
+
+ private final List recorded = new ArrayList();
+ private final List routes = new ArrayList();
+ private String tokenBody = DEFAULT_TOKEN_BODY;
+
+ public static RecordingTransport create() {
+ return new RecordingTransport();
+ }
+
+ /** 覆盖令牌接口的响应体(默认是一个最小成功响应)。 */
+ public RecordingTransport tokenResponse(String body) {
+ this.tokenBody = body;
+ return this;
+ }
+
+ /** 按 URL 子串 + 方法匹配;方法传 null 表示不限制。 */
+ public RecordingTransport route(String urlContains, String method, Function responder) {
+ routes.add(new Route(urlContains, method, responder));
+ return this;
+ }
+
+ public RecordingTransport route(String urlContains, Function responder) {
+ return route(urlContains, null, responder);
+ }
+
+ @Override
+ public HttpResponse execute(HttpRequest request) {
+ recorded.add(request);
+ if (request.url().contains(TOKEN_PATH)) {
+ return HttpResponse.of(200, Collections.emptyMap(), tokenBody, 1);
+ }
+ for (Route r : routes) {
+ if (request.url().contains(r.urlContains)
+ && (r.method == null || r.method.equalsIgnoreCase(request.method()))) {
+ return r.responder.apply(request);
+ }
+ }
+ throw new IllegalStateException("no route for " + request.method() + " " + request.url());
+ }
+
+ public List recorded() {
+ return Collections.unmodifiableList(recorded);
+ }
+
+ /** 除令牌请求外的业务请求,按发生顺序。 */
+ public List dataRequests() {
+ List out = new ArrayList();
+ for (HttpRequest r : recorded) {
+ if (!r.url().contains(TOKEN_PATH)) {
+ out.add(r);
+ }
+ }
+ return out;
+ }
+
+ /** 最后一次业务请求;没有时返回 null。 */
+ public HttpRequest lastDataRequest() {
+ List data = dataRequests();
+ return data.isEmpty() ? null : data.get(data.size() - 1);
+ }
+
+ public void clear() {
+ recorded.clear();
+ }
+
+ private static final class Route {
+
+ private final String urlContains;
+ private final String method;
+ private final Function responder;
+
+ private Route(String urlContains, String method, Function responder) {
+ this.urlContains = urlContains;
+ this.method = method;
+ this.responder = responder;
+ }
+ }
+}
diff --git a/testkit/src/main/java/common/ecommerce/testkit/Responses.java b/testkit/src/main/java/common/ecommerce/testkit/Responses.java
new file mode 100644
index 0000000..db5d5b8
--- /dev/null
+++ b/testkit/src/main/java/common/ecommerce/testkit/Responses.java
@@ -0,0 +1,34 @@
+package common.ecommerce.testkit;
+
+import common.ecommerce.http.HttpResponse;
+
+import java.util.Collections;
+
+/**
+ * 测试用的快捷响应构造。
+ *
+ * 注意与 {@code common.ecommerce.http.Responses} 区分:那个是「状态码 → 异常」的映射,
+ * 这个是「直接造一个响应对象」。
+ */
+public final class Responses {
+
+ private Responses() {
+ }
+
+ public static HttpResponse ok(String body) {
+ return HttpResponse.of(200, Collections.emptyMap(), body, 1);
+ }
+
+ public static HttpResponse status(int code, String body) {
+ return HttpResponse.of(code, Collections.emptyMap(), body, 1);
+ }
+
+ public static HttpResponse withHeaders(int code, java.util.Map headers, String body) {
+ return HttpResponse.of(code, headers, body, 1);
+ }
+
+ public static HttpResponse rateLimited(String retryAfterSeconds) {
+ return HttpResponse.of(429,
+ Collections.singletonMap("Retry-After", retryAfterSeconds), "", 1);
+ }
+}
diff --git a/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java b/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java
new file mode 100644
index 0000000..ffdbcc8
--- /dev/null
+++ b/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java
@@ -0,0 +1,181 @@
+package common.ecommerce.testkit;
+
+import common.ecommerce.capability.CapabilityReport;
+import common.ecommerce.error.ChannelException;
+import common.ecommerce.model.Capability;
+import common.ecommerce.model.ChannelProvider;
+import common.ecommerce.model.Platform;
+import common.ecommerce.model.account.AccountKey;
+import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.model.aftersale.AfterSale;
+import common.ecommerce.model.aftersale.AfterSaleQuery;
+import common.ecommerce.model.aftersale.AfterSaleType;
+import common.ecommerce.model.order.SalesOrder;
+import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.model.product.ProductListing;
+import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.model.support.Page;
+import common.ecommerce.sdk.ChannelConnection;
+import common.ecommerce.sdk.ChannelSdk;
+import common.ecommerce.spi.ChannelSecret;
+import org.junit.jupiter.api.BeforeEach;
+import org.junit.jupiter.api.Test;
+
+import java.time.LocalDate;
+import java.time.ZoneOffset;
+import java.time.Instant;
+import java.time.Clock;
+
+import static org.junit.jupiter.api.Assertions.assertEquals;
+import static org.junit.jupiter.api.Assertions.assertNull;
+import static org.junit.jupiter.api.Assertions.assertThrows;
+import static org.junit.jupiter.api.Assertions.assertTrue;
+
+/**
+ * 从 ChannelSdk 门面调用的完整示例,覆盖商品与售后两条主链路。
+ *
+ * 用 {@link FakeDirectAdapter} 代替真实平台:它实现了同样的能力接口,
+ * 因此这里验证的是门面契约——参数怎么传、能检查什么、失败时抛什么。
+ */
+class SdkFacadeCallTest {
+
+ private static final AccountKey KEY =
+ AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-test-001");
+
+ private static final ChannelConnection CONNECTION = ChannelConnection.of(
+ "https://api.example.com",
+ ChannelSecret.builder().appKey("test-app-id-1234").appSecret("test-secret").build());
+
+ private ChannelSdk sdk;
+
+ @BeforeEach
+ void setUp() {
+ ChannelAccount account = FakeDirectAdapter.account(Platform.WALMART_SC, "oms-test-001");
+ sdk = ChannelSdk.builder()
+ .accountRepository(new InMemoryAccounts().put(account))
+ .clock(Clock.fixed(Instant.parse("2026-11-04T00:00:00Z"), ZoneOffset.UTC))
+ .register(FakeDirectAdapter.builder()
+ .orders(3)
+ .products(3)
+ .afterSales(3)
+ .pageSize(2)
+ .build())
+ .build();
+ }
+
+ // ---------------------------------------------------------------- 商品
+
+ @Test
+ void pullProductsThroughFacade() {
+ Page page = sdk.products(KEY, CONNECTION).pull(
+ ProductQuery.builder().pageSize(2).build());
+
+ assertEquals(2, page.size());
+ ProductListing p = page.items().get(0);
+ assertEquals(Platform.WALMART_SC, p.platform());
+ assertEquals("SKU-1", p.platformSku());
+ assertEquals(ProductStatus.ACTIVE, p.status());
+ assertEquals("oms-test-001", p.omsStoreId());
+ assertEquals(ChannelProvider.DIRECT, p.sourceProvider());
+ assertTrue(page.nextCursor() != null, "3 条数据 pageSize=2,应有下一页");
+ }
+
+ @Test
+ void productPagingByCursor() {
+ ProductQuery query = ProductQuery.builder().pageSize(2).build();
+ Page first = sdk.products(KEY, CONNECTION).pull(query);
+ Page second = sdk.products(KEY, CONNECTION).pull(
+ query.toBuilder().cursor(first.nextCursor()).build());
+
+ assertEquals(1, second.size());
+ assertEquals("SKU-3", second.items().get(0).platformSku());
+ assertNull(second.nextCursor());
+ }
+
+ @Test
+ void productQueryRejectsSearchWithoutField() {
+ assertThrows(IllegalArgumentException.class,
+ () -> ProductQuery.builder().searchValue("SKU-1").build());
+ }
+
+ @Test
+ void productQueryRejectsFuzzyAndExactTogether() {
+ assertThrows(IllegalArgumentException.class,
+ () -> ProductQuery.builder()
+ .searchField(common.ecommerce.model.product.ProductSearchField.PLATFORM_SKU)
+ .searchValue("A")
+ .searchValues(java.util.Arrays.asList("B"))
+ .build());
+ }
+
+ // ---------------------------------------------------------------- 售后
+
+ @Test
+ void pullAfterSalesThroughFacade() {
+ Page page = sdk.afterSales(KEY, CONNECTION).pull(
+ AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-10-01"))
+ .endDate(LocalDate.parse("2026-11-01"))
+ .pageSize(2)
+ .build());
+
+ assertEquals(2, page.size());
+ AfterSale first = page.items().get(0);
+ assertEquals(Platform.WALMART_SC, first.platform());
+ assertEquals("AS-1", first.afterSaleId());
+ assertEquals("FAKE-1", first.channelOrderId());
+ assertEquals(AfterSaleType.REFUND, first.type());
+ assertTrue(page.nextCursor() != null);
+ }
+
+ @Test
+ void afterSaleQueryRequiresTimeWindow() {
+ assertThrows(NullPointerException.class,
+ () -> AfterSaleQuery.builder().endDate(LocalDate.parse("2026-11-01")).build());
+ }
+
+ @Test
+ void afterSaleQueryRejectsInvertedWindow() {
+ assertThrows(IllegalArgumentException.class,
+ () -> AfterSaleQuery.builder()
+ .startDate(LocalDate.parse("2026-11-01"))
+ .endDate(LocalDate.parse("2026-10-01"))
+ .build());
+ }
+
+ @Test
+ void capabilityReportReflectsAdapter() {
+ CapabilityReport caps = sdk.capabilities(KEY);
+ assertTrue(caps.supports(Capability.SALES_ORDER));
+ assertTrue(caps.supports(Capability.PRODUCT));
+ assertTrue(caps.supports(Capability.RETURNS));
+ assertEquals(false, caps.supports(Capability.BILLING));
+ }
+
+ // ---------------------------------------------------------------- 错误路径
+
+ @Test
+ void unsupportedCapabilityThrowsOnCall() {
+ // FakeDirectAdapter 没有实现结算能力:取视图不报错,调用时报错
+ assertThrows(ChannelException.UnsupportedCapabilityException.class,
+ () -> sdk.settlements(KEY, CONNECTION).pull(
+ common.ecommerce.model.settlement.SettlementQuery.builder().build()));
+ }
+
+ @Test
+ void unknownAccountFailsBeforeAnyNetworkCall() {
+ AccountKey other = AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-unknown");
+ IllegalStateException ex = assertThrows(IllegalStateException.class,
+ () -> sdk.products(other, CONNECTION));
+ assertTrue(ex.getMessage().contains("channel account not configured"), ex.getMessage());
+ }
+
+ @Test
+ void ordersStillWorkAlongsideNewCapabilities() {
+ Page page = sdk.salesOrders(KEY, CONNECTION).pull(
+ SalesOrderQuery.builder().updatedAfter(Instant.EPOCH).pageSize(2).build());
+ assertEquals(2, page.size());
+ assertEquals("FAKE-1", page.items().get(0).channelOrderId());
+ }
+}