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.
171 lines
7.0 KiB
171 lines
7.0 KiB
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())); |
|
} |
|
}
|
|
|