pull(SalesOrderQuery query) {
- requireSalesOrderCapable();
- return ((SalesOrderCapable) adapter).pull(ctx, query);
- }
-
- public SalesOrder get(String channelOrderId) {
- requireSalesOrderCapable();
- return ((SalesOrderCapable) adapter).get(ctx, channelOrderId);
- }
-
- private void requireSalesOrderCapable() {
- if (!adapter.supports(account, Capability.SALES_ORDER) || !(adapter instanceof SalesOrderCapable)) {
- throw new ChannelException.UnsupportedCapabilityException(Capability.SALES_ORDER);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/AuthException.java b/core/src/main/java/apelet/common/ecommerce/error/AuthException.java
deleted file mode 100644
index 98d317f..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/AuthException.java
+++ /dev/null
@@ -1,17 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/**
- * 认证失败:401/403、token 失效。刷新后重试一次;仍失败则告警并停用账户。
- */
-public class AuthException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- public AuthException(Builder b) {
- super(b, null);
- }
-
- public AuthException(Builder b, Throwable cause) {
- super(b, cause);
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/ChannelException.java b/core/src/main/java/apelet/common/ecommerce/error/ChannelException.java
deleted file mode 100644
index f40130a..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/ChannelException.java
+++ /dev/null
@@ -1,154 +0,0 @@
-package apelet.common.ecommerce.error;
-
-import apelet.common.ecommerce.model.Capability;
-import apelet.common.ecommerce.model.Platform;
-
-/**
- * 统一异常基类。适配器把平台错误映射到这里;{@code rawResponse} 必须已脱敏。
- */
-public class ChannelException extends RuntimeException {
-
- private static final long serialVersionUID = 1L;
-
- private final Platform platform;
- private final String provider;
- private final String omsStoreId;
- private final String operation;
- private final String requestId;
- private final String platformCode;
- private final boolean retryable;
- private final String rawResponse;
-
- public ChannelException(Builder b, Throwable cause) {
- super(b.message != null ? b.message : b.operation, cause);
- this.platform = b.platform;
- this.provider = b.provider;
- this.omsStoreId = b.omsStoreId;
- this.operation = b.operation;
- this.requestId = b.requestId;
- this.platformCode = b.platformCode;
- this.retryable = b.retryable;
- this.rawResponse = b.rawResponse;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public Platform platform() {
- return platform;
- }
-
- public String provider() {
- return provider;
- }
-
- public String omsStoreId() {
- return omsStoreId;
- }
-
- public String operation() {
- return operation;
- }
-
- public String requestId() {
- return requestId;
- }
-
- public String platformCode() {
- return platformCode;
- }
-
- public boolean retryable() {
- return retryable;
- }
-
- public String rawResponse() {
- return rawResponse;
- }
-
- public static class Builder {
-
- protected String message;
- protected Platform platform;
- protected String provider;
- protected String omsStoreId;
- protected String operation;
- protected String requestId;
- protected String platformCode;
- protected boolean retryable;
- protected String rawResponse;
-
- public Builder message(String message) {
- this.message = message;
- return this;
- }
-
- public Builder platform(Platform platform) {
- this.platform = platform;
- return this;
- }
-
- public Builder provider(String provider) {
- this.provider = provider;
- return this;
- }
-
- public Builder omsStoreId(String omsStoreId) {
- this.omsStoreId = omsStoreId;
- return this;
- }
-
- public Builder operation(String operation) {
- this.operation = operation;
- return this;
- }
-
- public Builder requestId(String requestId) {
- this.requestId = requestId;
- return this;
- }
-
- public Builder platformCode(String platformCode) {
- this.platformCode = platformCode;
- return this;
- }
-
- public Builder retryable(boolean retryable) {
- this.retryable = retryable;
- return this;
- }
-
- public Builder rawResponse(String rawResponse) {
- this.rawResponse = rawResponse;
- return this;
- }
-
- public ChannelException build() {
- return new ChannelException(this, null);
- }
-
- public ChannelException build(Throwable cause) {
- return new ChannelException(this, cause);
- }
- }
-
- /** 平台不支持该能力;调用方走 3PL 或人工兜底。 */
- public static class UnsupportedCapabilityException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- private final Capability capability;
-
- public UnsupportedCapabilityException(Capability capability) {
- super(ChannelException.builder()
- .message("capability [" + capability + "] is not supported by this adapter")
- .operation("capabilities"), null);
- this.capability = capability;
- }
-
- public Capability capability() {
- return capability;
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/CrossProviderConflictException.java b/core/src/main/java/apelet/common/ecommerce/error/CrossProviderConflictException.java
deleted file mode 100644
index 861ecd3..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/CrossProviderConflictException.java
+++ /dev/null
@@ -1,22 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/**
- * 跨 provider 冲突:同一业务动作已由另一个 provider 完成。
- *
- * 不自动跨 provider 重试,必须人工确认。
- */
-public class CrossProviderConflictException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- private final String completedByProvider;
-
- public CrossProviderConflictException(Builder b, String completedByProvider) {
- super(b, null);
- this.completedByProvider = completedByProvider;
- }
-
- public String completedByProvider() {
- return completedByProvider;
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/IdempotencyConflictException.java b/core/src/main/java/apelet/common/ecommerce/error/IdempotencyConflictException.java
deleted file mode 100644
index ccadc75..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/IdempotencyConflictException.java
+++ /dev/null
@@ -1,18 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/** 写操作幂等冲突:重复写。返回已完成结果,不视为失败。 */
-public class IdempotencyConflictException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- private final String idempotencyKey;
-
- public IdempotencyConflictException(Builder b, String idempotencyKey) {
- super(b, null);
- this.idempotencyKey = idempotencyKey;
- }
-
- public String idempotencyKey() {
- return idempotencyKey;
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/PlatformBusinessException.java b/core/src/main/java/apelet/common/ecommerce/error/PlatformBusinessException.java
deleted file mode 100644
index 5643984..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/PlatformBusinessException.java
+++ /dev/null
@@ -1,13 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/**
- * 平台业务错误码。是否重试视错误码而定,保留 code/message/raw。
- */
-public class PlatformBusinessException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- public PlatformBusinessException(Builder b) {
- super(b, null);
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/RateLimitException.java b/core/src/main/java/apelet/common/ecommerce/error/RateLimitException.java
deleted file mode 100644
index 08d9e1c..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/RateLimitException.java
+++ /dev/null
@@ -1,20 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/**
- * 限流:429。遵守 Retry-After 并退避。
- */
-public class RateLimitException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- private final long retryAfterMillis;
-
- public RateLimitException(Builder b, long retryAfterMillis) {
- super(b, null);
- this.retryAfterMillis = retryAfterMillis;
- }
-
- public long retryAfterMillis() {
- return retryAfterMillis;
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/TransientException.java b/core/src/main/java/apelet/common/ecommerce/error/TransientException.java
deleted file mode 100644
index d3cbdbd..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/TransientException.java
+++ /dev/null
@@ -1,13 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/**
- * 瞬时错误:5xx / 网络 / 超时。退避加抖动后重试,超过上限进入补偿队列。
- */
-public class TransientException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- public TransientException(Builder b, Throwable cause) {
- super(b, cause);
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/error/ValidationException.java b/core/src/main/java/apelet/common/ecommerce/error/ValidationException.java
deleted file mode 100644
index 1838a43..0000000
--- a/core/src/main/java/apelet/common/ecommerce/error/ValidationException.java
+++ /dev/null
@@ -1,17 +0,0 @@
-package apelet.common.ecommerce.error;
-
-/**
- * 参数或映射错误:4xx。不重试,保留原始报文由人工修正映射。
- */
-public class ValidationException extends ChannelException {
-
- private static final long serialVersionUID = 1L;
-
- public ValidationException(Builder b) {
- super(b, null);
- }
-
- public ValidationException(Builder b, Throwable cause) {
- super(b, cause);
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/AccountKey.java b/core/src/main/java/apelet/common/ecommerce/model/AccountKey.java
deleted file mode 100644
index bbde0bb..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/AccountKey.java
+++ /dev/null
@@ -1,65 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.util.Objects;
-
-/**
- * 渠道账户标识:{@code provider + platform + omsStoreId}。
- *
- * 这是所有门面调用的隔离维度。同一 omsStoreId 可以同时绑定直连与聚合器账户,
- * 业务实体不会因此重复——provider 不进入业务主键,见 {@link CanonicalKeys}。
- */
-public final class AccountKey {
-
- private final ChannelProvider provider;
- private final Platform platform;
- private final String omsStoreId;
-
- private AccountKey(ChannelProvider provider, Platform platform, String omsStoreId) {
- this.provider = Objects.requireNonNull(provider, "provider");
- this.platform = Objects.requireNonNull(platform, "platform");
- if (omsStoreId == null || omsStoreId.trim().isEmpty()) {
- throw new IllegalArgumentException("omsStoreId must not be blank");
- }
- this.omsStoreId = omsStoreId.trim();
- }
-
- public static AccountKey of(ChannelProvider provider, Platform platform, String omsStoreId) {
- return new AccountKey(provider, platform, omsStoreId);
- }
-
- public ChannelProvider provider() {
- return provider;
- }
-
- public Platform platform() {
- return platform;
- }
-
- public String omsStoreId() {
- return omsStoreId;
- }
-
- @Override
- public boolean equals(Object o) {
- if (this == o) {
- return true;
- }
- if (!(o instanceof AccountKey)) {
- return false;
- }
- AccountKey that = (AccountKey) o;
- return provider == that.provider
- && platform == that.platform
- && omsStoreId.equals(that.omsStoreId);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(provider, platform, omsStoreId);
- }
-
- @Override
- public String toString() {
- return provider + ":" + platform + ":" + omsStoreId;
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/CanonicalKeys.java b/core/src/main/java/apelet/common/ecommerce/model/CanonicalKeys.java
deleted file mode 100644
index 4cf6262..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/CanonicalKeys.java
+++ /dev/null
@@ -1,112 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.nio.charset.StandardCharsets;
-import java.security.MessageDigest;
-import java.security.NoSuchAlgorithmException;
-
-/**
- * 三级标识计算。
- *
- *
- * - omsStoreId:业务归属,直连与聚合器都映射到同一个店铺
- * - canonicalKey:platform + omsStoreId + 平台实体 ID,用于 upsert、去重、状态流转
- * - sourceKey:provider + platform + externalStoreId + 平台实体 ID,用于原始报文、水位线、审计
- *
- *
- * provider 不得进入 canonicalKey,否则直连与聚合器切换会把同一实体变成两条。
- */
-public final class CanonicalKeys {
-
- private CanonicalKeys() {
- }
-
- public static String canonical(Platform platform, String omsStoreId, String platformEntityId) {
- return platform.name() + ':' + require(omsStoreId, "omsStoreId") + ':' + require(platformEntityId, "platformEntityId");
- }
-
- public static String source(ChannelProvider provider, Platform platform, String externalStoreId, String platformEntityId) {
- return provider.name() + ':' + platform.name() + ':' + require(externalStoreId, "externalStoreId")
- + ':' + require(platformEntityId, "platformEntityId");
- }
-
- /** 销售订单 canonicalKey:platform + omsStoreId + channelOrderId */
- public static String salesOrder(Platform platform, String omsStoreId, String channelOrderId) {
- return canonical(platform, omsStoreId, channelOrderId);
- }
-
- /** 商品 canonicalKey:platform + omsStoreId + platformSku */
- public static String product(Platform platform, String omsStoreId, String platformSku) {
- return canonical(platform, omsStoreId, platformSku);
- }
-
- /**
- * 结算单指纹:hash(periodStart, periodEnd, currency, paymentId/statementNo)。
- *
- * 刻意不含金额,避免不同 provider 的舍入差异造成重复账单;金额差异由 SourceConflict 记录。
- */
- public static String statementFingerprint(String periodStart, String periodEnd, String currency, String statementNo) {
- return sha256Hex("STMT|" + periodStart + '|' + periodEnd + '|' + currency + '|' + statementNo);
- }
-
- /** 账单行指纹:hash(platformTxnId, orderRef, type, amount, currency, postedAt) */
- public static String txnFingerprint(String platformTxnId, String orderRef, String type,
- String amount, String currency, String postedAt) {
- return sha256Hex("TXN|" + platformTxnId + '|' + orderRef + '|' + type + '|' + amount + '|' + currency + '|' + postedAt);
- }
-
- /** 事件指纹:hash(eventType, platformOrderId, returnId/refundId, occurredAt, status) */
- public static String eventFingerprint(String eventType, String platformOrderId, String returnOrRefundId,
- String occurredAt, String status) {
- return sha256Hex("EVT|" + eventType + '|' + platformOrderId + '|' + returnOrRefundId + '|' + occurredAt + '|' + status);
- }
-
- /** 1P 扣款指纹:hash(poNumber, invoiceNumber, type, amount, currency, period, reason) */
- public static String deductionFingerprint(String poNumber, String invoiceNumber, String type,
- String amount, String currency, String period, String reason) {
- return sha256Hex("DED|" + poNumber + '|' + invoiceNumber + '|' + type + '|'
- + amount + '|' + currency + '|' + period + '|' + reason);
- }
-
- /**
- * 写操作业务幂等键:platform + omsStoreId + businessRef + action。
- *
- * 不带 provider,直连与聚合器共用,保证同一业务动作只成功一次。
- */
- public static String businessIdempotencyKey(Platform platform, String omsStoreId, String businessRef, String action) {
- return platform.name() + ':' + require(omsStoreId, "omsStoreId") + ':' + require(businessRef, "businessRef")
- + ':' + require(action, "action");
- }
-
- /**
- * provider 请求幂等键:provider + platform + externalStoreId + operation + providerRef。
- *
- * 带 provider,用于单 provider 内的重复请求/重试去重。
- */
- public static String providerRequestKey(ChannelProvider provider, Platform platform, String externalStoreId,
- String operation, String providerRef) {
- return provider.name() + ':' + platform.name() + ':' + require(externalStoreId, "externalStoreId")
- + ':' + require(operation, "operation") + ':' + require(providerRef, "providerRef");
- }
-
- static String sha256Hex(String raw) {
- try {
- MessageDigest md = MessageDigest.getInstance("SHA-256");
- byte[] digest = md.digest(raw.getBytes(StandardCharsets.UTF_8));
- StringBuilder sb = new StringBuilder(digest.length * 2);
- for (byte b : digest) {
- sb.append(Character.forDigit((b >> 4) & 0xF, 16));
- sb.append(Character.forDigit(b & 0xF, 16));
- }
- return sb.toString();
- } catch (NoSuchAlgorithmException e) {
- throw new IllegalStateException("SHA-256 not available", e);
- }
- }
-
- private static String require(String value, String name) {
- if (value == null || value.trim().isEmpty()) {
- throw new IllegalArgumentException(name + " must not be blank");
- }
- return value.trim();
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/Capability.java b/core/src/main/java/apelet/common/ecommerce/model/Capability.java
deleted file mode 100644
index 14eda8c..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/Capability.java
+++ /dev/null
@@ -1,45 +0,0 @@
-package apelet.common.ecommerce.model;
-
-/**
- * 能力枚举。
- *
- * 适配器实现哪些能力接口,就声明哪些能力;门面据此在调用前做能力检查,
- * 缺失时抛 UnsupportedCapabilityException,而不是静默失败。
- */
-public enum Capability {
-
- /** 商品 / Listing */
- PRODUCT,
- /** 3P 销售订单 */
- SALES_ORDER,
- /** 1P 采购订单 */
- PURCHASE_ORDER,
- /** 3P 标发 */
- MARK_SHIPPED,
- /** 1P DF/DSV 发货确认 */
- VENDOR_SHIPMENT,
- /** 1P Retail ASN(856) */
- ASN,
- /** 1P 发票 */
- INVOICE,
- /** 平台面单 */
- LABEL,
- /** 作废面单 */
- LABEL_VOID,
- /** 账单 / 结算 */
- BILLING,
- /** 退货单 */
- RETURNS,
- /** 退款 */
- REFUND,
- /** 退货运单 */
- RETURN_LABEL,
- /** 1P 扣款 / 红字 */
- DEDUCTION,
- /** 事件接入 */
- WEBHOOK,
- /** 异步报表 */
- ASYNC_REPORT,
- /** EDI 报文 */
- EDI
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/ChannelAccount.java b/core/src/main/java/apelet/common/ecommerce/model/ChannelAccount.java
deleted file mode 100644
index cf4de9f..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/ChannelAccount.java
+++ /dev/null
@@ -1,167 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.Objects;
-
-/**
- * 渠道账户。一个 omsStoreId 可绑定多个 provider 账户。
- *
- * 凭证不落配置:本对象只保存 {@code credentialRef},真实密钥由宿主
- * {@code SecretProvider} 按引用取出。
- */
-public final class ChannelAccount {
-
- private final AccountKey key;
- private final String externalStoreId;
- private final Integer platformCode;
- private final String region;
- private final List marketplaceIds;
- private final String credentialRef;
- private final String marketplaceZone;
- private final String currency;
- private final String shipNode;
- private final boolean sandbox;
-
- private ChannelAccount(Builder b) {
- this.key = Objects.requireNonNull(b.key, "key");
- this.externalStoreId = Objects.requireNonNull(b.externalStoreId, "externalStoreId");
- this.platformCode = b.platformCode;
- this.region = b.region;
- this.marketplaceIds = Collections.unmodifiableList(new ArrayList(b.marketplaceIds));
- this.credentialRef = Objects.requireNonNull(b.credentialRef, "credentialRef");
- this.marketplaceZone = Objects.requireNonNull(b.marketplaceZone, "marketplaceZone");
- this.currency = Objects.requireNonNull(b.currency, "currency");
- this.shipNode = b.shipNode;
- this.sandbox = b.sandbox;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public AccountKey key() {
- return key;
- }
-
- public String omsStoreId() {
- return key.omsStoreId();
- }
-
- public Platform platform() {
- return key.platform();
- }
-
- public ChannelProvider provider() {
- return key.provider();
- }
-
- /** 平台店铺 ID / 领星 store_id */
- public String externalStoreId() {
- return externalStoreId;
- }
-
- /** 领星 platform_code;直连账户为 null,落库时用 {@link ChannelProvider#NO_PLATFORM_CODE} */
- public Integer platformCode() {
- return platformCode;
- }
-
- public String region() {
- return region;
- }
-
- public List marketplaceIds() {
- return marketplaceIds;
- }
-
- /** SecretProvider 的引用,不是密钥本身 */
- public String credentialRef() {
- return credentialRef;
- }
-
- /** IANA 时区 ID,如 America/Los_Angeles */
- public String marketplaceZone() {
- return marketplaceZone;
- }
-
- public String currency() {
- return currency;
- }
-
- public String shipNode() {
- return shipNode;
- }
-
- public boolean sandbox() {
- return sandbox;
- }
-
- public static final class Builder {
-
- private AccountKey key;
- private String externalStoreId;
- private Integer platformCode;
- private String region;
- private List marketplaceIds = Collections.emptyList();
- private String credentialRef;
- private String marketplaceZone;
- private String currency;
- private String shipNode;
- private boolean sandbox;
-
- public Builder key(AccountKey key) {
- this.key = key;
- return this;
- }
-
- public Builder externalStoreId(String externalStoreId) {
- this.externalStoreId = externalStoreId;
- return this;
- }
-
- public Builder platformCode(Integer platformCode) {
- this.platformCode = platformCode;
- return this;
- }
-
- public Builder region(String region) {
- this.region = region;
- return this;
- }
-
- public Builder marketplaceIds(List marketplaceIds) {
- this.marketplaceIds = marketplaceIds == null ? Collections.emptyList() : marketplaceIds;
- return this;
- }
-
- public Builder credentialRef(String credentialRef) {
- this.credentialRef = credentialRef;
- return this;
- }
-
- public Builder marketplaceZone(String marketplaceZone) {
- this.marketplaceZone = marketplaceZone;
- return this;
- }
-
- public Builder currency(String currency) {
- this.currency = currency;
- return this;
- }
-
- public Builder shipNode(String shipNode) {
- this.shipNode = shipNode;
- return this;
- }
-
- public Builder sandbox(boolean sandbox) {
- this.sandbox = sandbox;
- return this;
- }
-
- public ChannelAccount build() {
- return new ChannelAccount(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/ChannelProvider.java b/core/src/main/java/apelet/common/ecommerce/model/ChannelProvider.java
deleted file mode 100644
index 5eab69e..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/ChannelProvider.java
+++ /dev/null
@@ -1,23 +0,0 @@
-package apelet.common.ecommerce.model;
-
-/**
- * 接入 provider 枚举。
- *
- * provider 是接入通道,不是业务渠道。同一个平台店铺可以同时存在
- * {@link #DIRECT} 与 {@link #LINGXING} 两条接入通道,由调用方显式选择;
- * SDK 不做推荐、不自动选路、不自动兜底。
- */
-public enum ChannelProvider {
-
- /** 平台直连 */
- DIRECT,
- /** 领星聚合 */
- LINGXING,
- /** Teapplix 订单源 */
- TEAPPLIX,
- /** 其他聚合器或自建通道 */
- CUSTOM;
-
- /** 直连账户的 platformCode 哨兵值,避免 {@code (provider, externalStoreId, platformCode)} 唯一索引因 NULL 失效。 */
- public static final int NO_PLATFORM_CODE = 0;
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/FulfillmentMode.java b/core/src/main/java/apelet/common/ecommerce/model/FulfillmentMode.java
deleted file mode 100644
index 89b8503..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/FulfillmentMode.java
+++ /dev/null
@@ -1,12 +0,0 @@
-package apelet.common.ecommerce.model;
-
-/** 履约模式,对应四种业务模式中的 A / C / D;B(FBA/WFS 平台仓发货)只读,不在枚举内。 */
-public enum FulfillmentMode {
-
- /** A:3P 卖家自发货 */
- THIRD_PARTY_SHIP,
- /** C:1P 代发(VC DF / 沃尔玛 DSV) */
- VENDOR_DF_SHIP,
- /** D:1P Retail 供应商供货 */
- VENDOR_RETAIL_ASN
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/Money.java b/core/src/main/java/apelet/common/ecommerce/model/Money.java
deleted file mode 100644
index ba0fb45..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/Money.java
+++ /dev/null
@@ -1,104 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.math.BigDecimal;
-import java.math.RoundingMode;
-import java.util.Currency;
-import java.util.Objects;
-
-/**
- * 金额:{@link BigDecimal} + {@link Currency}。
- *
- * 禁止使用 double。保留平台原始精度与币种,不做隐式舍入。
- */
-public final class Money {
-
- private final BigDecimal amount;
- private final Currency currency;
-
- private Money(BigDecimal amount, Currency currency) {
- this.amount = Objects.requireNonNull(amount, "amount");
- this.currency = Objects.requireNonNull(currency, "currency");
- }
-
- public static Money of(BigDecimal amount, String currencyCode) {
- return new Money(amount, Currency.getInstance(currencyCode));
- }
-
- public static Money of(String amount, String currencyCode) {
- return of(new BigDecimal(amount), currencyCode);
- }
-
- public static Money zero(String currencyCode) {
- return of(BigDecimal.ZERO, currencyCode);
- }
-
- public BigDecimal amount() {
- return amount;
- }
-
- public Currency currency() {
- return currency;
- }
-
- public String currencyCode() {
- return currency.getCurrencyCode();
- }
-
- public Money add(Money other) {
- requireSameCurrency(other);
- return new Money(amount.add(other.amount), currency);
- }
-
- public Money subtract(Money other) {
- requireSameCurrency(other);
- return new Money(amount.subtract(other.amount), currency);
- }
-
- public Money multiply(BigDecimal factor) {
- return new Money(amount.multiply(factor), currency);
- }
-
- /** 按币种最小单位舍入,仅用于展示或平台要求的定长格式,不用于内部累计。 */
- public Money round() {
- return new Money(amount.setScale(currency.getDefaultFractionDigits(), RoundingMode.HALF_UP), currency);
- }
-
- public boolean isNegative() {
- return amount.signum() < 0;
- }
-
- public int compareTo(Money other) {
- requireSameCurrency(other);
- return amount.compareTo(other.amount);
- }
-
- private void requireSameCurrency(Money other) {
- Objects.requireNonNull(other, "other");
- if (!currency.equals(other.currency)) {
- throw new IllegalArgumentException(
- "currency mismatch: " + currency.getCurrencyCode() + " vs " + other.currency.getCurrencyCode());
- }
- }
-
- @Override
- public boolean equals(Object o) {
- if (this == o) {
- return true;
- }
- if (!(o instanceof Money)) {
- return false;
- }
- Money that = (Money) o;
- return amount.compareTo(that.amount) == 0 && currency.equals(that.currency);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(amount.stripTrailingZeros(), currency);
- }
-
- @Override
- public String toString() {
- return amount.toPlainString() + " " + currency.getCurrencyCode();
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/OrderLine.java b/core/src/main/java/apelet/common/ecommerce/model/OrderLine.java
deleted file mode 100644
index dd4b68d..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/OrderLine.java
+++ /dev/null
@@ -1,97 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.util.Objects;
-
-/**
- * 订单明细行。
- */
-public final class OrderLine {
-
- private final String lineId;
- private final String platformSku;
- private final int quantity;
- private final Money unitPrice;
- private final Money tax;
- private final Money discount;
-
- private OrderLine(Builder b) {
- this.lineId = b.lineId;
- this.platformSku = Objects.requireNonNull(b.platformSku, "platformSku");
- this.quantity = b.quantity;
- this.unitPrice = b.unitPrice;
- this.tax = b.tax;
- this.discount = b.discount;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public String lineId() {
- return lineId;
- }
-
- public String platformSku() {
- return platformSku;
- }
-
- public int quantity() {
- return quantity;
- }
-
- public Money unitPrice() {
- return unitPrice;
- }
-
- public Money tax() {
- return tax;
- }
-
- public Money discount() {
- return discount;
- }
-
- public static final class Builder {
-
- private String lineId;
- private String platformSku;
- private int quantity;
- private Money unitPrice;
- private Money tax;
- private Money discount;
-
- public Builder lineId(String lineId) {
- this.lineId = lineId;
- return this;
- }
-
- public Builder platformSku(String platformSku) {
- this.platformSku = platformSku;
- return this;
- }
-
- public Builder quantity(int quantity) {
- this.quantity = quantity;
- return this;
- }
-
- public Builder unitPrice(Money unitPrice) {
- this.unitPrice = unitPrice;
- return this;
- }
-
- public Builder tax(Money tax) {
- this.tax = tax;
- return this;
- }
-
- public Builder discount(Money discount) {
- this.discount = discount;
- return this;
- }
-
- public OrderLine build() {
- return new OrderLine(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/Page.java b/core/src/main/java/apelet/common/ecommerce/model/Page.java
deleted file mode 100644
index c793e45..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/Page.java
+++ /dev/null
@@ -1,52 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-
-/**
- * 分页结果的通用载体。
- *
- * @param 条目类型
- */
-public final class Page {
-
- private final List items;
- private final String nextCursor;
- private final boolean hasMore;
-
- private Page(List items, String nextCursor, boolean hasMore) {
- this.items = Collections.unmodifiableList(new ArrayList(items));
- this.nextCursor = nextCursor;
- this.hasMore = hasMore;
- }
-
- public static Page of(List items, String nextCursor) {
- return new Page(items, nextCursor, nextCursor != null && !nextCursor.isEmpty());
- }
-
- public static Page last(List items) {
- return new Page(items, null, false);
- }
-
- public static Page empty() {
- return new Page(Collections.emptyList(), null, false);
- }
-
- public List items() {
- return items;
- }
-
- /** 下一页游标;null 表示结束。 */
- public String nextCursor() {
- return nextCursor;
- }
-
- public boolean hasMore() {
- return hasMore;
- }
-
- public int size() {
- return items.size();
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/Platform.java b/core/src/main/java/apelet/common/ecommerce/model/Platform.java
deleted file mode 100644
index 3439f04..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/Platform.java
+++ /dev/null
@@ -1,42 +0,0 @@
-package apelet.common.ecommerce.model;
-
-/**
- * 业务平台枚举。
- *
- * 不含 provider:直连与领星等聚合器都映射到同一个平台值,
- * 保证业务主键(canonicalKey)在 provider 切换时不变。
- */
-public enum Platform {
-
- /** 亚马逊卖家平台(3P) */
- AMAZON_SC,
- /** 亚马逊供应商平台(1P) */
- AMAZON_VC,
- /** 沃尔玛 3P */
- WALMART_SC,
- /** 沃尔玛 1P */
- WALMART_1P,
- /** TikTok Shop */
- TIKTOK,
- /** Temu */
- TEMU,
- /** eBay(首期经领星接入) */
- EBAY,
- /** SHEIN(首期经领星接入) */
- SHEIN,
- /** Mirakl 市场 */
- MIRAKL,
- /** Target(领星平台码待确认) */
- TARGET,
- /** BestBuy(Mirakl/自定义,待确认) */
- BESTBUY,
- /** AEPH(平台码待确认) */
- AEPH,
- /** 自定义平台 */
- CUSTOM;
-
- /** 是否属于 1P(平台向供应商采购)语义。 */
- public boolean isFirstParty() {
- return this == AMAZON_VC || this == WALMART_1P;
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/PlatformTime.java b/core/src/main/java/apelet/common/ecommerce/model/PlatformTime.java
deleted file mode 100644
index d140834..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/PlatformTime.java
+++ /dev/null
@@ -1,85 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.time.Clock;
-import java.time.Instant;
-import java.time.ZoneId;
-import java.time.ZonedDateTime;
-import java.util.Objects;
-
-/**
- * 三轴时间:UTC 是唯一真值,市场当地时间与北京时间是派生/物化视图。
- *
- * 夏令时一律通过 {@link ZoneId} 解析,禁止使用固定偏移量。
- */
-public final class PlatformTime {
-
- /** 北京时间固定时区。 */
- public static final ZoneId BEIJING_ZONE = ZoneId.of("Asia/Shanghai");
-
- private final Instant utc;
- private final ZoneId marketplaceZone;
-
- private PlatformTime(Instant utc, ZoneId marketplaceZone) {
- this.utc = Objects.requireNonNull(utc, "utc");
- this.marketplaceZone = Objects.requireNonNull(marketplaceZone, "marketplaceZone");
- }
-
- public static PlatformTime of(Instant utc, ZoneId marketplaceZone) {
- return new PlatformTime(utc, marketplaceZone);
- }
-
- public static PlatformTime of(Instant utc, String marketplaceZone) {
- return of(utc, ZoneId.of(marketplaceZone));
- }
-
- /** 以当前 UTC 时刻构造。 */
- public static PlatformTime now(Clock clock, ZoneId marketplaceZone) {
- return of(Instant.now(clock), marketplaceZone);
- }
-
- /** 存储与计算基准。 */
- public Instant utc() {
- return utc;
- }
-
- public ZoneId marketplaceZone() {
- return marketplaceZone;
- }
-
- /** 平台/买家当地展示时间。 */
- public ZonedDateTime marketplaceLocal() {
- return utc.atZone(marketplaceZone);
- }
-
- /** 运营/财务/客服展示时间。 */
- public ZonedDateTime beijing() {
- return utc.atZone(BEIJING_ZONE);
- }
-
- /** 在市场当地时区上做偏移,返回新的三轴时间。 */
- public PlatformTime plus(java.time.Duration duration) {
- return new PlatformTime(utc.plus(duration), marketplaceZone);
- }
-
- @Override
- public boolean equals(Object o) {
- if (this == o) {
- return true;
- }
- if (!(o instanceof PlatformTime)) {
- return false;
- }
- PlatformTime that = (PlatformTime) o;
- return utc.equals(that.utc) && marketplaceZone.equals(that.marketplaceZone);
- }
-
- @Override
- public int hashCode() {
- return Objects.hash(utc, marketplaceZone);
- }
-
- @Override
- public String toString() {
- return utc + " (" + marketplaceZone + ")";
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/ProductListing.java b/core/src/main/java/apelet/common/ecommerce/model/ProductListing.java
deleted file mode 100644
index be18252..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/ProductListing.java
+++ /dev/null
@@ -1,112 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.Objects;
-
-/**
- * 统一商品 / Listing。
- */
-public final class ProductListing {
-
- private final String omsStoreId;
- private final String platformSku;
- private final String title;
- private final List imageUrls;
- private final String status;
- private final PlatformTime updatedAt;
- private final ChannelProvider sourceProvider;
-
- private ProductListing(Builder b) {
- this.omsStoreId = Objects.requireNonNull(b.omsStoreId, "omsStoreId");
- this.platformSku = Objects.requireNonNull(b.platformSku, "platformSku");
- this.title = b.title;
- this.imageUrls = Collections.unmodifiableList(new ArrayList(b.imageUrls));
- this.status = b.status;
- this.updatedAt = b.updatedAt;
- this.sourceProvider = b.sourceProvider;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public String omsStoreId() {
- return omsStoreId;
- }
-
- public String platformSku() {
- return platformSku;
- }
-
- public String title() {
- return title;
- }
-
- public List imageUrls() {
- return imageUrls;
- }
-
- public String status() {
- return status;
- }
-
- public PlatformTime updatedAt() {
- return updatedAt;
- }
-
- public ChannelProvider sourceProvider() {
- return sourceProvider;
- }
-
- public static final class Builder {
-
- private String omsStoreId;
- private String platformSku;
- private String title;
- private List imageUrls = Collections.emptyList();
- private String status;
- private PlatformTime updatedAt;
- private ChannelProvider sourceProvider;
-
- public Builder omsStoreId(String omsStoreId) {
- this.omsStoreId = omsStoreId;
- return this;
- }
-
- public Builder platformSku(String platformSku) {
- this.platformSku = platformSku;
- return this;
- }
-
- public Builder title(String title) {
- this.title = title;
- return this;
- }
-
- public Builder imageUrls(List imageUrls) {
- this.imageUrls = imageUrls == null ? Collections.emptyList() : imageUrls;
- return this;
- }
-
- public Builder status(String status) {
- this.status = status;
- return this;
- }
-
- public Builder updatedAt(PlatformTime updatedAt) {
- this.updatedAt = updatedAt;
- return this;
- }
-
- public Builder sourceProvider(ChannelProvider sourceProvider) {
- this.sourceProvider = sourceProvider;
- return this;
- }
-
- public ProductListing build() {
- return new ProductListing(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/ProductQuery.java b/core/src/main/java/apelet/common/ecommerce/model/ProductQuery.java
deleted file mode 100644
index a62cbef..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/ProductQuery.java
+++ /dev/null
@@ -1,74 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.time.Instant;
-import java.util.Objects;
-
-/**
- * 商品查询条件。
- */
-public final class ProductQuery {
-
- private final Instant updatedAfter;
- private final Instant updatedBefore;
- private final int pageSize;
- private final String cursor;
-
- private ProductQuery(Builder b) {
- this.updatedAfter = b.updatedAfter;
- this.updatedBefore = b.updatedBefore;
- this.pageSize = b.pageSize;
- this.cursor = b.cursor;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public Instant updatedAfter() {
- return updatedAfter;
- }
-
- public Instant updatedBefore() {
- return updatedBefore;
- }
-
- public int pageSize() {
- return pageSize;
- }
-
- public String cursor() {
- return cursor;
- }
-
- public static final class Builder {
-
- private Instant updatedAfter;
- private Instant updatedBefore;
- private int pageSize = 100;
- private String cursor;
-
- public Builder updatedAfter(Instant updatedAfter) {
- this.updatedAfter = updatedAfter;
- return this;
- }
-
- public Builder updatedBefore(Instant updatedBefore) {
- this.updatedBefore = updatedBefore;
- return this;
- }
-
- public Builder pageSize(int pageSize) {
- this.pageSize = pageSize;
- return this;
- }
-
- public Builder cursor(String cursor) {
- this.cursor = cursor;
- return this;
- }
-
- public ProductQuery build() {
- return new ProductQuery(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/ProductSyncStrategy.java b/core/src/main/java/apelet/common/ecommerce/model/ProductSyncStrategy.java
deleted file mode 100644
index 6409d33..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/ProductSyncStrategy.java
+++ /dev/null
@@ -1,12 +0,0 @@
-package apelet.common.ecommerce.model;
-
-/** 商品同步策略,适配器声明自己支持哪一种。 */
-public enum ProductSyncStrategy {
-
- /** 时间窗增量 */
- INCREMENTAL_TIME_WINDOW,
- /** 全量拉取 + 差异比对 */
- FULL_PULL_DIFF,
- /** 报告 / 文件 */
- REPORT
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/SalesOrder.java b/core/src/main/java/apelet/common/ecommerce/model/SalesOrder.java
deleted file mode 100644
index d38c1ae..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/SalesOrder.java
+++ /dev/null
@@ -1,151 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.Objects;
-
-/**
- * 3P 销售订单。
- *
- * 统一带 {@code omsStoreId + sourceProvider + sourceAccountId},
- * 用于跨 provider 去重与追溯。
- */
-public final class SalesOrder {
-
- private final String omsStoreId;
- private final String channelOrderId;
- private final String status;
- private final String buyerName;
- private final String shipToCountryCode;
- private final List lines;
- private final Money totalAmount;
- private final PlatformTime occurredAt;
- private final ChannelProvider sourceProvider;
- private final String sourceAccountId;
-
- private SalesOrder(Builder b) {
- this.omsStoreId = Objects.requireNonNull(b.omsStoreId, "omsStoreId");
- this.channelOrderId = Objects.requireNonNull(b.channelOrderId, "channelOrderId");
- this.status = b.status;
- this.buyerName = b.buyerName;
- this.shipToCountryCode = b.shipToCountryCode;
- this.lines = Collections.unmodifiableList(new ArrayList(b.lines));
- this.totalAmount = b.totalAmount;
- this.occurredAt = Objects.requireNonNull(b.occurredAt, "occurredAt");
- this.sourceProvider = Objects.requireNonNull(b.sourceProvider, "sourceProvider");
- this.sourceAccountId = b.sourceAccountId;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public String omsStoreId() {
- return omsStoreId;
- }
-
- public String channelOrderId() {
- return channelOrderId;
- }
-
- public String status() {
- return status;
- }
-
- public String buyerName() {
- return buyerName;
- }
-
- public String shipToCountryCode() {
- return shipToCountryCode;
- }
-
- public List lines() {
- return lines;
- }
-
- public Money totalAmount() {
- return totalAmount;
- }
-
- public PlatformTime occurredAt() {
- return occurredAt;
- }
-
- public ChannelProvider sourceProvider() {
- return sourceProvider;
- }
-
- public String sourceAccountId() {
- return sourceAccountId;
- }
-
- public static final class Builder {
-
- private String omsStoreId;
- private String channelOrderId;
- private String status;
- private String buyerName;
- private String shipToCountryCode;
- private List lines = Collections.emptyList();
- private Money totalAmount;
- private PlatformTime occurredAt;
- private ChannelProvider sourceProvider;
- private String sourceAccountId;
-
- public Builder omsStoreId(String omsStoreId) {
- this.omsStoreId = omsStoreId;
- return this;
- }
-
- public Builder channelOrderId(String channelOrderId) {
- this.channelOrderId = channelOrderId;
- return this;
- }
-
- public Builder status(String status) {
- this.status = status;
- return this;
- }
-
- public Builder buyerName(String buyerName) {
- this.buyerName = buyerName;
- return this;
- }
-
- public Builder shipToCountryCode(String shipToCountryCode) {
- this.shipToCountryCode = shipToCountryCode;
- return this;
- }
-
- public Builder lines(List lines) {
- this.lines = lines == null ? Collections.emptyList() : lines;
- return this;
- }
-
- public Builder totalAmount(Money totalAmount) {
- this.totalAmount = totalAmount;
- return this;
- }
-
- public Builder occurredAt(PlatformTime occurredAt) {
- this.occurredAt = occurredAt;
- return this;
- }
-
- public Builder sourceProvider(ChannelProvider sourceProvider) {
- this.sourceProvider = sourceProvider;
- return this;
- }
-
- public Builder sourceAccountId(String sourceAccountId) {
- this.sourceAccountId = sourceAccountId;
- return this;
- }
-
- public SalesOrder build() {
- return new SalesOrder(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/model/SalesOrderQuery.java b/core/src/main/java/apelet/common/ecommerce/model/SalesOrderQuery.java
deleted file mode 100644
index dd7ec9e..0000000
--- a/core/src/main/java/apelet/common/ecommerce/model/SalesOrderQuery.java
+++ /dev/null
@@ -1,82 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import java.time.Instant;
-import java.util.Objects;
-
-/**
- * 销售订单查询条件(单次查询,不推进水位线)。
- */
-public final class SalesOrderQuery {
-
- private final Instant updatedAfter;
- private final Instant updatedBefore;
- private final int pageSize;
- private final String cursor;
-
- private SalesOrderQuery(Builder b) {
- this.updatedAfter = Objects.requireNonNull(b.updatedAfter, "updatedAfter");
- this.updatedBefore = b.updatedBefore;
- this.pageSize = b.pageSize;
- this.cursor = b.cursor;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public Instant updatedAfter() {
- return updatedAfter;
- }
-
- public Instant updatedBefore() {
- return updatedBefore;
- }
-
- public int pageSize() {
- return pageSize;
- }
-
- public String cursor() {
- return cursor;
- }
-
- public Builder toBuilder() {
- return builder()
- .updatedAfter(updatedAfter)
- .updatedBefore(updatedBefore)
- .pageSize(pageSize)
- .cursor(cursor);
- }
-
- public static final class Builder {
-
- private Instant updatedAfter;
- private Instant updatedBefore;
- private int pageSize = 100;
- private String cursor;
-
- public Builder updatedAfter(Instant updatedAfter) {
- this.updatedAfter = updatedAfter;
- return this;
- }
-
- public Builder updatedBefore(Instant updatedBefore) {
- this.updatedBefore = updatedBefore;
- return this;
- }
-
- public Builder pageSize(int pageSize) {
- this.pageSize = pageSize;
- return this;
- }
-
- public Builder cursor(String cursor) {
- this.cursor = cursor;
- return this;
- }
-
- public SalesOrderQuery build() {
- return new SalesOrderQuery(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sdk/AdapterFactory.java b/core/src/main/java/apelet/common/ecommerce/sdk/AdapterFactory.java
deleted file mode 100644
index ebf92dc..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sdk/AdapterFactory.java
+++ /dev/null
@@ -1,47 +0,0 @@
-package apelet.common.ecommerce.sdk;
-
-import apelet.common.ecommerce.capability.PlatformAdapter;
-import apelet.common.ecommerce.model.AccountKey;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.Platform;
-
-import java.util.EnumSet;
-
-/**
- * 适配器工厂。直连与聚合器统一注册,SDK 按 AccountKey 的 provider 解析。
- */
-public interface AdapterFactory {
-
- String adapterId();
-
- ChannelProvider provider();
-
- EnumSet platforms();
-
- PlatformAdapter create(AdapterConfig config);
-
- /** 适配器实例化所需的最小配置;凭证与账户信息在调用时经 ChannelContext 传入。 */
- final class AdapterConfig {
-
- private final String endpointBaseUrl;
- private final boolean sandbox;
-
- public AdapterConfig(String endpointBaseUrl, boolean sandbox) {
- this.endpointBaseUrl = endpointBaseUrl;
- this.sandbox = sandbox;
- }
-
- public String endpointBaseUrl() {
- return endpointBaseUrl;
- }
-
- public boolean sandbox() {
- return sandbox;
- }
- }
-
- /** 兜底:由平台推导默认 adapterId,便于日志定位。 */
- static String defaultAdapterId(AccountKey key) {
- return key.platform().name().toLowerCase() + "-" + key.provider().name().toLowerCase();
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sdk/ChannelContext.java b/core/src/main/java/apelet/common/ecommerce/sdk/ChannelContext.java
deleted file mode 100644
index d8582fa..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sdk/ChannelContext.java
+++ /dev/null
@@ -1,48 +0,0 @@
-package apelet.common.ecommerce.sdk;
-
-import apelet.common.ecommerce.model.ChannelAccount;
-import apelet.common.ecommerce.model.Platform;
-
-import java.time.Clock;
-
-/**
- * 单次调用的上下文。由 SDK 统一创建并注入适配器,适配器不得自行构造。
- */
-public final class ChannelContext {
-
- private final ChannelAccount account;
- private final String requestId;
- private final Clock clock;
-
- private ChannelContext(ChannelAccount account, String requestId, Clock clock) {
- this.account = account;
- this.requestId = requestId;
- this.clock = clock;
- }
-
- public static ChannelContext of(ChannelAccount account, String requestId, Clock clock) {
- return new ChannelContext(account, requestId, clock);
- }
-
- public ChannelAccount account() {
- return account;
- }
-
- public String omsStoreId() {
- return account.omsStoreId();
- }
-
- public Platform platform() {
- return account.platform();
- }
-
- /** 链路 ID,用于日志与原始报文关联。 */
- public String requestId() {
- return requestId;
- }
-
- /** UTC 时钟;测试可注入固定时间。 */
- public Clock clock() {
- return clock;
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sdk/ChannelSdk.java b/core/src/main/java/apelet/common/ecommerce/sdk/ChannelSdk.java
deleted file mode 100644
index 39e66a3..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sdk/ChannelSdk.java
+++ /dev/null
@@ -1,169 +0,0 @@
-package apelet.common.ecommerce.sdk;
-
-import apelet.common.ecommerce.capability.AdapterCapabilityReport;
-import apelet.common.ecommerce.capability.CapabilityReport;
-import apelet.common.ecommerce.capability.PlatformAdapter;
-import apelet.common.ecommerce.capability.Products;
-import apelet.common.ecommerce.capability.SalesOrders;
-import apelet.common.ecommerce.model.AccountKey;
-import apelet.common.ecommerce.model.ChannelAccount;
-import apelet.common.ecommerce.spi.ChannelAccountRepository;
-
-import java.time.Clock;
-import java.util.ArrayList;
-import java.util.Collection;
-import java.util.Collections;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.Objects;
-import java.util.UUID;
-
-/**
- * 渠道 SDK 统一门面。
- *
- * 业务层只依赖本类,不直接感知平台协议。所有外部副作用经 SPI 注入,
- * SDK 自身不访问数据库 / Redis / MQ,也不持有线程或定时器。
- *
- * provider 由调用方在 {@link AccountKey} 中显式指定,SDK 不推荐、
- * 不自动选路、不自动兜底;能力缺失时抛
- * {@code ChannelException.UnsupportedCapabilityException}。
- */
-public final class ChannelSdk implements ProviderResolver {
-
- private final Map adapters;
- private final ChannelAccountRepository accountRepository;
- private final Clock clock;
-
- private ChannelSdk(Builder b) {
- this.adapters = Collections.unmodifiableMap(new LinkedHashMap(b.adapters));
- this.accountRepository = b.accountRepository;
- this.clock = b.clock;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- // ------------------------------------------------------------------ 门面方法
-
- /** 能力矩阵,只读,不触发任何真实 API。 */
- public CapabilityReport capabilities(AccountKey key) {
- ChannelAccount account = requireAccount(key);
- return new AdapterCapabilityReport(resolve(key), account);
- }
-
- /** 3P 销售订单视图。 */
- public SalesOrders salesOrders(AccountKey key) {
- ChannelAccount account = requireAccount(key);
- return new SalesOrders(resolve(key), account, newContext(account));
- }
-
- /** 商品 / Listing 视图。 */
- public Products products(AccountKey key) {
- ChannelAccount account = requireAccount(key);
- return new Products(resolve(key), account, newContext(account));
- }
-
- /** 按 AccountKey 解析适配器;不自动选路、不自动兜底。 */
- @Override
- public PlatformAdapter resolve(AccountKey key) {
- PlatformAdapter adapter = adapters.get(registryKey(key));
- if (adapter == null) {
- throw new IllegalStateException("no adapter registered for " + key
- + "; registered: " + adapters.keySet());
- }
- return adapter;
- }
-
- // ------------------------------------------------------------------ internals
-
- private ChannelAccount requireAccount(AccountKey key) {
- return accountRepository.findByKey(key.provider().name(), key.platform().name(), key.omsStoreId())
- .orElseThrow(() -> new IllegalStateException("channel account not configured: " + key));
- }
-
- private ChannelContext newContext(ChannelAccount account) {
- return ChannelContext.of(account, UUID.randomUUID().toString(), clock);
- }
-
- /** 注册维度:provider + platform。同一组合下只能有一个适配器。 */
- private static String registryKey(AccountKey key) {
- return key.provider().name() + '|' + key.platform().name();
- }
-
- // ------------------------------------------------------------------ builder
-
- public static final class Builder {
-
- private final Map adapters = new LinkedHashMap();
- private final List factories = new ArrayList();
- private ChannelAccountRepository accountRepository;
- private Clock clock = Clock.systemUTC();
-
- /** 注入账户仓库;宿主实现。 */
- public Builder accountRepository(ChannelAccountRepository accountRepository) {
- this.accountRepository = accountRepository;
- return this;
- }
-
- /** 注入时钟;测试可给固定时间。 */
- public Builder clock(Clock clock) {
- this.clock = clock;
- return this;
- }
-
- /** 注册适配器工厂;工厂覆盖的平台会在 build 时创建并注册。 */
- public Builder register(AdapterFactory factory) {
- this.factories.add(Objects.requireNonNull(factory, "factory"));
- return this;
- }
-
- public Builder registerAll(Collection extends AdapterFactory> factories) {
- if (factories != null) {
- for (AdapterFactory f : factories) {
- register(f);
- }
- }
- return this;
- }
-
- /** 直接注册适配器实例,主要用于测试替身。 */
- public Builder register(PlatformAdapter adapter) {
- Objects.requireNonNull(adapter, "adapter");
- for (apelet.common.ecommerce.model.Platform p : adapter.platforms()) {
- put(adapter.provider().name() + '|' + p.name(), adapter);
- }
- return this;
- }
-
- /**
- * 构建门面。
- *
- * 缺必需配置时立刻失败,而不是返回一个不可用的空对象。
- */
- public ChannelSdk build() {
- if (accountRepository == null) {
- throw new IllegalStateException("ChannelSdk requires an accountRepository");
- }
- if (clock == null) {
- throw new IllegalStateException("ChannelSdk requires a clock");
- }
- if (adapters.isEmpty() && factories.isEmpty()) {
- throw new IllegalStateException("ChannelSdk requires at least one adapter or adapter factory");
- }
- for (AdapterFactory factory : factories) {
- register(factory.create(new AdapterFactory.AdapterConfig(null, false)));
- }
- return new ChannelSdk(this);
- }
-
- private void put(String key, PlatformAdapter adapter) {
- PlatformAdapter previous = adapters.put(key, adapter);
- if (previous != null && previous != adapter) {
- throw new IllegalStateException("duplicate adapter for " + key
- + ": " + previous.adapterId() + " / " + adapter.adapterId());
- }
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sdk/ProviderResolver.java b/core/src/main/java/apelet/common/ecommerce/sdk/ProviderResolver.java
deleted file mode 100644
index f566925..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sdk/ProviderResolver.java
+++ /dev/null
@@ -1,14 +0,0 @@
-package apelet.common.ecommerce.sdk;
-
-import apelet.common.ecommerce.capability.PlatformAdapter;
-import apelet.common.ecommerce.model.AccountKey;
-
-/**
- * 按 AccountKey 解析适配器。
- *
- * 不自动选路、不自动兜底:provider 由调用方在 AccountKey 中显式指定。
- */
-public interface ProviderResolver {
-
- PlatformAdapter resolve(AccountKey key);
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/AccessToken.java b/core/src/main/java/apelet/common/ecommerce/spi/AccessToken.java
deleted file mode 100644
index ee0aa91..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/AccessToken.java
+++ /dev/null
@@ -1,84 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import java.time.Instant;
-import java.util.Objects;
-
-/**
- * 访问令牌。
- */
-public final class AccessToken {
-
- private final String value;
- private final String refreshToken;
- private final Instant expiresAt;
- private final String tokenType;
-
- private AccessToken(Builder b) {
- this.value = Objects.requireNonNull(b.value, "value");
- this.refreshToken = b.refreshToken;
- this.expiresAt = Objects.requireNonNull(b.expiresAt, "expiresAt");
- this.tokenType = b.tokenType == null ? "Bearer" : b.tokenType;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public String value() {
- return value;
- }
-
- public String refreshToken() {
- return refreshToken;
- }
-
- public Instant expiresAt() {
- return expiresAt;
- }
-
- public String tokenType() {
- return tokenType;
- }
-
- /** 是否已过期或将在 {@code earlyRefreshSeconds} 内过期。 */
- public boolean needsRefresh(Instant now, long earlyRefreshSeconds) {
- return !now.plusSeconds(earlyRefreshSeconds).isBefore(expiresAt);
- }
-
- /** 日志用指纹,不打印令牌本体。 */
- public String fingerprint() {
- return "token#" + Integer.toHexString(value.hashCode());
- }
-
- public static final class Builder {
-
- private String value;
- private String refreshToken;
- private Instant expiresAt;
- private String tokenType;
-
- public Builder value(String value) {
- this.value = value;
- return this;
- }
-
- public Builder refreshToken(String refreshToken) {
- this.refreshToken = refreshToken;
- return this;
- }
-
- public Builder expiresAt(Instant expiresAt) {
- this.expiresAt = expiresAt;
- return this;
- }
-
- public Builder tokenType(String tokenType) {
- this.tokenType = tokenType;
- return this;
- }
-
- public AccessToken build() {
- return new AccessToken(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/ChannelAccountRepository.java b/core/src/main/java/apelet/common/ecommerce/spi/ChannelAccountRepository.java
deleted file mode 100644
index f5080ba..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/ChannelAccountRepository.java
+++ /dev/null
@@ -1,16 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import apelet.common.ecommerce.model.ChannelAccount;
-
-import java.util.Optional;
-
-/**
- * 渠道账户读取 SPI。由宿主实现(典型 MySQL)。
- */
-public interface ChannelAccountRepository {
-
- Optional findByKey(String provider, String platform, String omsStoreId);
-
- /** 同一 omsStoreId 下所有 provider 账户。 */
- java.util.List findByOmsStoreId(String omsStoreId);
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/ChannelSecret.java b/core/src/main/java/apelet/common/ecommerce/spi/ChannelSecret.java
deleted file mode 100644
index 0957020..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/ChannelSecret.java
+++ /dev/null
@@ -1,91 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import java.util.Objects;
-
-/**
- * 凭证内容。按 provider 需要取用,未使用的字段为 null。
- */
-public final class ChannelSecret {
-
- private final String appKey;
- private final String appSecret;
- private final String clientId;
- private final String clientSecret;
- private final String refreshToken;
-
- private ChannelSecret(Builder b) {
- this.appKey = b.appKey;
- this.appSecret = b.appSecret;
- this.clientId = b.clientId;
- this.clientSecret = b.clientSecret;
- this.refreshToken = b.refreshToken;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public String appKey() {
- return appKey;
- }
-
- public String appSecret() {
- return appSecret;
- }
-
- public String clientId() {
- return clientId;
- }
-
- public String clientSecret() {
- return clientSecret;
- }
-
- public String refreshToken() {
- return refreshToken;
- }
-
- /** 用于日志的安全指纹,不泄露内容。 */
- public String fingerprint() {
- String seed = String.valueOf(Objects.hash(appKey, clientId));
- return "secret#" + Integer.toHexString(seed.hashCode());
- }
-
- public static final class Builder {
-
- private String appKey;
- private String appSecret;
- private String clientId;
- private String clientSecret;
- private String refreshToken;
-
- public Builder appKey(String appKey) {
- this.appKey = appKey;
- return this;
- }
-
- public Builder appSecret(String appSecret) {
- this.appSecret = appSecret;
- return this;
- }
-
- public Builder clientId(String clientId) {
- this.clientId = clientId;
- return this;
- }
-
- public Builder clientSecret(String clientSecret) {
- this.clientSecret = clientSecret;
- return this;
- }
-
- public Builder refreshToken(String refreshToken) {
- this.refreshToken = refreshToken;
- return this;
- }
-
- public ChannelSecret build() {
- return new ChannelSecret(this);
- }
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/LockProvider.java b/core/src/main/java/apelet/common/ecommerce/spi/LockProvider.java
deleted file mode 100644
index 10e31d3..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/LockProvider.java
+++ /dev/null
@@ -1,24 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import java.util.Optional;
-
-/**
- * 锁 SPI。用于 token 刷新防击穿、账户级同步互斥。
- */
-public interface LockProvider {
-
- /**
- * 尝试获取锁,不阻塞。
- *
- * @param key 锁键
- * @param ttlSeconds 锁自动过期时间
- * @return 锁句柄;未获取到返回 empty
- */
- Optional tryLock(String key, long ttlSeconds);
-
- interface Lock extends AutoCloseable {
-
- @Override
- void close();
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/SecretProvider.java b/core/src/main/java/apelet/common/ecommerce/spi/SecretProvider.java
deleted file mode 100644
index c3cf0c1..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/SecretProvider.java
+++ /dev/null
@@ -1,14 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-/**
- * 凭证读取 SPI。{@code credentialRef} 由 {@code ChannelAccount} 提供。
- *
- * 真实密钥只在内存中出现,禁止落配置、禁止写日志。
- */
-public interface SecretProvider {
-
- /**
- * @param credentialRef 形如 {@code kms://oms/lingxing/store-001}
- */
- ChannelSecret get(String credentialRef);
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/Sink.java b/core/src/main/java/apelet/common/ecommerce/spi/Sink.java
deleted file mode 100644
index 33170db..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/Sink.java
+++ /dev/null
@@ -1,18 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.ProductListing;
-import apelet.common.ecommerce.model.SalesOrder;
-
-/**
- * 领域对象落库 SPI。SDK 只调用,不碰数据库。
- *
- * 实现方必须按 canonicalKey 做 upsert:同一实体从直连与聚合器同步时
- * 不得产生两条记录。
- */
-public interface Sink {
-
- void upsertSalesOrders(Page page);
-
- void upsertProducts(Page page);
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/SyncCursorStore.java b/core/src/main/java/apelet/common/ecommerce/spi/SyncCursorStore.java
deleted file mode 100644
index 306637e..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/SyncCursorStore.java
+++ /dev/null
@@ -1,18 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import apelet.common.ecommerce.model.ChannelProvider;
-
-import java.time.Instant;
-
-/**
- * 增量水位线 SPI。
- *
- * 按 {@code provider + account + stream} 分开维护;只在整个批次成功后推进。
- */
-public interface SyncCursorStore {
-
- /** 返回 null 表示还没有水位线,需要首次全量建底。 */
- Instant get(ChannelProvider provider, String accountKey, String stream);
-
- void advance(ChannelProvider provider, String accountKey, String stream, Instant watermark);
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/spi/TokenStore.java b/core/src/main/java/apelet/common/ecommerce/spi/TokenStore.java
deleted file mode 100644
index f4e7872..0000000
--- a/core/src/main/java/apelet/common/ecommerce/spi/TokenStore.java
+++ /dev/null
@@ -1,15 +0,0 @@
-package apelet.common.ecommerce.spi;
-
-import java.util.Optional;
-
-/**
- * 访问令牌读取/写入 SPI。宿主负责加密存储。
- */
-public interface TokenStore {
-
- Optional get(String tokenKey);
-
- void save(String tokenKey, AccessToken token);
-
- void remove(String tokenKey);
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sync/SyncEngine.java b/core/src/main/java/apelet/common/ecommerce/sync/SyncEngine.java
deleted file mode 100644
index b574df9..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sync/SyncEngine.java
+++ /dev/null
@@ -1,77 +0,0 @@
-package apelet.common.ecommerce.sync;
-
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.model.SalesOrderQuery;
-import apelet.common.ecommerce.spi.Sink;
-import apelet.common.ecommerce.spi.SyncCursorStore;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import java.time.Instant;
-import java.util.function.BiFunction;
-
-/**
- * 增量同步引擎。
- *
- *
- * from = lastWatermark - overlapWindow
- * to = now
- * loop 拉一页 → 经 Sink upsert → cursor = page.nextCursor
- * 直到 cursor == null
- * 全部成功才推进水位线,失败不推进
- *
- *
- * 引擎不持有线程或定时器,由宿主调度触发。
- */
-public final class SyncEngine {
-
- private static final Logger LOG = LoggerFactory.getLogger(SyncEngine.class);
-
- private final SyncCursorStore cursorStore;
- private final Sink sink;
-
- public SyncEngine(SyncCursorStore cursorStore, Sink sink) {
- this.cursorStore = cursorStore;
- this.sink = sink;
- }
-
- /**
- * 同步销售订单。
- *
- * @param spec 同步维度(provider + account + stream + overlap)
- * @param to 本次增量终点
- * @param fetch 拉一页的函数:(from, cursor) → page
- */
- public SyncResult syncSalesOrders(SyncSpec spec, Instant to,
- BiFunction> fetch) {
- Instant watermark = cursorStore.get(spec.provider(), spec.accountKey(), spec.stream());
- Instant from = spec.from(watermark);
- if (from == null) {
- throw new IllegalStateException("no watermark for " + spec.accountKey()
- + "/" + spec.stream() + ", run full bootstrap first");
- }
-
- int pages = 0;
- int items = 0;
- String cursor = null;
- // 首页需要 from,后续页沿用同一 from(时间窗固定,靠游标翻页)
- while (true) {
- Page page = fetch.apply(from, cursor);
- if (page == null || page.size() == 0) {
- break;
- }
- sink.upsertSalesOrders(page);
- pages++;
- items += page.size();
- cursor = page.nextCursor();
- if (cursor == null) {
- break;
- }
- }
-
- cursorStore.advance(spec.provider(), spec.accountKey(), spec.stream(), to);
- LOG.debug("sync {} pages={} items={} from={} to={}", spec.stream(), pages, items, from, to);
- return SyncResult.of(pages, items, true);
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sync/SyncResult.java b/core/src/main/java/apelet/common/ecommerce/sync/SyncResult.java
deleted file mode 100644
index fd3ed72..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sync/SyncResult.java
+++ /dev/null
@@ -1,43 +0,0 @@
-package apelet.common.ecommerce.sync;
-
-/**
- * 单次同步结果。
- */
-public final class SyncResult {
-
- private final int pages;
- private final int items;
- private final boolean watermarkAdvanced;
-
- private SyncResult(int pages, int items, boolean watermarkAdvanced) {
- this.pages = pages;
- this.items = items;
- this.watermarkAdvanced = watermarkAdvanced;
- }
-
- public static SyncResult of(int pages, int items, boolean watermarkAdvanced) {
- return new SyncResult(pages, items, watermarkAdvanced);
- }
-
- public static SyncResult empty() {
- return new SyncResult(0, 0, false);
- }
-
- public int pages() {
- return pages;
- }
-
- public int items() {
- return items;
- }
-
- /** 只有全部页成功才为 true。 */
- public boolean watermarkAdvanced() {
- return watermarkAdvanced;
- }
-
- @Override
- public String toString() {
- return "SyncResult{pages=" + pages + ", items=" + items + ", watermarkAdvanced=" + watermarkAdvanced + '}';
- }
-}
diff --git a/core/src/main/java/apelet/common/ecommerce/sync/SyncSpec.java b/core/src/main/java/apelet/common/ecommerce/sync/SyncSpec.java
deleted file mode 100644
index 561e4aa..0000000
--- a/core/src/main/java/apelet/common/ecommerce/sync/SyncSpec.java
+++ /dev/null
@@ -1,59 +0,0 @@
-package apelet.common.ecommerce.sync;
-
-import apelet.common.ecommerce.model.ChannelProvider;
-
-import java.time.Duration;
-import java.time.Instant;
-
-/**
- * 同步流的执行配置。
- */
-public final class SyncSpec {
-
- /** 订单流标识,用于水位线维度。 */
- public static final String STREAM_SALES_ORDERS = "salesOrders";
- /** 商品流标识。 */
- public static final String STREAM_PRODUCTS = "products";
-
- private final ChannelProvider provider;
- private final String accountKey;
- private final String stream;
- private final Duration overlap;
-
- private SyncSpec(ChannelProvider provider, String accountKey, String stream, Duration overlap) {
- this.provider = provider;
- this.accountKey = accountKey;
- this.stream = stream;
- this.overlap = overlap;
- }
-
- public static SyncSpec of(ChannelProvider provider, String accountKey, String stream, Duration overlap) {
- return new SyncSpec(provider, accountKey, stream, overlap);
- }
-
- public ChannelProvider provider() {
- return provider;
- }
-
- public String accountKey() {
- return accountKey;
- }
-
- public String stream() {
- return stream;
- }
-
- /** 上次水位线回退的重叠窗口,防边界丢单。 */
- public Duration overlap() {
- return overlap;
- }
-
- /**
- * 计算增量起点。
- *
- * 没有水位线时返回 null,由调用方走首次全量。
- */
- public Instant from(Instant watermark) {
- return watermark == null ? null : watermark.minus(overlap);
- }
-}
diff --git a/core/src/test/java/apelet/common/ecommerce/model/CanonicalKeysTest.java b/core/src/test/java/apelet/common/ecommerce/model/CanonicalKeysTest.java
deleted file mode 100644
index 925b5fd..0000000
--- a/core/src/test/java/apelet/common/ecommerce/model/CanonicalKeysTest.java
+++ /dev/null
@@ -1,77 +0,0 @@
-package apelet.common.ecommerce.model;
-
-import org.junit.jupiter.api.Test;
-
-import java.time.Instant;
-import java.time.ZoneId;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotEquals;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-
-class CanonicalKeysTest {
-
- @Test
- void canonicalKeyMustNotContainProvider() {
- // 直连和领星拉到同一订单,canonicalKey 必须相同
- String direct = CanonicalKeys.salesOrder(Platform.WALMART_SC, "oms-wm-001", "PO-123");
- String lingxing = CanonicalKeys.salesOrder(Platform.WALMART_SC, "oms-wm-001", "PO-123");
- assertEquals(direct, lingxing);
- assertEquals("WALMART_SC:oms-wm-001:PO-123", direct);
- }
-
- @Test
- void sourceKeyIncludesProvider() {
- String direct = CanonicalKeys.source(ChannelProvider.DIRECT, Platform.WALMART_SC, "wm-seller-01", "PO-123");
- String lingxing = CanonicalKeys.source(ChannelProvider.LINGXING, Platform.WALMART_SC, "1108", "PO-123");
- assertNotEquals(direct, lingxing);
- }
-
- @Test
- void statementFingerprintIgnoresAmount() {
- String a = CanonicalKeys.statementFingerprint("2026-09-01", "2026-09-30", "USD", "STMT-1");
- String b = CanonicalKeys.statementFingerprint("2026-09-01", "2026-09-30", "USD", "STMT-1");
- assertEquals(a, b);
- assertNotEquals(a, CanonicalKeys.statementFingerprint("2026-09-01", "2026-09-30", "USD", "STMT-2"));
- }
-
- @Test
- void businessKeyDiffersFromProviderKey() {
- String business = CanonicalKeys.businessIdempotencyKey(Platform.WALMART_SC, "oms-wm-001", "PO-1:pkg-1", "shipping");
- String providerKey = CanonicalKeys.providerRequestKey(ChannelProvider.DIRECT, Platform.WALMART_SC,
- "wm-seller-01", "shipping", "PO-1:pkg-1");
- assertNotEquals(business, providerKey);
- }
-
- @Test
- void blankIdRejected() {
- assertThrows(IllegalArgumentException.class,
- () -> CanonicalKeys.canonical(Platform.TEMU, " ", "order-1"));
- }
-
- @Test
- void platformTimeKeepsThreeAxes() {
- Instant utc = Instant.parse("2026-10-29T02:00:00Z");
- PlatformTime t = PlatformTime.of(utc, ZoneId.of("America/Los_Angeles"));
- assertEquals(utc, t.utc());
- assertEquals(19, t.marketplaceLocal().getHour()); // 前一天 19:00 PDT
- assertEquals(10, t.beijing().getHour());
- }
-
- @Test
- void dstHandledByZoneId() {
- // 2026-03-08 美国太平洋时区进入夏令时
- PlatformTime before = PlatformTime.of(Instant.parse("2026-03-08T09:59:00Z"), "America/Los_Angeles");
- PlatformTime after = PlatformTime.of(Instant.parse("2026-03-08T10:00:00Z"), "America/Los_Angeles");
- assertEquals(1, before.marketplaceLocal().getHour()); // PST UTC-8
- assertEquals(3, after.marketplaceLocal().getHour()); // PDT UTC-7
- }
-
- @Test
- void moneyRejectsCurrencyMix() {
- Money usd = Money.of("10.00", "USD");
- Money cny = Money.of("10.00", "CNY");
- assertThrows(IllegalArgumentException.class, () -> usd.add(cny));
- assertEquals("15.00", usd.add(Money.of("5.00", "USD")).amount().toPlainString());
- }
-}
diff --git a/core/src/test/java/apelet/common/ecommerce/sdk/ChannelSdkTest.java b/core/src/test/java/apelet/common/ecommerce/sdk/ChannelSdkTest.java
deleted file mode 100644
index 7aacae7..0000000
--- a/core/src/test/java/apelet/common/ecommerce/sdk/ChannelSdkTest.java
+++ /dev/null
@@ -1,183 +0,0 @@
-package apelet.common.ecommerce.sdk;
-
-import apelet.common.ecommerce.capability.CapabilityReport;
-import apelet.common.ecommerce.capability.PlatformAdapter;
-import apelet.common.ecommerce.error.ChannelException;
-import apelet.common.ecommerce.model.AccountKey;
-import apelet.common.ecommerce.model.Capability;
-import apelet.common.ecommerce.model.ChannelAccount;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.Platform;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.model.SalesOrderQuery;
-import apelet.common.ecommerce.sdk.ChannelContext;
-import apelet.common.ecommerce.spi.ChannelAccountRepository;
-import org.junit.jupiter.api.Test;
-
-import java.util.Collections;
-import java.util.EnumSet;
-import java.util.Optional;
-import java.util.Set;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertSame;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-/**
- * 门面骨架测试:校验 build 的必需项、路由解析、能力检查。
- */
-class ChannelSdkTest {
-
- private static final AccountKey WM = AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-wm-001");
-
- /** 假直连适配器:单平台,只有订单能力。 */
- static final class FakeDirectAdapter implements apelet.common.ecommerce.capability.SalesOrderCapable {
-
- @Override
- public String adapterId() {
- return "fake-walmart-sc";
- }
-
- @Override
- public ChannelProvider provider() {
- return ChannelProvider.DIRECT;
- }
-
- @Override
- public Set platforms() {
- return EnumSet.of(Platform.WALMART_SC);
- }
-
- @Override
- public EnumSet capabilities() {
- return EnumSet.of(Capability.SALES_ORDER);
- }
-
- @Override
- public Page pull(ChannelContext ctx, SalesOrderQuery query) {
- return Page.empty();
- }
-
- @Override
- public SalesOrder get(ChannelContext ctx, String channelOrderId) {
- return null;
- }
- }
-
- static final class FixedAccounts implements ChannelAccountRepository {
-
- private final ChannelAccount account;
-
- FixedAccounts(ChannelAccount account) {
- this.account = account;
- }
-
- @Override
- public Optional findByKey(String provider, String platform, String omsStoreId) {
- return account.provider().name().equals(provider)
- && account.platform().name().equals(platform)
- && account.omsStoreId().equals(omsStoreId)
- ? Optional.of(account) : Optional.empty();
- }
-
- @Override
- public java.util.List findByOmsStoreId(String omsStoreId) {
- return Collections.singletonList(account);
- }
- }
-
- private static ChannelAccount walmartAccount() {
- return ChannelAccount.builder()
- .key(WM)
- .externalStoreId("wm-seller-01")
- .credentialRef("kms://test/wm")
- .marketplaceZone("America/Chicago")
- .currency("USD")
- .build();
- }
-
- private static ChannelSdk sdkWith(PlatformAdapter adapter) {
- return ChannelSdk.builder()
- .accountRepository(new FixedAccounts(walmartAccount()))
- .register(adapter)
- .build();
- }
-
- @Test
- void buildRequiresAccountRepository() {
- IllegalStateException ex = assertThrows(IllegalStateException.class,
- () -> ChannelSdk.builder().register(new FakeDirectAdapter()).build());
- assertTrue(ex.getMessage().contains("accountRepository"), ex.getMessage());
- }
-
- @Test
- void buildRequiresAtLeastOneAdapter() {
- IllegalStateException ex = assertThrows(IllegalStateException.class,
- () -> ChannelSdk.builder()
- .accountRepository(new FixedAccounts(walmartAccount()))
- .build());
- assertTrue(ex.getMessage().contains("adapter"), ex.getMessage());
- }
-
- @Test
- void resolveReturnsRegisteredAdapter() {
- FakeDirectAdapter adapter = new FakeDirectAdapter();
- ChannelSdk sdk = sdkWith(adapter);
- assertSame(adapter, sdk.resolve(WM));
- }
-
- @Test
- void resolveFailsForUnregisteredProvider() {
- ChannelSdk sdk = sdkWith(new FakeDirectAdapter());
- AccountKey lingxing = AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, "oms-wm-001");
- IllegalStateException ex = assertThrows(IllegalStateException.class, () -> sdk.resolve(lingxing));
- assertTrue(ex.getMessage().contains("no adapter registered"), ex.getMessage());
- }
-
- @Test
- void capabilitiesReflectAdapter() {
- ChannelSdk sdk = sdkWith(new FakeDirectAdapter());
- CapabilityReport caps = sdk.capabilities(WM);
- assertTrue(caps.supports(Capability.SALES_ORDER));
- assertEquals(false, caps.supports(Capability.REFUND));
- assertTrue(caps.unsupported().contains(Capability.REFUND));
- }
-
- @Test
- void facadeDelegatesToAdapter() {
- ChannelSdk sdk = sdkWith(new FakeDirectAdapter());
- Page page = sdk.salesOrders(WM).pull(SalesOrderQuery.builder()
- .updatedAfter(java.time.Instant.parse("2026-10-25T00:00:00Z"))
- .build());
- assertNotNull(page);
- assertEquals(0, page.size());
- }
-
- @Test
- void missingCapabilityThrowsUnsupported() {
- ChannelSdk sdk = sdkWith(new FakeDirectAdapter());
- assertThrows(ChannelException.UnsupportedCapabilityException.class,
- () -> sdk.products(WM).pull(apelet.common.ecommerce.model.ProductQuery.builder().build()));
- }
-
- @Test
- void unknownAccountFailsFast() {
- ChannelSdk sdk = ChannelSdk.builder()
- .accountRepository(new FixedAccounts(walmartAccount()))
- .register(new FakeDirectAdapter())
- .build();
- AccountKey other = AccountKey.of(ChannelProvider.DIRECT, Platform.WALMART_SC, "oms-unknown");
- assertThrows(IllegalStateException.class, () -> sdk.capabilities(other));
- }
-
- @Test
- void duplicateAdapterRegistrationRejected() {
- ChannelSdk.Builder builder = ChannelSdk.builder()
- .accountRepository(new FixedAccounts(walmartAccount()))
- .register(new FakeDirectAdapter());
- assertThrows(IllegalStateException.class, () -> builder.register(new FakeDirectAdapter()));
- }
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/HttpRequest.java b/http/src/main/java/apelet/common/ecommerce/http/HttpRequest.java
deleted file mode 100644
index 3d31603..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/HttpRequest.java
+++ /dev/null
@@ -1,110 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import java.util.Collections;
-import java.util.LinkedHashMap;
-import java.util.Map;
-import java.util.Objects;
-
-/**
- * 统一请求对象。保留原始 header/body 供留痕。
- */
-public final class HttpRequest {
-
- private final String method;
- private final String url;
- private final Map headers;
- private final String body;
- private final String operation;
-
- private HttpRequest(Builder b) {
- this.method = Objects.requireNonNull(b.method, "method");
- this.url = Objects.requireNonNull(b.url, "url");
- this.headers = Collections.unmodifiableMap(new LinkedHashMap(b.headers));
- this.body = b.body;
- this.operation = b.operation;
- }
-
- public static Builder builder() {
- return new Builder();
- }
-
- public static HttpRequest get(String url) {
- return builder().method("GET").url(url).build();
- }
-
- public static HttpRequest post(String url, String body) {
- return builder().method("POST").url(url).body(body).build();
- }
-
- public String method() {
- return method;
- }
-
- public String url() {
- return url;
- }
-
- public Map headers() {
- return headers;
- }
-
- public String body() {
- return body;
- }
-
- /** 操作名,如 salesOrders.pull / token.refresh。 */
- public String operation() {
- return operation;
- }
-
- public Builder toBuilder() {
- return builder().method(method).url(url).headers(headers).body(body).operation(operation);
- }
-
- public static final class Builder {
-
- private String method;
- private String url;
- private Map headers = new LinkedHashMap();
- private String body;
- private String operation;
-
- public Builder method(String method) {
- this.method = method;
- return this;
- }
-
- public Builder url(String url) {
- this.url = url;
- return this;
- }
-
- public Builder header(String name, String value) {
- if (value != null) {
- this.headers.put(name, value);
- }
- return this;
- }
-
- public Builder headers(Map headers) {
- if (headers != null) {
- this.headers.putAll(headers);
- }
- return this;
- }
-
- public Builder body(String body) {
- this.body = body;
- return this;
- }
-
- public Builder operation(String operation) {
- this.operation = operation;
- return this;
- }
-
- public HttpRequest build() {
- return new HttpRequest(this);
- }
- }
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/HttpResponse.java b/http/src/main/java/apelet/common/ecommerce/http/HttpResponse.java
deleted file mode 100644
index d189c65..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/HttpResponse.java
+++ /dev/null
@@ -1,69 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import java.util.Collections;
-import java.util.LinkedHashMap;
-import java.util.Map;
-
-/**
- * 统一响应对象。保留原始 header/body 供留痕与错误映射。
- */
-public final class HttpResponse {
-
- private final int statusCode;
- private final Map headers;
- private final String body;
- private final long latencyMillis;
-
- private HttpResponse(int statusCode, Map headers, String body, long latencyMillis) {
- this.statusCode = statusCode;
- this.headers = Collections.unmodifiableMap(new LinkedHashMap(headers));
- this.body = body;
- this.latencyMillis = latencyMillis;
- }
-
- public static HttpResponse of(int statusCode, Map headers, String body, long latencyMillis) {
- return new HttpResponse(statusCode, headers == null ? Collections.emptyMap() : headers,
- body, latencyMillis);
- }
-
- public int statusCode() {
- return statusCode;
- }
-
- public Map headers() {
- return headers;
- }
-
- public String body() {
- return body;
- }
-
- public long latencyMillis() {
- return latencyMillis;
- }
-
- public boolean isSuccess() {
- return statusCode >= 200 && statusCode < 300;
- }
-
- public boolean isAuthFailure() {
- return statusCode == 401 || statusCode == 403;
- }
-
- public boolean isRateLimited() {
- return statusCode == 429;
- }
-
- public boolean isServerError() {
- return statusCode >= 500;
- }
-
- public String header(String name) {
- for (Map.Entry e : headers.entrySet()) {
- if (e.getKey().equalsIgnoreCase(name)) {
- return e.getValue();
- }
- }
- return null;
- }
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/HttpTransport.java b/http/src/main/java/apelet/common/ecommerce/http/HttpTransport.java
deleted file mode 100644
index 67de3d7..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/HttpTransport.java
+++ /dev/null
@@ -1,9 +0,0 @@
-package apelet.common.ecommerce.http;
-
-/**
- * HTTP 传输接口。默认实现 OkHttp,可替换为 Apache HttpClient 或测试用 Fake。
- */
-public interface HttpTransport {
-
- HttpResponse execute(HttpRequest request);
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/JacksonJsonCodec.java b/http/src/main/java/apelet/common/ecommerce/http/JacksonJsonCodec.java
deleted file mode 100644
index 3386ea0..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/JacksonJsonCodec.java
+++ /dev/null
@@ -1,86 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import com.fasterxml.jackson.databind.DeserializationFeature;
-import com.fasterxml.jackson.databind.JsonNode;
-import com.fasterxml.jackson.databind.ObjectMapper;
-import com.fasterxml.jackson.databind.node.ArrayNode;
-
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- * Jackson 实现。
- */
-public final class JacksonJsonCodec implements JsonCodec {
-
- private final ObjectMapper mapper;
-
- public JacksonJsonCodec() {
- this.mapper = new ObjectMapper()
- .configure(DeserializationFeature.FAIL_ON_UNKNOWN_PROPERTIES, false);
- }
-
- public ObjectMapper mapper() {
- return mapper;
- }
-
- @Override
- public String toJson(Object value) {
- try {
- return mapper.writeValueAsString(value);
- } catch (Exception e) {
- throw new IllegalArgumentException("serialize failed", e);
- }
- }
-
- @Override
- public T fromJson(String json, Class type) {
- try {
- return mapper.readValue(json, type);
- } catch (Exception e) {
- throw new IllegalArgumentException("deserialize failed for " + type.getSimpleName(), e);
- }
- }
-
- @Override
- public String stringAt(String json, String pointer) {
- JsonNode node = nodeAt(json, pointer);
- return node == null || node.isNull() ? null : node.asText();
- }
-
- /** 按点路径取节点,如 {@code data.list}。数组下标用数字段。 */
- public JsonNode nodeAt(String json, String pointer) {
- if (json == null || pointer == null || pointer.isEmpty()) {
- return null;
- }
- try {
- JsonNode cur = mapper.readTree(json);
- for (String seg : pointer.split("\\.")) {
- if (cur == null || cur.isNull()) {
- return null;
- }
- if (cur.isArray() && seg.matches("\\d+")) {
- cur = cur.get(Integer.parseInt(seg));
- } else {
- cur = cur.get(seg);
- }
- }
- return cur;
- } catch (Exception e) {
- return null;
- }
- }
-
- /** 把点路径下的数组节点反序列化为列表。 */
- public List listAt(String json, String pointer, Class type) {
- JsonNode node = nodeAt(json, pointer);
- if (node == null || !node.isArray()) {
- return new ArrayList();
- }
- List out = new ArrayList(node.size());
- for (JsonNode item : (ArrayNode) node) {
- out.add(mapper.convertValue(item, type));
- }
- return out;
- }
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/JsonCodec.java b/http/src/main/java/apelet/common/ecommerce/http/JsonCodec.java
deleted file mode 100644
index 0392fec..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/JsonCodec.java
+++ /dev/null
@@ -1,17 +0,0 @@
-package apelet.common.ecommerce.http;
-
-/**
- * 够用的最小 JSON 读写抽象,避免 core 层绑死 Jackson。
- */
-public interface JsonCodec {
-
- String toJson(Object value);
-
- T fromJson(String json, Class type);
-
- /**
- * 按点路径取字段值,用于解析平台响应里的 data.list 这类结构。
- * 找不到返回 null。
- */
- String stringAt(String json, String pointer);
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/OkHttpTransport.java b/http/src/main/java/apelet/common/ecommerce/http/OkHttpTransport.java
deleted file mode 100644
index 64f8ff9..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/OkHttpTransport.java
+++ /dev/null
@@ -1,70 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import apelet.common.ecommerce.error.TransientException;
-
-import java.util.concurrent.TimeUnit;
-
-/**
- * OkHttp 实现。连接池、超时、统一 User-Agent。
- */
-public final class OkHttpTransport implements HttpTransport {
-
- private final okhttp3.OkHttpClient client;
- private final String userAgent;
-
- public OkHttpTransport(String userAgent) {
- this(userAgent, 5_000, 30_000);
- }
-
- public OkHttpTransport(String userAgent, long connectTimeoutMillis, long readTimeoutMillis) {
- this.userAgent = userAgent;
- this.client = new okhttp3.OkHttpClient.Builder()
- .connectTimeout(connectTimeoutMillis, TimeUnit.MILLISECONDS)
- .readTimeout(readTimeoutMillis, TimeUnit.MILLISECONDS)
- .writeTimeout(readTimeoutMillis, TimeUnit.MILLISECONDS)
- .build();
- }
-
- @Override
- public HttpResponse execute(HttpRequest request) {
- long start = System.nanoTime();
- okhttp3.Request.Builder rb = new okhttp3.Request.Builder()
- .url(request.url())
- .header("User-Agent", userAgent);
- for (java.util.Map.Entry e : request.headers().entrySet()) {
- rb.header(e.getKey(), e.getValue());
- }
-
- String method = request.method().toUpperCase();
- okhttp3.RequestBody body = null;
- if (request.body() != null) {
- body = okhttp3.RequestBody.create(request.body(),
- okhttp3.MediaType.parse("application/json; charset=utf-8"));
- }
- if ("POST".equals(method)) {
- rb.post(body == null ? okhttp3.RequestBody.create(new byte[0], null) : body);
- } else if ("PUT".equals(method)) {
- rb.put(body == null ? okhttp3.RequestBody.create(new byte[0], null) : body);
- } else if ("DELETE".equals(method)) {
- rb.delete();
- } else {
- rb.get();
- }
-
- try (okhttp3.Response resp = client.newCall(rb.build()).execute()) {
- long latency = TimeUnit.NANOSECONDS.toMillis(System.nanoTime() - start);
- String respBody = resp.body() == null ? null : resp.body().string();
- java.util.Map headers = new java.util.LinkedHashMap();
- for (String name : resp.headers().names()) {
- headers.put(name, resp.header(name));
- }
- return HttpResponse.of(resp.code(), headers, respBody, latency);
- } catch (java.io.IOException e) {
- throw TransientException.class.cast(new TransientException(
- apelet.common.ecommerce.error.ChannelException.builder()
- .message("http transport failed: " + e.getMessage())
- .operation(request.operation())
- .retryable(true), e));
- }
- }
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/Responses.java b/http/src/main/java/apelet/common/ecommerce/http/Responses.java
deleted file mode 100644
index 36e56b6..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/Responses.java
+++ /dev/null
@@ -1,56 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import apelet.common.ecommerce.error.AuthException;
-import apelet.common.ecommerce.error.ChannelException;
-import apelet.common.ecommerce.error.RateLimitException;
-import apelet.common.ecommerce.error.TransientException;
-
-/**
- * 响应判定与重试分类。
- *
- *
- * - 2xx:成功
- * - 401/403:{@link AuthException},刷新后重试一次
- * - 429:{@link RateLimitException},遵守 Retry-After
- * - 5xx / 网络:{@link TransientException},退避加抖动
- * - 其他 4xx:业务错误,不在此层重试
- *
- */
-public final class Responses {
-
- private Responses() {
- }
-
- public static void throwIfNotSuccess(HttpResponse response, String operation) {
- if (response.isSuccess()) {
- return;
- }
- ChannelException.Builder b = ChannelException.builder()
- .message("http " + response.statusCode() + " on " + operation)
- .operation(operation)
- .platformCode(String.valueOf(response.statusCode()))
- .rawResponse(response.body());
-
- if (response.isAuthFailure()) {
- throw new AuthException(b);
- }
- if (response.isRateLimited()) {
- throw new RateLimitException(b, parseRetryAfterMillis(response.header("Retry-After")));
- }
- if (response.isServerError()) {
- throw new TransientException(b.retryable(true), null);
- }
- throw new apelet.common.ecommerce.error.ValidationException(b);
- }
-
- static long parseRetryAfterMillis(String raw) {
- if (raw == null || raw.trim().isEmpty()) {
- return 1_000L;
- }
- try {
- return Math.max(0L, Long.parseLong(raw.trim()) * 1000L);
- } catch (NumberFormatException e) {
- return 1_000L;
- }
- }
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/Signer.java b/http/src/main/java/apelet/common/ecommerce/http/Signer.java
deleted file mode 100644
index cb396ed..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/Signer.java
+++ /dev/null
@@ -1,10 +0,0 @@
-package apelet.common.ecommerce.http;
-
-/**
- * 签名器。按平台实现,差异收敛在适配器内。
- */
-public interface Signer {
-
- /** 在请求上补齐签名相关的 header / query。 */
- HttpRequest sign(HttpRequest request, apelet.common.ecommerce.spi.ChannelSecret secret);
-}
diff --git a/http/src/main/java/apelet/common/ecommerce/http/TokenManager.java b/http/src/main/java/apelet/common/ecommerce/http/TokenManager.java
deleted file mode 100644
index af27de6..0000000
--- a/http/src/main/java/apelet/common/ecommerce/http/TokenManager.java
+++ /dev/null
@@ -1,85 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import apelet.common.ecommerce.spi.AccessToken;
-import apelet.common.ecommerce.spi.ChannelSecret;
-import apelet.common.ecommerce.spi.LockProvider;
-import apelet.common.ecommerce.spi.TokenStore;
-import org.slf4j.Logger;
-import org.slf4j.LoggerFactory;
-
-import java.time.Clock;
-import java.time.Instant;
-import java.util.Optional;
-
-/**
- * 令牌管理模板。
- *
- *
- * - 按账户隔离缓存
- * - 提前 {@code earlyRefreshSeconds} 续期
- * - 刷新用 {@link LockProvider} 防击穿
- * - 刷新失败不返回旧 token(除显式宽限窗口)
- * - 日志只打印指纹
- *
- */
-public abstract class TokenManager {
-
- private static final Logger LOG = LoggerFactory.getLogger(TokenManager.class);
-
- protected final TokenStore tokenStore;
- protected final LockProvider lockProvider;
- protected final Clock clock;
- private final long earlyRefreshSeconds;
-
- protected TokenManager(TokenStore tokenStore, LockProvider lockProvider, Clock clock, long earlyRefreshSeconds) {
- this.tokenStore = tokenStore;
- this.lockProvider = lockProvider;
- this.clock = clock;
- this.earlyRefreshSeconds = earlyRefreshSeconds;
- }
-
- /** 拿到可用的 access token;必要时刷新。 */
- public AccessToken getOrRefresh(String tokenKey, ChannelSecret secret) {
- Instant now = Instant.now(clock);
- Optional cached = tokenStore.get(tokenKey);
- if (cached.isPresent() && !cached.get().needsRefresh(now, earlyRefreshSeconds)) {
- return cached.get();
- }
-
- Optional lock = lockProvider.tryLock("token-refresh:" + tokenKey, 30);
- if (!lock.isPresent()) {
- // 别的线程在刷新:再读一次,读不到就短等待后重读
- Optional again = tokenStore.get(tokenKey);
- if (again.isPresent() && !again.get().needsRefresh(now, earlyRefreshSeconds)) {
- return again.get();
- }
- throw new apelet.common.ecommerce.error.AuthException(
- apelet.common.ecommerce.error.ChannelException.builder()
- .message("token refresh in progress for " + tokenKey)
- .operation("token.refresh"));
- }
-
- try {
- Optional again = tokenStore.get(tokenKey);
- Instant nowInLock = Instant.now(clock);
- if (again.isPresent() && !again.get().needsRefresh(nowInLock, earlyRefreshSeconds)) {
- return again.get();
- }
- AccessToken refreshed = refresh(secret, cached.orElse(null));
- tokenStore.save(tokenKey, refreshed);
- LOG.info("token refreshed for {} [{}]", tokenKey, refreshed.fingerprint());
- return refreshed;
- } finally {
- lock.get().close();
- }
- }
-
- /** 401 后作废并强制重取一次。 */
- public AccessToken forceRefresh(String tokenKey, ChannelSecret secret) {
- tokenStore.remove(tokenKey);
- return getOrRefresh(tokenKey, secret);
- }
-
- /** 由平台实现:向平台换取新令牌。 */
- protected abstract AccessToken refresh(ChannelSecret secret, AccessToken previous);
-}
diff --git a/http/src/test/java/apelet/common/ecommerce/http/ResponsesTest.java b/http/src/test/java/apelet/common/ecommerce/http/ResponsesTest.java
deleted file mode 100644
index 3bbab42..0000000
--- a/http/src/test/java/apelet/common/ecommerce/http/ResponsesTest.java
+++ /dev/null
@@ -1,43 +0,0 @@
-package apelet.common.ecommerce.http;
-
-import org.junit.jupiter.api.Test;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertThrows;
-
-class ResponsesTest {
-
- @Test
- void successPasses() {
- Responses.throwIfNotSuccess(HttpResponse.of(200, null, "{}", 1), "op");
- }
-
- @Test
- void authMapsToAuthException() {
- assertThrows(apelet.common.ecommerce.error.AuthException.class,
- () -> Responses.throwIfNotSuccess(HttpResponse.of(401, null, "{}", 1), "op"));
- }
-
- @Test
- void rateLimitCarriesRetryAfter() {
- apelet.common.ecommerce.error.RateLimitException ex = assertThrows(
- apelet.common.ecommerce.error.RateLimitException.class,
- () -> Responses.throwIfNotSuccess(
- HttpResponse.of(429, java.util.Collections.singletonMap("Retry-After", "3"), "", 1), "op"));
- assertEquals(3000L, ex.retryAfterMillis());
- }
-
- @Test
- void serverErrorIsRetryable() {
- apelet.common.ecommerce.error.TransientException ex = assertThrows(
- apelet.common.ecommerce.error.TransientException.class,
- () -> Responses.throwIfNotSuccess(HttpResponse.of(503, null, "", 1), "op"));
- assertEquals(true, ex.retryable());
- }
-
- @Test
- void badRequestIsValidation() {
- assertThrows(apelet.common.ecommerce.error.ValidationException.class,
- () -> Responses.throwIfNotSuccess(HttpResponse.of(400, null, "", 1), "op"));
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingAdapter.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingAdapter.java
deleted file mode 100644
index 7296762..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingAdapter.java
+++ /dev/null
@@ -1,262 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.capability.AggregatorCapable;
-import apelet.common.ecommerce.capability.SalesOrderCapable;
-import apelet.common.ecommerce.error.ChannelException;
-import apelet.common.ecommerce.http.HttpRequest;
-import apelet.common.ecommerce.http.HttpResponse;
-import apelet.common.ecommerce.http.HttpTransport;
-import apelet.common.ecommerce.http.JacksonJsonCodec;
-import apelet.common.ecommerce.http.Responses;
-import apelet.common.ecommerce.http.TokenManager;
-import apelet.common.ecommerce.lingxing.dto.LingxingOrderDto;
-import apelet.common.ecommerce.model.Capability;
-import apelet.common.ecommerce.model.ChannelAccount;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.Platform;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.model.SalesOrderQuery;
-import apelet.common.ecommerce.sdk.ChannelContext;
-import apelet.common.ecommerce.spi.AccessToken;
-import apelet.common.ecommerce.spi.ChannelSecret;
-import apelet.common.ecommerce.spi.LockProvider;
-import apelet.common.ecommerce.spi.SecretProvider;
-import apelet.common.ecommerce.spi.TokenStore;
-
-import java.io.UnsupportedEncodingException;
-import java.net.URLEncoder;
-import java.time.Clock;
-import java.time.Duration;
-import java.time.Instant;
-import java.time.ZoneId;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.EnumSet;
-import java.util.LinkedHashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.Set;
-
-/**
- * 领星聚合适配器。
- *
- * 一个适配器服务多个子平台,子平台由 {@code ChannelAccount.platformCode} 决定,
- * 能力按子平台细化({@link #supports})。首期只实现订单列表拉取。
- *
- * 领星字段名与签名细节标注为「待核对」的地方集中在 {@code dto} 与
- * {@link LingxingSigner},联调时只改这两处。
- */
-public final class LingxingAdapter implements SalesOrderCapable, AggregatorCapable {
-
- /** 领星订单列表令牌桶:10 req/s(文档 9.3 按接口配置)。 */
- private static final int ORDERS_PER_SECOND = 10;
-
- private final String baseUrl;
- private final HttpTransport transport;
- private final JacksonJsonCodec json;
- private final SecretProvider secretProvider;
- private final Clock clock;
- private final LingxingOrderMapper mapper;
- private final TokenManager tokenManager;
- private final SimpleRateLimiter rateLimiter;
-
- public LingxingAdapter(String baseUrl, HttpTransport transport, JacksonJsonCodec json,
- SecretProvider secretProvider, TokenStore tokenStore, LockProvider lockProvider,
- Clock clock) {
- this.baseUrl = baseUrl;
- this.transport = transport;
- this.json = json;
- this.secretProvider = secretProvider;
- this.clock = clock;
- this.mapper = new LingxingOrderMapper(json);
- final LingxingTokenClient tokenClient = new LingxingTokenClient(transport, json, baseUrl);
- // 领星 access_token 约 2h,提前 10 分钟续期
- this.tokenManager = new TokenManager(tokenStore, lockProvider, clock, 600) {
- @Override
- protected AccessToken refresh(ChannelSecret secret, AccessToken previous) {
- return tokenClient.fetch(secret.appKey(), secret.appSecret());
- }
- };
- this.rateLimiter = new SimpleRateLimiter(ORDERS_PER_SECOND);
- }
-
- @Override
- public String adapterId() {
- return LingxingConstants.ADAPTER_ID;
- }
-
- @Override
- public ChannelProvider provider() {
- return ChannelProvider.LINGXING;
- }
-
- @Override
- public Set platforms() {
- return EnumSet.of(Platform.AMAZON_SC, Platform.AMAZON_VC, Platform.WALMART_SC, Platform.TIKTOK,
- Platform.TEMU, Platform.EBAY, Platform.SHEIN, Platform.MIRAKL, Platform.CUSTOM);
- }
-
- @Override
- public EnumSet capabilities() {
- return EnumSet.of(Capability.SALES_ORDER);
- }
-
- /**
- * 聚合器按子平台细化能力。
- *
- * eBay / SHEIN / Mirakl / 自定义平台在领星侧只有订单,未见账单与售后接口,
- * 因此只声明 SALES_ORDER,缺口由能力报告显式暴露,不假装支持。
- */
- @Override
- public boolean supports(ChannelAccount account, Capability capability) {
- if (!capabilities().contains(capability)) {
- return false;
- }
- Platform p = LingxingConstants.toPlatform(account.platformCode());
- if (p == Platform.EBAY || p == Platform.SHEIN || p == Platform.MIRAKL || p == Platform.CUSTOM) {
- return capability == Capability.SALES_ORDER;
- }
- return true;
- }
-
- @Override
- public List listSubChannels(ChannelAccount account) {
- // 首期一个账户对应一个子渠道;店铺列表接口待接入
- SubChannel ch = new SubChannel(
- account.platformCode() == null ? 0 : account.platformCode(),
- account.externalStoreId(),
- LingxingConstants.toPlatform(account.platformCode()),
- account.externalStoreId());
- return Collections.singletonList(ch);
- }
-
- @Override
- public Page pull(ChannelContext ctx, SalesOrderQuery query) {
- requireCapability();
- ChannelAccount account = ctx.account();
- ZoneId zone = ZoneId.of(account.marketplaceZone());
-
- Instant from = query.updatedAfter();
- Instant to = query.updatedBefore() != null ? query.updatedBefore() : Instant.now(clock);
- // 领星时间窗 ≤31 天:超出时截断到最近 31 天,由 SyncEngine 分段推进
- if (Duration.between(from, to).toDays() > LingxingConstants.MAX_QUERY_DAYS) {
- from = to.minus(Duration.ofDays(LingxingConstants.MAX_QUERY_DAYS));
- }
-
- int length = Math.min(query.pageSize() <= 0 ? 100 : query.pageSize(), LingxingConstants.MAX_PAGE_SIZE);
- int offset = query.cursor() == null ? 0 : Integer.parseInt(query.cursor());
-
- rateLimiter.acquire();
- String body = buildOrderListBody(account, from, to, offset, length);
- HttpRequest req = signedPost(ctx, LingxingConstants.PATH_ORDER_LIST, body, "salesOrders.pull");
-
- HttpResponse resp = transport.execute(req);
- Responses.throwIfNotSuccess(resp, "salesOrders.pull");
-
- List dtos = mapper.parseList(resp.body());
- int total = mapper.parseTotal(resp.body());
-
- List orders = new ArrayList(dtos.size());
- for (LingxingOrderDto dto : dtos) {
- orders.add(mapper.toSalesOrder(dto, account.omsStoreId(), zone));
- }
-
- int nextOffset = offset + dtos.size();
- String nextCursor = (dtos.isEmpty() || nextOffset >= total) ? null : String.valueOf(nextOffset);
- return Page.of(orders, nextCursor);
- }
-
- /** 单订单详情接口待核对(领星以列表接口为主),先显式拒绝而不是返回 null。 */
- @Override
- public SalesOrder get(ChannelContext ctx, String channelOrderId) {
- throw ChannelException.builder()
- .message("lingxing order detail is not implemented yet")
- .operation("salesOrders.get")
- .provider(provider().name())
- .omsStoreId(ctx.omsStoreId())
- .requestId(ctx.requestId())
- .platformCode(channelOrderId)
- .build();
- }
-
- // ---------------------------------------------------------------- internals
-
- private String buildOrderListBody(ChannelAccount account, Instant from, Instant to, int offset, int length) {
- Map body = new LinkedHashMap();
- body.put("offset", offset);
- body.put("length", length);
- if (account.platformCode() != null) {
- body.put("platform_code", account.platformCode());
- }
- if (account.externalStoreId() != null) {
- body.put("store_id", account.externalStoreId());
- }
- // 领星查询时间为 epoch 秒
- body.put("update_time_start", from.getEpochSecond());
- body.put("update_time_end", to.getEpochSecond());
- return json.toJson(body);
- }
-
- private HttpRequest signedPost(ChannelContext ctx, String path, String body, String operation) {
- ChannelAccount account = ctx.account();
- ChannelSecret secret = secretProvider.get(account.credentialRef());
- AccessToken token = tokenManager.getOrRefresh(tokenKey(account), secret);
-
- Map common = new LinkedHashMap();
- common.put("app_key", secret.appKey());
- common.put("timestamp", String.valueOf(Instant.now(clock).getEpochSecond()));
- String sign = LingxingSigner.sign(common, secret);
-
- String url = baseUrl + path
- + "?app_key=" + urlEncode(common.get("app_key"))
- + "×tamp=" + common.get("timestamp")
- + "&sign=" + sign;
-
- return HttpRequest.builder()
- .method("POST")
- .url(url)
- .header("Content-Type", "application/json")
- .header("Authorization", token.tokenType() + " " + token.value())
- .header("X-Request-Id", ctx.requestId())
- .body(body)
- .operation(operation)
- .build();
- }
-
- private static String tokenKey(ChannelAccount account) {
- return "lingxing:" + account.externalStoreId();
- }
-
- private static String urlEncode(String v) {
- try {
- return URLEncoder.encode(v == null ? "" : v, "UTF-8");
- } catch (UnsupportedEncodingException e) {
- throw new IllegalStateException(e);
- }
- }
-
- /** 简单令牌桶;首期按接口串行即可,后续替换为通用 RateLimiter。 */
- static final class SimpleRateLimiter {
-
- private final long intervalNanos;
- private long nextAllowed;
-
- SimpleRateLimiter(int permitsPerSecond) {
- this.intervalNanos = 1_000_000_000L / permitsPerSecond;
- }
-
- synchronized void acquire() {
- long now = System.nanoTime();
- if (now < nextAllowed) {
- long waitNanos = nextAllowed - now;
- try {
- Thread.sleep(waitNanos / 1_000_000L, (int) (waitNanos % 1_000_000L));
- } catch (InterruptedException e) {
- Thread.currentThread().interrupt();
- }
- }
- nextAllowed = System.nanoTime() + intervalNanos;
- }
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingAdapterFactory.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingAdapterFactory.java
deleted file mode 100644
index 2729d1c..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingAdapterFactory.java
+++ /dev/null
@@ -1,58 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.capability.PlatformAdapter;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.Platform;
-import apelet.common.ecommerce.sdk.AdapterFactory;
-import apelet.common.ecommerce.spi.LockProvider;
-import apelet.common.ecommerce.spi.SecretProvider;
-import apelet.common.ecommerce.spi.TokenStore;
-import com.fasterxml.jackson.databind.ObjectMapper;
-
-import java.time.Clock;
-import java.util.EnumSet;
-
-/**
- * 领星适配器工厂。直连适配器使用同一套注册机制。
- */
-public final class LingxingAdapterFactory implements AdapterFactory {
-
- private final SecretProvider secretProvider;
- private final TokenStore tokenStore;
- private final LockProvider lockProvider;
- private final Clock clock;
-
- public LingxingAdapterFactory(SecretProvider secretProvider, TokenStore tokenStore,
- LockProvider lockProvider, Clock clock) {
- this.secretProvider = secretProvider;
- this.tokenStore = tokenStore;
- this.lockProvider = lockProvider;
- this.clock = clock;
- }
-
- @Override
- public String adapterId() {
- return LingxingConstants.ADAPTER_ID;
- }
-
- @Override
- public ChannelProvider provider() {
- return ChannelProvider.LINGXING;
- }
-
- @Override
- public EnumSet platforms() {
- return EnumSet.of(Platform.AMAZON_SC, Platform.AMAZON_VC, Platform.WALMART_SC, Platform.TIKTOK,
- Platform.TEMU, Platform.EBAY, Platform.SHEIN, Platform.MIRAKL, Platform.CUSTOM);
- }
-
- @Override
- public PlatformAdapter create(AdapterConfig config) {
- String baseUrl = config.endpointBaseUrl() == null
- ? LingxingConstants.DEFAULT_BASE_URL : config.endpointBaseUrl();
- return new LingxingAdapter(baseUrl,
- new apelet.common.ecommerce.http.OkHttpTransport("common-ecommerce/1.0.0 (lingxing)"),
- new apelet.common.ecommerce.http.JacksonJsonCodec(),
- secretProvider, tokenStore, lockProvider, clock);
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingConstants.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingConstants.java
deleted file mode 100644
index 0c74095..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingConstants.java
+++ /dev/null
@@ -1,60 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-/** 领星常量与 platform_code 映射。 */
-public final class LingxingConstants {
-
- /** 生产环境基址。 */
- public static final String DEFAULT_BASE_URL = "https://openapi.lingxing.com";
-
- public static final String ADAPTER_ID = "lingxing";
-
- /** 获取令牌。 */
- public static final String PATH_ACCESS_TOKEN = "/api/auth-server/oauth/access-token";
- /** 多平台订单列表(各平台自发货)。 */
- public static final String PATH_ORDER_LIST = "/pb/mp/order/v2/list";
- /** 店铺列表。 */
- public static final String PATH_SELLER_LIST = "/pb/mp/shop/v2/getSellerList";
-
- /** 订单查询时间跨度上限:31 天。 */
- public static final int MAX_QUERY_DAYS = 31;
- /** 分页 length 上限。 */
- public static final int MAX_PAGE_SIZE = 500;
-
- private LingxingConstants() {
- }
-
- /**
- * 领星 platform_code → 统一 Platform。
- *
- * 10034 同时对应 Mirakl / BestBuy;Target、AEPH 未独立枚举,
- * 按文档需要到领星后台确认,此处先映射到 CUSTOM,待核对。
- */
- public static apelet.common.ecommerce.model.Platform toPlatform(Integer platformCode) {
- if (platformCode == null) {
- return null;
- }
- switch (platformCode) {
- case 10001:
- return apelet.common.ecommerce.model.Platform.AMAZON_SC;
- case 10035:
- return apelet.common.ecommerce.model.Platform.AMAZON_VC;
- case 10008:
- return apelet.common.ecommerce.model.Platform.WALMART_SC;
- case 10011:
- return apelet.common.ecommerce.model.Platform.TIKTOK;
- case 10022:
- case 10024:
- return apelet.common.ecommerce.model.Platform.TEMU;
- case 10003:
- return apelet.common.ecommerce.model.Platform.EBAY;
- case 10021:
- case 10027:
- case 10028:
- return apelet.common.ecommerce.model.Platform.SHEIN;
- case 10034:
- return apelet.common.ecommerce.model.Platform.MIRAKL;
- default:
- return apelet.common.ecommerce.model.Platform.CUSTOM;
- }
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingOrderMapper.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingOrderMapper.java
deleted file mode 100644
index ebb30b3..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingOrderMapper.java
+++ /dev/null
@@ -1,112 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.http.JacksonJsonCodec;
-import apelet.common.ecommerce.lingxing.dto.LingxingOrderDto;
-import apelet.common.ecommerce.lingxing.dto.LingxingOrderItemDto;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.Money;
-import apelet.common.ecommerce.model.OrderLine;
-import apelet.common.ecommerce.model.Platform;
-import apelet.common.ecommerce.model.PlatformTime;
-import apelet.common.ecommerce.model.SalesOrder;
-
-import java.time.Instant;
-import java.time.ZoneId;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.Comparator;
-import java.util.List;
-
-/**
- * 领星订单 → 统一模型。
- *
- * 领星订单是唯一的映射入口,平台差异全部收敛在这里。
- */
-public final class LingxingOrderMapper {
-
- private final JacksonJsonCodec json;
-
- public LingxingOrderMapper(JacksonJsonCodec json) {
- this.json = json;
- }
-
- public SalesOrder toSalesOrder(LingxingOrderDto dto, String omsStoreId, ZoneId marketplaceZone) {
- Platform platform = LingxingConstants.toPlatform(dto.getPlatformCode());
- String channelOrderId = resolveChannelOrderId(dto);
- String currency = dto.getCurrencyCode() == null ? "USD" : dto.getCurrencyCode();
-
- List lines = new ArrayList();
- for (LingxingOrderItemDto item : safe(dto.getItemList())) {
- lines.add(OrderLine.builder()
- .lineId(item.getOrderItemId())
- // 领星 MSKU 与平台 SKU 不总一致;优先 platform_sku,缺失时回落 sku
- .platformSku(item.getPlatformSku() != null ? item.getPlatformSku() : item.getSku())
- .quantity(item.getQuantity() == null ? 0 : item.getQuantity())
- .unitPrice(moneyOrNull(item.getItemPrice(), currency))
- .tax(moneyOrNull(item.getTax(), currency))
- .discount(moneyOrNull(item.getDiscount(), currency))
- .build());
- }
-
- Instant occur = dto.getPurchaseTime() != null
- ? Instant.ofEpochSecond(dto.getPurchaseTime())
- : Instant.EPOCH;
-
- return SalesOrder.builder()
- .omsStoreId(omsStoreId)
- .channelOrderId(channelOrderId)
- .status(dto.getOrderStatus())
- .buyerName(dto.getBuyerName())
- .shipToCountryCode(dto.getCountryCode())
- .lines(lines)
- .totalAmount(moneyOrNull(dto.getOrderTotal(), currency))
- .occurredAt(PlatformTime.of(occur, marketplaceZone))
- .sourceProvider(ChannelProvider.LINGXING)
- .sourceAccountId(dto.getStoreId())
- .build();
- }
-
- /**
- * channelOrderId 是 canonicalKey 的一部分,必须稳定。
- *
- * 优先平台单号;缺失时退回领星 order_id(此时跨 provider 无法去重,
- * 会由 DuplicateOrderGuard 记录差异)。
- */
- static String resolveChannelOrderId(LingxingOrderDto dto) {
- if (dto.getPlatformOrderNo() != null && !dto.getPlatformOrderNo().trim().isEmpty()) {
- return dto.getPlatformOrderNo().trim();
- }
- List names = dto.getPlatformOrderNames();
- if (names != null && !names.isEmpty()) {
- List sorted = new ArrayList(names);
- Collections.sort(sorted, new Comparator() {
- @Override
- public int compare(String a, String b) {
- return a.compareTo(b);
- }
- });
- return sorted.get(0);
- }
- return dto.getOrderId();
- }
-
- public List parseList(String body) {
- return json.listAt(body, "data.list", LingxingOrderDto.class);
- }
-
- public int parseTotal(String body) {
- String total = json.stringAt(body, "data.total");
- return total == null ? 0 : Integer.parseInt(total);
- }
-
- private static List safe(List in) {
- return in == null ? Collections.emptyList() : in;
- }
-
- private static Money moneyOrNull(String value, String currency) {
- if (value == null || value.trim().isEmpty()) {
- return null;
- }
- return Money.of(value.trim(), currency);
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingSigner.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingSigner.java
deleted file mode 100644
index 70f1246..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingSigner.java
+++ /dev/null
@@ -1,58 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.spi.ChannelSecret;
-
-import java.nio.charset.StandardCharsets;
-import java.security.MessageDigest;
-import java.security.NoSuchAlgorithmException;
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.Map;
-
-/**
- * 领星签名:公共参数按 ASCII 升序拼接 {@code key+value},前后拼 appSecret,MD5 小写。
- *
- * 待核对:官方文档对 sign 的大小写与大写规则未在需求文档中固化,
- * 实现集中在 {@link #sign(Map, String)} 一处,便于联调时调整。
- */
-public final class LingxingSigner {
-
- private LingxingSigner() {
- }
-
- /**
- * @param params 参与签名的参数(不含 sign),值不得为 null
- * @param appSecret 应用密钥
- */
- public static String sign(Map params, String appSecret) {
- List keys = new ArrayList(params.keySet());
- Collections.sort(keys);
- StringBuilder sb = new StringBuilder(appSecret);
- for (String k : keys) {
- sb.append(k).append(params.get(k));
- }
- sb.append(appSecret);
- return md5Hex(sb.toString());
- }
-
- /** 便捷:从凭证取 appSecret。 */
- public static String sign(Map params, ChannelSecret secret) {
- return sign(params, secret.appSecret());
- }
-
- static String md5Hex(String raw) {
- try {
- MessageDigest md = MessageDigest.getInstance("MD5");
- byte[] digest = md.digest(raw.getBytes(StandardCharsets.UTF_8));
- StringBuilder sb = new StringBuilder(digest.length * 2);
- for (byte b : digest) {
- sb.append(Character.forDigit((b >> 4) & 0xF, 16));
- sb.append(Character.forDigit(b & 0xF, 16));
- }
- return sb.toString();
- } catch (NoSuchAlgorithmException e) {
- throw new IllegalStateException("MD5 not available", e);
- }
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingTokenClient.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingTokenClient.java
deleted file mode 100644
index 95f3e14..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/LingxingTokenClient.java
+++ /dev/null
@@ -1,67 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.http.HttpRequest;
-import apelet.common.ecommerce.http.HttpResponse;
-import apelet.common.ecommerce.http.HttpTransport;
-import apelet.common.ecommerce.http.JsonCodec;
-import apelet.common.ecommerce.http.Responses;
-import apelet.common.ecommerce.spi.AccessToken;
-
-import java.time.Instant;
-import java.util.LinkedHashMap;
-import java.util.Map;
-
-/**
- * 领星令牌获取:{@code POST /api/auth-server/oauth/access-token}。
- *
- * 请求体字段名以官方文档为准(appId/appSecret),这里集中在一处便于联调调整。
- */
-public final class LingxingTokenClient {
-
- private final HttpTransport transport;
- private final JsonCodec json;
- private final String baseUrl;
-
- public LingxingTokenClient(HttpTransport transport, JsonCodec json, String baseUrl) {
- this.transport = transport;
- this.json = json;
- this.baseUrl = baseUrl;
- }
-
- public AccessToken fetch(String appId, String appSecret) {
- Map body = new LinkedHashMap();
- body.put("appId", appId);
- body.put("appSecret", appSecret);
-
- HttpRequest req = HttpRequest.builder()
- .method("POST")
- .url(baseUrl + LingxingConstants.PATH_ACCESS_TOKEN)
- .header("Content-Type", "application/json")
- .body(json.toJson(body))
- .operation("token.refresh")
- .build();
-
- HttpResponse resp = transport.execute(req);
- Responses.throwIfNotSuccess(resp, "token.refresh");
-
- String token = json.stringAt(resp.body(), "data.access_token");
- if (token == null) {
- // 兼容部分版本的 data 为数组
- token = json.stringAt(resp.body(), "data.0.access_token");
- }
- String accessToken = json.stringAt(resp.body(), "access_token");
- if (accessToken == null) {
- accessToken = token;
- }
- String refreshToken = json.stringAt(resp.body(), "data.refresh_token");
- String expiresIn = json.stringAt(resp.body(), "data.expires_in");
-
- long seconds = expiresIn == null ? 7199L : Long.parseLong(expiresIn);
- return AccessToken.builder()
- .value(accessToken)
- .refreshToken(refreshToken)
- .expiresAt(Instant.now().plusSeconds(seconds))
- .tokenType("Bearer")
- .build();
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/dto/LingxingOrderDto.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/dto/LingxingOrderDto.java
deleted file mode 100644
index 5fb4633..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/dto/LingxingOrderDto.java
+++ /dev/null
@@ -1,196 +0,0 @@
-package apelet.common.ecommerce.lingxing.dto;
-
-import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
-import com.fasterxml.jackson.annotation.JsonProperty;
-
-import java.util.ArrayList;
-import java.util.List;
-
-/**
- * 领星多平台订单列表条目。
- *
- * 待核对:字段名依据领星 OpenAPI 文档摘录,联调时以官方最新文档
- * 与真实响应为准;调整集中在本 DTO 与 {@code LingxingOrderMapper}。
- */
-@JsonIgnoreProperties(ignoreUnknown = true)
-public class LingxingOrderDto {
-
- /** 领星内部订单 ID。 */
- @JsonProperty("order_id")
- private String orderId;
-
- /** 平台订单号(Amazon / Walmart PO / eBay 等)。 */
- @JsonProperty("platform_order_no")
- private String platformOrderNo;
-
- /** 部分接口返回平台单号数组,eBay 需用 platform_order_names 查询。 */
- @JsonProperty("platform_order_names")
- private List platformOrderNames = new ArrayList();
-
- /** 领星平台码,如 10008=Walmart。 */
- @JsonProperty("platform_code")
- private Integer platformCode;
-
- /** 领星店铺 ID。 */
- @JsonProperty("store_id")
- private String storeId;
-
- /** 平台侧订单状态。 */
- @JsonProperty("order_status")
- private String orderStatus;
-
- /** 买家名称。 */
- @JsonProperty("buyer_name")
- private String buyerName;
-
- /** 收货国家二字码。 */
- @JsonProperty("country_code")
- private String countryCode;
-
- /** 订单币种。 */
- @JsonProperty("currency_code")
- private String currencyCode;
-
- /** 订单总额。 */
- @JsonProperty("order_total")
- private String orderTotal;
-
- /** 站点本地下单时间字符串。 */
- @JsonProperty("purchase_time_locale")
- private String purchaseTimeLocale;
-
- /** epoch 秒下单时间。 */
- @JsonProperty("purchase_time")
- private Long purchaseTime;
-
- /** epoch 秒更新时间。 */
- @JsonProperty("update_time")
- private Long updateTime;
-
- /** 站点本地更新时间字符串。 */
- @JsonProperty("update_time_locale")
- private String updateTimeLocale;
-
- @JsonProperty("item_list")
- private List itemList = new ArrayList();
-
- public String getOrderId() {
- return orderId;
- }
-
- public void setOrderId(String orderId) {
- this.orderId = orderId;
- }
-
- public String getPlatformOrderNo() {
- return platformOrderNo;
- }
-
- public void setPlatformOrderNo(String platformOrderNo) {
- this.platformOrderNo = platformOrderNo;
- }
-
- public List getPlatformOrderNames() {
- return platformOrderNames;
- }
-
- public void setPlatformOrderNames(List platformOrderNames) {
- this.platformOrderNames = platformOrderNames;
- }
-
- public Integer getPlatformCode() {
- return platformCode;
- }
-
- public void setPlatformCode(Integer platformCode) {
- this.platformCode = platformCode;
- }
-
- public String getStoreId() {
- return storeId;
- }
-
- public void setStoreId(String storeId) {
- this.storeId = storeId;
- }
-
- public String getOrderStatus() {
- return orderStatus;
- }
-
- public void setOrderStatus(String orderStatus) {
- this.orderStatus = orderStatus;
- }
-
- public String getBuyerName() {
- return buyerName;
- }
-
- public void setBuyerName(String buyerName) {
- this.buyerName = buyerName;
- }
-
- public String getCountryCode() {
- return countryCode;
- }
-
- public void setCountryCode(String countryCode) {
- this.countryCode = countryCode;
- }
-
- public String getCurrencyCode() {
- return currencyCode;
- }
-
- public void setCurrencyCode(String currencyCode) {
- this.currencyCode = currencyCode;
- }
-
- public String getOrderTotal() {
- return orderTotal;
- }
-
- public void setOrderTotal(String orderTotal) {
- this.orderTotal = orderTotal;
- }
-
- public String getPurchaseTimeLocale() {
- return purchaseTimeLocale;
- }
-
- public void setPurchaseTimeLocale(String purchaseTimeLocale) {
- this.purchaseTimeLocale = purchaseTimeLocale;
- }
-
- public Long getPurchaseTime() {
- return purchaseTime;
- }
-
- public void setPurchaseTime(Long purchaseTime) {
- this.purchaseTime = purchaseTime;
- }
-
- public Long getUpdateTime() {
- return updateTime;
- }
-
- public void setUpdateTime(Long updateTime) {
- this.updateTime = updateTime;
- }
-
- public String getUpdateTimeLocale() {
- return updateTimeLocale;
- }
-
- public void setUpdateTimeLocale(String updateTimeLocale) {
- this.updateTimeLocale = updateTimeLocale;
- }
-
- public List getItemList() {
- return itemList;
- }
-
- public void setItemList(List itemList) {
- this.itemList = itemList;
- }
-}
diff --git a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java b/lingxing/src/main/java/apelet/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java
deleted file mode 100644
index b50e990..0000000
--- a/lingxing/src/main/java/apelet/common/ecommerce/lingxing/dto/LingxingOrderItemDto.java
+++ /dev/null
@@ -1,88 +0,0 @@
-package apelet.common.ecommerce.lingxing.dto;
-
-import com.fasterxml.jackson.annotation.JsonIgnoreProperties;
-import com.fasterxml.jackson.annotation.JsonProperty;
-
-/** 领星订单明细行。字段名待官方文档核对。 */
-@JsonIgnoreProperties(ignoreUnknown = true)
-public class LingxingOrderItemDto {
-
- @JsonProperty("order_item_id")
- private String orderItemId;
-
- /** 领星 MSKU,需映射回平台 SKU 才能与直连对齐。 */
- @JsonProperty("sku")
- private String sku;
-
- /** 平台 SKU(部分接口返回)。 */
- @JsonProperty("platform_sku")
- private String platformSku;
-
- @JsonProperty("quantity")
- private Integer quantity;
-
- @JsonProperty("item_price")
- private String itemPrice;
-
- @JsonProperty("tax")
- private String tax;
-
- @JsonProperty("discount")
- private String discount;
-
- public String getOrderItemId() {
- return orderItemId;
- }
-
- public void setOrderItemId(String orderItemId) {
- this.orderItemId = orderItemId;
- }
-
- public String getSku() {
- return sku;
- }
-
- public void setSku(String sku) {
- this.sku = sku;
- }
-
- public String getPlatformSku() {
- return platformSku;
- }
-
- public void setPlatformSku(String platformSku) {
- this.platformSku = platformSku;
- }
-
- public Integer getQuantity() {
- return quantity;
- }
-
- public void setQuantity(Integer quantity) {
- this.quantity = quantity;
- }
-
- public String getItemPrice() {
- return itemPrice;
- }
-
- public void setItemPrice(String itemPrice) {
- this.itemPrice = itemPrice;
- }
-
- public String getTax() {
- return tax;
- }
-
- public void setTax(String tax) {
- this.tax = tax;
- }
-
- public String getDiscount() {
- return discount;
- }
-
- public void setDiscount(String discount) {
- this.discount = discount;
- }
-}
diff --git a/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingAdapterTest.java b/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingAdapterTest.java
deleted file mode 100644
index 25ceae0..0000000
--- a/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingAdapterTest.java
+++ /dev/null
@@ -1,190 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.http.JacksonJsonCodec;
-import apelet.common.ecommerce.model.AccountKey;
-import apelet.common.ecommerce.model.ChannelAccount;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.Platform;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.model.SalesOrderQuery;
-import apelet.common.ecommerce.sdk.ChannelContext;
-import apelet.common.ecommerce.spi.ChannelSecret;
-import apelet.common.ecommerce.sync.SyncEngine;
-import apelet.common.ecommerce.sync.SyncResult;
-import apelet.common.ecommerce.sync.SyncSpec;
-import apelet.common.ecommerce.testkit.FakeTransport;
-import apelet.common.ecommerce.testkit.Fixtures;
-import apelet.common.ecommerce.testkit.InMemoryAccounts;
-import apelet.common.ecommerce.testkit.InMemoryCursorStore;
-import apelet.common.ecommerce.testkit.InMemoryLockProvider;
-import apelet.common.ecommerce.testkit.InMemorySink;
-import apelet.common.ecommerce.testkit.InMemoryTokenStore;
-import apelet.common.ecommerce.testkit.Responses;
-import org.junit.jupiter.api.BeforeEach;
-import org.junit.jupiter.api.Test;
-
-import java.time.Clock;
-import java.time.Duration;
-import java.time.Instant;
-import java.time.ZoneOffset;
-import java.util.Collections;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotNull;
-import static org.junit.jupiter.api.Assertions.assertNull;
-import static org.junit.jupiter.api.Assertions.assertTrue;
-
-/**
- * 领星订单拉取的契约测试:不依赖网络、数据库、Spring。
- */
-class LingxingAdapterTest {
-
- private static final String CREDENTIAL_REF = "kms://test/lingxing/001";
-
- private FakeTransport transport;
- private InMemoryTokenStore tokenStore;
- private InMemoryAccounts accounts;
- private InMemoryLockProvider locks;
- private LingxingAdapter adapter;
- private ChannelAccount account;
- private ChannelContext ctx;
-
- @BeforeEach
- void setUp() {
- transport = FakeTransport.create();
- tokenStore = new InMemoryTokenStore();
- accounts = new InMemoryAccounts();
- locks = new InMemoryLockProvider();
-
- account = ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.WALMART_SC, "oms-wm-001"))
- .externalStoreId("1108413237731")
- .platformCode(10008)
- .credentialRef(CREDENTIAL_REF)
- .marketplaceZone("America/Los_Angeles")
- .currency("USD")
- .build();
-
- accounts.put(account).putSecret(CREDENTIAL_REF, ChannelSecret.builder()
- .appKey("test-app-key")
- .appSecret("test-app-secret")
- .build());
-
- Clock clock = Clock.fixed(Instant.parse("2026-10-29T00:00:00Z"), ZoneOffset.UTC);
- adapter = new LingxingAdapter(LingxingConstants.DEFAULT_BASE_URL, transport, new JacksonJsonCodec(),
- accounts, tokenStore, locks, clock);
-
- ctx = ChannelContext.of(account, "req-1", clock);
-
- String tokenJson = Fixtures.load(LingxingAdapterTest.class, "lingxing", "token", "success");
- String orderJson = Fixtures.load(LingxingAdapterTest.class, "lingxing", "orderList", "success");
- transport.route(LingxingConstants.PATH_ACCESS_TOKEN, "POST", r -> Responses.ok(tokenJson));
- transport.route(LingxingConstants.PATH_ORDER_LIST, "POST", r -> Responses.ok(orderJson));
- }
-
- @Test
- void pullsOrdersAndMapsToUnifiedModel() {
- Page page = adapter.pull(ctx, SalesOrderQuery.builder()
- .updatedAfter(Instant.parse("2026-10-25T00:00:00Z"))
- .updatedBefore(Instant.parse("2026-10-26T00:00:00Z"))
- .pageSize(100)
- .build());
-
- assertEquals(3, page.size());
- assertEquals("PO-123456789", page.items().get(0).channelOrderId());
- assertEquals(ChannelProvider.LINGXING, page.items().get(0).sourceProvider());
- // total=3, offset 0 + 3 = 3 → 结束
- assertNull(page.nextCursor());
- }
-
- @Test
- void tokenFetchedOnceAndReused() {
- SalesOrderQuery q = SalesOrderQuery.builder()
- .updatedAfter(Instant.parse("2026-10-25T00:00:00Z"))
- .updatedBefore(Instant.parse("2026-10-26T00:00:00Z"))
- .build();
- adapter.pull(ctx, q);
- adapter.pull(ctx, q);
-
- assertEquals(1, tokenStore.saveCount(), "token should be refreshed only once");
- assertEquals(1, locks.acquireCount("token-refresh:lingxing:1108413237731"));
- assertNotNull(tokenStore.get("lingxing:1108413237731").orElse(null));
- }
-
- @Test
- void requestCarriesSignAndBearerToken() {
- adapter.pull(ctx, SalesOrderQuery.builder()
- .updatedAfter(Instant.parse("2026-10-25T00:00:00Z"))
- .updatedBefore(Instant.parse("2026-10-26T00:00:00Z"))
- .build());
-
- apelet.common.ecommerce.http.HttpRequest last = transport.lastRequest();
- assertTrue(last.url().contains("app_key=test-app-key"), last.url());
- assertTrue(last.url().contains("sign="), last.url());
- assertEquals("Bearer lx-access-token-abc", last.headers().get("Authorization"));
- assertEquals("req-1", last.headers().get("X-Request-Id"));
- assertTrue(last.body().contains("\"platform_code\":10008"), last.body());
- assertTrue(last.body().contains("\"store_id\":\"1108413237731\""), last.body());
- }
-
- @Test
- void queryWindowClampedTo31Days() {
- adapter.pull(ctx, SalesOrderQuery.builder()
- .updatedAfter(Instant.parse("2026-01-01T00:00:00Z"))
- .updatedBefore(Instant.parse("2026-10-26T00:00:00Z"))
- .build());
-
- String body = transport.lastRequest().body();
- long end = Instant.parse("2026-10-26T00:00:00Z").getEpochSecond();
- long expectedStart = Instant.parse("2026-10-26T00:00:00Z").minus(Duration.ofDays(31)).getEpochSecond();
- assertTrue(body.contains("\"update_time_end\":" + end), body);
- assertTrue(body.contains("\"update_time_start\":" + expectedStart), body);
- }
-
- @Test
- void syncEngineAdvancesWatermarkOnlyAfterWholeBatch() {
- InMemoryCursorStore cursors = new InMemoryCursorStore();
- InMemorySink sink = new InMemorySink();
- SyncSpec spec = SyncSpec.of(ChannelProvider.LINGXING, "oms-wm-001",
- SyncSpec.STREAM_SALES_ORDERS, Duration.ofMinutes(10));
- cursors.seed(ChannelProvider.LINGXING, "oms-wm-001", SyncSpec.STREAM_SALES_ORDERS,
- Instant.parse("2026-10-25T00:00:00Z"));
-
- Instant to = Instant.parse("2026-10-26T00:00:00Z");
- SyncResult result = new SyncEngine(cursors, sink).syncSalesOrders(spec, to,
- (from, cursor) -> adapter.pull(ctx, SalesOrderQuery.builder()
- .updatedAfter(from).updatedBefore(to).build()));
-
- assertEquals(1, result.pages());
- assertEquals(3, result.items());
- assertTrue(result.watermarkAdvanced());
- assertEquals(to, cursors.watermark(ChannelProvider.LINGXING, "oms-wm-001",
- SyncSpec.STREAM_SALES_ORDERS));
- assertEquals(3, sink.salesOrders().size());
- }
-
- @Test
- void capabilityIsAccountScoped() {
- ChannelAccount ebay = ChannelAccount.builder()
- .key(AccountKey.of(ChannelProvider.LINGXING, Platform.EBAY, "oms-ebay-001"))
- .externalStoreId("1108413237731")
- .platformCode(10003)
- .credentialRef(CREDENTIAL_REF)
- .marketplaceZone("America/New_York")
- .currency("USD")
- .build();
-
- assertTrue(adapter.supports(account, apelet.common.ecommerce.model.Capability.SALES_ORDER));
- assertTrue(adapter.supports(ebay, apelet.common.ecommerce.model.Capability.SALES_ORDER));
- // eBay 在领星侧未见账单与退货接口
- assertEquals(false, adapter.supports(ebay, apelet.common.ecommerce.model.Capability.BILLING));
- assertEquals(false, adapter.supports(ebay, apelet.common.ecommerce.model.Capability.REFUND));
- }
-
- @Test
- void subChannelsReflectAccount() {
- assertEquals(1, adapter.listSubChannels(account).size());
- assertEquals(10008, adapter.listSubChannels(account).get(0).platformCode());
- }
-}
diff --git a/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingOrderMapperTest.java b/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingOrderMapperTest.java
deleted file mode 100644
index 491d275..0000000
--- a/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingOrderMapperTest.java
+++ /dev/null
@@ -1,72 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.http.JacksonJsonCodec;
-import apelet.common.ecommerce.lingxing.dto.LingxingOrderDto;
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.testkit.Fixtures;
-import org.junit.jupiter.api.Test;
-
-import java.time.ZoneId;
-import java.util.List;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNull;
-
-class LingxingOrderMapperTest {
-
- private final JacksonJsonCodec json = new JacksonJsonCodec();
- private final LingxingOrderMapper mapper = new LingxingOrderMapper(json);
-
- private List fixture() {
- String body = Fixtures.load(LingxingOrderMapperTest.class, "lingxing", "orderList", "success");
- return json.listAt(body, "data.list", LingxingOrderDto.class);
- }
-
- @Test
- void mapsWalmartOrder() {
- SalesOrder o = mapper.toSalesOrder(fixture().get(0), "oms-wm-001", ZoneId.of("America/Los_Angeles"));
-
- assertEquals("oms-wm-001", o.omsStoreId());
- assertEquals("PO-123456789", o.channelOrderId());
- assertEquals("Shipped", o.status());
- assertEquals("US", o.shipToCountryCode());
- assertEquals(2, o.lines().size());
- assertEquals("SKU-RED-M", o.lines().get(0).platformSku());
- assertEquals(2, o.lines().get(0).quantity());
- assertEquals("59.97 USD", o.totalAmount().toString());
- assertEquals(ChannelProvider.LINGXING, o.sourceProvider());
- assertEquals("1108413237731", o.sourceAccountId());
- // epoch 秒 1793001600 → UTC 2026-10-26T08:00:00Z
- assertEquals(1793001600L, o.occurredAt().utc().getEpochSecond());
- }
-
- @Test
- void fallsBackToSkuWhenPlatformSkuMissing() {
- SalesOrder o = mapper.toSalesOrder(fixture().get(1), "oms-ebay-001", ZoneId.of("America/New_York"));
- assertEquals("MSKU-GREEN-S", o.lines().get(0).platformSku());
- assertNull(o.lines().get(0).tax());
- }
-
- @Test
- void platformOrderNamesSortedForStableCanonicalKey() {
- // 返回顺序是 EBAY-2222, EBAY-1111,取排序后第一个,保证多次同步 key 稳定
- SalesOrder o = mapper.toSalesOrder(fixture().get(1), "oms-ebay-001", ZoneId.of("America/New_York"));
- assertEquals("EBAY-1111", o.channelOrderId());
- }
-
- @Test
- void fallsBackToLingxingOrderIdWhenNoPlatformNo() {
- SalesOrder o = mapper.toSalesOrder(fixture().get(2), "oms-tts-001", ZoneId.of("Europe/London"));
- assertEquals("LX-1003", o.channelOrderId());
- }
-
- @Test
- void platformCodeMapsToUnifiedPlatform() {
- assertEquals(apelet.common.ecommerce.model.Platform.WALMART_SC, LingxingConstants.toPlatform(10008));
- assertEquals(apelet.common.ecommerce.model.Platform.EBAY, LingxingConstants.toPlatform(10003));
- assertEquals(apelet.common.ecommerce.model.Platform.SHEIN, LingxingConstants.toPlatform(10027));
- assertEquals(apelet.common.ecommerce.model.Platform.CUSTOM, LingxingConstants.toPlatform(99999));
- assertNull(LingxingConstants.toPlatform(null));
- }
-}
diff --git a/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingSignerTest.java b/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingSignerTest.java
deleted file mode 100644
index 3eb8076..0000000
--- a/lingxing/src/test/java/apelet/common/ecommerce/lingxing/LingxingSignerTest.java
+++ /dev/null
@@ -1,54 +0,0 @@
-package apelet.common.ecommerce.lingxing;
-
-import apelet.common.ecommerce.http.JsonCodec;
-import org.junit.jupiter.api.Test;
-
-import java.util.LinkedHashMap;
-import java.util.Map;
-
-import static org.junit.jupiter.api.Assertions.assertEquals;
-import static org.junit.jupiter.api.Assertions.assertNotEquals;
-
-class LingxingSignerTest {
-
- @Test
- void signatureIsOrderIndependent() {
- Map a = new LinkedHashMap();
- a.put("app_key", "k1");
- a.put("timestamp", "1793001600");
-
- Map b = new LinkedHashMap();
- b.put("timestamp", "1793001600");
- b.put("app_key", "k1");
-
- assertEquals(LingxingSigner.sign(a, "secret"), LingxingSigner.sign(b, "secret"));
- }
-
- @Test
- void signatureIs32LowercaseHex() {
- Map p = new LinkedHashMap();
- p.put("app_key", "k1");
- p.put("timestamp", "1793001600");
- String sign = LingxingSigner.sign(p, "secret");
- assertEquals(32, sign.length());
- assertEquals(sign.toLowerCase(), sign);
- assertEquals(true, sign.matches("[0-9a-f]{32}"));
- }
-
- @Test
- void differentSecretDifferentSignature() {
- Map p = new LinkedHashMap();
- p.put("app_key", "k1");
- assertNotEquals(LingxingSigner.sign(p, "a"), LingxingSigner.sign(p, "b"));
- }
-
- @Test
- void knownVector() {
- // 固定向量:appSecret + "app_key" + "k1" + "timestamp" + "1793001600" + appSecret
- Map p = new LinkedHashMap();
- p.put("app_key", "k1");
- p.put("timestamp", "1793001600");
- assertEquals(LingxingSigner.md5Hex("secretapp_keyk1timestamp1793001600secret"),
- LingxingSigner.sign(p, "secret"));
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/FakeTransport.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/FakeTransport.java
deleted file mode 100644
index 2509437..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/FakeTransport.java
+++ /dev/null
@@ -1,85 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.http.HttpRequest;
-import apelet.common.ecommerce.http.HttpResponse;
-import apelet.common.ecommerce.http.HttpTransport;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-import java.util.function.Function;
-
-/**
- * 可编程传输。适配器单测直接返回录制的响应,不需要网络或 mock server。
- *
- *
- * FakeTransport t = FakeTransport.create()
- * .route("lingxing", "order/v2/list", body -> HttpResponse.of(200, null, json, 5));
- *
- */
-public final class FakeTransport implements HttpTransport {
-
- private final List recorded = new ArrayList();
- private final List routes = new ArrayList();
- private Function fallback;
-
- public static FakeTransport create() {
- return new FakeTransport();
- }
-
- /** 按 URL 子串 + 方法匹配。 */
- public FakeTransport route(String urlContains, String method, Function responder) {
- routes.add(new Route(urlContains, method, responder));
- return this;
- }
-
- public FakeTransport route(String urlContains, Function responder) {
- return route(urlContains, null, responder);
- }
-
- public FakeTransport fallback(Function responder) {
- this.fallback = responder;
- return this;
- }
-
- @Override
- public HttpResponse execute(HttpRequest request) {
- recorded.add(request);
- for (Route r : routes) {
- if (request.url().contains(r.urlContains)
- && (r.method == null || r.method.equalsIgnoreCase(request.method()))) {
- return r.responder.apply(request);
- }
- }
- if (fallback != null) {
- return fallback.apply(request);
- }
- throw new IllegalStateException("no fake route for " + request.method() + " " + request.url());
- }
-
- public List recorded() {
- return Collections.unmodifiableList(recorded);
- }
-
- /** 最后一次请求;无请求时返回 null。 */
- public HttpRequest lastRequest() {
- return recorded.isEmpty() ? null : recorded.get(recorded.size() - 1);
- }
-
- public void clear() {
- recorded.clear();
- }
-
- private static final class Route {
-
- private final String urlContains;
- private final String method;
- private final Function responder;
-
- private Route(String urlContains, String method, Function responder) {
- this.urlContains = urlContains;
- this.method = method;
- this.responder = responder;
- }
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/Fixtures.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/Fixtures.java
deleted file mode 100644
index 994fc59..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/Fixtures.java
+++ /dev/null
@@ -1,36 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import java.io.IOException;
-import java.io.InputStream;
-import java.nio.charset.StandardCharsets;
-import java.util.Scanner;
-
-/**
- * 夹具加载器。
- *
- * 约定目录:{@code src/test/resources/fixtures/{platform}/{operation}/{case}.json}。
- * 适配器测试只依赖录制报文,不依赖网络。
- */
-public final class Fixtures {
-
- private Fixtures() {
- }
-
- public static String load(Class> anchor, String path) {
- String resource = path.startsWith("/") ? path : "/" + path;
- try (InputStream in = anchor.getResourceAsStream(resource)) {
- if (in == null) {
- throw new IllegalStateException("fixture not found: " + resource);
- }
- Scanner scanner = new Scanner(in, StandardCharsets.UTF_8.name()).useDelimiter("\\A");
- return scanner.hasNext() ? scanner.next() : "";
- } catch (IOException e) {
- throw new IllegalStateException("read fixture failed: " + resource, e);
- }
- }
-
- /** 按约定拼路径。 */
- public static String load(Class> anchor, String platform, String operation, String caseName) {
- return load(anchor, "fixtures/" + platform + "/" + operation + "/" + caseName + ".json");
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryAccounts.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryAccounts.java
deleted file mode 100644
index a18b85d..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryAccounts.java
+++ /dev/null
@@ -1,59 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.spi.ChannelAccountRepository;
-import apelet.common.ecommerce.spi.ChannelSecret;
-import apelet.common.ecommerce.model.ChannelAccount;
-import apelet.common.ecommerce.spi.SecretProvider;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.HashMap;
-import java.util.List;
-import java.util.Map;
-import java.util.Optional;
-
-/** 内存版账户仓库与凭证提供者。 */
-public final class InMemoryAccounts implements ChannelAccountRepository, SecretProvider {
-
- private final Map accounts = new HashMap();
- private final Map secrets = new HashMap();
-
- public InMemoryAccounts put(ChannelAccount account) {
- accounts.put(id(account.provider().name(), account.platform().name(), account.omsStoreId()), account);
- return this;
- }
-
- public InMemoryAccounts putSecret(String credentialRef, ChannelSecret secret) {
- secrets.put(credentialRef, secret);
- return this;
- }
-
- @Override
- public Optional findByKey(String provider, String platform, String omsStoreId) {
- return Optional.ofNullable(accounts.get(id(provider, platform, omsStoreId)));
- }
-
- @Override
- public List findByOmsStoreId(String omsStoreId) {
- List out = new ArrayList();
- for (ChannelAccount a : accounts.values()) {
- if (a.omsStoreId().equals(omsStoreId)) {
- out.add(a);
- }
- }
- return Collections.unmodifiableList(out);
- }
-
- @Override
- public ChannelSecret get(String credentialRef) {
- ChannelSecret s = secrets.get(credentialRef);
- if (s == null) {
- throw new IllegalStateException("no fake secret for " + credentialRef);
- }
- return s;
- }
-
- private static String id(String provider, String platform, String omsStoreId) {
- return provider + '|' + platform + '|' + omsStoreId;
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryCursorStore.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryCursorStore.java
deleted file mode 100644
index d9f2028..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryCursorStore.java
+++ /dev/null
@@ -1,37 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.model.ChannelProvider;
-import apelet.common.ecommerce.spi.SyncCursorStore;
-
-import java.time.Instant;
-import java.util.HashMap;
-import java.util.Map;
-
-/** 内存版水位线存储。 */
-public final class InMemoryCursorStore implements SyncCursorStore {
-
- private final Map cursors = new HashMap();
-
- @Override
- public Instant get(ChannelProvider provider, String accountKey, String stream) {
- return cursors.get(id(provider, accountKey, stream));
- }
-
- @Override
- public void advance(ChannelProvider provider, String accountKey, String stream, Instant watermark) {
- cursors.put(id(provider, accountKey, stream), watermark);
- }
-
- public void seed(ChannelProvider provider, String accountKey, String stream, Instant watermark) {
- advance(provider, accountKey, stream, watermark);
- }
-
- /** 断言用:读取当前水位线。 */
- public Instant watermark(ChannelProvider provider, String accountKey, String stream) {
- return get(provider, accountKey, stream);
- }
-
- private static String id(ChannelProvider provider, String accountKey, String stream) {
- return provider.name() + '|' + accountKey + '|' + stream;
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryLockProvider.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryLockProvider.java
deleted file mode 100644
index fa67ed0..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryLockProvider.java
+++ /dev/null
@@ -1,52 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.spi.LockProvider;
-
-import java.util.HashMap;
-import java.util.HashSet;
-import java.util.Map;
-import java.util.Optional;
-import java.util.Set;
-
-/** 单线程内存锁,足以验证防击穿分支。 */
-public final class InMemoryLockProvider implements LockProvider {
-
- private final Set held = new HashSet();
- private final Map acquireCounts = new HashMap();
-
- @Override
- public synchronized Optional tryLock(String key, long ttlSeconds) {
- if (held.contains(key)) {
- return Optional.empty();
- }
- held.add(key);
- Integer c = acquireCounts.get(key);
- acquireCounts.put(key, c == null ? 1 : c + 1);
- return Optional.of(new Handle(key));
- }
-
- public synchronized int acquireCount(String key) {
- Integer c = acquireCounts.get(key);
- return c == null ? 0 : c;
- }
-
- public synchronized boolean isHeld(String key) {
- return held.contains(key);
- }
-
- private final class Handle implements Lock {
-
- private final String key;
-
- private Handle(String key) {
- this.key = key;
- }
-
- @Override
- public void close() {
- synchronized (InMemoryLockProvider.this) {
- held.remove(key);
- }
- }
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemorySink.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemorySink.java
deleted file mode 100644
index 5431ddd..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemorySink.java
+++ /dev/null
@@ -1,47 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.ProductListing;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.spi.Sink;
-
-import java.util.ArrayList;
-import java.util.Collections;
-import java.util.List;
-
-/** 内存版落库 Sink,记录每次 upsert。 */
-public final class InMemorySink implements Sink {
-
- private final List salesOrders = new ArrayList();
- private final List products = new ArrayList();
- private int salesOrderUpsertCalls;
- private int productUpsertCalls;
-
- @Override
- public void upsertSalesOrders(Page page) {
- salesOrders.addAll(page.items());
- salesOrderUpsertCalls++;
- }
-
- @Override
- public void upsertProducts(Page page) {
- products.addAll(page.items());
- productUpsertCalls++;
- }
-
- public List salesOrders() {
- return Collections.unmodifiableList(salesOrders);
- }
-
- public List products() {
- return Collections.unmodifiableList(products);
- }
-
- public int salesOrderUpsertCalls() {
- return salesOrderUpsertCalls;
- }
-
- public int productUpsertCalls() {
- return productUpsertCalls;
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryTokenStore.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryTokenStore.java
deleted file mode 100644
index 3262c23..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/InMemoryTokenStore.java
+++ /dev/null
@@ -1,36 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.spi.AccessToken;
-import apelet.common.ecommerce.spi.TokenStore;
-
-import java.util.HashMap;
-import java.util.Map;
-import java.util.Optional;
-
-/** 内存版令牌存储。 */
-public final class InMemoryTokenStore implements TokenStore {
-
- private final Map tokens = new HashMap();
- private int saveCount;
-
- @Override
- public Optional get(String tokenKey) {
- return Optional.ofNullable(tokens.get(tokenKey));
- }
-
- @Override
- public void save(String tokenKey, AccessToken token) {
- tokens.put(tokenKey, token);
- saveCount++;
- }
-
- @Override
- public void remove(String tokenKey) {
- tokens.remove(tokenKey);
- }
-
- /** 刷新写入次数,用于断言「防击穿只刷新一次」。 */
- public int saveCount() {
- return saveCount;
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/Responses.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/Responses.java
deleted file mode 100644
index 242383c..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/Responses.java
+++ /dev/null
@@ -1,25 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.http.HttpResponse;
-
-import java.util.Collections;
-
-/** 快捷构造响应。 */
-public final class Responses {
-
- private Responses() {
- }
-
- public static HttpResponse ok(String body) {
- return HttpResponse.of(200, Collections.emptyMap(), body, 1);
- }
-
- public static HttpResponse status(int code, String body) {
- return HttpResponse.of(code, Collections.emptyMap(), body, 1);
- }
-
- public static HttpResponse rateLimited(String retryAfterSeconds) {
- return HttpResponse.of(429,
- Collections.singletonMap("Retry-After", retryAfterSeconds), "", 1);
- }
-}
diff --git a/testkit/src/main/java/apelet/common/ecommerce/testkit/TestData.java b/testkit/src/main/java/apelet/common/ecommerce/testkit/TestData.java
deleted file mode 100644
index 832271e..0000000
--- a/testkit/src/main/java/apelet/common/ecommerce/testkit/TestData.java
+++ /dev/null
@@ -1,32 +0,0 @@
-package apelet.common.ecommerce.testkit;
-
-import apelet.common.ecommerce.model.Page;
-import apelet.common.ecommerce.model.SalesOrder;
-import apelet.common.ecommerce.spi.SyncCursorStore;
-
-import java.time.Duration;
-import java.time.Instant;
-
-/** 测试夹具:常用账户与同步维度。 */
-public final class TestData {
-
- private TestData() {
- }
-
- public static Instant utc(String iso) {
- return Instant.parse(iso);
- }
-
- public static Duration overlapMinutes(int minutes) {
- return Duration.ofMinutes(minutes);
- }
-
- /** 已推进过的水位线,避免测试里每次走全量。 */
- public static void seedWatermark(SyncCursorStore store, apelet.common.ecommerce.sync.SyncSpec spec, String iso) {
- store.advance(spec.provider(), spec.accountKey(), spec.stream(), Instant.parse(iso));
- }
-
- public static Page pageOf(SalesOrder... orders) {
- return Page.last(java.util.Arrays.asList(orders));
- }
-}