Browse Source

test(lingxing): 补 SDK 层 listing 调用测试,契约测试对齐实测参数

- 新增 LingxingSdkListingCallTest:从 ChannelSdk 门面调领星 listing,
  覆盖能力检查、snake_case 搜索参数、Target 时间窗三字段、审计记录
- 各平台契约测试同步实测结论:沃尔玛/eBay 改断言 snake_case、
  多值搜索显式失败;Target 补时间窗与多值校验;Temu 补 30 天截断;
  SHEIN/TikTok 补本地 SKU 编码 8

Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
chenchuchuan 2 weeks ago
parent
commit
04bea3ec5e
  1. 164
      lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingSdkListingCallTest.java
  2. 31
      lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
  3. 11
      lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
  4. 45
      lingxing/src/test/java/common/ecommerce/lingxing/platform/target/product/TargetProductSourceTest.java
  5. 27
      lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
  6. 20
      lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
  7. 24
      lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java

164
lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingSdkListingCallTest.java

@ -0,0 +1,164 @@ @@ -0,0 +1,164 @@
package common.ecommerce.lingxing.adapter;
import common.ecommerce.audit.CallObserver;
import common.ecommerce.audit.CallOutcome;
import common.ecommerce.audit.CallRecord;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.lingxing.support.LingxingTestSupport;
import common.ecommerce.model.Platform;
import common.ecommerce.model.account.ChannelAccount;
import common.ecommerce.model.product.ProductListing;
import common.ecommerce.model.product.ProductQuery;
import common.ecommerce.model.product.ProductSearchField;
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 common.ecommerce.testkit.RecordingTransport;
import common.ecommerce.testkit.Responses;
import org.junit.jupiter.api.Test;
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.assertTrue;
/**
* 从 {@link ChannelSdk} 门面调用领星 listing 的端到端测试。
*
* <p>用 {@link RecordingTransport} 替掉网络,走真实的 {@link LingxingAdapter},
* 验证「门面 → 子平台 → Source」这条链路:能力检查、请求路径、SKU 搜索参数、
* 统一模型映射和调用日志。</p>
*/
class LingxingSdkListingCallTest {
/** 沃尔玛的商品页;响应里 total 在顶层,data 是数组。 */
private static final String WALMART_JSON =
"{\"code\":0,\"message\":\"success\",\"total\":1,\"data\":[{"
+ "\"item_id\":\"wal-1\",\"msku\":\"WM-MSKU-1\",\"title\":\"Walmart Item\","
+ "\"local_sku\":\"WM-LOCAL-1\",\"status_name\":\"PUBLISHED\","
+ "\"store_id\":\"store-1\",\"currency_icon\":\"$\",\"price\":\"19.99\"}]}";
/** Target 的商品页;响应结构是 data.list。 */
private static final String TARGET_JSON =
"{\"code\":0,\"message\":\"success\",\"data\":{\"count\":1,\"list\":[{"
+ "\"product_unique_id\":\"prod-1\",\"msku\":\"TGT-MSKU-1\",\"title\":\"Target Item\","
+ "\"local_sku\":\"\",\"store_id\":\"store-1\",\"price\":\"9.99\","
+ "\"currency_icon\":\"$\",\"status\":1,\"status_name\":\"active\"}]}}";
private static final class CollectingObserver implements CallObserver {
private final List<CallRecord> records = new ArrayList<CallRecord>();
@Override
public void onCall(CallRecord record) {
records.add(record);
}
}
private static ChannelSdk sdk(RecordingTransport transport, ChannelAccount account,
CallObserver observer) {
LingxingAdapter adapter = new LingxingAdapter(
transport, new JacksonJsonCodec(),
new InMemoryTokenStore(), new InMemoryLockProvider(),
LingxingTestSupport.CLOCK);
return ChannelSdk.builder()
.accountRepository(new InMemoryAccounts().put(account))
.clock(LingxingTestSupport.CLOCK)
.register(adapter)
.callObserver(observer)
.build();
}
private static ChannelConnection connection() {
return ChannelConnection.of(LingxingTestSupport.ENDPOINT,
ChannelSecret.builder()
.appKey(LingxingTestSupport.APP_KEY)
.appSecret(LingxingTestSupport.APP_SECRET)
.build());
}
@Test
void pullsWalmartListingThroughFacade() {
RecordingTransport transport = RecordingTransport.create()
.route(LingxingApi.LISTING_WALMART.path(), r -> Responses.ok(WALMART_JSON));
ChannelAccount account = LingxingTestSupport.account(Platform.WALMART_SC, 10008, "store-1");
CollectingObserver observer = new CollectingObserver();
Page<ProductListing> page = sdk(transport, account, observer)
.products(account.key(), connection())
.pull(ProductQuery.builder()
.pageSize(10)
.searchField(ProductSearchField.PLATFORM_SKU)
.searchValue("WM-MSKU-1")
.build());
assertEquals(1, page.size());
ProductListing p = page.items().get(0);
assertEquals(Platform.WALMART_SC, p.platform());
assertEquals("WM-MSKU-1", p.platformSku());
// omsStoreId 是宿主的店铺标识(这里取 AccountKey 的 storeId),不是领星 store_id
assertEquals(account.omsStoreId(), p.omsStoreId());
assertEquals("PUBLISHED", p.rawStatus());
// 实测:搜索参数必须是 snake_case,否则平台静默忽略
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"search_field\":1"), body);
assertTrue(body.contains("\"search_single_value\":\"WM-MSKU-1\""), body);
assertFalse(body.contains("searchField"), body);
// 门面审计记录:operation / 平台 / store / 条数
assertEquals(1, observer.records.size());
CallRecord record = observer.records.get(0);
assertEquals("products.pull", record.operation());
assertEquals(CallOutcome.SUCCESS, record.outcome());
assertEquals(Platform.WALMART_SC, record.platform());
assertEquals("store-1", record.externalStoreId());
assertEquals(1, record.resultCount());
}
@Test
void pullsTargetListingThroughFacade() {
RecordingTransport transport = RecordingTransport.create()
.route(LingxingApi.LISTING_SHOPIFY.path(), r -> Responses.ok(TARGET_JSON));
ChannelAccount account = LingxingTestSupport.account(Platform.TARGET, 0, "store-1");
Page<ProductListing> page = sdk(transport, account, CallObserver.NOOP)
.products(account.key(), connection())
.pull(ProductQuery.builder()
.pageSize(5)
.updatedAfter(java.time.Instant.parse("2026-10-01T00:00:00Z"))
.updatedBefore(java.time.Instant.parse("2026-10-08T00:00:00Z"))
.build());
assertEquals(1, page.size());
assertEquals("TGT-MSKU-1", page.items().get(0).platformSku());
assertEquals("prod-1", page.items().get(0).listingId());
String body = transport.lastDataRequest().body();
assertTrue(body.contains("\"store_ids\":[\"store-1\"]"), body);
assertTrue(body.contains("\"listing_time_field\":2"), body);
assertTrue(body.contains("\"listing_start_time\":\"2026-10-01\""), body);
assertTrue(body.contains("\"listing_end_time\":\"2026-10-08\""), body);
}
@Test
void capabilityReportIncludesProductPerSubPlatform() {
RecordingTransport transport = RecordingTransport.create();
ChannelAccount account = LingxingTestSupport.account(Platform.TARGET, 0, "store-1");
// Target 有商品能力;没有商品接口的长尾平台(如 Mirakl)没有
assertTrue(sdk(transport, account, CallObserver.NOOP)
.capabilities(account.key()).supports(common.ecommerce.model.Capability.PRODUCT));
ChannelAccount mirakl = LingxingTestSupport.account(Platform.MIRAKL, 10034, "store-1");
assertFalse(sdk(transport, mirakl, CallObserver.NOOP)
.capabilities(mirakl.key()).supports(common.ecommerce.model.Capability.PRODUCT));
}
}

