From 8dabf9fb1bea694d2f93edebaa19cd5d6e9193db Mon Sep 17 00:00:00 2001 From: chenchuchuan <13554600537@163.com> Date: Tue, 17 Nov 2026 09:50:08 +0800 Subject: [PATCH] =?UTF-8?q?test(edayun):=20=E8=A1=A5=20SDK=20=E8=A3=85?= =?UTF-8?q?=E9=85=8D=E9=93=BE=E8=B7=AF=E5=86=92=E7=83=9F=EF=BC=88=E7=A6=BB?= =?UTF-8?q?=E7=BA=BF=EF=BC=8C=E6=8C=89=E4=B8=9A=E5=8A=A1=E5=9C=BA=E6=99=AF?= =?UTF-8?q?=EF=BC=89?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 从门面 WarehouseSdk 走一遍,覆盖: - 装配:能力位全量断言(12 个已声明 + 3 个必须为假)、工厂能建出适配器 - 场景 1 主数据:仓库 / 承运商 / 物流产品(-998 已跳过) - 场景 2 发货:试算 → 建单 → 查单 → 面单 → 取消前校验 → 取消, 外加建单幂等(同一 outboundRequestNo 只打一次仓方) - 场景 3 库存:safeStock 缺失映射为 -1 - 场景 4 退货:建单 → 详情 → 列表 → 取消 - 场景 5 单据 / 轨迹 / 打印:BOL、节点与运单级轨迹(上网/妥投时间)、 箱唛、入库单 - 未实现能力(调拨 / 退货检验后处理)必须抛,不返回空 不联网:用 RecordingTransport + 真实报文样本。适配器直接注册(传输层可替换), 另用一例单独验证工厂路径能 build 出适配器。 验证:9 个用例全绿;全仓 mvn test 通过。 Co-Authored-By: Claude --- .../ecommerce/edayun/sdk/EdayunSdkSmokeTest.java | 436 +++++++++++++++++++++ 1 file changed, 436 insertions(+) create mode 100644 warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java diff --git a/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java new file mode 100644 index 0000000..0f09551 --- /dev/null +++ b/warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java @@ -0,0 +1,436 @@ +package common.ecommerce.edayun.sdk; + +import common.ecommerce.edayun.EdayunConstants; +import common.ecommerce.edayun.adapter.EdayunAdapter; +import common.ecommerce.edayun.adapter.EdayunAdapterFactory; +import common.ecommerce.shared.model.Platform; +import common.ecommerce.shared.spi.ChannelSecret; +import common.ecommerce.shared.support.Money; +import common.ecommerce.shared.testkit.InMemoryIdempotencyStore; +import common.ecommerce.shared.testkit.InMemoryLockProvider; +import common.ecommerce.http.JacksonJsonCodec; +import common.ecommerce.shared.testkit.InMemoryTokenStore; +import common.ecommerce.shared.testkit.RecordingTransport; +import common.ecommerce.shared.testkit.Responses; +import common.ecommerce.warehouse.enums.CaseMarkPaperSize; +import common.ecommerce.warehouse.enums.CancelEligibility; +import common.ecommerce.warehouse.enums.ReturnDealMethod; +import common.ecommerce.warehouse.enums.WarehouseCapability; +import common.ecommerce.warehouse.enums.WarehouseProvider; +import common.ecommerce.warehouse.model.CaseMarkPrintCommand; +import common.ecommerce.warehouse.model.BolDocument; +import common.ecommerce.warehouse.model.CancelCommand; +import common.ecommerce.warehouse.model.CancelResult; +import common.ecommerce.warehouse.model.FeeEstimateQuery; +import common.ecommerce.warehouse.model.FeeEstimateResult; +import common.ecommerce.warehouse.model.InventoryQuery; +import common.ecommerce.warehouse.model.InventorySnapshot; +import common.ecommerce.warehouse.model.LogisticsProduct; +import common.ecommerce.warehouse.model.OutboundCommand; +import common.ecommerce.warehouse.model.OutboundLine; +import common.ecommerce.warehouse.model.OutboundOrder; +import common.ecommerce.warehouse.model.OutboundReceipt; +import common.ecommerce.warehouse.model.OutboundRef; +import common.ecommerce.warehouse.model.ReturnCommand; +import common.ecommerce.warehouse.model.ReturnQuery; +import common.ecommerce.warehouse.model.ShipTo; +import common.ecommerce.warehouse.model.TrackEvent; +import common.ecommerce.warehouse.model.TrackingInfo; +import common.ecommerce.warehouse.model.WarehouseCarrier; +import common.ecommerce.warehouse.model.WarehouseFacility; +import common.ecommerce.warehouse.model.WarehouseLabel; +import common.ecommerce.warehouse.model.WarehouseReturn; +import common.ecommerce.warehouse.sdk.WarehouseConnection; +import common.ecommerce.warehouse.sdk.WarehouseSdk; +import common.ecommerce.warehouse.spi.WarehouseAccount; +import common.ecommerce.warehouse.testkit.InMemoryWarehouses; +import org.junit.jupiter.api.Test; + +import java.math.BigDecimal; +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.assertNotNull; +import static org.junit.jupiter.api.Assertions.assertThrows; +import static org.junit.jupiter.api.Assertions.assertTrue; + +/** + * 易达云 SDK 装配链路冒烟。 + * + *

不联网:走 {@link WarehouseSdk} 门面 → 工厂 → 适配器 → 假传输层, + * 用真实报文样本验一遍「能不能装起来、能力位对不对、字段有没有搬对」。

+ * + *

覆盖的业务场景:

+ *
    + *
  1. 主数据:仓库 / 承运商 / 物流产品
  2. + *
  3. 发货:试算 → 建单 → 查单 → 面单 → 取消
  4. + *
  5. 库存:查询
  6. + *
  7. 退货:建单 → 查详情 → 列表 → 取消
  8. + *
  9. 单据 / 轨迹 / 打印
  10. + *
+ */ +class EdayunSdkSmokeTest { + + private static final Clock CLOCK = Clock.fixed(Instant.parse("2026-11-16T00:00:00Z"), ZoneOffset.UTC); + private static final String WH = "EDY-USLA"; + private static final String BASE = "https://test.omniselling.com.cn/saas-service/openapi/microService"; + + private static WarehouseSdk sdk(RecordingTransport transport) { + InMemoryWarehouses repo = new InMemoryWarehouses().put(WarehouseAccount.builder() + .warehouseCode(WH) + .provider(WarehouseProvider.EDAYUN.name()) + .providerWarehouseId("2") + .credentialRef("kms://test/edayun") + .timeZone("America/Los_Angeles") + .build()); + // 直接注册适配器实例:把传输层换成假的,其余装配(token 缓存 / 锁 / 时钟)与 + // 生产走同一套构造参数。工厂路径由 factoryAssemblesAdapter 单独验证。 + EdayunAdapter adapter = new EdayunAdapter(transport, new JacksonJsonCodec(), + new InMemoryTokenStore(), new InMemoryLockProvider(), CLOCK); + return WarehouseSdk.builder() + .warehouseRepository(repo) + .idempotencyStore(new InMemoryIdempotencyStore()) + .clock(CLOCK) + .register(adapter) + .build(); + } + + private static WarehouseConnection conn() { + return WarehouseConnection.of(BASE, ChannelSecret.builder() + .appKey("ak").appSecret("sk") + .clientId("cid").clientSecret("cs") + .build()); + } + + /** 所有业务接口共用的假传输层:token + 按路径路由。 */ + private static RecordingTransport transport() { + return RecordingTransport.create() + .route(EdayunConstants.PATH_TOKEN, req -> Responses.ok( + "{\"access_token\":\"T1\",\"token_type\":\"bearer\"}")) + .route(EdayunConstants.PATH_WAREHOUSE_PERMITTED, req -> Responses.ok( + "{\"code\":200,\"data\":[{\"warehouseId\":\"2\",\"warehouseName\":\"美西1仓\"," + + "\"warehouseCode\":\"USLA\",\"countryCode\":\"US\"}]}")) + .route(EdayunConstants.PATH_CARRIERS, req -> Responses.ok( + "{\"code\":200,\"data\":[{\"carrierId\":\"1\",\"carrierNameEn\":\"FedEx\"," + + "\"carrierNameCn\":\"FedEx\",\"ownLogisticList\":[" + + "{\"logisticId\":\"250\",\"logisticName\":\"FedEx-express\"}]}]}")) + .route(EdayunConstants.PATH_LOGISTICS_PRODUCTS, req -> Responses.ok( + "{\"code\":200,\"data\":[{\"productId\":\"133\",\"productName\":\"USPS\"}," + + "{\"productId\":\"-998\",\"productName\":\"使用分物流规则\"}]}")) + .route(EdayunConstants.PATH_FEE_ESTIMATE, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"successItems\":[{" + + "\"logisticProductId\":\"80\",\"logisticProductName\":\"美国经济派送\"," + + "\"currencyCode\":\"USD\",\"estimatedPrice\":5.315," + + "\"detailList\":[{\"billingItemName\":\"尾程配送费\"," + + "\"estimatedPrice\":3.315,\"currencyCode\":\"USD\"}]}]," + + "\"failItems\":[]}}")) + .route(EdayunConstants.PATH_ORDER_CREATE, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"orderNo\":\"ORD1001\"," + + "\"poNumber\":\"SO-1\"}}")) + .route(EdayunConstants.PATH_ORDER_GET, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"orderNo\":\"ORD1001\"," + + "\"poNumber\":\"SO-1\",\"orderStatus\":\"Shipped\"," + + "\"trackingNo\":\"1Z111\"}}")) + .route(EdayunConstants.PATH_ORDER_LABEL, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"orderNo\":\"ORD1001\"," + + "\"trackingNo\":\"1Z111\",\"labels\":\"https://oss/l1.pdf\"}}")) + .route(EdayunConstants.PATH_ORDER_CHECK_CANCEL, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":\"Published\"}")) + .route(EdayunConstants.PATH_ORDER_CANCEL, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":true}")) + .route(EdayunConstants.PATH_INVENTORY, req -> Responses.ok( + "{\"code\":200,\"msg\":\"success\",\"total\":1,\"rows\":[{" + + "\"skuCode\":\"ybtest\",\"stock\":\"4\",\"totalStock\":\"10\"," + + "\"inTransitStock\":\"20\",\"frozenStock\":\"1\"," + + "\"toDeliverStock\":\"2\",\"safeStock\":null," + + "\"warehouseCode\":\"USLA\"}]}")) + .route(EdayunConstants.PATH_RETURN_CREATE, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":\"RMA1001\"}")) + .route(EdayunConstants.PATH_RETURN_DETAIL, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":{\"basicInfo\":{" + + "\"rmaCode\":\"RMA1001\",\"status\":5,\"statusName\":\"已处理\"," + + "\"relationNo\":\"SO-1\",\"warehouseName\":\"美西1仓\"}," + + "\"checkList\":[{\"skuCode\":\"ybtest\",\"skuNum\":1," + + "\"commandName\":\"上架\"}]}}")) + .route(EdayunConstants.PATH_RETURN_LIST, req -> Responses.ok( + "{\"total\":1,\"code\":200,\"rows\":[{\"rmaCode\":\"RMA1001\"," + + "\"status\":5,\"statusName\":\"已处理\",\"warehouseName\":\"美西1仓\"," + + "\"createTime\":1790568000000}]}")) + .route(EdayunConstants.PATH_RETURN_CANCEL, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":true}")) + .route(EdayunConstants.PATH_BOL_LIST, req -> Responses.ok( + "{\"code\":200,\"data\":{\"bolList\":[{\"bolCode\":\"cp005\"," + + "\"status\":11,\"statusName\":\"已妥投\",\"bolFileUrl\":\"https://oss/b.pdf\"}]}}")) + .route(EdayunConstants.PATH_TRACK, req -> Responses.ok( + "{\"code\":200,\"data\":[{\"trackingNo\":\"1Z111\",\"status\":1," + + "\"carrierName\":\"fedex\",\"onlineTime\":\"2025-08-19 08:17:00\"," + + "\"deliveredTime\":\"2025-08-20 10:00:00\",\"timeZone\":\"GMT-04:00\"," + + "\"trackDetaillVoList\":[{\"recentDescribe\":\"上网\"," + + "\"recentDescribeTime\":1741145821000}]}]}")) + .route(EdayunConstants.PATH_CASE_MARK_PRINT, req -> Responses.ok( + "{\"code\":200,\"msg\":\"操作成功\",\"data\":\"https://oss/case.pdf\"}")) + .route(EdayunConstants.PATH_INBOUND_SKU_DETAIL, req -> Responses.ok( + "{\"total\":1,\"code\":200,\"rows\":[{\"entryCode\":\"REV1\"," + + "\"skuCode\":\"ybtest\",\"forecastQuantity\":10," + + "\"actualCheckedQuantity\":10,\"shelvesQuantity\":10," + + "\"status\":4,\"statusName\":\"已上架\"}]}")); + } + + // ================================================================ 装配 + + /** + * 工厂装配:不联网,只验证 {@code build()} 能把适配器建出来、 + * 能力位与 provider 对得上。 + */ + @Test + void factoryAssemblesAdapter() { + InMemoryWarehouses repo = new InMemoryWarehouses().put(WarehouseAccount.builder() + .warehouseCode(WH) + .provider(WarehouseProvider.EDAYUN.name()) + .providerWarehouseId("2") + .credentialRef("kms://test/edayun") + .timeZone("America/Los_Angeles") + .build()); + WarehouseSdk built = WarehouseSdk.builder() + .warehouseRepository(repo) + .clock(CLOCK) + .register(new EdayunAdapterFactory( + new InMemoryTokenStore(), new InMemoryLockProvider(), CLOCK)) + .build(); + + assertTrue(built.capabilities(WH).supported().contains(WarehouseCapability.OUTBOUND)); + // 能按仓解析到适配器:仓库清单会真的打一次仓方,用假传输层接 + assertNotNull(built.warehouses(WH, conn())); + } + + // ================================================================ 能力位 + + @Test + void declaresAllImplementedCapabilities() { + WarehouseSdk sdk = sdk(transport()); + java.util.EnumSet caps = sdk.capabilities(WH).supported(); + + // 已实现 + assertTrue(caps.contains(WarehouseCapability.PRODUCT), "商品"); + assertTrue(caps.contains(WarehouseCapability.OUTBOUND), "出库"); + assertTrue(caps.contains(WarehouseCapability.INVENTORY_QUERY), "库存"); + assertTrue(caps.contains(WarehouseCapability.INBOUND), "入库"); + assertTrue(caps.contains(WarehouseCapability.RETURN), "退货"); + assertTrue(caps.contains(WarehouseCapability.FEE_SETTLEMENT), "费用"); + assertTrue(caps.contains(WarehouseCapability.FEE_ESTIMATE), "试算"); + assertTrue(caps.contains(WarehouseCapability.BOL), "BOL"); + assertTrue(caps.contains(WarehouseCapability.TRACKING), "轨迹"); + assertTrue(caps.contains(WarehouseCapability.LOGISTICS_PRODUCT), "物流产品"); + assertTrue(caps.contains(WarehouseCapability.CASE_MARK_PRINT), "箱唛"); + assertTrue(caps.contains(WarehouseCapability.DIRECTORY), "基础资料"); + + // 未实现——调了必须抛,不能返回空 + assertTrue(!caps.contains(WarehouseCapability.TRANSFER), "易达云没有调拨"); + assertTrue(!caps.contains(WarehouseCapability.WEBHOOK), "回调文档还没给"); + assertTrue(!caps.contains(WarehouseCapability.RETURN_DISPOSITION), "缺行 id"); + } + + // ================================================================ 场景 1:主数据 + + @Test + void scenario1_masterData() { + WarehouseSdk sdk = sdk(transport()); + + List warehouses = sdk.warehouses(WH, conn()).warehouses(); + assertEquals(1, warehouses.size()); + assertEquals("USLA", warehouses.get(0).warehouseCode()); + assertEquals("2", warehouses.get(0).providerWarehouseId()); + + List carriers = sdk.warehouses(WH, conn()).carrierDirectory(); + assertEquals(1, carriers.size()); + assertEquals("FedEx", carriers.get(0).nameEn()); + assertEquals(1, carriers.get(0).logists().size()); + + List products = sdk.warehouses(WH, conn()).logisticsProducts(null); + // -998 已跳过 + assertEquals(1, products.size()); + assertEquals("133", products.get(0).logisticsProductCode()); + } + + // ================================================================ 场景 2:发货 + + @Test + void scenario2_shipping() { + RecordingTransport transport = transport(); + WarehouseSdk sdk = sdk(transport); + + // 2.1 发货前试算 + List quotes = sdk.warehouses(WH, conn()).fees().estimate( + FeeEstimateQuery.builder() + .lengthCm(new BigDecimal("22")).widthCm(new BigDecimal("22")) + .heightCm(new BigDecimal("22")).weightGrams(new BigDecimal("1000")) + .receiveCountry("US").receivePostal("91761") + .logisticsServiceCode("80") + .build()); + assertEquals(1, quotes.size()); + assertEquals(1, quotes.get(0).carriers().size()); + assertEquals(new BigDecimal("5.315"), quotes.get(0).carriers().get(0).totalRate().amount()); + + // 2.2 建单 + OutboundReceipt receipt = sdk.warehouses(WH, conn()).outbound().create(outbound()); + assertEquals("ORD1001", receipt.providerOrderId()); + + // 2.3 查单 + OutboundOrder order = sdk.warehouses(WH, conn()).outbound() + .get(OutboundRef.ofRequestNo("SO-1")); + assertNotNull(order); + assertEquals("ORD1001", order.providerOrderId()); + + // 2.4 面单 + assertEquals(1, sdk.warehouses(WH, conn()).outbound() + .packages(OutboundRef.ofRequestNo("SO-1")).size()); + + // 2.5 取消前校验 → 免费 + assertEquals(CancelEligibility.FREE, sdk.warehouses(WH, conn()).outbound() + .checkCancel(OutboundRef.ofRequestNo("SO-1"))); + + // 2.6 取消 + CancelResult cancelled = sdk.warehouses(WH, conn()).outbound().cancel( + CancelCommand.builder().outboundRequestNo("SO-1").providerOrderId("ORD1001").build()); + assertTrue(cancelled.cancelled()); + } + + /** 建单幂等:同一个 outboundRequestNo 调两次只发一次请求。 */ + @Test + void scenario2_createIsIdempotent() { + RecordingTransport transport = transport(); + WarehouseSdk sdk = sdk(transport); + + sdk.warehouses(WH, conn()).outbound().create(outbound()); + sdk.warehouses(WH, conn()).outbound().create(outbound()); + + long creates = transport.dataRequests().stream() + .filter(r -> r.url().endsWith(EdayunConstants.PATH_ORDER_CREATE)) + .count(); + assertEquals(1, creates, "第二次应命中幂等,不再调仓"); + } + + private static OutboundCommand outbound() { + return OutboundCommand.builder() + .outboundRequestNo("OB-1") + .orderRef("SO-1") + .warehouseId("2") + .currency("USD") + .salesPlatform(Platform.AMAZON_SC) + .shipTo(ShipTo.builder() + .name("Buyer").phone("+1-555-0100") + .countryCode("US").stateOrProvince("California") + .city("Escondido").addressLine1("1308 E Washington Ave") + .postalCode("92027") + .build()) + .line(OutboundLine.builder() + .lineNo("1").omsSku("ybtest").quantity(1) + .declareValue(Money.of("19.99", "USD")) + .build()) + .build(); + } + + // ================================================================ 场景 3:库存 + + @Test + void scenario3_inventory() { + WarehouseSdk sdk = sdk(transport()); + + List rows = sdk.warehouses(WH, conn()).inventory() + .query(InventoryQuery.builder().sku("ybtest").build()).items(); + + assertEquals(1, rows.size()); + InventorySnapshot s = rows.get(0); + assertEquals("ybtest", s.providerSku()); + assertEquals(4, s.available()); + assertEquals(10, s.onHand()); + assertEquals(20, s.inTransit()); + // safeStock 为 null → -1(统一模型约定) + assertEquals(-1, s.alertQuantity()); + } + + // ================================================================ 场景 4:退货 + + @Test + void scenario4_returns() { + WarehouseSdk sdk = sdk(transport()); + + // 4.1 建退货单(自行退回) + WarehouseReturn created = sdk.warehouses(WH, conn()).returns().create( + ReturnCommand.builder() + .returnRequestNo("RT-1") + .saleOrderNo("SO-1") + .returnTrackingNo("1Z999") + .carrierCode("FedEx") + .warehouseId("2") + .line("ybtest", 1, ReturnDealMethod.WAREHOUSE_CONFIRM) + .build()); + assertEquals("RMA1001", created.providerReturnId()); + + // 4.2 查详情 + WarehouseReturn detail = sdk.warehouses(WH, conn()).returns().get("RMA1001"); + assertNotNull(detail); + assertEquals("RMA1001", detail.providerReturnId()); + assertEquals(1, detail.lines().size()); + + // 4.3 列表 + assertEquals(1, sdk.warehouses(WH, conn()).returns() + .query(ReturnQuery.builder().pageSize(100).build()).size()); + + // 4.4 取消 + assertTrue(sdk.warehouses(WH, conn()).returns().cancel("RMA1001")); + } + + // ================================================================ 场景 5:单据 / 轨迹 / 打印 + + @Test + void scenario5_documentsTrackingAndPrinting() { + WarehouseSdk sdk = sdk(transport()); + + // BOL + List bols = sdk.warehouses(WH, conn()).orderBols("FBA1"); + assertEquals(1, bols.size()); + assertEquals("cp005", bols.get(0).bolCode()); + + // 轨迹:节点 + List events = sdk.warehouses(WH, conn()).track("1Z111"); + assertEquals(1, events.size()); + // 轨迹:运单级,带上网 / 妥投时间 + TrackingInfo info = sdk.warehouses(WH, conn()).trackShipment("1Z111"); + assertNotNull(info.firstOnlineAt()); + assertNotNull(info.deliveredAt()); + + // 箱唛(同步 PDF) + WarehouseLabel label = sdk.warehouses(WH, conn()).printCaseMarks( + CaseMarkPrintCommand.builder() + .paperSize(CaseMarkPaperSize.SIZE_70_30) + .item("ybtest", 1) + .build()); + assertEquals("https://oss/case.pdf", label.url()); + + // 入库单 + assertNotNull(sdk.warehouses(WH, conn()).inbound().get("REV1")); + } + + // ================================================================ 未实现能力 + + @Test + void unimplementedCapabilitiesThrow() { + WarehouseSdk sdk = sdk(transport()); + + // 调拨 + assertThrows(RuntimeException.class, + () -> sdk.warehouses(WH, conn()).getTransfer("T-1")); + // 退货检验后处理(缺行 id) + assertThrows(RuntimeException.class, + () -> sdk.warehouses(WH, conn()).returns().process( + common.ecommerce.warehouse.model.ReturnProcessCommand.builder() + .providerReturnNo("RMA1").lineId(1) + .disposition(common.ecommerce.warehouse.enums + .ReturnProcessDisposition.RESTOCK) + .build())); + } +}