You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

198 lines
9.0 KiB

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"));
}
}