package common.ecommerce.xincang.adapter; import common.ecommerce.shared.error.ValidationException; import common.ecommerce.shared.spi.ChannelSecret; import common.ecommerce.shared.testkit.InMemoryLockProvider; import common.ecommerce.shared.testkit.InMemoryTokenStore; import common.ecommerce.shared.testkit.MutableClock; import common.ecommerce.shared.testkit.RecordingTransport; import common.ecommerce.shared.testkit.Responses; import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.model.ChannelRecommendQuery; import common.ecommerce.warehouse.model.ChannelRecommendResult; import common.ecommerce.warehouse.sdk.WarehouseConnection; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.xincang.XincangConstants; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import java.time.Clock; import java.time.Duration; import static org.junit.jupiter.api.Assertions.*; /** * 最优渠道({@code api.calculate_order_v3})契约测试。 */ class XincangChannelRecommendTest { private static final String BASE = XincangConstants.TEST_BASE_URL; private static final String APP_KEY = "ak-1"; /** 文档成功示例(截取两层结构)。 */ private static final String OK_BODY = "{\"rst\":{" + "\"optimalPlan\":{\"warehouse\":\"CA-3790\",\"service_code\":\"GOFO-G\",\"sum\":\"20.87\"}," + "\"warehouseFeeList\":[" + "{\"warehouse\":\"CA-3790\",\"isInventoryEnough\":\"1\",\"insufficientStockError\":\"\"," + "\"logisticsService\":[" + "{\"service_code\":\"GOFO-G\",\"sum\":\"20.87\",\"fees\":[" + "{\"big_fee_type\":\"快递费\",\"fee_type\":\"基础费\",\"customer_fee\":\"11.87\"}," + "{\"big_fee_type\":\"快递费\",\"fee_type\":\"燃油附加费\",\"customer_fee\":\"5.64\"}]}," + "{\"service_code\":\"USPS-G\",\"sum\":\"22.10\",\"fees\":[]}]}," + "{\"warehouse\":\"NJ-2605\",\"isInventoryEnough\":\"0\"," + "\"insufficientStockError\":\"库存不足\",\"logisticsService\":[]}" + "]}," + "\"errno\":0,\"err\":\"\",\"trace_id\":\"t-v3\"}"; private RecordingTransport transport; private XincangAdapter adapter; @BeforeEach void setUp() { transport = RecordingTransport.create(); MutableClock clock = MutableClock.atUtc("2026-11-10T00:00:00Z"); transport.route(XincangConstants.PATH_LOGIN, req -> Responses.ok( "{\"rst\":{\"id\":\"c-1\",\"token\":\"{T-1}\",\"token_expire_time\":\"" + java.time.LocalDateTime.ofInstant(clock.instant().plus(Duration.ofHours(2)), XincangConstants.SYSTEM_ZONE) .format(java.time.format.DateTimeFormatter.ofPattern("yyyy-MM-dd HH:mm:ss")) + "\"},\"errno\":0,\"err\":\"\",\"trace_id\":\"t-login\"}")); adapter = new XincangAdapter(transport, new common.ecommerce.http.JacksonJsonCodec(), new InMemoryTokenStore(), new InMemoryLockProvider(), clock); } private static WarehouseContext ctx() { return WarehouseContext.of("XC-CA-3790", WarehouseProvider.XINCANG, "CA-3790", WarehouseConnection.of(BASE, ChannelSecret.builder() .appKey(APP_KEY).appSecret("sk").build()), "req-1", Clock.systemUTC()); } private static ChannelRecommendQuery query() { return ChannelRecommendQuery.builder() .product("NOTEBOOK-MULTI-3", 9) .product("BOX-PENS-10", 3) .postalCode("937862") .signatureRequired(false) .build(); } @Test void sendsDocumentedRequestShape() { transport.route(XincangConstants.PATH_CHANNEL_RECOMMEND, req -> Responses.ok(OK_BODY)); adapter.recommend(ctx(), query()); common.ecommerce.http.HttpRequest req = transport.lastDataRequest(); assertTrue(req.url().contains("/api.calculate_order_v3?token=%7BT-1%7D"), req.url()); assertEquals("application/json", req.contentType()); String body = req.body(); assertTrue(body.contains("\"sku\":\"NOTEBOOK-MULTI-3\""), body); assertTrue(body.contains("\"qty\":\"9\""), body); assertTrue(body.contains("\"sku\":\"BOX-PENS-10\""), body); assertTrue(body.contains("\"qty\":\"3\""), body); assertTrue(body.contains("\"postcode\":\"937862\""), body); assertTrue(body.contains("\"is_sign\":\"否\""), body); // 未指定仓库时不下发 warehouse_code assertFalse(body.contains("warehouse_code"), body); } @Test void mapsOptimalPlanAndAllQuotes() { transport.route(XincangConstants.PATH_CHANNEL_RECOMMEND, req -> Responses.ok(OK_BODY)); ChannelRecommendResult result = adapter.recommend(ctx(), query()); assertEquals(WarehouseProvider.XINCANG, result.sourceProvider()); // 最优方案 assertNotNull(result.optimalPlan()); assertEquals("CA-3790", result.optimalPlan().warehouseCode()); assertEquals("GOFO-G", result.optimalPlan().serviceCode()); assertEquals(0, result.optimalPlan().total().amount().compareTo(new java.math.BigDecimal("20.87"))); assertEquals("USD", result.optimalPlan().total().currencyCode()); // 所有仓库明细 assertEquals(2, result.warehouseQuotes().size()); ChannelRecommendResult.WarehouseQuote first = result.warehouseQuotes().get(0); assertEquals("CA-3790", first.warehouseCode()); assertEquals(Boolean.TRUE, first.inventoryEnough()); assertNull(first.insufficientStockError(), "空串应转 null"); assertEquals(2, first.services().size()); ChannelRecommendResult.ServiceQuote gogo = first.services().get(0); assertEquals("GOFO-G", gogo.serviceCode()); assertEquals(2, gogo.fees().size()); assertEquals("快递费", gogo.fees().get(0).bigFeeType()); assertEquals("燃油附加费", gogo.fees().get(1).feeType()); assertEquals(0, gogo.fees().get(1).fee().amount() .compareTo(new java.math.BigDecimal("5.64"))); ChannelRecommendResult.WarehouseQuote second = result.warehouseQuotes().get(1); assertEquals(Boolean.FALSE, second.inventoryEnough()); assertEquals("库存不足", second.insufficientStockError()); assertTrue(second.services().isEmpty()); } @Test void signatureIsSentWhenRequested() { transport.route(XincangConstants.PATH_CHANNEL_RECOMMEND, req -> Responses.ok(OK_BODY)); ChannelRecommendQuery signed = ChannelRecommendQuery.builder() .product("SKU-A", 1).postalCode("10001").signatureRequired(true).build(); adapter.recommend(ctx(), signed); assertTrue(transport.lastDataRequest().body().contains("\"is_sign\":\"是\"")); } @Test void warehouseCodeIsSentWhenSpecified() { transport.route(XincangConstants.PATH_CHANNEL_RECOMMEND, req -> Responses.ok(OK_BODY)); ChannelRecommendQuery pinned = ChannelRecommendQuery.builder() .product("SKU-A", 1).postalCode("10001").warehouseCode("CA-3790").build(); adapter.recommend(ctx(), pinned); assertTrue(transport.lastDataRequest().body().contains("\"warehouse_code\":\"CA-3790\"")); } @Test void emptyOptimalPlanIsNullNotThrow() { transport.route(XincangConstants.PATH_CHANNEL_RECOMMEND, req -> Responses.ok( "{\"rst\":{\"optimalPlan\":null,\"warehouseFeeList\":[]}," + "\"errno\":0,\"err\":\"\",\"trace_id\":\"t-empty\"}")); ChannelRecommendResult result = adapter.recommend(ctx(), query()); assertNull(result.optimalPlan(), "无可用渠道时为 null"); assertTrue(result.warehouseQuotes().isEmpty()); } @Test void missingRstIsNotSilentSuccess() { transport.route(XincangConstants.PATH_CHANNEL_RECOMMEND, req -> Responses.ok( "{\"rst\":null,\"errno\":0,\"err\":\"\"}")); ValidationException e = assertThrows(ValidationException.class, () -> adapter.recommend(ctx(), query())); assertTrue(e.getMessage().contains("no rst"), e.getMessage()); } @Test void capabilityDeclared() { assertTrue(adapter.capabilities().contains(WarehouseCapability.CHANNEL_RECOMMEND)); assertTrue(adapter.supports("XC-CA-3790", WarehouseCapability.CHANNEL_RECOMMEND)); } @Test void busyFlagAcceptsBothStringForms() { assertEquals(Boolean.TRUE, XincangChannelRecommendMapper.parseFlag("1")); assertEquals(Boolean.TRUE, XincangChannelRecommendMapper.parseFlag("true")); assertEquals(Boolean.FALSE, XincangChannelRecommendMapper.parseFlag("0")); assertEquals(Boolean.FALSE, XincangChannelRecommendMapper.parseFlag("false")); assertNull(XincangChannelRecommendMapper.parseFlag("")); assertNull(XincangChannelRecommendMapper.parseFlag("unknown")); } }