Browse Source

test(edayun): 补 SDK 装配链路冒烟(离线,按业务场景)

从门面 WarehouseSdk 走一遍,覆盖:
- 装配:能力位全量断言(12 个已声明 + 3 个必须为假)、工厂能建出适配器
- 场景 1 主数据:仓库 / 承运商 / 物流产品(-998 已跳过)
- 场景 2 发货:试算 → 建单 → 查单 → 面单 → 取消前校验 → 取消,
  外加建单幂等(同一 outboundRequestNo 只打一次仓方)
- 场景 3 库存:safeStock 缺失映射为 -1
- 场景 4 退货:建单 → 详情 → 列表 → 取消
- 场景 5 单据 / 轨迹 / 打印:BOL、节点与运单级轨迹(上网/妥投时间)、
  箱唛、入库单
- 未实现能力(调拨 / 退货检验后处理)必须抛,不返回空

不联网:用 RecordingTransport + 真实报文样本。适配器直接注册(传输层可替换),
另用一例单独验证工厂路径能 build 出适配器。

验证:9 个用例全绿;全仓 mvn test 通过。

Co-Authored-By: Claude <noreply@anthropic.com>
feature/Walmart
chenchuchuan 3 days ago
parent
commit
8dabf9fb1b
  1. 436
      warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java

436
warehouse-sdk-edayun/src/test/java/common/ecommerce/edayun/sdk/EdayunSdkSmokeTest.java

@ -0,0 +1,436 @@ @@ -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 装配链路冒烟。
*
* <p><b>不联网</b>:走 {@link WarehouseSdk} 门面 → 工厂 → 适配器 → 假传输层,
* 用真实报文样本验一遍「能不能装起来、能力位对不对、字段有没有搬对」。</p>
*
* <p>覆盖的业务场景:</p>
* <ol>
* <li>主数据:仓库 / 承运商 / 物流产品</li>
* <li>发货:试算 → 建单 → 查单 → 面单 → 取消</li>
* <li>库存:查询</li>
* <li>退货:建单 → 查详情 → 列表 → 取消</li>
* <li>单据 / 轨迹 / 打印</li>
* </ol>
*/
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<WarehouseCapability> 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<WarehouseFacility> warehouses = sdk.warehouses(WH, conn()).warehouses();
assertEquals(1, warehouses.size());
assertEquals("USLA", warehouses.get(0).warehouseCode());
assertEquals("2", warehouses.get(0).providerWarehouseId());
List<WarehouseCarrier> carriers = sdk.warehouses(WH, conn()).carrierDirectory();
assertEquals(1, carriers.size());
assertEquals("FedEx", carriers.get(0).nameEn());
assertEquals(1, carriers.get(0).logists().size());
List<LogisticsProduct> 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<FeeEstimateResult> 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<InventorySnapshot> 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<BolDocument> bols = sdk.warehouses(WH, conn()).orderBols("FBA1");
assertEquals(1, bols.size());
assertEquals("cp005", bols.get(0).bolCode());
// 轨迹:节点
List<TrackEvent> 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()));
}
}
Loading…
Cancel
Save