31
lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java

@ -1,5 +1,6 @@ @@ -1,5 +1,6 @@
package common.ecommerce.lingxing.platform.ebay.product;
import common.ecommerce.error.ValidationException;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.model.Platform;
import common.ecommerce.model.product.ProductListing;
@ -15,10 +16,12 @@ import java.time.Instant; @@ -15,10 +16,12 @@ 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;
import static org.junit.jupiter.api.Assertions.assertNull;
import static org.junit.jupiter.api.Assertions.assertThrows;
/** eBay 在线商品:请求构造 + 响应映射。 */
class EbayProductSourceTest {
@ -40,8 +43,32 @@ class EbayProductSourceTest { @@ -40,8 +43,32 @@ class EbayProductSourceTest {
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\"");
// 实测:camelCase 会被静默忽略,必须用 snake_case
assertBodyContains(body, "\"search_field\":1");
assertBodyContains(body, "\"search_single_value\":\"EBAY-MSKU-1\"");
assertBodyNotContains(body, "searchField");
}
@Test
void localSkuSearchUsesField3() {
new EbayProductSource().products(call(transport, account(Platform.EBAY, 10003, "1106")),
ProductQuery.builder()
.searchField(ProductSearchField.LOCAL_SKU)
.searchValue("EBAY-LOCAL-1")
.build());
assertBodyContains(lastBody(transport), "\"search_field\":3");
}
@Test
void multiValueSearchUnsupportedFailsLoudly() {
assertThrows(ValidationException.class,
() -> new EbayProductSource().products(
call(transport, account(Platform.EBAY, 10003, "1106")),
ProductQuery.builder()
.searchField(ProductSearchField.PLATFORM_SKU)
.searchValues(java.util.Arrays.asList("A", "B"))
.build()));
}
@Test

11
lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java

@ -42,6 +42,17 @@ class SheinProductSourceTest { @@ -42,6 +42,17 @@ class SheinProductSourceTest {
}
@Test
void localSkuSearchUsesField8() {
// 实测:9 = msku,8 = 本地 sku
new SheinProductSource().products(call(transport, account(Platform.SHEIN, 10028, "1105")),
ProductQuery.builder()
.searchField(ProductSearchField.LOCAL_SKU)
.searchValue("SHEIN-LOCAL-1")
.build());
assertBodyContains(lastBody(transport), "\"searchField\":8");
}
@Test
void mapsResponseWithSalePrice() {
ProductListing p = new SheinProductSource().products(
call(transport, account(Platform.SHEIN, 10028, "1105")),

45
lingxing/src/test/java/common/ecommerce/lingxing/platform/target/product/TargetProductSourceTest.java

@ -13,6 +13,7 @@ import org.junit.jupiter.api.Test; @@ -13,6 +13,7 @@ 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;
@ -21,7 +22,8 @@ import static org.junit.jupiter.api.Assertions.assertThrows; @@ -21,7 +22,8 @@ import static org.junit.jupiter.api.Assertions.assertThrows;
/**
* Target 在线商品:走 Shopify 的 variantList 接口。
*
* <p>Target 的本地 SKU 搜索编码尚未确认,传了必须显式失败。</p>
* <p>实测:时间窗三字段必须同时出现且只接受 {@code Y-m-d};多值搜索返回 400;
* {@code local_sku} 在该 app 下恒为空,本地 SKU 搜索显式不支持。</p>
*/
class TargetProductSourceTest {
@ -44,6 +46,36 @@ class TargetProductSourceTest { @@ -44,6 +46,36 @@ class TargetProductSourceTest {
}
@Test
void timeWindowSendsAllThreeFieldsWithDateOnly() {
new TargetProductSource().products(call(transport, account(Platform.TARGET, 10017, "1106")),
ProductQuery.builder()
.updatedAfter(java.time.Instant.parse("2026-10-01T00:00:00Z"))
.updatedBefore(java.time.Instant.parse("2026-10-08T00:00:00Z"))
.build());
String body = lastBody(transport);
// 实测:缺 listing_time_field 或日期带时分秒都会 400
assertBodyContains(body, "\"listing_time_field\":2");
assertBodyContains(body, "\"listing_start_time\":\"2026-10-01\"");
assertBodyContains(body, "\"listing_end_time\":\"2026-10-08\"");
assertBodyNotContains(body, "00:00:00");
}
@Test
void singleSidedWindowFillsBothEnds() {
new TargetProductSource().products(call(transport, account(Platform.TARGET, 10017, "1106")),
ProductQuery.builder()
.updatedAfter(java.time.Instant.parse("2026-10-01T00:00:00Z"))
.build());
String body = lastBody(transport);
// 实测:只传一端返回 400,所以必须补齐另一端
assertBodyContains(body, "\"listing_time_field\":2");
assertBodyContains(body, "\"listing_start_time\":\"2026-10-01\"");
assertBodyContains(body, "\"listing_end_time\":\"");
}
@Test
void localSkuSearchUnsupportedFailsLoudly() {
assertThrows(common.ecommerce.error.ValidationException.class,
() -> new TargetProductSource().products(
@ -55,6 +87,17 @@ class TargetProductSourceTest { @@ -55,6 +87,17 @@ class TargetProductSourceTest {
}
@Test
void multiValueSearchUnsupportedFailsLoudly() {
assertThrows(common.ecommerce.error.ValidationException.class,
() -> new TargetProductSource().products(
call(transport, account(Platform.TARGET, 10017, "1106")),
ProductQuery.builder()
.searchField(ProductSearchField.PLATFORM_SKU)
.searchValues(java.util.Arrays.asList("A", "B"))
.build()));
}
@Test
void mapsResponse() {
ProductListing p = new TargetProductSource().products(
call(transport, account(Platform.TARGET, 10017, "1106")),

27
lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java

@ -52,6 +52,33 @@ class TemuProductSourceTest { @@ -52,6 +52,33 @@ class TemuProductSourceTest {
}
@Test
void timeWindowIsCappedAt30Days() {
// 实测:跨度 31 天直接返回 500,必须截断
new TemuProductSource().products(call(transport, account(Platform.TEMU, 10024, "1105")),
ProductQuery.builder()
.updatedAfter(java.time.Instant.parse("2026-09-01T00:00:00Z"))
.updatedBefore(java.time.Instant.parse("2026-11-06T00:00:00Z"))
.build());
String body = lastBody(transport);
assertBodyContains(body, "\"updateEndTime\":\"2026-11-06 00:00:00\"");
assertBodyContains(body, "\"updateStartTime\":\"2026-10-07 00:00:00\"");
}
@Test
void singleSidedWindowFillsBothEnds() {
// 实测:只传一端返回 500,必须两端同时给
new TemuProductSource().products(call(transport, account(Platform.TEMU, 10024, "1105")),
ProductQuery.builder()
.updatedAfter(java.time.Instant.parse("2026-10-30T00:00:00Z"))
.build());
String body = lastBody(transport);
assertBodyContains(body, "\"updateStartTime\":\"2026-10-30 00:00:00\"");
assertBodyContains(body, "\"updateEndTime\":\"");
}
@Test
void mapsResponseToUnifiedModel() {
ProductListing p = new TemuProductSource().products(
call(transport, account(Platform.TEMU, 10024, "1105")),

20
lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java

@ -4,6 +4,7 @@ import common.ecommerce.lingxing.LingxingApi; @@ -4,6 +4,7 @@ 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;
@ -34,6 +35,25 @@ class TiktokProductSourceTest { @@ -34,6 +35,25 @@ class TiktokProductSourceTest {
}
@Test
void searchUsesField9ForPlatformSkuAnd8ForLocalSku() {
// 实测:9 = msku,8 = 本地 sku,单值/多值都生效
new TiktokProductSource().products(call(transport, account(Platform.TIKTOK, 10011, "1104")),
ProductQuery.builder()
.searchField(ProductSearchField.PLATFORM_SKU)
.searchValue("TT-MSKU-1")
.build());
assertBodyContains(lastBody(transport), "\"searchField\":9");
new TiktokProductSource().products(call(transport, account(Platform.TIKTOK, 10011, "1104")),
ProductQuery.builder()
.searchField(ProductSearchField.LOCAL_SKU)
.searchValues(java.util.Arrays.asList("L-1", "L-2"))
.build());
assertBodyContains(lastBody(transport), "\"searchField\":8");
assertBodyContains(lastBody(transport), "\"searchValues\":[\"L-1\",\"L-2\"]");
}
@Test
void mapsPlatformStatusString() {
ProductListing p = new TiktokProductSource().products(
call(transport, account(Platform.TIKTOK, 10011, "1104")),

24
lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java

@ -1,5 +1,6 @@ @@ -1,5 +1,6 @@
package common.ecommerce.lingxing.platform.walmart.product;
import common.ecommerce.error.ValidationException;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.model.Platform;
import common.ecommerce.model.product.ProductListing;
@ -17,12 +18,14 @@ import java.time.Instant; @@ -17,12 +18,14 @@ 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.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.assertNull;
import static org.junit.jupiter.api.Assertions.assertThrows;
/** 沃尔玛在线商品:请求构造 + 响应映射。 */
class WalmartProductSourceTest {
@ -49,8 +52,11 @@ class WalmartProductSourceTest { @@ -49,8 +52,11 @@ class WalmartProductSourceTest {
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\"");
// 实测:camelCase 会被静默忽略,必须用 snake_case
assertBodyContains(body, "\"search_field\":1");
assertBodyContains(body, "\"search_single_value\":\"WM-MSKU-1\"");
assertBodyNotContains(body, "searchField");
assertBodyNotContains(body, "searchSingleValue");
}
@Test
@ -61,7 +67,19 @@ class WalmartProductSourceTest { @@ -61,7 +67,19 @@ class WalmartProductSourceTest {
.searchValue("WM-LOCAL-1")
.build());
assertBodyContains(lastBody(transport), "\"searchField\":3");
assertBodyContains(lastBody(transport), "\"search_field\":3");
}
@Test
void multiValueSearchUnsupportedFailsLoudly() {
// 实测:search_values 被平台忽略并返回整页,宁可报错也不静默返回全量
assertThrows(ValidationException.class,
() -> new WalmartProductSource().products(
call(transport, account(Platform.WALMART_SC, 10008, "1108")),
ProductQuery.builder()
.searchField(ProductSearchField.PLATFORM_SKU)
.searchValues(java.util.Arrays.asList("A", "B"))
.build()));
}
@Test

Loading…
Cancel
Save