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.
398 lines
15 KiB
398 lines
15 KiB
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 抽象没有被聚合器带偏: |
|
* 单平台、能力并集即账户能力、分页靠游标、不依赖网络。 |
|
* |
|
* <pre> |
|
* FakeDirectAdapter adapter = FakeDirectAdapter.builder() |
|
* .platform(Platform.WALMART_SC) |
|
* .orders(3) |
|
* .pageSize(2) |
|
* .build(); |
|
* </pre> |
|
*/ |
|
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<Capability> capabilities; |
|
private final List<SalesOrder> orders; |
|
private final List<ProductListing> products; |
|
private final List<AfterSale> afterSales; |
|
private final List<InboundShipment> inboundShipments; |
|
private final List<InboundReceipt> inboundReceipts; |
|
private final int pageSize; |
|
private final List<SalesOrderQuery> orderQueries = new ArrayList<SalesOrderQuery>(); |
|
private final List<ProductQuery> productQueries = new ArrayList<ProductQuery>(); |
|
private final List<String> writeCalls = new ArrayList<String>(); |
|
|
|
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<Platform> platforms() { |
|
return EnumSet.of(platform); |
|
} |
|
|
|
@Override |
|
public EnumSet<Capability> capabilities() { |
|
return EnumSet.copyOf(capabilities); |
|
} |
|
|
|
@Override |
|
public Page<SalesOrder> 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<ProductListing> 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<AfterSale> pull(ChannelContext ctx, AfterSaleQuery query) { |
|
requireCapability(Capability.RETURNS); |
|
return slice(afterSales, query.cursor()); |
|
} |
|
|
|
@Override |
|
public Page<InboundShipment> pull(ChannelContext ctx, InboundShipmentQuery query) { |
|
requireCapability(Capability.INBOUND_SHIPMENT); |
|
return slice(inboundShipments, query.cursor()); |
|
} |
|
|
|
@Override |
|
public Page<InboundReceipt> 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<String> writeCalls() { |
|
return Collections.unmodifiableList(writeCalls); |
|
} |
|
|
|
public List<SalesOrderQuery> orderQueries() { |
|
return Collections.unmodifiableList(orderQueries); |
|
} |
|
|
|
public List<ProductQuery> productQueries() { |
|
return Collections.unmodifiableList(productQueries); |
|
} |
|
|
|
public void resetRecorded() { |
|
orderQueries.clear(); |
|
productQueries.clear(); |
|
writeCalls.clear(); |
|
} |
|
|
|
// ---------------------------------------------------------------- internals |
|
|
|
private <T> Page<T> slice(List<T> 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<Capability> capabilities = EnumSet.of(Capability.SALES_ORDER, Capability.PRODUCT, |
|
Capability.RETURNS, Capability.INBOUND_SHIPMENT, Capability.INBOUND_RECEIPT); |
|
private List<SalesOrder> orders = new ArrayList<SalesOrder>(); |
|
private List<ProductListing> products = new ArrayList<ProductListing>(); |
|
private List<AfterSale> afterSales = new ArrayList<AfterSale>(); |
|
private List<InboundShipment> inboundShipments = new ArrayList<InboundShipment>(); |
|
private List<InboundReceipt> inboundReceipts = new ArrayList<InboundReceipt>(); |
|
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<SalesOrder>(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<ProductListing>(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<AfterSale>(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<InboundShipment>(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<InboundReceipt>(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); |
|
} |
|
} |
|
}
|
|
|