package common.ecommerce.yqn.adapter; import common.ecommerce.http.JacksonJsonCodec; import common.ecommerce.shared.spi.ChannelSecret; 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.TrackEvent; import common.ecommerce.warehouse.model.TrackingInfo; import common.ecommerce.warehouse.sdk.WarehouseConnection; import common.ecommerce.warehouse.sdk.WarehouseContext; import common.ecommerce.warehouse.sdk.WarehouseAdapter; import java.util.EnumSet; import common.ecommerce.yqn.YqnConstants; import org.junit.jupiter.api.Test; import java.time.Clock; import java.time.Instant; import java.time.ZoneOffset; import java.util.List; 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; /** * 物流轨迹(API 189)契约测试。 * *
注意这个接口在另一个主机,且成功码是 {@code 1} 而不是 {@code 200}。
*/ class YqnTrackingTest { private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-10T00:00:00Z"), ZoneOffset.UTC); private static ChannelSecret secret() { return ChannelSecret.builder().appSecret("key-1").build(); } /** 主基址 + 辅助基址。 */ private static WarehouseContext ctx() { return WarehouseContext.of("YQN-RF_NY_US", WarehouseProvider.YQN, "RF_NY_US", WarehouseConnection.of(YqnConstants.PR_BASE_URL, YqnConstants.AUX_BASE_URL_PR, secret()), "req-track", CLOCK); } /** 只有主基址。 */ private static WarehouseContext ctxWithoutAux() { return WarehouseContext.of("YQN-RF_NY_US", WarehouseProvider.YQN, "RF_NY_US", WarehouseConnection.of(YqnConstants.PR_BASE_URL, secret()), "req-track", CLOCK); } private static final String OK_BODY = "{\"code\":1,\"message\":\"success\",\"data\":{" + "\"id\":9527,\"carrier\":\"FEDEX\",\"trackingCode\":\"TRK123\"," + "\"status\":\"DELIVERED\",\"statusDetail\":\"已签收\"," + "\"estDeliveryDate\":\"2026-11-12T10:00:00Z\"," + "\"signedBy\":\"J SMITH\",\"publicUrl\":\"https://track.example/TRK123\"," + "\"trackingDetails\":[" + "{\"status\":\"IN_TRANSIT\",\"message\":\"已离开分拨中心\"," + "\"datetime\":\"2026-11-09 08:30:00\",\"timeZone\":\"America/New_York\"," + "\"trackingLocation\":{\"city\":\"Newark\",\"state\":\"NJ\"," + "\"country\":\"US\",\"zip\":\"07102\"}}," + "{\"status\":\"DELIVERED\",\"message\":\"delivered\"," + "\"datetime\":\"2026-11-10T15:20:00Z\",\"signedBy\":null}]," + "\"carrierDetail\":{\"service\":\"FedEx_FEDEX_GROUND\"}}}"; @Test void callsAuxiliaryHostNotWarehouseHost() { RecordingTransport transport = RecordingTransport.create() .route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY)); new YqnAdapter(transport, new JacksonJsonCodec()).trackShipment(ctx(), "TRK123"); String url = transport.lastDataRequest().url(); assertTrue(url.startsWith(YqnConstants.AUX_BASE_URL_PR), url); assertTrue(url.contains("/api/v2/orderShipment/track/TRK123"), url); } @Test void missingAuxEndpointIsRejectedNotSilentlyRetargeted() { RecordingTransport transport = RecordingTransport.create(); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); assertThrows(common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException.class, () -> adapter.trackShipment(ctxWithoutAux(), "TRK123")); assertTrue(transport.recorded().isEmpty(), "不应该发出任何请求"); } @Test void mapsShipmentLevelFields() { RecordingTransport transport = RecordingTransport.create() .route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY)); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); TrackingInfo info = adapter.trackShipment(ctx(), "TRK123"); assertEquals("TRK123", info.trackingNumber()); assertEquals("FEDEX", info.carrier()); assertEquals("FedEx_FEDEX_GROUND", info.carrierService()); assertEquals("DELIVERED", info.status()); assertEquals("已签收", info.statusDetail()); assertEquals(Instant.parse("2026-11-12T10:00:00Z"), info.estimatedDeliveryAt()); assertEquals("J SMITH", info.signedBy()); assertEquals("https://track.example/TRK123", info.publicUrl()); assertEquals(2, info.events().size()); } @Test void mapsTrackingDetailsAndLocation() { RecordingTransport transport = RecordingTransport.create() .route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY)); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); TrackingInfo info = adapter.trackShipment(ctx(), "TRK123"); TrackEvent first = info.events().get(0); assertEquals("IN_TRANSIT", first.status()); assertEquals("已离开分拨中心", first.description()); assertEquals("Newark, NJ, US, 07102", first.location()); assertEquals("TRK123", first.trackingNumber()); assertEquals("FEDEX", first.carrier()); // 带时区的直接解析;本地格式按调用时区解释 assertEquals(Instant.parse("2026-11-10T15:20:00Z"), info.events().get(1).occurredAt()); TrackEvent second = info.events().get(1); assertEquals("DELIVERED", second.status()); assertNull(second.location()); } @Test void trackReturnsSameEventsAsTrackShipment() { RecordingTransport transport = RecordingTransport.create() .route("/api/v2/orderShipment/track/TRK123", req -> Responses.ok(OK_BODY)); YqnAdapter adapter = new YqnAdapter(transport, new JacksonJsonCodec()); List