|
|
|
|
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()));
|
|
|
|
|
}
|
|
|
|
|
}
|