ecommerce
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java b/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java
index cb952ad..8a48ed7 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java
@@ -1,15 +1,15 @@
package common.ecommerce.lingxing.adapter;
-import common.ecommerce.capability.AfterSaleCapable;
-import common.ecommerce.capability.AggregatorCapable;
-import common.ecommerce.capability.OrderEditCapable;
-import common.ecommerce.capability.OutboundCapable;
-import common.ecommerce.capability.OutboundOrderCapable;
-import common.ecommerce.capability.ProductCapable;
-import common.ecommerce.capability.SalesOrderCapable;
-import common.ecommerce.capability.SettlementCapable;
-import common.ecommerce.capability.ShipmentReviewCapable;
-import common.ecommerce.capability.ShippingLabelCapable;
+import common.ecommerce.channel.capability.AfterSaleCapable;
+import common.ecommerce.channel.capability.AggregatorCapable;
+import common.ecommerce.channel.capability.OrderEditCapable;
+import common.ecommerce.channel.capability.OutboundCapable;
+import common.ecommerce.channel.capability.OutboundOrderCapable;
+import common.ecommerce.channel.capability.ProductCapable;
+import common.ecommerce.channel.capability.SalesOrderCapable;
+import common.ecommerce.channel.capability.SettlementCapable;
+import common.ecommerce.channel.capability.ShipmentReviewCapable;
+import common.ecommerce.channel.capability.ShippingLabelCapable;
import common.ecommerce.shared.error.AuthException;
import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.http.HttpTransport;
@@ -36,29 +36,29 @@ import common.ecommerce.lingxing.platform.wms.WmsOutboundOrderSource;
import common.ecommerce.shared.model.Capability;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.model.order.SalesOrderRef;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleQuery;
-import common.ecommerce.model.fulfillment.LabelQuery;
-import common.ecommerce.model.fulfillment.OrderEditRequest;
-import common.ecommerce.model.fulfillment.OrderEditResult;
-import common.ecommerce.model.fulfillment.OutboundOrder;
-import common.ecommerce.model.fulfillment.OutboundOrderQuery;
-import common.ecommerce.model.fulfillment.OutboundPackage;
-import common.ecommerce.model.fulfillment.OutboundResult;
-import common.ecommerce.model.fulfillment.ShipmentReviewResult;
-import common.ecommerce.model.fulfillment.ShippingLabel;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductRef;
-import common.ecommerce.model.product.ProductSyncStrategy;
-import common.ecommerce.model.settlement.SettlementQuery;
-import common.ecommerce.model.settlement.SettlementTransaction;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.order.SalesOrderRef;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleQuery;
+import common.ecommerce.channel.model.fulfillment.LabelQuery;
+import common.ecommerce.channel.model.fulfillment.OrderEditRequest;
+import common.ecommerce.channel.model.fulfillment.OrderEditResult;
+import common.ecommerce.channel.model.fulfillment.OutboundOrder;
+import common.ecommerce.channel.model.fulfillment.OutboundOrderQuery;
+import common.ecommerce.channel.model.fulfillment.OutboundPackage;
+import common.ecommerce.channel.model.fulfillment.OutboundResult;
+import common.ecommerce.channel.model.fulfillment.ShipmentReviewResult;
+import common.ecommerce.channel.model.fulfillment.ShippingLabel;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductRef;
+import common.ecommerce.channel.model.product.ProductSyncStrategy;
+import common.ecommerce.channel.model.settlement.SettlementQuery;
+import common.ecommerce.channel.model.settlement.SettlementTransaction;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
import common.ecommerce.shared.spi.LockProvider;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapterFactory.java b/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapterFactory.java
index 0e26e01..0e52243 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapterFactory.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapterFactory.java
@@ -1,10 +1,10 @@
package common.ecommerce.lingxing.adapter;
import common.ecommerce.lingxing.LingxingConstants;
-import common.ecommerce.capability.PlatformAdapter;
+import common.ecommerce.channel.capability.PlatformAdapter;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.sdk.AdapterFactory;
+import common.ecommerce.channel.sdk.AdapterFactory;
import common.ecommerce.shared.spi.LockProvider;
import common.ecommerce.shared.spi.TokenStore;
import com.fasterxml.jackson.databind.ObjectMapper;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/http/LingxingRequestFactory.java b/lingxing/src/main/java/common/ecommerce/lingxing/http/LingxingRequestFactory.java
index 17b4cd5..e0eb579 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/http/LingxingRequestFactory.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/http/LingxingRequestFactory.java
@@ -2,7 +2,7 @@ package common.ecommerce.lingxing.http;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.JacksonJsonCodec;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java b/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java
index b9ff416..cd5686c 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/mapper/LingxingOrderMapper.java
@@ -6,8 +6,8 @@ import common.ecommerce.lingxing.dto.LingxingTransactionInfoDto;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.order.OrderLine;
-import common.ecommerce.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.OrderLine;
+import common.ecommerce.channel.model.order.SalesOrder;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingAfterSaleSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingAfterSaleSource.java
index 9184d01..ddc1a45 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingAfterSaleSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingAfterSaleSource.java
@@ -1,7 +1,7 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleQuery;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleQuery;
import common.ecommerce.shared.support.Page;
/**
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingCall.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingCall.java
index 1258a3f..1504bdc 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingCall.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingCall.java
@@ -7,7 +7,7 @@ import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.lingxing.http.LingxingEnvelope;
import common.ecommerce.lingxing.http.LingxingRateLimiter;
import common.ecommerce.lingxing.http.LingxingRequestFactory;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingLabelSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingLabelSource.java
index 4022a18..b638965 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingLabelSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingLabelSource.java
@@ -1,7 +1,7 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.fulfillment.LabelQuery;
-import common.ecommerce.model.fulfillment.ShippingLabel;
+import common.ecommerce.channel.model.fulfillment.LabelQuery;
+import common.ecommerce.channel.model.fulfillment.ShippingLabel;
import java.util.List;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderEditSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderEditSource.java
index 67343b8..a36a6b8 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderEditSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderEditSource.java
@@ -1,7 +1,7 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.fulfillment.OrderEditRequest;
-import common.ecommerce.model.fulfillment.OrderEditResult;
+import common.ecommerce.channel.model.fulfillment.OrderEditRequest;
+import common.ecommerce.channel.model.fulfillment.OrderEditResult;
import java.util.List;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderSource.java
index 5f53d67..75dd424 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOrderSource.java
@@ -1,7 +1,7 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
import common.ecommerce.shared.support.Page;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.multiplatform.order.LingxingOrderFilters;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundOrderSource.java
index eba4b24..89e8b2d 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundOrderSource.java
@@ -1,7 +1,7 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.fulfillment.OutboundOrder;
-import common.ecommerce.model.fulfillment.OutboundOrderQuery;
+import common.ecommerce.channel.model.fulfillment.OutboundOrder;
+import common.ecommerce.channel.model.fulfillment.OutboundOrderQuery;
import common.ecommerce.shared.support.Page;
/**
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundSource.java
index 4b4e98a..56a0d9e 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingOutboundSource.java
@@ -1,7 +1,7 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.fulfillment.OutboundPackage;
-import common.ecommerce.model.fulfillment.OutboundResult;
+import common.ecommerce.channel.model.fulfillment.OutboundPackage;
+import common.ecommerce.channel.model.fulfillment.OutboundResult;
import java.util.List;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingProductSource.java
index 09f0736..10ee08f 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingProductSource.java
@@ -1,8 +1,8 @@
package common.ecommerce.lingxing.platform;
import common.ecommerce.lingxing.platform.LingxingCall;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.shared.support.Page;
/**
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSettlementSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSettlementSource.java
index 3d5e3f7..1dae047 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSettlementSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingSettlementSource.java
@@ -1,8 +1,8 @@
package common.ecommerce.lingxing.platform;
import common.ecommerce.lingxing.platform.LingxingCall;
-import common.ecommerce.model.settlement.SettlementQuery;
-import common.ecommerce.model.settlement.SettlementTransaction;
+import common.ecommerce.channel.model.settlement.SettlementQuery;
+import common.ecommerce.channel.model.settlement.SettlementTransaction;
import common.ecommerce.shared.support.Page;
/**
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShipmentReviewSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShipmentReviewSource.java
index d300c8e..b185f7e 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShipmentReviewSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShipmentReviewSource.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.model.fulfillment.ShipmentReviewResult;
+import common.ecommerce.channel.model.fulfillment.ShipmentReviewResult;
import java.util.List;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShopSource.java
index 22ec3a1..fa44e4b 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShopSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/LingxingShopSource.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform;
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
+import common.ecommerce.channel.capability.AggregatorCapable.SubChannel;
import common.ecommerce.lingxing.platform.LingxingCall;
import java.util.List;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSource.java
index e3456a8..0a310a4 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSource.java
@@ -7,9 +7,9 @@ import common.ecommerce.lingxing.http.LingxingEnvelope;
import common.ecommerce.lingxing.platform.LingxingAfterSaleSource;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.aftersale.dto.AfterSaleDto;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleQuery;
-import common.ecommerce.model.aftersale.AfterSaleType;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleQuery;
+import common.ecommerce.channel.model.aftersale.AfterSaleType;
import common.ecommerce.shared.support.Page;
import java.time.ZoneId;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapper.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapper.java
index 9659dd9..ed6933a 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapper.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapper.java
@@ -4,8 +4,8 @@ import common.ecommerce.lingxing.platform.aftersale.dto.AfterSaleDto;
import common.ecommerce.lingxing.platform.aftersale.dto.AfterSaleItemDto;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleType;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleType;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSource.java
index 1abadcc..5031848 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.aliexpress.dto.AliexpressListingDto;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java
index 7548aa6..109ca9e 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonFbmOrderSource.java
@@ -16,10 +16,10 @@ import common.ecommerce.lingxing.platform.amazon.dto.FbmOrderDto;
import common.ecommerce.lingxing.platform.amazon.dto.FbmOrderItemDto;
import common.ecommerce.lingxing.platform.LingxingOrderSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.OrderLine;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.OrderLine;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonOrderSource.java
index ff28384..fc77579 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/order/AmazonOrderSource.java
@@ -15,10 +15,10 @@ import common.ecommerce.lingxing.platform.amazon.sc.dto.AmazonOrderDto;
import common.ecommerce.lingxing.platform.amazon.sc.dto.AmazonOrderItemDto;
import common.ecommerce.lingxing.platform.LingxingOrderSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.OrderLine;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.OrderLine;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSource.java
index 5bfe0ea..bbf4e37 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.amazon.sc.dto.AmazonScListingDto;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/shop/AmazonScShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/shop/AmazonScShopSource.java
index 2236090..53fb8a5 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/shop/AmazonScShopSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/sc/shop/AmazonScShopSource.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform.amazon.sc.shop;
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
+import common.ecommerce.channel.capability.AggregatorCapable.SubChannel;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.HttpResponse;
import common.ecommerce.lingxing.LingxingApi;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/settlement/AmazonSettlementSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/settlement/AmazonSettlementSource.java
index af00fe2..6c2728b 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/settlement/AmazonSettlementSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/settlement/AmazonSettlementSource.java
@@ -12,9 +12,9 @@ import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.amazon.sc.dto.AmazonSettlementTransactionDto;
import common.ecommerce.lingxing.platform.LingxingSettlementSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.settlement.SettlementQuery;
-import common.ecommerce.model.settlement.SettlementTransaction;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.settlement.SettlementQuery;
+import common.ecommerce.channel.model.settlement.SettlementTransaction;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/order/VcOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/order/VcOrderSource.java
index fd35fee..d5eae54 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/order/VcOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/order/VcOrderSource.java
@@ -18,10 +18,10 @@ import common.ecommerce.lingxing.platform.amazon.vc.dto.VcOrderItemDto;
import common.ecommerce.lingxing.platform.amazon.vc.dto.VcOrderPoDetailDto;
import common.ecommerce.lingxing.platform.LingxingOrderSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.OrderLine;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.OrderLine;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
index a833d3d..40043bf 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSource.java
@@ -8,9 +8,9 @@ import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.amazon.vc.dto.AmazonVcListingDto;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/shop/VcShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/shop/VcShopSource.java
index 180f781..c16a1c7 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/shop/VcShopSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/amazon/vc/shop/VcShopSource.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform.amazon.vc.shop;
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
+import common.ecommerce.channel.capability.AggregatorCapable.SubChannel;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.HttpResponse;
import common.ecommerce.lingxing.LingxingApi;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java
index 7db7803..5f8d249 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.ebay.dto.EbayListingDto;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/LingxingOrderFilters.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/LingxingOrderFilters.java
index 076530e..f1936a3 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/LingxingOrderFilters.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/LingxingOrderFilters.java
@@ -7,7 +7,7 @@ import java.util.List;
/**
* 领星多平台订单列表({@code /pb/mp/order/v2/list})的专有过滤条件。
*
- * 通用的时间窗、分页、游标仍由 {@link common.ecommerce.model.order.SalesOrderQuery}
+ *
通用的时间窗、分页、游标仍由 {@link common.ecommerce.channel.model.order.SalesOrderQuery}
* 提供;这里只放领星协议独有的参数,避免把领星字段污染到 core 的跨渠道模型。
*
* 所有条件都是可选的,全部为空时按「账户 + 更新时间窗」做常规同步。
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java
index bfff93e..bae597b 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/order/MultiPlatformOrderSource.java
@@ -13,9 +13,9 @@ import common.ecommerce.lingxing.http.LingxingEnvelope;
import common.ecommerce.lingxing.mapper.LingxingOrderMapper;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.LingxingOrderSource;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
import common.ecommerce.shared.support.Page;
import java.time.Duration;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java
index daca648..9c4b439 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/outbound/MultiPlatformOutboundSource.java
@@ -6,8 +6,8 @@ import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.lingxing.http.LingxingEnvelope;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.LingxingOutboundSource;
-import common.ecommerce.model.fulfillment.OutboundPackage;
-import common.ecommerce.model.fulfillment.OutboundResult;
+import common.ecommerce.channel.model.fulfillment.OutboundPackage;
+import common.ecommerce.channel.model.fulfillment.OutboundResult;
import java.util.ArrayList;
import java.util.LinkedHashMap;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchBody.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchBody.java
index cc349a7..7746ad6 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchBody.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchBody.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform.multiplatform.product;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import java.util.List;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchMapper.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchMapper.java
index 830dda9..dae865d 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchMapper.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/product/LingxingProductSearchMapper.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform.multiplatform.product;
-import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductSearchField;
/**
* 领星侧各平台的「搜索维度 → 平台枚举值」映射。
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java
index 18242f2..bc0e70f 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/multiplatform/shop/MultiPlatformShopSource.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.platform.multiplatform.shop;
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
+import common.ecommerce.channel.capability.AggregatorCapable.SubChannel;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.HttpResponse;
import common.ecommerce.lingxing.LingxingApi;
@@ -10,7 +10,7 @@ import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.multiplatform.dto.MultiPlatformShopDto;
import common.ecommerce.lingxing.platform.LingxingShopSource;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.channel.model.account.ChannelAccount;
import java.util.ArrayList;
import java.util.Collections;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSource.java
index fd87ed9..64ffcfa 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.lingxing.platform.shein.dto.SheinListingDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
index efe605a..8dbb434 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/target/product/TargetProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.lingxing.platform.target.dto.TargetListingDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
@@ -55,7 +55,7 @@ public final class TargetProductSource implements LingxingProductSource {
/**
* 时间字段取值:1 创建时间、2 更新时间。用 2 才符合
- * {@link common.ecommerce.model.product.ProductQuery#updatedAfter()} 的语义。
+ * {@link common.ecommerce.channel.model.product.ProductQuery#updatedAfter()} 的语义。
*/
private static final int TIME_FIELD_UPDATE = 2;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSource.java
index 0880ed6..1d610d1 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.lingxing.platform.temu.dto.TemuListingDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Page;
import java.time.Instant;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSource.java
index 041b340..11c75ec 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSource.java
@@ -9,13 +9,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.lingxing.platform.tiktok.dto.TiktokListingDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java
index 0944d94..ef8f57c 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSource.java
@@ -10,14 +10,14 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchBody;
import common.ecommerce.lingxing.platform.multiplatform.product.LingxingProductSearchMapper;
-import common.ecommerce.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductQuery;
import common.ecommerce.lingxing.platform.LingxingProductSource;
import common.ecommerce.lingxing.platform.walmart.dto.WalmartListingDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/OrderEditSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/OrderEditSource.java
index 13fd069..4cafa0b 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/OrderEditSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/OrderEditSource.java
@@ -11,9 +11,9 @@ import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.LingxingOrderEditSource;
import common.ecommerce.lingxing.platform.wms.dto.OrderEditErrorDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.fulfillment.DeclaredItem;
-import common.ecommerce.model.fulfillment.OrderEditRequest;
-import common.ecommerce.model.fulfillment.OrderEditResult;
+import common.ecommerce.channel.model.fulfillment.DeclaredItem;
+import common.ecommerce.channel.model.fulfillment.OrderEditRequest;
+import common.ecommerce.channel.model.fulfillment.OrderEditResult;
import java.math.BigDecimal;
import java.util.ArrayList;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/ShipmentReviewSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/ShipmentReviewSource.java
index 77f9c73..b09798e 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/ShipmentReviewSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/ShipmentReviewSource.java
@@ -14,7 +14,7 @@ import common.ecommerce.lingxing.platform.wms.dto.ShipmentReviewDataDto;
import common.ecommerce.lingxing.platform.wms.dto.ShipmentReviewFailureDto;
import common.ecommerce.lingxing.platform.wms.dto.ShipmentReviewSuccessDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.fulfillment.ShipmentReviewResult;
+import common.ecommerce.channel.model.fulfillment.ShipmentReviewResult;
import java.util.ArrayList;
import java.util.LinkedHashMap;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsLabelSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsLabelSource.java
index b8f5b20..0d8223e 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsLabelSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsLabelSource.java
@@ -11,8 +11,8 @@ import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.lingxing.platform.LingxingLabelSource;
import common.ecommerce.lingxing.platform.wms.dto.WmsLogisticsLabelDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.fulfillment.LabelQuery;
-import common.ecommerce.model.fulfillment.ShippingLabel;
+import common.ecommerce.channel.model.fulfillment.LabelQuery;
+import common.ecommerce.channel.model.fulfillment.ShippingLabel;
import java.util.ArrayList;
import java.util.LinkedHashMap;
diff --git a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsOutboundOrderSource.java b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsOutboundOrderSource.java
index bedad43..3129bfc 100644
--- a/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsOutboundOrderSource.java
+++ b/lingxing/src/main/java/common/ecommerce/lingxing/platform/wms/WmsOutboundOrderSource.java
@@ -14,10 +14,10 @@ import common.ecommerce.lingxing.platform.wms.dto.WmsOutboundOrderDto;
import common.ecommerce.lingxing.platform.wms.dto.WmsOutboundOrderItemDto;
import common.ecommerce.lingxing.platform.wms.dto.WmsSurfaceFileDto;
import common.ecommerce.shared.model.ChannelProvider;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.fulfillment.OutboundOrder;
-import common.ecommerce.model.fulfillment.OutboundOrderLine;
-import common.ecommerce.model.fulfillment.OutboundOrderQuery;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.fulfillment.OutboundOrder;
+import common.ecommerce.channel.model.fulfillment.OutboundOrderLine;
+import common.ecommerce.channel.model.fulfillment.OutboundOrderQuery;
import common.ecommerce.shared.support.Money;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.support.PlatformTime;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java
index be408cf..3f2e434 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingCallObserverTest.java
@@ -9,18 +9,18 @@ import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.lingxing.support.LingxingTestSupport;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelSdk;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelSdk;
import common.ecommerce.shared.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryAccounts;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.shared.testkit.InMemoryAccounts;
+import common.ecommerce.shared.testkit.InMemoryLockProvider;
+import common.ecommerce.shared.testkit.InMemoryTokenStore;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.time.Instant;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java
index c0b09c6..c7b6c7d 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.adapter;
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
+import common.ecommerce.channel.capability.AggregatorCapable.SubChannel;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.HttpResponse;
import common.ecommerce.http.HttpTransport;
@@ -10,28 +10,28 @@ import common.ecommerce.lingxing.LingxingConstants;
import common.ecommerce.lingxing.auth.LingxingTokenClient;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.fulfillment.LabelQuery;
-import common.ecommerce.model.fulfillment.OutboundOrder;
-import common.ecommerce.model.fulfillment.OutboundOrderLine;
-import common.ecommerce.model.fulfillment.OutboundOrderQuery;
-import common.ecommerce.model.fulfillment.ShippingLabel;
-import common.ecommerce.model.order.OrderLine;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.model.order.SalesOrderRef;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.settlement.SettlementQuery;
-import common.ecommerce.model.settlement.SettlementTransaction;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.fulfillment.LabelQuery;
+import common.ecommerce.channel.model.fulfillment.OutboundOrder;
+import common.ecommerce.channel.model.fulfillment.OutboundOrderLine;
+import common.ecommerce.channel.model.fulfillment.OutboundOrderQuery;
+import common.ecommerce.channel.model.fulfillment.ShippingLabel;
+import common.ecommerce.channel.model.order.OrderLine;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.order.SalesOrderRef;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.settlement.SettlementQuery;
+import common.ecommerce.channel.model.settlement.SettlementTransaction;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
+import common.ecommerce.shared.testkit.InMemoryLockProvider;
+import common.ecommerce.shared.testkit.InMemoryTokenStore;
import org.junit.jupiter.api.Test;
import java.time.Clock;
@@ -194,7 +194,7 @@ class LingxingLiveSmokeTest {
SalesOrder detail = adapter.get(ctx, SalesOrderRef.of(first.channelOrderId()));
System.out.println("[amazon detail] " + detail.channelOrderId()
+ " total=" + detail.totalAmount() + " lines=" + detail.lines().size());
- for (common.ecommerce.model.order.OrderLine line : detail.lines()) {
+ for (common.ecommerce.channel.model.order.OrderLine line : detail.lines()) {
System.out.println(" sku=" + line.platformSku()
+ " qty=" + line.quantity()
+ " unit=" + line.unitPrice()
@@ -248,7 +248,7 @@ class LingxingLiveSmokeTest {
+ " status=" + detail.status()
+ " total=" + detail.totalAmount()
+ " lines=" + detail.lines().size());
- for (common.ecommerce.model.order.OrderLine line : detail.lines()) {
+ for (common.ecommerce.channel.model.order.OrderLine line : detail.lines()) {
System.out.println(" sku=" + line.platformSku()
+ " qty=" + line.quantity()
+ " unit=" + line.unitPrice());
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingSdkListingCallTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingSdkListingCallTest.java
index 2767d11..6d63df2 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingSdkListingCallTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingSdkListingCallTest.java
@@ -7,19 +7,19 @@ import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.lingxing.support.LingxingTestSupport;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelSdk;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelSdk;
import common.ecommerce.shared.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryAccounts;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.shared.testkit.InMemoryAccounts;
+import common.ecommerce.shared.testkit.InMemoryLockProvider;
+import common.ecommerce.shared.testkit.InMemoryTokenStore;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.util.ArrayList;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/http/LingxingRequestFactoryTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/http/LingxingRequestFactoryTest.java
index 9080577..51cd126 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/http/LingxingRequestFactoryTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/http/LingxingRequestFactoryTest.java
@@ -4,10 +4,10 @@ import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
import org.junit.jupiter.api.Test;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
index ee24753..5a63950 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleListSourceTest.java
@@ -4,13 +4,13 @@ import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleQuery;
-import common.ecommerce.model.aftersale.AfterSaleType;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleQuery;
+import common.ecommerce.channel.model.aftersale.AfterSaleType;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.time.LocalDate;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapperTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapperTest.java
index 008ee8f..f0016fc 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapperTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aftersale/LingxingAfterSaleMapperTest.java
@@ -4,8 +4,8 @@ import common.ecommerce.http.JacksonJsonCodec;
import common.ecommerce.lingxing.platform.aftersale.dto.AfterSaleDto;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleType;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleType;
import org.junit.jupiter.api.Test;
import java.time.ZoneId;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
index 2728d7c..7e82885 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/aliexpress/product/AliexpressProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.aliexpress.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.time.Instant;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
index 01231cc..6c78c7e 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/sc/product/AmazonScProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.amazon.sc.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
index 8791c65..c5eda2d 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/amazon/vc/product/AmazonVcProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.amazon.vc.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
index 428f388..b3bbe77 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/ebay/product/EbayProductSourceTest.java
@@ -3,13 +3,13 @@ package common.ecommerce.lingxing.platform.ebay.product;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.time.Instant;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
index 960593e..53ecad7 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/shein/product/SheinProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.shein.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/target/product/TargetProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/target/product/TargetProductSourceTest.java
index 7654dd8..7477fbf 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/target/product/TargetProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/target/product/TargetProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.target.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
index 50bdbf2..67b7e50 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/temu/product/TemuProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.temu.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.util.Arrays;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
index 2cc6d22..021b1f4 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/tiktok/product/TiktokProductSourceTest.java
@@ -2,13 +2,13 @@ package common.ecommerce.lingxing.platform.tiktok.product;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import static common.ecommerce.lingxing.support.LingxingTestSupport.account;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
index ce291f9..8b8c418 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/platform/walmart/product/WalmartProductSourceTest.java
@@ -3,14 +3,14 @@ package common.ecommerce.lingxing.platform.walmart.product;
import common.ecommerce.shared.error.ValidationException;
import common.ecommerce.lingxing.LingxingApi;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.testkit.JsonFixture;
-import common.ecommerce.testkit.RecordingTransport;
-import common.ecommerce.testkit.Responses;
+import common.ecommerce.shared.testkit.JsonFixture;
+import common.ecommerce.shared.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.Responses;
import org.junit.jupiter.api.Test;
import java.time.Instant;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingParamProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingParamProbeTest.java
index 0438ad1..91655a3 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingParamProbeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingParamProbeTest.java
@@ -14,10 +14,10 @@ import common.ecommerce.lingxing.http.LingxingRequestFactory;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
import com.fasterxml.jackson.core.JsonProcessingException;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingSmokeProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingSmokeProbeTest.java
index a204a1f..0ad05b8 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingSmokeProbeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ListingSmokeProbeTest.java
@@ -1,6 +1,6 @@
package common.ecommerce.lingxing.probe;
-import common.ecommerce.capability.AggregatorCapable.SubChannel;
+import common.ecommerce.channel.capability.AggregatorCapable.SubChannel;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.HttpResponse;
import common.ecommerce.http.HttpTransport;
@@ -10,19 +10,19 @@ import common.ecommerce.lingxing.LingxingConstants;
import common.ecommerce.lingxing.adapter.LingxingAdapter;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductSearchField;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductSearchField;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
-import common.ecommerce.sdk.ChannelSdk;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
+import common.ecommerce.channel.sdk.ChannelSdk;
import common.ecommerce.shared.spi.ChannelSecret;
-import common.ecommerce.testkit.InMemoryAccounts;
-import common.ecommerce.testkit.InMemoryLockProvider;
-import common.ecommerce.testkit.InMemoryTokenStore;
+import common.ecommerce.shared.testkit.InMemoryAccounts;
+import common.ecommerce.shared.testkit.InMemoryLockProvider;
+import common.ecommerce.shared.testkit.InMemoryTokenStore;
import org.junit.jupiter.api.Assumptions;
import org.junit.jupiter.api.Test;
import org.junit.jupiter.api.condition.EnabledIfSystemProperty;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
index a2a6aff..441cf38 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/SearchFieldProbeTest.java
@@ -11,10 +11,10 @@ import common.ecommerce.lingxing.http.LingxingRequestFactory;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
import org.junit.jupiter.api.Assumptions;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
index 9520383..1e72399 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/probe/ShopListProbeTest.java
@@ -13,10 +13,10 @@ import common.ecommerce.lingxing.http.LingxingRequestFactory;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
import org.junit.jupiter.api.Assumptions;
diff --git a/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java b/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
index 30a9443..d002e64 100644
--- a/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
+++ b/lingxing/src/test/java/common/ecommerce/lingxing/support/LingxingTestSupport.java
@@ -8,13 +8,13 @@ import common.ecommerce.lingxing.http.LingxingRequestFactory;
import common.ecommerce.lingxing.platform.LingxingCall;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.ChannelSecret;
-import common.ecommerce.testkit.RecordingTransport;
+import common.ecommerce.shared.testkit.RecordingTransport;
import java.time.Clock;
import java.time.Instant;
diff --git a/pom.xml b/pom.xml
index d3005c0..7386c9d 100644
--- a/pom.xml
+++ b/pom.xml
@@ -26,8 +26,8 @@
- common
- core
+ shared
+ channel
http
testkit
lingxing
@@ -37,12 +37,12 @@
ecommerce
- common-ecommerce-common
+ common-ecommerce-shared
${project.version}
ecommerce
- common-ecommerce-core
+ common-ecommerce-channel
${project.version}
diff --git a/common/pom.xml b/shared/pom.xml
similarity index 95%
rename from common/pom.xml
rename to shared/pom.xml
index 7f70c4a..d2d6bc8 100644
--- a/common/pom.xml
+++ b/shared/pom.xml
@@ -10,7 +10,7 @@
1.0.0-SNAPSHOT
- common-ecommerce-common
+ common-ecommerce-shared
跨域共享层:异常体系、SPI 契约、幂等、审计、水位线、通用值对象。
不依赖任何领域模块,供渠道域(core)与仓库域复用。
diff --git a/common/src/main/java/common/ecommerce/shared/audit/CallObserver.java b/shared/src/main/java/common/ecommerce/shared/audit/CallObserver.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/audit/CallObserver.java
rename to shared/src/main/java/common/ecommerce/shared/audit/CallObserver.java
diff --git a/common/src/main/java/common/ecommerce/shared/audit/CallOutcome.java b/shared/src/main/java/common/ecommerce/shared/audit/CallOutcome.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/audit/CallOutcome.java
rename to shared/src/main/java/common/ecommerce/shared/audit/CallOutcome.java
diff --git a/common/src/main/java/common/ecommerce/shared/audit/CallRecord.java b/shared/src/main/java/common/ecommerce/shared/audit/CallRecord.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/audit/CallRecord.java
rename to shared/src/main/java/common/ecommerce/shared/audit/CallRecord.java
diff --git a/common/src/main/java/common/ecommerce/shared/audit/Slf4jCallObserver.java b/shared/src/main/java/common/ecommerce/shared/audit/Slf4jCallObserver.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/audit/Slf4jCallObserver.java
rename to shared/src/main/java/common/ecommerce/shared/audit/Slf4jCallObserver.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/AuthException.java b/shared/src/main/java/common/ecommerce/shared/error/AuthException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/AuthException.java
rename to shared/src/main/java/common/ecommerce/shared/error/AuthException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/ChannelException.java b/shared/src/main/java/common/ecommerce/shared/error/ChannelException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/ChannelException.java
rename to shared/src/main/java/common/ecommerce/shared/error/ChannelException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/CrossProviderConflictException.java b/shared/src/main/java/common/ecommerce/shared/error/CrossProviderConflictException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/CrossProviderConflictException.java
rename to shared/src/main/java/common/ecommerce/shared/error/CrossProviderConflictException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/IdempotencyConflictException.java b/shared/src/main/java/common/ecommerce/shared/error/IdempotencyConflictException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/IdempotencyConflictException.java
rename to shared/src/main/java/common/ecommerce/shared/error/IdempotencyConflictException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/PlatformBusinessException.java b/shared/src/main/java/common/ecommerce/shared/error/PlatformBusinessException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/PlatformBusinessException.java
rename to shared/src/main/java/common/ecommerce/shared/error/PlatformBusinessException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/RateLimitException.java b/shared/src/main/java/common/ecommerce/shared/error/RateLimitException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/RateLimitException.java
rename to shared/src/main/java/common/ecommerce/shared/error/RateLimitException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/TransientException.java b/shared/src/main/java/common/ecommerce/shared/error/TransientException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/TransientException.java
rename to shared/src/main/java/common/ecommerce/shared/error/TransientException.java
diff --git a/common/src/main/java/common/ecommerce/shared/error/ValidationException.java b/shared/src/main/java/common/ecommerce/shared/error/ValidationException.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/error/ValidationException.java
rename to shared/src/main/java/common/ecommerce/shared/error/ValidationException.java
diff --git a/common/src/main/java/common/ecommerce/shared/idempotency/IdempotencyGuard.java b/shared/src/main/java/common/ecommerce/shared/idempotency/IdempotencyGuard.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/idempotency/IdempotencyGuard.java
rename to shared/src/main/java/common/ecommerce/shared/idempotency/IdempotencyGuard.java
diff --git a/common/src/main/java/common/ecommerce/shared/idempotency/WriteAudit.java b/shared/src/main/java/common/ecommerce/shared/idempotency/WriteAudit.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/idempotency/WriteAudit.java
rename to shared/src/main/java/common/ecommerce/shared/idempotency/WriteAudit.java
diff --git a/common/src/main/java/common/ecommerce/shared/idempotency/WriteResult.java b/shared/src/main/java/common/ecommerce/shared/idempotency/WriteResult.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/idempotency/WriteResult.java
rename to shared/src/main/java/common/ecommerce/shared/idempotency/WriteResult.java
diff --git a/common/src/main/java/common/ecommerce/shared/idempotency/WriteScope.java b/shared/src/main/java/common/ecommerce/shared/idempotency/WriteScope.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/idempotency/WriteScope.java
rename to shared/src/main/java/common/ecommerce/shared/idempotency/WriteScope.java
diff --git a/common/src/main/java/common/ecommerce/shared/model/Capability.java b/shared/src/main/java/common/ecommerce/shared/model/Capability.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/model/Capability.java
rename to shared/src/main/java/common/ecommerce/shared/model/Capability.java
diff --git a/common/src/main/java/common/ecommerce/shared/model/ChannelProvider.java b/shared/src/main/java/common/ecommerce/shared/model/ChannelProvider.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/model/ChannelProvider.java
rename to shared/src/main/java/common/ecommerce/shared/model/ChannelProvider.java
diff --git a/common/src/main/java/common/ecommerce/shared/model/FulfillmentMode.java b/shared/src/main/java/common/ecommerce/shared/model/FulfillmentMode.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/model/FulfillmentMode.java
rename to shared/src/main/java/common/ecommerce/shared/model/FulfillmentMode.java
diff --git a/common/src/main/java/common/ecommerce/shared/model/Platform.java b/shared/src/main/java/common/ecommerce/shared/model/Platform.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/model/Platform.java
rename to shared/src/main/java/common/ecommerce/shared/model/Platform.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/AccessToken.java b/shared/src/main/java/common/ecommerce/shared/spi/AccessToken.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/AccessToken.java
rename to shared/src/main/java/common/ecommerce/shared/spi/AccessToken.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/ChannelSecret.java b/shared/src/main/java/common/ecommerce/shared/spi/ChannelSecret.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/ChannelSecret.java
rename to shared/src/main/java/common/ecommerce/shared/spi/ChannelSecret.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/IdempotencyClaim.java b/shared/src/main/java/common/ecommerce/shared/spi/IdempotencyClaim.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/IdempotencyClaim.java
rename to shared/src/main/java/common/ecommerce/shared/spi/IdempotencyClaim.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/IdempotencyRecord.java b/shared/src/main/java/common/ecommerce/shared/spi/IdempotencyRecord.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/IdempotencyRecord.java
rename to shared/src/main/java/common/ecommerce/shared/spi/IdempotencyRecord.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/IdempotencyStatus.java b/shared/src/main/java/common/ecommerce/shared/spi/IdempotencyStatus.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/IdempotencyStatus.java
rename to shared/src/main/java/common/ecommerce/shared/spi/IdempotencyStatus.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/IdempotencyStore.java b/shared/src/main/java/common/ecommerce/shared/spi/IdempotencyStore.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/IdempotencyStore.java
rename to shared/src/main/java/common/ecommerce/shared/spi/IdempotencyStore.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/LockProvider.java b/shared/src/main/java/common/ecommerce/shared/spi/LockProvider.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/LockProvider.java
rename to shared/src/main/java/common/ecommerce/shared/spi/LockProvider.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/SecretProvider.java b/shared/src/main/java/common/ecommerce/shared/spi/SecretProvider.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/SecretProvider.java
rename to shared/src/main/java/common/ecommerce/shared/spi/SecretProvider.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/SyncCursorStore.java b/shared/src/main/java/common/ecommerce/shared/spi/SyncCursorStore.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/SyncCursorStore.java
rename to shared/src/main/java/common/ecommerce/shared/spi/SyncCursorStore.java
diff --git a/common/src/main/java/common/ecommerce/shared/spi/TokenStore.java b/shared/src/main/java/common/ecommerce/shared/spi/TokenStore.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/spi/TokenStore.java
rename to shared/src/main/java/common/ecommerce/shared/spi/TokenStore.java
diff --git a/common/src/main/java/common/ecommerce/shared/support/CanonicalKeys.java b/shared/src/main/java/common/ecommerce/shared/support/CanonicalKeys.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/support/CanonicalKeys.java
rename to shared/src/main/java/common/ecommerce/shared/support/CanonicalKeys.java
diff --git a/common/src/main/java/common/ecommerce/shared/support/Money.java b/shared/src/main/java/common/ecommerce/shared/support/Money.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/support/Money.java
rename to shared/src/main/java/common/ecommerce/shared/support/Money.java
diff --git a/common/src/main/java/common/ecommerce/shared/support/Page.java b/shared/src/main/java/common/ecommerce/shared/support/Page.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/support/Page.java
rename to shared/src/main/java/common/ecommerce/shared/support/Page.java
diff --git a/common/src/main/java/common/ecommerce/shared/support/PlatformTime.java b/shared/src/main/java/common/ecommerce/shared/support/PlatformTime.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/support/PlatformTime.java
rename to shared/src/main/java/common/ecommerce/shared/support/PlatformTime.java
diff --git a/common/src/main/java/common/ecommerce/shared/sync/SyncResult.java b/shared/src/main/java/common/ecommerce/shared/sync/SyncResult.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/sync/SyncResult.java
rename to shared/src/main/java/common/ecommerce/shared/sync/SyncResult.java
diff --git a/common/src/main/java/common/ecommerce/shared/sync/SyncSpec.java b/shared/src/main/java/common/ecommerce/shared/sync/SyncSpec.java
similarity index 100%
rename from common/src/main/java/common/ecommerce/shared/sync/SyncSpec.java
rename to shared/src/main/java/common/ecommerce/shared/sync/SyncSpec.java
diff --git a/common/src/test/java/common/ecommerce/shared/audit/Slf4jCallObserverTest.java b/shared/src/test/java/common/ecommerce/shared/audit/Slf4jCallObserverTest.java
similarity index 100%
rename from common/src/test/java/common/ecommerce/shared/audit/Slf4jCallObserverTest.java
rename to shared/src/test/java/common/ecommerce/shared/audit/Slf4jCallObserverTest.java
diff --git a/common/src/test/java/common/ecommerce/shared/idempotency/WriteAuditTest.java b/shared/src/test/java/common/ecommerce/shared/idempotency/WriteAuditTest.java
similarity index 100%
rename from common/src/test/java/common/ecommerce/shared/idempotency/WriteAuditTest.java
rename to shared/src/test/java/common/ecommerce/shared/idempotency/WriteAuditTest.java
diff --git a/common/src/test/java/common/ecommerce/shared/support/CanonicalKeysTest.java b/shared/src/test/java/common/ecommerce/shared/support/CanonicalKeysTest.java
similarity index 100%
rename from common/src/test/java/common/ecommerce/shared/support/CanonicalKeysTest.java
rename to shared/src/test/java/common/ecommerce/shared/support/CanonicalKeysTest.java
diff --git a/testkit/pom.xml b/testkit/pom.xml
index 26cab42..eed9411 100644
--- a/testkit/pom.xml
+++ b/testkit/pom.xml
@@ -16,11 +16,11 @@
ecommerce
- common-ecommerce-common
+ common-ecommerce-shared
ecommerce
- common-ecommerce-core
+ common-ecommerce-channel
ecommerce
diff --git a/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java b/testkit/src/main/java/common/ecommerce/shared/testkit/FakeDirectAdapter.java
similarity index 90%
rename from testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/FakeDirectAdapter.java
index 9087871..c19b577 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/FakeDirectAdapter.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/FakeDirectAdapter.java
@@ -1,31 +1,31 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
-import common.ecommerce.capability.AfterSaleCapable;
-import common.ecommerce.capability.ProductCapable;
-import common.ecommerce.capability.SalesOrderCapable;
+import common.ecommerce.channel.capability.AfterSaleCapable;
+import common.ecommerce.channel.capability.ProductCapable;
+import common.ecommerce.channel.capability.SalesOrderCapable;
import common.ecommerce.shared.error.ChannelException;
-import common.ecommerce.model.account.AccountKey;
+import common.ecommerce.channel.model.account.AccountKey;
import common.ecommerce.shared.model.Capability;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleQuery;
-import common.ecommerce.model.aftersale.AfterSaleType;
-import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleQuery;
+import common.ecommerce.channel.model.aftersale.AfterSaleType;
+import common.ecommerce.channel.model.account.ChannelAccount;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.support.Money;
-import common.ecommerce.model.order.OrderLine;
+import common.ecommerce.channel.model.order.OrderLine;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.model.Platform;
import common.ecommerce.shared.support.PlatformTime;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
-import common.ecommerce.model.product.ProductRef;
-import common.ecommerce.model.product.ProductSyncStrategy;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.model.order.SalesOrderRef;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelContext;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
+import common.ecommerce.channel.model.product.ProductRef;
+import common.ecommerce.channel.model.product.ProductSyncStrategy;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.order.SalesOrderRef;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelContext;
import common.ecommerce.shared.spi.ChannelSecret;
import java.time.Instant;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/InMemoryAccounts.java b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryAccounts.java
similarity index 92%
rename from testkit/src/main/java/common/ecommerce/testkit/InMemoryAccounts.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryAccounts.java
index 26673d0..5990249 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/InMemoryAccounts.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryAccounts.java
@@ -1,8 +1,8 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
-import common.ecommerce.spi.ChannelAccountRepository;
+import common.ecommerce.channel.spi.ChannelAccountRepository;
import common.ecommerce.shared.spi.ChannelSecret;
-import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.channel.model.account.ChannelAccount;
import common.ecommerce.shared.spi.SecretProvider;
import java.util.ArrayList;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/InMemoryCursorStore.java b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryCursorStore.java
similarity index 96%
rename from testkit/src/main/java/common/ecommerce/testkit/InMemoryCursorStore.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryCursorStore.java
index d9f5dcd..8d4fe9b 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/InMemoryCursorStore.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryCursorStore.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.spi.SyncCursorStore;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/InMemoryIdempotencyStore.java b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryIdempotencyStore.java
similarity index 99%
rename from testkit/src/main/java/common/ecommerce/testkit/InMemoryIdempotencyStore.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryIdempotencyStore.java
index c10d289..eaa5587 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/InMemoryIdempotencyStore.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryIdempotencyStore.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.spi.IdempotencyClaim;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/InMemoryLockProvider.java b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryLockProvider.java
similarity index 97%
rename from testkit/src/main/java/common/ecommerce/testkit/InMemoryLockProvider.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryLockProvider.java
index 156dc19..eda5111 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/InMemoryLockProvider.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryLockProvider.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.shared.spi.LockProvider;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/InMemorySink.java b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemorySink.java
similarity index 85%
rename from testkit/src/main/java/common/ecommerce/testkit/InMemorySink.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/InMemorySink.java
index 73806c2..4310706 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/InMemorySink.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemorySink.java
@@ -1,9 +1,9 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.spi.Sink;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.spi.Sink;
import java.util.ArrayList;
import java.util.Collections;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/InMemoryTokenStore.java b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryTokenStore.java
similarity index 95%
rename from testkit/src/main/java/common/ecommerce/testkit/InMemoryTokenStore.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryTokenStore.java
index 5bb523c..c5ddb21 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/InMemoryTokenStore.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/InMemoryTokenStore.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.shared.spi.AccessToken;
import common.ecommerce.shared.spi.TokenStore;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java b/testkit/src/main/java/common/ecommerce/shared/testkit/JsonFixture.java
similarity index 96%
rename from testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/JsonFixture.java
index 6f82274..d42d001 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/JsonFixture.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/JsonFixture.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import java.io.ByteArrayOutputStream;
import java.io.InputStream;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/MutableClock.java b/testkit/src/main/java/common/ecommerce/shared/testkit/MutableClock.java
similarity index 96%
rename from testkit/src/main/java/common/ecommerce/testkit/MutableClock.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/MutableClock.java
index fdec95c..032ba66 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/MutableClock.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/MutableClock.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import java.time.Clock;
import java.time.Duration;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java b/testkit/src/main/java/common/ecommerce/shared/testkit/RecordingTransport.java
similarity index 98%
rename from testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/RecordingTransport.java
index 02f6ecc..b19f2f0 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/RecordingTransport.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/RecordingTransport.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.http.HttpRequest;
import common.ecommerce.http.HttpResponse;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/Responses.java b/testkit/src/main/java/common/ecommerce/shared/testkit/Responses.java
similarity index 96%
rename from testkit/src/main/java/common/ecommerce/testkit/Responses.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/Responses.java
index db5d5b8..ebfd891 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/Responses.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/Responses.java
@@ -1,4 +1,4 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.http.HttpResponse;
diff --git a/testkit/src/main/java/common/ecommerce/testkit/TestData.java b/testkit/src/main/java/common/ecommerce/shared/testkit/TestData.java
similarity index 90%
rename from testkit/src/main/java/common/ecommerce/testkit/TestData.java
rename to testkit/src/main/java/common/ecommerce/shared/testkit/TestData.java
index e41bee0..4433d65 100644
--- a/testkit/src/main/java/common/ecommerce/testkit/TestData.java
+++ b/testkit/src/main/java/common/ecommerce/shared/testkit/TestData.java
@@ -1,7 +1,7 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrder;
import common.ecommerce.shared.spi.SyncCursorStore;
import java.time.Duration;
diff --git a/testkit/src/test/java/common/ecommerce/idempotency/IdempotencyGuardTest.java b/testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java
similarity index 97%
rename from testkit/src/test/java/common/ecommerce/idempotency/IdempotencyGuardTest.java
rename to testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java
index 5d408c2..6ca8875 100644
--- a/testkit/src/test/java/common/ecommerce/idempotency/IdempotencyGuardTest.java
+++ b/testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java
@@ -9,8 +9,8 @@ import common.ecommerce.shared.idempotency.IdempotencyGuard;
import common.ecommerce.shared.idempotency.WriteResult;
import common.ecommerce.shared.idempotency.WriteScope;
import common.ecommerce.shared.spi.IdempotencyStatus;
-import common.ecommerce.testkit.InMemoryIdempotencyStore;
-import common.ecommerce.testkit.MutableClock;
+import common.ecommerce.shared.testkit.InMemoryIdempotencyStore;
+import common.ecommerce.shared.testkit.MutableClock;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
@@ -190,8 +190,8 @@ class IdempotencyGuardTest {
@Test
void guardOnlyWritesPlatformOnceAcrossRetry() {
// 适配器层记录:平台写操作只应发生一次
- common.ecommerce.testkit.FakeDirectAdapter adapter =
- common.ecommerce.testkit.FakeDirectAdapter.builder().build();
+ common.ecommerce.shared.testkit.FakeDirectAdapter adapter =
+ common.ecommerce.shared.testkit.FakeDirectAdapter.builder().build();
guard.execute(MARK_SHIPPED, () -> adapter.markShipped("pkg-1", "1Z-1"), v -> v);
guard.execute(MARK_SHIPPED, () -> adapter.markShipped("pkg-1", "1Z-1"), v -> v);
diff --git a/testkit/src/test/java/common/ecommerce/testkit/FakeDirectAdapterTest.java b/testkit/src/test/java/common/ecommerce/shared/testkit/FakeDirectAdapterTest.java
similarity index 89%
rename from testkit/src/test/java/common/ecommerce/testkit/FakeDirectAdapterTest.java
rename to testkit/src/test/java/common/ecommerce/shared/testkit/FakeDirectAdapterTest.java
index 19704f9..3e21cc1 100644
--- a/testkit/src/test/java/common/ecommerce/testkit/FakeDirectAdapterTest.java
+++ b/testkit/src/test/java/common/ecommerce/shared/testkit/FakeDirectAdapterTest.java
@@ -1,20 +1,20 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
-import common.ecommerce.capability.AdapterCapabilityReport;
-import common.ecommerce.capability.CapabilityReport;
+import common.ecommerce.channel.capability.AdapterCapabilityReport;
+import common.ecommerce.channel.capability.CapabilityReport;
import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.model.Capability;
-import common.ecommerce.model.account.ChannelAccount;
+import common.ecommerce.channel.model.account.ChannelAccount;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.support.Page;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductRef;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.sdk.ChannelContext;
-import common.ecommerce.sync.SyncEngine;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductRef;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
+import common.ecommerce.channel.sdk.ChannelContext;
+import common.ecommerce.channel.sync.SyncEngine;
import common.ecommerce.shared.sync.SyncResult;
import common.ecommerce.shared.sync.SyncSpec;
import org.junit.jupiter.api.Test;
diff --git a/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java b/testkit/src/test/java/common/ecommerce/shared/testkit/SdkFacadeCallTest.java
similarity index 86%
rename from testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java
rename to testkit/src/test/java/common/ecommerce/shared/testkit/SdkFacadeCallTest.java
index 72e1b67..3ed0150 100644
--- a/testkit/src/test/java/common/ecommerce/testkit/SdkFacadeCallTest.java
+++ b/testkit/src/test/java/common/ecommerce/shared/testkit/SdkFacadeCallTest.java
@@ -1,23 +1,23 @@
-package common.ecommerce.testkit;
+package common.ecommerce.shared.testkit;
-import common.ecommerce.capability.CapabilityReport;
+import common.ecommerce.channel.capability.CapabilityReport;
import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.model.Capability;
import common.ecommerce.shared.model.ChannelProvider;
import common.ecommerce.shared.model.Platform;
-import common.ecommerce.model.account.AccountKey;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.aftersale.AfterSale;
-import common.ecommerce.model.aftersale.AfterSaleQuery;
-import common.ecommerce.model.aftersale.AfterSaleType;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.model.product.ProductListing;
-import common.ecommerce.model.product.ProductQuery;
-import common.ecommerce.model.product.ProductStatus;
+import common.ecommerce.channel.model.account.AccountKey;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.aftersale.AfterSale;
+import common.ecommerce.channel.model.aftersale.AfterSaleQuery;
+import common.ecommerce.channel.model.aftersale.AfterSaleType;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.product.ProductListing;
+import common.ecommerce.channel.model.product.ProductQuery;
+import common.ecommerce.channel.model.product.ProductStatus;
import common.ecommerce.shared.support.Page;
-import common.ecommerce.sdk.ChannelConnection;
-import common.ecommerce.sdk.ChannelSdk;
+import common.ecommerce.channel.sdk.ChannelConnection;
+import common.ecommerce.channel.sdk.ChannelSdk;
import common.ecommerce.shared.spi.ChannelSecret;
import org.junit.jupiter.api.BeforeEach;
import org.junit.jupiter.api.Test;
@@ -103,7 +103,7 @@ class SdkFacadeCallTest {
void productQueryRejectsFuzzyAndExactTogether() {
assertThrows(IllegalArgumentException.class,
() -> ProductQuery.builder()
- .searchField(common.ecommerce.model.product.ProductSearchField.PLATFORM_SKU)
+ .searchField(common.ecommerce.channel.model.product.ProductSearchField.PLATFORM_SKU)
.searchValue("A")
.searchValues(java.util.Arrays.asList("B"))
.build());
@@ -160,7 +160,7 @@ class SdkFacadeCallTest {
// FakeDirectAdapter 没有实现结算能力:取视图不报错,调用时报错
assertThrows(ChannelException.UnsupportedCapabilityException.class,
() -> sdk.settlements(KEY, CONNECTION).pull(
- common.ecommerce.model.settlement.SettlementQuery.builder().build()));
+ common.ecommerce.channel.model.settlement.SettlementQuery.builder().build()));
}
@Test
diff --git a/操作手册.md b/操作手册.md
index 1e56061..81f4d1a 100644
--- a/操作手册.md
+++ b/操作手册.md
@@ -27,7 +27,7 @@
```xml
ecommerce
- common-ecommerce-core
+ common-ecommerce-channel
1.0.0-SNAPSHOT
From 6a8796cc0b8392924fd071f47bf093561dcca396 Mon Sep 17 00:00:00 2001
From: chenchuchuan <13554600537@163.com>
Date: Fri, 6 Nov 2026 17:40:14 +0800
Subject: [PATCH 3/5] =?UTF-8?q?fix:=20=E8=A1=A5=E9=BD=90=E5=8C=85=E6=9B=B4?=
=?UTF-8?q?=E5=90=8D=E9=81=97=E7=95=99=E7=9A=84=20package=20=E5=A3=B0?=
=?UTF-8?q?=E6=98=8E=E4=B8=8E=20GUIDE=20=E7=A4=BA=E4=BE=8B?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- IdempotencyGuardTest 的 package 由 common.ecommerce.idempotency
改为 common.ecommerce.shared.idempotency,与文件路径一致
- GUIDE 示例里的 import 与子包说明同步到 channel / shared
Co-Authored-By: Claude
---
GUIDE.md | 24 +++++++++++-----------
.../shared/idempotency/IdempotencyGuardTest.java | 2 +-
2 files changed, 13 insertions(+), 13 deletions(-)
diff --git a/GUIDE.md b/GUIDE.md
index 99d2853..2a63b9d 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -147,7 +147,7 @@ public interface ProductCapable extends PlatformAdapter {
Java 擦除后两个 `get(ctx, String)` 是同一个签名。一个同时实现订单和商品的适配器(比如直连沃尔玛)**无法同时实现**,编译器直接报名称冲突。所以包成两个不同的类。
-> 对应的 import 路径:`common.ecommerce.model.order.SalesOrderRef`、`common.ecommerce.model.product.ProductRef`。`model` 包按职责拆成 `account` / `order` / `product` / `support` 四个子包,枚举留在 `model` 根包。
+> 对应的 import 路径:`common.ecommerce.channel.model.order.SalesOrderRef`、`common.ecommerce.channel.model.product.ProductRef`。`channel.model` 按职责拆成 `account` / `order` / `product` / `fulfillment` / `aftersale` / `settlement` 六个子包;枚举在 `common.ecommerce.shared.model` 根包。
**为什么 `pull` 返回 `Page` 而不是 `List`?**
@@ -410,17 +410,17 @@ if (r.alreadyCompleted()) {
```java
package common.ecommerce.acme;
-// model 包按职责分了子包,import 时注意:
-import common.ecommerce.model.Capability;
-import common.ecommerce.model.ChannelProvider;
-import common.ecommerce.model.Platform;
-import common.ecommerce.model.account.ChannelAccount;
-import common.ecommerce.model.order.SalesOrder;
-import common.ecommerce.model.order.SalesOrderQuery;
-import common.ecommerce.model.order.SalesOrderRef;
-import common.ecommerce.model.support.Money;
-import common.ecommerce.model.support.Page;
-import common.ecommerce.model.support.PlatformTime;
+// 枚举在 shared.model,渠道域模型在 channel.model
+import common.ecommerce.shared.model.Capability;
+import common.ecommerce.shared.model.ChannelProvider;
+import common.ecommerce.shared.model.Platform;
+import common.ecommerce.channel.model.account.ChannelAccount;
+import common.ecommerce.channel.model.order.SalesOrder;
+import common.ecommerce.channel.model.order.SalesOrderQuery;
+import common.ecommerce.channel.model.order.SalesOrderRef;
+import common.ecommerce.shared.support.Money;
+import common.ecommerce.shared.support.Page;
+import common.ecommerce.shared.support.PlatformTime;
public final class AcmeConstants {
diff --git a/testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java b/testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java
index 6ca8875..373de7e 100644
--- a/testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java
+++ b/testkit/src/test/java/common/ecommerce/shared/idempotency/IdempotencyGuardTest.java
@@ -1,4 +1,4 @@
-package common.ecommerce.idempotency;
+package common.ecommerce.shared.idempotency;
import common.ecommerce.shared.error.ChannelException;
import common.ecommerce.shared.error.CrossProviderConflictException;
From e1d6621d3d024a05e8242c609004a69887e1d39f Mon Sep 17 00:00:00 2001
From: chenchuchuan <13554600537@163.com>
Date: Fri, 6 Nov 2026 17:55:17 +0800
Subject: [PATCH 4/5] =?UTF-8?q?docs:=20GUIDE=20/=20=E6=93=8D=E4=BD=9C?=
=?UTF-8?q?=E6=89=8B=E5=86=8C=20=E5=AF=B9=E9=BD=90=20shared/channel=20?=
=?UTF-8?q?=E4=B8=8E=E9=A2=86=E6=98=9F=E7=8E=B0=E7=8A=B6?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
GUIDE:
- 能力接口清单补齐结算/售后/出库/面单/审核/订单编辑,门面 API 补全视图
- 接入示例改为「适配器不持凭据」,端点与密钥取自 ChannelContext
- 测试分层改为 单测 → 契约(RecordingTransport+夹具)→ 真实冒烟(系统属性传凭据)→ 分页水位线 → 门面能力
- 验收与实现状态表按 channel/shared 模块名更新
操作手册:
- 商品搜索维度 searchField / searchValue / searchValues,及 Target LOCAL_SKU 的显式拒绝
- 商品 / 店铺 / 订单详情的支持范围按实际子平台修正
- platform_code 对照与实现状态表按实测补齐
代码:ChannelAccount 的 credentialRef 注释去掉已废弃的 SecretProvider 说法
Co-Authored-By: Claude
---
GUIDE.md | 173 +++++++++++----------
.../channel/model/account/ChannelAccount.java | 6 +-
操作手册.md | 75 ++++++---
3 files changed, 151 insertions(+), 103 deletions(-)
diff --git a/GUIDE.md b/GUIDE.md
index 2a63b9d..727e78b 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -127,7 +127,7 @@ public interface PlatformAdapter {
### 3.2 能力接口
-供应商实现哪些接口,就声明哪些能力。目前有两个:
+供应商实现哪些接口,就声明哪些能力。接口都继承 `PlatformAdapter`:
```java
public interface SalesOrderCapable extends PlatformAdapter {
@@ -143,9 +143,22 @@ public interface ProductCapable extends PlatformAdapter {
}
```
+其余能力接口(按需实现,不实现就不声明):
+
+| 接口 | 读/写 | 关键方法 |
+|:---|:---:|:---|
+| `SettlementCapable` | 读 | `pull(ctx, SettlementQuery)` |
+| `AfterSaleCapable` | 读 | `pull(ctx, AfterSaleQuery)` |
+| `OutboundOrderCapable` | 读 | `pull(ctx, OutboundOrderQuery)` |
+| `ShippingLabelCapable` | 读 | `labels(ctx, LabelQuery)` |
+| `OutboundCapable` | **写** | `submit(ctx, packages)` / `results(ctx, globalOrderNos)` |
+| `ShipmentReviewCapable` | **写** | `review(ctx, globalOrderNos)` |
+| `OrderEditCapable` | **写** | `edit(ctx, requests)` |
+| `AggregatorCapable` | — | `listSubChannels(ctx)`,聚合器额外实现 |
+
**为什么 `get` 的参数是 `SalesOrderRef` / `ProductRef` 而不是 `String`?**
-Java 擦除后两个 `get(ctx, String)` 是同一个签名。一个同时实现订单和商品的适配器(比如直连沃尔玛)**无法同时实现**,编译器直接报名称冲突。所以包成两个不同的类。
+Java 擦除后两个 `get(ctx, String)` 是同一个签名。一个同时实现订单和商品的适配器(比如直连沃尔玛)**无法同时实现**,编译器直接报名称冲突。所以包成两个不同的类。对外的门面视图仍收 `String`(`sdk.salesOrders(key, conn).get("PO-123")`),由视图负责包装。
> 对应的 import 路径:`common.ecommerce.channel.model.order.SalesOrderRef`、`common.ecommerce.channel.model.product.ProductRef`。`channel.model` 按职责拆成 `account` / `order` / `product` / `fulfillment` / `aftersale` / `settlement` 六个子包;枚举在 `common.ecommerce.shared.model` 根包。
@@ -157,14 +170,20 @@ Java 擦除后两个 `get(ctx, String)` 是同一个签名。一个同时实现
```java
public final class ChannelSdk implements ProviderResolver {
- public CapabilityReport capabilities(AccountKey key); // 只读,不发请求
- public SalesOrders salesOrders(AccountKey key, ChannelConnection conn); // 订单视图
- public Products products(AccountKey key, ChannelConnection conn); // 商品视图
- public IdempotencyGuard writes(); // 写操作守卫
- public PlatformAdapter resolve(AccountKey key); // 按 key 找适配器
+ public CapabilityReport capabilities(AccountKey key); // 只读,不发请求
+ public SalesOrders salesOrders(AccountKey key, ChannelConnection conn); // 订单视图
+ public Products products(AccountKey key, ChannelConnection conn); // 商品视图
+ public Settlements settlements(AccountKey key, ChannelConnection conn); // 账单视图(读)
+ public AfterSales afterSales(AccountKey key, ChannelConnection conn); // 售后视图(读)
+ public Outbounds outbounds(AccountKey key, ChannelConnection conn); // 出库/面单/审核视图
+ public List subChannels(AccountKey key, ChannelConnection conn);
+ public IdempotencyGuard writes(); // 写操作守卫
+ public PlatformAdapter resolve(AccountKey key); // 按 key 找适配器
}
```
+写类能力(`submit` / `review` / `edit`)挂在 `Outbounds` 视图上,**仍必须经 `sdk.writes()` 包一层幂等**再调用。
+
门面**不做**:不选 provider、不自动兜底、不重试、不缓存。
每次调用固定三步:
@@ -190,12 +209,13 @@ key → accountRepository.findByKey(provider, platform, omsStoreId)
| SPI | 作用 | 读要用 | 写要用 |
|:---|:---|:---:|:---:|
-| `ChannelAccountRepository` | 读渠道账户 | ✅ | ✅ |
+| `ChannelAccountRepository`(channel) | 读渠道账户 | ✅ | ✅ |
+| `ChannelSecret` | 凭据载体,调用时经 `ChannelConnection` 传入 | ✅ | ✅ |
| `SecretProvider` | ~~按 credentialRef 取密钥~~ **已废弃**:凭据由调用方传入 | — | — |
| `TokenStore` | token 读写(宿主加密) | ✅ | ✅ |
| `LockProvider` | token 刷新防击穿 | ✅ | ✅ |
| `SyncCursorStore` | 水位线 | 批量读 | — |
-| `Sink` | 领域对象落库 | 批量读 | — |
+| `Sink`(channel) | 领域对象落库 | 批量读 | — |
| `IdempotencyStore` | 幂等键抢占与结果 | — | ✅ |
### 3.5 错误类型
@@ -359,19 +379,19 @@ if (r.alreadyCompleted()) {
## 五、加一个供应商:8 步
-以新增 `acme` 直连平台为例。**核心原则:不改 core、不改门面、不改宿主。**
+以新增 `acme` 直连平台为例。**核心原则:不改 channel、不改门面、不改宿主。**
### 第 0 步:先想清楚三件事
| 问题 | 影响 |
|:---|:---|
-| 它属于哪个 `Platform`? | 枚举里有直接用;没有才加(唯一允许改 core 的地方) |
+| 它属于哪个 `Platform`? | 枚举里有直接用;没有才加(唯一允许改 `shared` 的地方) |
| 走 `DIRECT` 还是新聚合器? | 新聚合器才加 `ChannelProvider` 枚举值 |
| 它会哪些能力? | 只列真能做的 |
-现有枚举:
+现有枚举(`common.ecommerce.shared.model`):
-- `Platform`:`AMAZON_SC` `AMAZON_VC` `WALMART_SC` `WALMART_1P` `TIKTOK` `TEMU` `EBAY` `SHEIN` `MIRAKL` `TARGET` `BESTBUY` `AEPH` `CUSTOM`
+- `Platform`:`AMAZON_SC` `AMAZON_VC` `WALMART_SC` `WALMART_1P` `TIKTOK` `TEMU` `EBAY` `SHEIN` `ALIEXPRESS` `MIRAKL` `TARGET` `BESTBUY` `AEPH` `WAYFAIR` `MICHAELS` `ECHO` `LOSDLIUS` `CUSTOM`
- `ChannelProvider`:`DIRECT` `LINGXING` `TEAPPLIX` `CUSTOM`
### 第 1 步:建模块
@@ -460,7 +480,7 @@ public final class AcmeOrderDto {
**平台字段名只允许出现在 DTO 和 Mapper 里。**
**DTO 用 Lombok,领域模型不用。** DTO 是纯数据容器,没有不变量要保护,`@Getter`/`@Setter`
-省掉全部样板;`core` 的模型是不可变 + Builder,本来就没有 setter,且 `core` 要尽量少依赖
+省掉全部样板;`channel` 的模型是不可变 + Builder,本来就没有 setter,且 `channel` 要尽量少依赖
编译期工具。Lombok 声明为 `scope=provided`,不进宿主运行时。
**端点和路径写成常量,不做配置。** 协议细节(URL、字段名、限流值)是代码的一部分——
@@ -564,27 +584,23 @@ public final class AcmeSigner {
```java
public final class AcmeAdapter implements SalesOrderCapable {
- private final String baseUrl;
private final HttpTransport transport;
private final JacksonJsonCodec json;
- private final SecretProvider secretProvider;
private final Clock clock;
private final TokenManager tokenManager;
private final AcmeOrderMapper mapper = new AcmeOrderMapper();
- public AcmeAdapter(String baseUrl, HttpTransport transport, JacksonJsonCodec json,
- SecretProvider secretProvider, TokenStore tokenStore,
- LockProvider lockProvider, Clock clock) {
- this.baseUrl = baseUrl;
+ // 适配器只持有协议与基础设施:端点与凭据随每次调用的 ChannelContext 进来
+ public AcmeAdapter(HttpTransport transport, JacksonJsonCodec json,
+ TokenStore tokenStore, LockProvider lockProvider, Clock clock) {
this.transport = transport;
this.json = json;
- this.secretProvider = secretProvider;
this.clock = clock;
- final AcmeTokenClient tokenClient = new AcmeTokenClient(transport, json, baseUrl);
+ final AcmeTokenClient tokenClient = new AcmeTokenClient(transport, json, clock);
this.tokenManager = new TokenManager(tokenStore, lockProvider, clock, 600) {
@Override
protected AccessToken refresh(ChannelSecret secret, AccessToken previous) {
- return tokenClient.fetch(secret.appKey(), secret.appSecret());
+ return tokenClient.fetch(secret.endpointBaseUrl(), secret.appKey(), secret.appSecret());
}
};
}
@@ -608,7 +624,7 @@ public final class AcmeAdapter implements SalesOrderCapable {
HttpRequest req = HttpRequest.builder()
.method("POST")
- .url(baseUrl + AcmeConstants.PATH_ORDERS)
+ .url(ctx.endpointBaseUrl() + AcmeConstants.PATH_ORDERS) // ★ 端点来自 ctx
.header("Content-Type", "application/json")
.header("Authorization", authHeader(ctx))
.header("X-Request-Id", ctx.requestId())
@@ -645,8 +661,8 @@ public final class AcmeAdapter implements SalesOrderCapable {
private String authHeader(ChannelContext ctx) {
ChannelAccount account = ctx.account();
- ChannelSecret secret = secretProvider.get(account.credentialRef());
- AccessToken token = tokenManager.getOrRefresh("acme:" + account.externalStoreId(), secret);
+ // 凭据由调用方经 ChannelConnection 传入,适配器不自己去找
+ AccessToken token = tokenManager.getOrRefresh("acme:" + account.externalStoreId(), ctx.secret());
return token.tokenType() + " " + token.value();
}
@@ -677,13 +693,11 @@ public final class AcmeAdapter implements SalesOrderCapable {
```java
public final class AcmeAdapterFactory implements AdapterFactory {
- private final SecretProvider secretProvider;
private final TokenStore tokenStore;
private final LockProvider lockProvider;
private final Clock clock;
- public AcmeAdapterFactory(SecretProvider secretProvider, TokenStore tokenStore,
- LockProvider lockProvider, Clock clock) { ... }
+ public AcmeAdapterFactory(TokenStore tokenStore, LockProvider lockProvider, Clock clock) { ... }
@Override public String adapterId() { return AcmeConstants.ADAPTER_ID; }
@Override public ChannelProvider provider() { return ChannelProvider.DIRECT; }
@@ -691,17 +705,15 @@ public final class AcmeAdapterFactory implements AdapterFactory {
@Override
public PlatformAdapter create(AdapterConfig config) {
- String baseUrl = config.endpointBaseUrl() == null
- ? AcmeConstants.DEFAULT_BASE_URL : config.endpointBaseUrl();
- return new AcmeAdapter(baseUrl,
- new OkHttpTransport("common-ecommerce/1.0.0 (acme)"),
- new JacksonJsonCodec(),
- secretProvider, tokenStore, lockProvider, clock);
+ // 生产端点由调用方的 ChannelConnection 提供;config 只用于测试/联调时覆盖目标地址
+ return new AcmeAdapter(new OkHttpTransport("common-ecommerce/1.0.0 (acme)"),
+ new JacksonJsonCodec(), tokenStore, lockProvider, clock);
}
}
```
工厂的意义:把「怎么 new」和「业务怎么用」隔开。宿主只注册工厂,不需要知道构造参数。
+**工厂不持有凭据**——凭据随每次调用的 `ChannelConnection` 进来。
### 第 8 步:接进门面
@@ -710,7 +722,7 @@ ChannelSdk sdk = ChannelSdk.builder()
.accountRepository(accountRepo)
.idempotencyStore(idempotencyStore) // 要写操作就必须
.idempotencyOwner(hostName) // 多实例时区分抢占方
- .register(new AcmeAdapterFactory(secretProvider, tokenStore, lockProvider, clock))
+ .register(new AcmeAdapterFactory(tokenStore, lockProvider, clock))
.build();
AccountKey key = AccountKey.of(ChannelProvider.DIRECT, Platform.AMAZON_SC, "oms-amz-001");
@@ -774,24 +786,49 @@ assertEquals(md5Hex("secretapp_keyk1"), AcmeSigner.sign(params, "secret"));
时间相关的用 DST 边界:2026-03-08 美国太平洋时区进入夏令时,前后各测一次。
-### 第 2 层:真实环境冒烟(主力)
+### 第 2 层:契约测试(主力)
+
+用 `RecordingTransport` + 夹具断言「请求怎么拼、响应怎么解」,**不联网**:
-当前只保留真实环境冒烟(`LingxingLiveSmokeTest`),不再使用录制报文。
+```java
+RecordingTransport transport = new RecordingTransport()
+ .tokenResponse("{\"data\":{\"access_token\":\"t-1\",\"expires_in\":7200}}")
+ .route("/v1/orders", "POST",
+ r -> Responses.ok(JsonFixture.load("fixtures/acme/orderList/success.json")));
+
+AcmeAdapter adapter = new AcmeAdapter(transport, json, new InMemoryTokenStore(), locks, fixedClock);
+ChannelContext ctx = ChannelContext.of(account, connection, "req-1", fixedClock);
-做法:在测试类顶部写常量(本地联调时填真实值,不提交),用真实的
-`OkHttpTransport` 直接打平台接口;未填常量时用 `Assumptions` 跳过,
-避免占位串打到线上。
+Page page = adapter.pull(ctx, query);
+
+HttpRequest last = transport.lastRequest();
+assertTrue(last.body().contains("\"updated_after\""));
+assertEquals("ACME-1001", page.items().get(0).channelOrderId());
+```
+
+夹具按 `src/test/resources/fixtures/{platform}/{operation}/{case}.json` 存放,每个平台至少「正常 + 异常」两套。
+真实报文跑通后存成新夹具,以后改代码不用再连真实环境。
+
+### 第 3 层:真实环境冒烟(手动,不进 CI)
+
+做法:凭据用**系统属性**传入(不要写成常量提交),未提供时用 `Assumptions` 跳过:
+
+```bash
+mvn -pl lingxing -am test -Dtest=AcmeLiveSmokeTest \
+ -Dacme.probe.appKey=xxx -Dacme.probe.appSecret=yyy
+```
```java
class AcmeLiveSmokeTest {
- private static final String APP_KEY = "在这里填 AppID";
- private static final String APP_SECRET = "在这里填 AppSecret";
+ private static final String APP_KEY = System.getProperty("acme.probe.appKey", "");
+ private static final String APP_SECRET = System.getProperty("acme.probe.appSecret", "");
private final HttpTransport transport = new OkHttpTransport("common-ecommerce-smoke");
@Test
void tokenCanBeFetched() {
+ Assumptions.assumeTrue(!APP_KEY.isEmpty() && !APP_SECRET.isEmpty(), "未提供凭据,跳过");
AccessToken token = new AcmeTokenClient(transport, json, Clock.systemUTC())
.fetch(BASE_URL, APP_KEY, APP_SECRET);
assertNotNull(token.value());
@@ -800,9 +837,11 @@ class AcmeLiveSmokeTest {
```
联调时把请求和响应打出来(token 打码),签名或字段名不对时靠日志定位。
-**凭证不要提交到仓库**,联调完重置。
+**凭证不要提交到仓库**(提交历史里的密钥要轮换),联调完重置。
+
+> 领星尤其注意:真实环境**只跑查询类接口**。出库、审核发货这类写接口没有测试环境,误操作不可回滚。
-### 第 3 层:分页与水位线
+### 第 4 层:分页与水位线
```java
@Test
@@ -840,7 +879,7 @@ void pagesThroughAllOrdersAndAdvancesWatermarkOnce() {
- 返回空页 → 立刻结束,不无限循环
- 没有水位线 → 抛 `IllegalStateException`
-### 第 4 层:门面 + 能力
+### 第 5 层:门面 + 能力
```java
@Test
@@ -859,33 +898,6 @@ void facadeRejectsUnsupportedCapability() {
聚合器还要额外测:同一适配器,Walmart 账户和 eBay 账户的 `supports` 结果不同。
-### 第 5 层:真实冒烟(手动,不进 CI)
-
-参考 `lingxing/src/test/java/common/ecommerce/lingxing/LingxingLiveSmokeTest.java`:没配环境变量时整类跳过。
-
-```java
-@EnabledIfEnvironmentVariable(named = "ACME_APP_KEY", matches = ".+")
-class AcmeLiveSmokeTest {
-
- @Test
- void tokenCanBeFetched() { ... } // 先验认证
-
- @Test
- void pullsOnePage() { ... } // 再验报文
-}
-```
-
-包一层 `LoggingTransport` 打印请求响应(Authorization 打码、body 截断)。
-
-**排错顺序**:
-
-1. 401 / 403 → 先单独跑 token 测试;还失败就查出口 IP 白名单。
-2. token 通了但接口报签名错 → 只改 `Signer`,跑已知向量。
-3. 200 但 0 条 → 查时间窗、`platform_code`、`store_id` 是否属于同一店铺。
-4. 200 有数据但字段 null → 对照原始报文改 DTO 的 `@JsonProperty`,然后把真实响应存成新夹具。
-
-**真实报文转夹具**:冒烟跑通后,把打印的响应存成 `fixtures/acme/orderList/real-2026-10-29.json`,加一个 Mapper 用例。以后改代码不用再连真实环境。
-
---
## 七、验收清单
@@ -903,20 +915,21 @@ class AcmeLiveSmokeTest {
| 7 | 超长时间窗会截断 | 断言 body 里的起止时间 |
| 8 | 写操作只执行一次 | `adapter.writeCallCount() == 1` |
| 9 | 水位线失败不推进 | 第二页抛异常后断言水位线不变 |
-| 10 | core 零改动 | `git diff core/` 应只有 `Platform` 枚举 |
+| 10 | channel / shared 零改动 | `git diff channel/ shared/` 应只有 `shared/model/Platform` 枚举 |
---
## 八、已知缺口与坑
-### 当前实现状态(2026-10-29)
+### 当前实现状态(2026-11-06)
| 模块 | 状态 |
|:---|:---|
-| core | 模型、能力接口、门面、SyncEngine、幂等守卫、SPI 全部可用 |
+| shared | 枚举、异常、SPI 契约、幂等守卫、审计、水位线通用类型全部可用 |
+| channel | 领域模型、能力接口、门面、SyncEngine、账户/落库 SPI 全部可用 |
| http | OkHttp 传输、Jackson 编解码、签名接口、TokenManager 模板可用 |
| testkit | InMemory SPI、FakeDirectAdapter、MutableClock 可用 |
-| lingxing | 订单列表拉取可用;商品、履约、面单、账单、售后未实现 |
+| lingxing | 16 个子平台:订单 / 店铺全量;商品 8 个平台;结算、售后目前只有亚马逊 SC;出库单 / 面单 / 审核发货 / 订单编辑为 ERP 级、全平台共用 |
| 其它平台 | 未开始 |
### 编码坑(按踩到概率排序)
@@ -940,7 +953,7 @@ class AcmeLiveSmokeTest {
| `RefundLedger` 未实现 | 无超退校验 | 与 `IdempotencyGuard` 配合 |
| `DuplicateOrderGuard` 未实现 | 跨 provider 重复订单无告警 | 新增 SPI |
| 领星时间窗超 31 天被静默截断 | 水位线落后太多会漏中间段 | 调用方分段补拉 |
-| 领星单订单详情未实现 | `get()` 直接抛异常 | 用 `pull` + 时间窗捞 |
+| 领星单订单详情未实现 | 除亚马逊 SC / VC 外的子平台 `get()` 直接抛异常 | 用 `pull` + 时间窗捞 |
| 领星限流器用 `Thread.sleep` | 多店并发时按实例数放大 | 按账户拆适配器实例,或换通用限流器 |
---
@@ -948,7 +961,7 @@ class AcmeLiveSmokeTest {
## 九、上手顺序
1. **读三个文件**:`PlatformAdapter`、`SalesOrderCapable`、`ChannelSdk`。不到 150 行,看懂这三个就懂一半。
-2. **跑一遍现有测试**:`mvn -pl lingxing -am test`,对照看 `LingxingAdapterTest` —— 它就是「加一个供应商」的完整范例。
+2. **跑一遍现有测试**:`mvn -pl lingxing -am test`,对照看 `LingxingSdkListingCallTest`(门面 + 契约)与 `LingxingAfterSaleListSourceTest`(Source + 夹具)—— 它们就是「加一个供应商」的完整范例。
3. **抄领星的结构**建新模块:`Constants → Dto → Mapper → Adapter → Factory → Test`。
4. **先用夹具跑通,再连真实环境。** 不要反过来。
@@ -957,6 +970,6 @@ class AcmeLiveSmokeTest {
```bash
mvn clean test # 全部
mvn -pl lingxing -am test # 单模块(含依赖)
-mvn -pl lingxing -am test -Dtest=LingxingAdapterTest # 单个测试类
+mvn -pl lingxing -am test -Dtest=LingxingSdkListingCallTest # 单个测试类
mvn -pl lingxing -am test -Dtest=LingxingLiveSmokeTest # 真实环境冒烟(需环境变量)
```
diff --git a/channel/src/main/java/common/ecommerce/channel/model/account/ChannelAccount.java b/channel/src/main/java/common/ecommerce/channel/model/account/ChannelAccount.java
index b13ed24..7222d16 100644
--- a/channel/src/main/java/common/ecommerce/channel/model/account/ChannelAccount.java
+++ b/channel/src/main/java/common/ecommerce/channel/model/account/ChannelAccount.java
@@ -11,8 +11,8 @@ import java.util.Objects;
/**
* 渠道账户。一个 omsStoreId 可绑定多个 provider 账户。
*
- * 凭证不落配置:本对象只保存 {@code credentialRef},真实密钥由宿主
- * {@code SecretProvider} 按引用取出。
+ * 凭证不落配置:本对象只保存 {@code credentialRef}(账户维度的标识),
+ * 真实密钥由调用方在每次调用时经 {@code ChannelConnection} 传入,SDK 不保存、不读取。
*/
public final class ChannelAccount {
@@ -31,7 +31,7 @@ public final class ChannelAccount {
/** 市场 ID 列表;单市场平台可为空列表。 */
private final List marketplaceIds;
- /** 凭证引用(SecretProvider 的键),不是密钥本身。 */
+ /** 凭证引用(宿主侧密钥条目的标识),不是密钥本身;真实密钥经 ChannelConnection 传入。 */
private final String credentialRef;
/** 市场时区 IANA ID,如 America/Los_Angeles。 */
diff --git a/操作手册.md b/操作手册.md
index 81f4d1a..29a171d 100644
--- a/操作手册.md
+++ b/操作手册.md
@@ -80,7 +80,7 @@ ChannelAccount account = ChannelAccount.builder()
.externalStoreId("1108413237731")
// 领星 platform_code;直连账户不填
.platformCode(10008)
- // 密钥引用(如果宿主仍用 SecretProvider 取密钥)
+ // 密钥引用(宿主侧密钥条目的标识);真实密钥经 ChannelConnection 传入,见第三节
.credentialRef("kms://oms/lingxing/store-001")
// 市场当地时区,必须是合法 IANA 时区
.marketplaceZone("America/Los_Angeles")
@@ -94,7 +94,7 @@ ChannelAccount account = ChannelAccount.builder()
| `key` | ✅ | `provider + platform + omsStoreId`,SDK 的隔离维度 |
| `externalStoreId` | ✅ | 平台店铺 ID。领星传 `store_id`;亚马逊 SC 传 `sid` |
| `platformCode` | 领星必填 | 见 [platform_code 对照](#领星-platform_code-对照) |
-| `credentialRef` | ✅ | 密钥引用,不是密钥本身 |
+| `credentialRef` | ✅ | 密钥引用标识,不是密钥本身;真实密钥经 `ChannelConnection` 传入 |
| `marketplaceZone` | ✅ | 必须是 `ZoneId.of(...)` 能解析的值 |
| `currency` | ✅ | ISO 4217 |
@@ -135,6 +135,8 @@ ChannelConnection conn = ChannelConnection.of(
.build());
```
+`credentialRef` 只是账户上的标识,SDK **不会**拿它去取密钥;真实密钥就在上面的 `ChannelSecret` 里。
+
### 各平台需要的凭据字段
| 平台 | 需要的字段 |
@@ -217,7 +219,9 @@ while (page.nextCursor() != null) {
SalesOrder order = sdk.salesOrders(key, conn).get("PO-123456789");
```
-**领星暂未实现**,会抛 `ChannelException: lingxing order detail is not implemented yet`。
+只有亚马逊 SC / VC(含 FBM 路由)实现了详情;其它子平台抛
+`UnsupportedCapabilityException`。商品详情(`sdk.products(key, conn).get(sku)`)**全部未实现**,
+会抛 `ChannelException: lingxing product detail is not implemented yet`。
---
@@ -248,14 +252,31 @@ for (ProductListing p : page.items()) {
| `updatedBefore` | `Instant` | | 同上 |
| `pageSize` | `int` | | 亚马逊 Listing 上限 1000 |
| `cursor` | `String` | | 上一页游标 |
+| `searchField` | `ProductSearchField` | | 按 SKU 搜索的维度:`PLATFORM_SKU` / `LOCAL_SKU`;不传表示不按 SKU 搜 |
+| `searchValue` | `String` | | 单个**模糊**匹配值;设了 `searchField` 才能用 |
+| `searchValues` | `List` | | 多个**精确**匹配值;与 `searchValue` 互斥(同时设置时会抛异常) |
+
+按 SKU 搜索的示例:
+
+```java
+Page page = sdk.products(key, conn).pull(
+ ProductQuery.builder()
+ .searchField(ProductSearchField.PLATFORM_SKU)
+ .searchValues(Arrays.asList("SKU-1", "SKU-2"))
+ .build());
+```
+
+领星会把上面的维度翻译成各子平台自己的 `searchField` 编码(见 `LingxingProductSearchMapper`)。
+Target 的 `LOCAL_SKU` 编码尚未实测确认,目前会显式抛 `UnsupportedOperationException`,不会静默返回错数据。
### 当前支持范围
| provider | 平台 | 是否支持 |
|:---|:---|:---:|
| LINGXING | 亚马逊 SC | ✅ |
-| LINGXING | 沃尔玛 | ❌(未接入) |
-| LINGXING | eBay / SHEIN 等 | ❌ |
+| LINGXING | 亚马逊 VC / 沃尔玛 / eBay / Temu / SHEIN / TikTok / Target / AliExpress | ✅ |
+| LINGXING | 其它子平台(BestBuy / AEPH / Michaels / Echo / Losdlius / Custom …) | ❌ 商品接口未接入 |
+| DIRECT | — | ❌ 暂无直连适配器 |
不支持时会抛 `ChannelException.UnsupportedCapabilityException: PRODUCT`。
@@ -269,6 +290,7 @@ for (ProductListing p : page.items()) {
AccountKey aggregatorKey = AccountKey.of(
ChannelProvider.LINGXING, Platform.AMAZON_SC, "oms-amz-parent");
+```java
List shops = sdk.subChannels(aggregatorKey, conn);
for (SubChannel shop : shops) {
@@ -276,6 +298,8 @@ for (SubChannel shop : shops) {
shop.externalStoreId(); // 领星店铺 sid,如 "1519"
shop.platform(); // Platform.AMAZON_SC
shop.name(); // 店铺名
+ shop.status(); // 授权状态原值
+ shop.region(); // 站点简称,如 na
// 用它构造账户
ChannelAccount account = ChannelAccount.builder()
@@ -294,8 +318,8 @@ for (SubChannel shop : shops) {
| provider | 平台 | 接口 |
|:---|:---|:---|
-| LINGXING | 亚马逊 SC | `/erp/sc/data/seller/lists` ✅ |
-| LINGXING | 沃尔玛 / eBay / … | ❌ |
+| LINGXING | 亚马逊 SC / VC | `/erp/sc/data/seller/lists` ✅ |
+| LINGXING | 沃尔玛 / eBay / Temu / SHEIN / TikTok / Target / AliExpress / Wayfair / Mirakl / BestBuy / AEPH / Michaels / Echo / Losdlius / Custom | 多平台店铺接口 `/pb/mp/shop/v2/getSellerList` ✅ |
返回的店铺会**过滤掉非正常状态**(领星 `status != 1` 的店铺)。
@@ -478,11 +502,10 @@ try {
| 现象 | 原因 | 处理 |
|:---|:---|:---|
| `channel account not configured` | `findByKey` 没查到 | 检查 `provider/platform/omsStoreId` 三个值是否与账户一致 |
-| `no adapter registered for ...` | 该 `provider + platform` 没注册适配器 | 检查 `register(...)`;领星只覆盖 8 个平台 |
+| `no adapter registered for ...` | 该 `provider + platform` 没注册适配器 | 检查 `register(...)`;领星工厂覆盖 16 个子平台,不含 `WALMART_1P` |
| `duplicate adapter for ...` | 同一 `provider + platform` 注册了两次 | 去掉重复的 `register` |
| `UnsupportedCapabilityException` | 适配器不声明该能力 | 先 `capabilities()` 判断,或换 provider |
-| `lingxing sub platform not implemented: X` | 该子平台没有实现类 | 目前只有 `WALMART_SC` / `AMAZON_SC` |
-| `lingxing shop list is not supported for X` | 该子平台没有店铺接口 | 目前只有亚马逊 SC 有 |
+| `lingxing sub platform not implemented: X` | 该子平台没有注册到 `LingxingSubPlatforms` | 对照 `LingxingSubPlatformDefaults.all(...)` 的注册清单 |
| `lingxing code=102 msg=参数不合法` | 请求参数不对 | 检查 `sid` / `platform_code` / 时间格式 |
| `lingxing code=2001013 app authentication failed` | AppID/AppSecret 错误 | 检查凭据;确认出口 IP 在白名单 |
| `lingxing code=3001008` | 触发限流 | 该接口 qps=1,必须串行调用 |
@@ -498,22 +521,34 @@ try {
|:---:|:---|
| 10001 | `AMAZON_SC` |
| 10035 | `AMAZON_VC` |
+| 10003 | `EBAY` |
+| 10005 / 10031 | `AEPH` |
| 10008 | `WALMART_SC` |
+| 10010 | `WAYFAIR` |
| 10011 | `TIKTOK` |
-| 10022 / 10024 | `TEMU` |
-| 10003 | `EBAY` |
| 10021 / 10027 / 10028 | `SHEIN` |
+| 10022 / 10024 | `TEMU` |
+| 10029 / 10030 | `ALIEXPRESS` |
| 10034 | `MIRAKL` |
-| 其它 | `CUSTOM`(调用时会因未注册子平台而失败) |
+| 10009 / 10017 / 其它 | `CUSTOM`(同一码下混有多个业务平台,无法用一个枚举表示) |
+
+> 业务平台以账户的 `AccountKey.platform` 为准,这张表只用于从店铺列表 / 订单行反推。
+> Target / BestBuy / Michaels / ECHO / LOS-DLI-US 在领星侧没有独立平台码。
---
## 附录:当前实现状态
-| 能力 | 领星·亚马逊 SC | 领星·沃尔玛 | 直连 |
-|:---|:---:|:---:|:---:|
-| 订单列表 | ❌ | ✅ | ❌ |
-| 订单详情 | ❌ | ❌ | ❌ |
-| 商品 / Listing | ✅ | ❌ | ❌ |
-| 店铺列表 | ✅ | ❌ | — |
-| 写操作 | ❌ | ❌ | ❌ |
+| 能力 | 亚马逊 SC | 亚马逊 VC | 沃尔玛 | Temu / SHEIN / eBay / TikTok / Target / AliExpress 等 | Direct |
+|:---|:---:|:---:|:---:|:---:|:---:|
+| 订单列表 | ✅ | ✅ | ✅ | ✅(多平台统一订单) | ❌ |
+| 订单详情 | ✅(含 FBM) | ✅ | ❌ | ❌ | ❌ |
+| 商品 / Listing | ✅ | ✅ | ✅ | ✅(8 个平台) | ❌ |
+| 店铺列表 | ✅ | ✅ | ✅ | ✅ | — |
+| 账单 / 结算 | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 售后(只读) | ✅ | ❌ | ❌ | ❌ | ❌ |
+| 快速出库(写) | ✅ | ✅ | ✅ | ✅ | ❌ |
+| 出库单 / 面单 / 审核发货 | ✅(ERP 级,全平台共用) | 同左 | 同左 | 同左 | ❌ |
+| 订单编辑(写) | ✅(ERP 级,全平台共用) | 同左 | 同左 | 同左 | ❌ |
+
+写接口没有测试环境,联调时**只跑查询**。
From 86843c4b5a4cb82c9aa72e31546a7f5591a68ee3 Mon Sep 17 00:00:00 2001
From: chenchuchuan <13554600537@163.com>
Date: Fri, 6 Nov 2026 17:58:27 +0800
Subject: [PATCH 5/5] =?UTF-8?q?docs(readme):=20=E5=8C=85=E7=BB=93=E6=9E=84?=
=?UTF-8?q?=E6=94=B9=E4=B8=BA=E6=8C=89=E5=BD=93=E5=89=8D=E4=BB=A3=E7=A0=81?=
=?UTF-8?q?=E7=9B=AE=E5=BD=95=E5=B1=95=E5=BC=80?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit
- 「一、包职责」改为「一、包结构」,按 shared / channel / http / lingxing
实际包与类逐目录列出,lingxing 下展开到子平台(含各自 dto/product/order/shop)
- testkit 归到 shared.testkit 下展示,与实际包名一致
- GUIDE / 操作手册 中指向 README 的说法同步
Co-Authored-By: Claude
---
GUIDE.md | 2 +-
README.md | 153 +++++++++++++++++++++++++++++++++++++++++++++-----------
操作手册.md | 2 +-
3 files changed, 127 insertions(+), 30 deletions(-)
diff --git a/GUIDE.md b/GUIDE.md
index 727e78b..f1da7cc 100644
--- a/GUIDE.md
+++ b/GUIDE.md
@@ -3,7 +3,7 @@
> 面向「要接入一个新平台」和「要写业务调用」的人。
> 读完之后你应该能回答三个问题:SDK 的分层是什么、加一个供应商要动哪些文件、加完之后怎么测。
>
-> 配套材料:`README.md`(包职责与调用方式速查)、`D:\woker\文档\01需求分析\2026-10-28-电商平台\2026-10-26-cross-border-fulfillment-sdk-design.md`(Spec 0 总体设计)。
+> 配套材料:`README.md`(架构图、包结构与调用方式速查)、`D:\woker\文档\01需求分析\2026-10-28-电商平台\2026-10-26-cross-border-fulfillment-sdk-design.md`(Spec 0 总体设计)。
---
diff --git a/README.md b/README.md
index 90b475d..69fa6c7 100644
--- a/README.md
+++ b/README.md
@@ -139,33 +139,132 @@ mvn clean test
---
-## 一、包职责
+## 一、包结构
+
+按当前代码实际目录生成(`src/main/java`,测试包与主代码同构)。模块名在注释里标出。
```
common.ecommerce
-├── shared 跨域共享层(shared)
-│ ├── model Platform / ChannelProvider / Capability / FulfillmentMode
-│ ├── error 统一异常体系
-│ ├── spi AccessToken / TokenStore / LockProvider / IdempotencyStore / SyncCursorStore …
-│ ├── idempotency 写操作双锁幂等守卫
-│ ├── audit CallObserver / CallRecord
-│ ├── sync SyncSpec / SyncResult
-│ └── support Money / PlatformTime / Page / CanonicalKeys
-├── channel 渠道域(channel)
-│ ├── model 领域模型
-│ │ ├── account AccountKey / ChannelAccount
-│ │ ├── order SalesOrder / OrderLine / Query / Ref
-│ │ ├── product ProductListing / Query / Ref / SearchField / SyncStrategy
-│ │ ├── fulfillment OutboundOrder / OutboundPackage / ShippingLabel / OrderEdit / ShipmentReview
-│ │ ├── aftersale AfterSale / Query / Type
-│ │ └── settlement SettlementQuery / SettlementTransaction
-│ ├── capability 能力接口,适配器实现这些
-│ ├── sdk 门面、上下文、适配器工厂接口
-│ ├── sync 同步引擎
-│ └── spi ChannelAccountRepository / Sink
-├── http HTTP 传输、JSON、签名、令牌(http)
-├── testkit 测试替身与夹具(testkit)
-└── lingxing 领星适配器(lingxing)
+│
+├── shared 跨域共享层(shared)
+│ ├── model Platform / ChannelProvider / Capability / FulfillmentMode
+│ ├── error ChannelException + Auth / RateLimit / Transient / Validation /
+│ │ PlatformBusiness / IdempotencyConflict / CrossProviderConflict
+│ ├── spi AccessToken / ChannelSecret / TokenStore / LockProvider /
+│ │ IdempotencyStore(+Claim/Record/Status) / SyncCursorStore /
+│ │ SecretProvider(已废弃)
+│ ├── idempotency IdempotencyGuard / WriteScope / WriteResult / WriteAudit
+│ ├── audit CallObserver / CallRecord / CallOutcome / Slf4jCallObserver
+│ ├── sync SyncSpec / SyncResult
+│ ├── support Money / PlatformTime / Page / CanonicalKeys
+│ └── testkit 测试替身(testkit 模块):
+│ FakeDirectAdapter / InMemory*(Accounts·Token·Cursor·Sink·
+│ Lock·Idempotency) / RecordingTransport / Responses /
+│ JsonFixture / MutableClock / TestData
+│
+├── channel 渠道域(channel)
+│ ├── model
+│ │ ├── account AccountKey / ChannelAccount
+│ │ ├── order SalesOrder / OrderLine / SalesOrderQuery / SalesOrderRef
+│ │ ├── product ProductListing / ProductQuery / ProductRef /
+│ │ │ ProductSearchField / ProductStatus / ProductSyncStrategy
+│ │ ├── fulfillment DeclaredItem / LabelQuery / OrderEditRequest / OrderEditResult /
+│ │ │ OutboundOrder / OutboundOrderLine / OutboundOrderQuery /
+│ │ │ OutboundPackage / OutboundResult / ShipmentReviewResult /
+│ │ │ ShippingLabel
+│ │ ├── aftersale AfterSale / AfterSaleQuery / AfterSaleType
+│ │ └── settlement SettlementQuery / SettlementTransaction
+│ ├── capability PlatformAdapter / AggregatorCapable / CapabilityReport /
+│ │ AdapterCapabilityReport /
+│ │ SalesOrderCapable / ProductCapable / SettlementCapable /
+│ │ AfterSaleCapable / OutboundCapable / OutboundOrderCapable /
+│ │ ShippingLabelCapable / ShipmentReviewCapable / OrderEditCapable /
+│ │ 门面视图:SalesOrders / Products / Settlements / AfterSales / Outbounds
+│ ├── sdk ChannelSdk / ChannelContext / ChannelConnection /
+│ │ AdapterFactory / ProviderResolver / CallSupport
+│ ├── spi ChannelAccountRepository / Sink
+│ └── sync SyncEngine
+│
+├── http HTTP 与令牌(http)
+│ HttpTransport / OkHttpTransport / HttpRequest / HttpResponse /
+│ JsonCodec / JacksonJsonCodec / Signer / TokenManager / Responses
+│
+└── lingxing 领星聚合适配器(lingxing)
+ ├── LingxingApi 接口定义(路径 + 限流参数)
+ ├── LingxingConstants 端点、分页/时间窗限制、platform_code → Platform
+ ├── adapter LingxingAdapter / LingxingAdapterFactory
+ ├── auth LingxingTokenClient
+ ├── http LingxingSigner / LingxingRequestFactory / LingxingRateLimiter /
+ │ LingxingEnvelope
+ ├── mapper LingxingOrderMapper
+ ├── dto 订单报文:LingxingOrderDto / OrderItem / OrderTag / LogisticsInfo /
+ │ PlatformInfo / SubProduct / TransactionInfo
+ └── platform
+ ├── LingxingSubPlatform / LingxingSubPlatforms / LingxingSubPlatformDefaults
+ ├── LingxingCall 每次调用的公共设施(token/限流/签名/信封)
+ ├── Lingxing{Order,Product,Shop,Settlement,AfterSale,Outbound}Source
+ ├── Lingxing{OutboundOrder,Label,ShipmentReview,OrderEdit}Source ERP 级,全平台共用
+ │
+ ├── multiplatform/ 多平台统一接口(大多数子平台共用)
+ │ ├── order MultiPlatformOrderSource / LingxingOrderFilters
+ │ ├── product LingxingProductSearchMapper / LingxingProductSearchBody
+ │ ├── shop MultiPlatformShopSource
+ │ ├── outbound MultiPlatformOutboundSource / OutboundOkDto / OutboundFailDto
+ │ └── dto MultiPlatformShopDto
+ │
+ ├── amazon/
+ │ ├── dto FbmOrderDto / FbmOrderItemDto
+ │ ├── order AmazonOrderSource / AmazonFbmOrderSource
+ │ ├── sc/ AmazonScSubPlatform
+ │ │ ├── product AmazonScProductSource
+ │ │ ├── shop AmazonScShopSource
+ │ │ └── dto AmazonOrder(Dto|Item|DetailDto|DetailItemDto) /
+ │ │ AmazonScListingDto / AmazonScShopDto /
+ │ │ AmazonSettlementTransactionDto / FbmOrderDetailDto
+ │ ├── vc/ AmazonVcSubPlatform
+ │ │ ├── order VcOrderSource
+ │ │ ├── product AmazonVcProductSource
+ │ │ ├── shop VcShopSource
+ │ │ └── dto VcOrderDto / VcOrderItemDto / VcOrderDfDetailDto /
+ │ │ VcOrderPoDetailDto / VcOrderDetailItemDto /
+ │ │ AmazonVcListingDto / VcShopDto
+ │ └── settlement AmazonSettlementSource
+ │
+ ├── wms/ ERP 级实现(不区分平台)
+ │ ├── WmsOutboundOrderSource / WmsLabelSource /
+ │ │ ShipmentReviewSource / OrderEditSource
+ │ └── dto WmsOutboundOrder(Dto|ItemDto) / WmsLogisticsLabelDto /
+ │ WmsSurfaceFileDto / ShipmentReview(Data|Success|Failure)Dto /
+ │ OrderEditErrorDto
+ │
+ ├── aftersale/ LingxingAfterSaleListSource / LingxingAfterSaleMapper
+ │ └── dto AfterSaleDto / AfterSaleItemDto / AmountDetailDto
+ │
+ ├── aliexpress/ AliexpressSubPlatform
+ │ ├── product AliexpressProductSource
+ │ └── dto AliexpressListingDto / Warehouse / SupplyPrice
+ ├── ebay/ EbaySubPlatform
+ │ ├── product EbayProductSource
+ │ └── dto EbayListingDto / EbayAutoRestockDto
+ ├── shein/ SheinSubPlatform
+ │ ├── product SheinProductSource
+ │ └── dto SheinListingDto / Site / Warehouse / SupplyPrice
+ ├── target/ TargetSubPlatform
+ │ ├── product TargetProductSource
+ │ └── dto TargetListingDto / TargetLocationDto
+ ├── temu/ TemuSubPlatform
+ │ ├── product TemuProductSource
+ │ └── dto TemuListingDto / Warehouse / SupplyPrice / PromotionalPrice
+ ├── tiktok/ TiktokSubPlatform
+ │ ├── product TiktokProductSource
+ │ └── dto TiktokListingDto / TiktokWarehouseDto
+ ├── walmart/ WalmartSubPlatform
+ │ ├── order WalmartOrderSource
+ │ ├── product WalmartProductSource
+ │ └── dto WalmartListingDto
+ │
+ └── 仅订单 + 店铺(多平台通用接口):
+ aeph/ · bestbuy/ · custom/ · echo/ · losdlius/ · michaels/ · mirakl/ · wayfair/
```
包名统一前缀 `common.ecommerce.`,下表省略前缀。
@@ -190,14 +289,12 @@ common.ecommerce
| 子包 | 内容 |
|:---|:---|
-| `shared.model` | **枚举**:`Platform` / `ChannelProvider` / `Capability` / `FulfillmentMode` |
| `channel.model.account` | `AccountKey` / `ChannelAccount` |
| `channel.model.order` | `SalesOrder` / `OrderLine` / `SalesOrderQuery` / `SalesOrderRef` |
-| `channel.model.product` | `ProductListing` / `ProductQuery` / `ProductRef` / `ProductSearchField` / `ProductSyncStrategy` |
-| `channel.model.fulfillment` | `OutboundOrder` / `OutboundPackage` / `ShippingLabel` / `OrderEditRequest` / `ShipmentReviewResult` … |
+| `channel.model.product` | `ProductListing` / `ProductQuery` / `ProductRef` / `ProductSearchField` / `ProductStatus` / `ProductSyncStrategy` |
+| `channel.model.fulfillment` | `OutboundOrder` / `OutboundOrderLine` / `OutboundOrderQuery` / `OutboundPackage` / `OutboundResult` / `ShippingLabel` / `LabelQuery` / `OrderEditRequest` / `OrderEditResult` / `ShipmentReviewResult` / `DeclaredItem` |
| `channel.model.aftersale` | `AfterSale` / `AfterSaleQuery` / `AfterSaleType` |
| `channel.model.settlement` | `SettlementQuery` / `SettlementTransaction` |
-| `shared.support` | `Money` / `PlatformTime` / `Page` / `CanonicalKeys` |
| 类 | 包袱 | 职责 |
|:---|:---|:---|
diff --git a/操作手册.md b/操作手册.md
index 29a171d..0f1cded 100644
--- a/操作手册.md
+++ b/操作手册.md
@@ -1,7 +1,7 @@
# common-ecommerce 操作手册
> 面向接入本 SDK 的宿主开发者。本文只讲**怎么调、参数怎么传**。
-> 设计原理见 [`GUIDE.md`](GUIDE.md),包职责速查见 [`README.md`](README.md)。
+> 设计原理见 [`GUIDE.md`](GUIDE.md),架构图与包结构见 [`README.md`](README.md)。
---