package common.ecommerce.shared.testkit; import common.ecommerce.channel.capability.AfterSaleCapable; import common.ecommerce.channel.capability.InboundReceiptCapable; import common.ecommerce.channel.capability.InboundShipmentCapable; import common.ecommerce.channel.capability.ProductCapable; import common.ecommerce.channel.capability.SalesOrderCapable; import common.ecommerce.shared.error.ChannelException; import common.ecommerce.channel.model.account.AccountKey; import common.ecommerce.shared.model.Capability; import common.ecommerce.channel.model.aftersale.AfterSale; import common.ecommerce.channel.model.aftersale.AfterSaleQuery; import common.ecommerce.channel.model.aftersale.AfterSaleType; import common.ecommerce.channel.model.account.ChannelAccount; import common.ecommerce.channel.model.inbound.InboundReceipt; import common.ecommerce.channel.model.inbound.InboundReceiptQuery; import common.ecommerce.channel.model.inbound.InboundShipment; import common.ecommerce.channel.model.inbound.InboundShipmentQuery; import common.ecommerce.shared.model.ChannelProvider; import common.ecommerce.shared.support.Money; import common.ecommerce.channel.model.order.OrderLine; import common.ecommerce.shared.support.Page; import common.ecommerce.shared.model.Platform; import common.ecommerce.shared.support.PlatformTime; import common.ecommerce.channel.model.product.ProductListing; import common.ecommerce.channel.model.product.ProductQuery; import common.ecommerce.channel.model.product.ProductStatus; import common.ecommerce.channel.model.product.ProductRef; import common.ecommerce.channel.model.product.ProductSyncStrategy; import common.ecommerce.channel.model.order.SalesOrder; import common.ecommerce.channel.model.order.SalesOrderQuery; import common.ecommerce.channel.model.order.SalesOrderRef; import common.ecommerce.channel.sdk.ChannelConnection; import common.ecommerce.channel.sdk.ChannelContext; import common.ecommerce.shared.spi.ChannelSecret; import java.time.Instant; import java.util.ArrayList; import java.util.Arrays; import java.util.Collections; import java.util.EnumSet; import java.util.List; import java.util.Set; /** * 假直连适配器。用来验证 core 抽象没有被聚合器带偏: * 单平台、能力并集即账户能力、分页靠游标、不依赖网络。 * *
 * FakeDirectAdapter adapter = FakeDirectAdapter.builder()
 *         .platform(Platform.WALMART_SC)
 *         .orders(3)
 *         .pageSize(2)
 *         .build();
 * 
*/ public final class FakeDirectAdapter implements SalesOrderCapable, ProductCapable, AfterSaleCapable, InboundShipmentCapable, InboundReceiptCapable { /** 游标格式:{@code item:序号},仅用于测试分页。 */ private static final String CURSOR_PREFIX = "item:"; private final String adapterId; private final Platform platform; private final EnumSet capabilities; private final List orders; private final List products; private final List afterSales; private final List inboundShipments; private final List inboundReceipts; private final int pageSize; private final List orderQueries = new ArrayList(); private final List productQueries = new ArrayList(); private final List writeCalls = new ArrayList(); private FakeDirectAdapter(Builder b) { this.adapterId = b.adapterId; this.platform = b.platform; this.capabilities = b.capabilities; this.orders = b.orders; this.products = b.products; this.afterSales = b.afterSales; this.inboundShipments = b.inboundShipments; this.inboundReceipts = b.inboundReceipts; this.pageSize = b.pageSize; } public static Builder builder() { return new Builder(); } /** 直连测试账户;聚合器账户只是 provider / platformCode 不同,能力检查逻辑共用。 */ public static ChannelAccount account(Platform platform, String omsStoreId) { return ChannelAccount.builder() .key(AccountKey.of(ChannelProvider.DIRECT, platform, omsStoreId)) .externalStoreId("fake-seller-01") .credentialRef("kms://test/fake-direct") .marketplaceZone("America/Los_Angeles") .currency("USD") .build(); } /** 测试用连接信息:调用方每次传入的那一份。 */ public static ChannelConnection connection() { return ChannelConnection.of("https://fake.example.com", ChannelSecret.builder().appKey("fake-key").appSecret("fake-secret").build()); } @Override public String adapterId() { return adapterId; } @Override public ChannelProvider provider() { return ChannelProvider.DIRECT; } @Override public Set platforms() { return EnumSet.of(platform); } @Override public EnumSet capabilities() { return EnumSet.copyOf(capabilities); } @Override public Page pull(ChannelContext ctx, SalesOrderQuery query) { requireCapability(Capability.SALES_ORDER); orderQueries.add(query); return slice(orders, query.cursor()); } @Override public SalesOrder get(ChannelContext ctx, SalesOrderRef ref) { requireCapability(Capability.SALES_ORDER); for (SalesOrder o : orders) { if (o.channelOrderId().equals(ref.channelOrderId())) { return o; } } return null; } @Override public ProductSyncStrategy syncStrategy() { return ProductSyncStrategy.FULL_PULL_DIFF; } @Override public Page pull(ChannelContext ctx, ProductQuery query) { requireCapability(Capability.PRODUCT); productQueries.add(query); return slice(products, query.cursor()); } @Override public ProductListing get(ChannelContext ctx, ProductRef ref) { requireCapability(Capability.PRODUCT); for (ProductListing p : products) { if (p.platformSku().equals(ref.platformSku())) { return p; } } return null; } @Override public Page pull(ChannelContext ctx, AfterSaleQuery query) { requireCapability(Capability.RETURNS); return slice(afterSales, query.cursor()); } @Override public Page pull(ChannelContext ctx, InboundShipmentQuery query) { requireCapability(Capability.INBOUND_SHIPMENT); return slice(inboundShipments, query.cursor()); } @Override public Page pull(ChannelContext ctx, InboundReceiptQuery query) { requireCapability(Capability.INBOUND_RECEIPT); return slice(inboundReceipts, query.cursor()); } /** 模拟一次写操作,如标发;带 IdempotencyGuard 的测试用它确认平台只被真正调用一次。 */ public String markShipped(String packageId, String trackingNumber) { writeCalls.add(packageId + ':' + trackingNumber); return "SHIP-" + writeCalls.size(); } public int writeCallCount() { return writeCalls.size(); } public List writeCalls() { return Collections.unmodifiableList(writeCalls); } public List orderQueries() { return Collections.unmodifiableList(orderQueries); } public List productQueries() { return Collections.unmodifiableList(productQueries); } public void resetRecorded() { orderQueries.clear(); productQueries.clear(); writeCalls.clear(); } // ---------------------------------------------------------------- internals private Page slice(List all, String cursor) { int from = cursorIndex(cursor); int to = Math.min(from + pageSize, all.size()); String next = to < all.size() ? CURSOR_PREFIX + to : null; return Page.of(all.subList(from, to), next); } private void requireCapability(Capability capability) { if (!capabilities.contains(capability)) { throw new ChannelException.UnsupportedCapabilityException(capability); } } private static int cursorIndex(String cursor) { if (cursor == null || cursor.isEmpty()) { return 0; } if (!cursor.startsWith(CURSOR_PREFIX)) { throw new IllegalArgumentException("bad cursor: " + cursor); } return Integer.parseInt(cursor.substring(CURSOR_PREFIX.length())); } private static SalesOrder sampleOrder(Platform platform, String channelOrderId) { return SalesOrder.builder() .omsStoreId("oms-test-001") .channelOrderId(channelOrderId) .status("Created") .buyerName("Fake Buyer") .shipToCountryCode("US") .lines(Collections.singletonList(OrderLine.builder() .lineId(channelOrderId + "-1") .platformSku("SKU-1") .quantity(1) .unitPrice(Money.of("9.99", "USD")) .build())) .totalAmount(Money.of("9.99", "USD")) .occurredAt(PlatformTime.of(Instant.parse("2026-10-26T00:00:00Z"), "America/Los_Angeles")) .sourceProvider(ChannelProvider.DIRECT) .sourceAccountId("fake-seller-01") .build(); } /** 生成一条最小可用的入库货件,单号形如 {@code SHIP-1}。 */ private static InboundShipment sampleInboundShipment(Platform platform, String shipmentNo) { return InboundShipment.builder() .omsStoreId("oms-test-001") .sourceProvider(ChannelProvider.DIRECT) .sourceAccountId("fake-seller-01") .shipmentId("ID-" + shipmentNo) .shipmentNo(shipmentNo) .storeId("store-1") .status("WORKING") .statusName("处理中") .createdAt(PlatformTime.of(Instant.parse("2026-10-26T00:00:00Z"), "America/Los_Angeles")) .build(); } /** 生成一条最小可用的 FBA 接收明细,货件号形如 {@code SHIP-1}。 */ private static InboundReceipt sampleInboundReceipt(Platform platform, String shipmentNo) { return InboundReceipt.builder() .omsStoreId("oms-test-001") .sourceProvider(ChannelProvider.DIRECT) .sourceAccountId("fake-seller-01") .shipmentId(shipmentNo) .fnsku("FNSKU-1") .sku("SKU-1") .quantity(1) .fulfillmentCenterId("FC1") .build(); } // ---------------------------------------------------------------- builder public static final class Builder { private String adapterId = "fake-direct"; private Platform platform = Platform.WALMART_SC; private EnumSet capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT, Capability.RETURNS, Capability.INBOUND_SHIPMENT, Capability.INBOUND_RECEIPT); private List orders = new ArrayList(); private List products = new ArrayList(); private List afterSales = new ArrayList(); private List inboundShipments = new ArrayList(); private List inboundReceipts = new ArrayList(); private int pageSize = 100; public Builder adapterId(String adapterId) { this.adapterId = adapterId; return this; } public Builder platform(Platform platform) { this.platform = platform; return this; } /** 能力并集必须与实现的接口一致;默认订单 + 商品 + 售后 + 两类入库。 */ public Builder capabilities(Capability... capabilities) { this.capabilities = capabilities.length == 0 ? EnumSet.noneOf(Capability.class) : EnumSet.copyOf(Arrays.asList(capabilities)); return this; } /** 生成 count 条顺序订单,单号形如 {@code FAKE-1..count}。 */ public Builder orders(int count) { this.orders = new ArrayList(count); for (int i = 1; i <= count; i++) { this.orders.add(sampleOrder(platform, "FAKE-" + i)); } return this; } public Builder products(int count) { this.products = new ArrayList(count); for (int i = 1; i <= count; i++) { this.products.add(ProductListing.builder() .omsStoreId("oms-test-001") .platformSku("SKU-" + i) .title("Fake product " + i) .platform(platform) .status(ProductStatus.ACTIVE) .rawStatus("ACTIVE") .sourceProvider(ChannelProvider.DIRECT) .build()); } return this; } /** 生成 count 条售后行,类型在退款/退货/换货之间轮转。 */ public Builder afterSales(int count) { this.afterSales = new ArrayList(count); AfterSaleType[] types = AfterSaleType.values(); for (int i = 1; i <= count; i++) { AfterSaleType type = types[(i - 1) % 3]; this.afterSales.add(AfterSale.builder() .platform(platform) .omsStoreId("oms-test-001") .afterSaleId("AS-" + i) .channelOrderId("FAKE-" + i) .type(type) .rawType(type.name()) .quantity(1) .platformSku("SKU-" + i) .sourceProvider(ChannelProvider.DIRECT) .build()); } return this; } /** 生成 count 条入库货件,单号形如 {@code SHIP-1..count}。 */ public Builder inboundShipments(int count) { this.inboundShipments = new ArrayList(count); for (int i = 1; i <= count; i++) { this.inboundShipments.add(sampleInboundShipment(platform, "SHIP-" + i)); } return this; } /** 生成 count 条 FBA 接收明细,货件号形如 {@code SHIP-1..count}。 */ public Builder inboundReceipts(int count) { this.inboundReceipts = new ArrayList(count); for (int i = 1; i <= count; i++) { this.inboundReceipts.add(sampleInboundReceipt(platform, "SHIP-" + i)); } return this; } public Builder pageSize(int pageSize) { if (pageSize <= 0) { throw new IllegalArgumentException("pageSize must be positive"); } this.pageSize = pageSize; return this; } public FakeDirectAdapter build() { return new FakeDirectAdapter(this); } } }