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

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