package common.ecommerce.warehouse.sdk; import common.ecommerce.shared.spi.ChannelSecret; import common.ecommerce.shared.support.Money; import common.ecommerce.warehouse.enums.WarehouseCapability; import common.ecommerce.warehouse.enums.WarehouseProvider; import common.ecommerce.warehouse.error.OutboundCancelBlockedException; import common.ecommerce.warehouse.error.OutboundCancelChargeRequiredException; import common.ecommerce.warehouse.error.WarehouseUnsupportedCapabilityException; import common.ecommerce.warehouse.model.CancelCommand; import common.ecommerce.warehouse.enums.CancelEligibility; import common.ecommerce.warehouse.model.CancelResult; import common.ecommerce.warehouse.enums.LabelMode; import common.ecommerce.warehouse.model.OutboundCommand; import common.ecommerce.warehouse.model.OutboundLine; import common.ecommerce.warehouse.model.OutboundReceipt; import common.ecommerce.warehouse.model.OutboundRef; import common.ecommerce.shared.testkit.InMemoryIdempotencyStore; import common.ecommerce.warehouse.model.ShipTo; import common.ecommerce.warehouse.testkit.FakeWarehouseAdapter; import common.ecommerce.warehouse.testkit.InMemoryWarehouses; import org.junit.jupiter.api.BeforeEach; import org.junit.jupiter.api.Test; import java.time.Clock; import java.time.Instant; import java.time.ZoneOffset; 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; /** * 仓库门面:能力检查、写操作强制幂等、收费取消拦截。 */ class WarehouseSdkTest { private static final Instant T0 = Instant.parse("2026-11-09T00:00:00Z"); private static final Clock CLOCK = Clock.fixed(T0, ZoneOffset.UTC); private static final String WH = "YQN-RF_NY_US"; private FakeWarehouseAdapter adapter; private InMemoryIdempotencyStore idempotency; private WarehouseSdk sdk; @BeforeEach void setUp() { adapter = new FakeWarehouseAdapter(); idempotency = new InMemoryIdempotencyStore(); InMemoryWarehouses repo = new InMemoryWarehouses() .put(FakeWarehouseAdapter.account(WH, WarehouseProvider.CUSTOM)); sdk = WarehouseSdk.builder() .warehouseRepository(repo) .idempotencyStore(idempotency) .clock(CLOCK) .register(adapter) .build(); } private static OutboundCommand cmd(String requestNo) { return OutboundCommand.builder() .outboundRequestNo(requestNo) .orderRef("SO-1") .labelMode(LabelMode.WAREHOUSE_LABEL) .salesPlatform(common.ecommerce.shared.model.Platform.WALMART_SC) .shipTo(ShipTo.builder() .name("B") // 测试数据 .countryCode("US") .city("New York") .addressLine1("1 Test St") .build()) .line(OutboundLine.builder() .lineNo("1") .omsSku("DM00001") .quantity(1) .declareName("Sample") .declareValue(Money.of("10.00", "USD")) .build()) .build(); } @Test void createIsIdempotent() { WarehouseOperations ops = sdk.warehouses(WH, FakeWarehouseAdapter.connection()); OutboundReceipt first = ops.outbound().create(cmd("OB-1")); assertEquals("WH1", first.providerOrderId()); assertEquals(1, adapter.createCallCount()); OutboundReceipt again = ops.outbound().create(cmd("OB-1")); assertEquals("WH1", again.providerOrderId()); assertEquals(1, adapter.createCallCount(), "第二次不应再调仓"); } @Test void retryableFailureAllowsRerun() { adapter.failNextCreate(); WarehouseOperations ops = sdk.warehouses(WH, FakeWarehouseAdapter.connection()); assertThrows(RuntimeException.class, () -> ops.outbound().create(cmd("OB-2"))); assertEquals(0, adapter.createCallCount()); OutboundReceipt receipt = ops.outbound().create(cmd("OB-2")); assertNotNull(receipt.providerOrderId()); assertEquals(1, adapter.createCallCount()); } @Test void chargedCancelRequiresExplicitAccept() { adapter.chargeCancel("5.00"); WarehouseOperations ops = sdk.warehouses(WH, FakeWarehouseAdapter.connection()); ops.outbound().create(cmd("OB-3")); assertEquals(CancelEligibility.CHARGED, ops.outbound().checkCancel(OutboundRef.ofRequestNo("OB-3"))); assertThrows(OutboundCancelChargeRequiredException.class, () -> ops.outbound().cancel(CancelCommand.builder() .outboundRequestNo("OB-3").build())); CancelResult ok = ops.outbound().cancel(CancelCommand.builder() .outboundRequestNo("OB-3").acceptCharge(true).build()); assertTrue(ok.cancelled()); assertEquals(CancelEligibility.CHARGED, ok.eligibility()); } @Test void blockedCancelThrows() { adapter.blockCancel(); WarehouseOperations ops = sdk.warehouses(WH, FakeWarehouseAdapter.connection()); ops.outbound().create(cmd("OB-4")); assertThrows(OutboundCancelBlockedException.class, () -> ops.outbound().cancel(CancelCommand.builder() .outboundRequestNo("OB-4").acceptCharge(true).build())); } @Test void unimplementedCapabilityIsRejected() { WarehouseOperations ops = sdk.warehouses(WH, FakeWarehouseAdapter.connection()); assertThrows(WarehouseUnsupportedCapabilityException.class, () -> ops.inventory().query( common.ecommerce.warehouse.model.InventoryQuery.builder().build())); assertThrows(WarehouseUnsupportedCapabilityException.class, () -> ops.inbound().get("INB-1")); assertEquals(false, sdk.capabilities(WH).supports(WarehouseCapability.INVENTORY_QUERY)); assertEquals(true, sdk.capabilities(WH).supports(WarehouseCapability.OUTBOUND)); } @Test void writeWithoutIdempotencyStoreFails() { InMemoryWarehouses repo = new InMemoryWarehouses() .put(FakeWarehouseAdapter.account(WH, WarehouseProvider.CUSTOM)); WarehouseSdk noGuard = WarehouseSdk.builder() .warehouseRepository(repo) .clock(CLOCK) .register(new FakeWarehouseAdapter()) .build(); assertThrows(IllegalStateException.class, () -> noGuard.warehouses(WH, FakeWarehouseAdapter.connection()) .outbound().create(cmd("OB-5"))); } @Test void unknownWarehouseFails() { assertThrows(IllegalStateException.class, () -> sdk.warehouses("NOT-CONFIGURED", FakeWarehouseAdapter.connection())); } }