Browse Source
把与渠道域无关的基础设施从 core 上提到 common 模块(包名
common.ecommerce.shared.*),为三方仓域复用同一套 SPI 与管道做准备。
不改变任何行为,只做搬迁、改包名与 import。
迁移内容(36 个类 + 3 个测试):
- audit CallObserver / CallOutcome / CallRecord / Slf4jCallObserver
- error 8 个异常(AuthException … ValidationException)
- idempotency IdempotencyGuard / WriteAudit / WriteResult / WriteScope
- spi AccessToken / ChannelSecret / TokenStore / LockProvider /
SecretProvider / SyncCursorStore / Idempotency* 共 10 个
- sync SyncSpec / SyncResult(SyncEngine 留在 core,它依赖订单模型)
- model Platform / ChannelProvider / Capability / FulfillmentMode
- support Money / Page / PlatformTime / CanonicalKeys
模块依赖调整为:
core / http / testkit → common
lingxing → core + http + common
http 不再依赖 core,仓库域可直接复用传输层与令牌管理。
验证:全量 84 个测试通过(common 33 / core 29 / http 13 / testkit 29 /
lingxing 84 含 13 个默认跳过的探针)。
Co-Authored-By: Claude <noreply@anthropic.com>
feature/supplier-lingxing
178 changed files with 589 additions and 522 deletions
@ -0,0 +1,30 @@ |
|||||||
|
<?xml version="1.0" encoding="UTF-8"?> |
||||||
|
<project xmlns="http://maven.apache.org/POM/4.0.0" |
||||||
|
xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" |
||||||
|
xsi:schemaLocation="http://maven.apache.org/POM/4.0.0 http://maven.apache.org/xsd/maven-4.0.0.xsd"> |
||||||
|
<modelVersion>4.0.0</modelVersion> |
||||||
|
|
||||||
|
<parent> |
||||||
|
<groupId>ecommerce</groupId> |
||||||
|
<artifactId>common-ecommerce</artifactId> |
||||||
|
<version>1.0.0-SNAPSHOT</version> |
||||||
|
</parent> |
||||||
|
|
||||||
|
<artifactId>common-ecommerce-common</artifactId> |
||||||
|
<description> |
||||||
|
跨域共享层:异常体系、SPI 契约、幂等、审计、水位线、通用值对象。 |
||||||
|
不依赖任何领域模块,供渠道域(core)与仓库域复用。 |
||||||
|
</description> |
||||||
|
|
||||||
|
<dependencies> |
||||||
|
<dependency> |
||||||
|
<groupId>org.slf4j</groupId> |
||||||
|
<artifactId>slf4j-api</artifactId> |
||||||
|
</dependency> |
||||||
|
<dependency> |
||||||
|
<groupId>org.junit.jupiter</groupId> |
||||||
|
<artifactId>junit-jupiter</artifactId> |
||||||
|
<scope>test</scope> |
||||||
|
</dependency> |
||||||
|
</dependencies> |
||||||
|
</project> |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.audit; |
package common.ecommerce.shared.audit; |
||||||
|
|
||||||
/** |
/** |
||||||
* SDK 调用观察者:操作日志 / 审计日志的宿主扩展点。 |
* SDK 调用观察者:操作日志 / 审计日志的宿主扩展点。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.audit; |
package common.ecommerce.shared.audit; |
||||||
|
|
||||||
/** |
/** |
||||||
* 一次 SDK 调用的结果状态。 |
* 一次 SDK 调用的结果状态。 |
||||||
@ -1,8 +1,8 @@ |
|||||||
package common.ecommerce.audit; |
package common.ecommerce.shared.audit; |
||||||
|
|
||||||
import common.ecommerce.error.ChannelException; |
import common.ecommerce.shared.error.ChannelException; |
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
import common.ecommerce.model.Platform; |
import common.ecommerce.shared.model.Platform; |
||||||
|
|
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
import java.time.ZoneId; |
import java.time.ZoneId; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.audit; |
package common.ecommerce.shared.audit; |
||||||
|
|
||||||
import org.slf4j.Logger; |
import org.slf4j.Logger; |
||||||
import org.slf4j.LoggerFactory; |
import org.slf4j.LoggerFactory; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 认证失败:401/403、token 失效。刷新后重试一次;仍失败则告警并停用账户。 |
* 认证失败:401/403、token 失效。刷新后重试一次;仍失败则告警并停用账户。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 跨 provider 冲突:同一业务动作已由另一个 provider 完成。 |
* 跨 provider 冲突:同一业务动作已由另一个 provider 完成。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 写操作幂等冲突:重复写。返回已完成结果,不视为失败。 |
* 写操作幂等冲突:重复写。返回已完成结果,不视为失败。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 平台业务错误码。是否重试视错误码而定,保留 code/message/raw。 |
* 平台业务错误码。是否重试视错误码而定,保留 code/message/raw。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 限流:429。遵守 Retry-After 并退避。 |
* 限流:429。遵守 Retry-After 并退避。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 瞬时错误:5xx / 网络 / 超时。退避加抖动后重试,超过上限进入补偿队列。 |
* 瞬时错误:5xx / 网络 / 超时。退避加抖动后重试,超过上限进入补偿队列。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.error; |
package common.ecommerce.shared.error; |
||||||
|
|
||||||
/** |
/** |
||||||
* 参数或映射错误:4xx。不重试,保留原始报文由人工修正映射。 |
* 参数或映射错误:4xx。不重试,保留原始报文由人工修正映射。 |
||||||
@ -1,14 +1,14 @@ |
|||||||
package common.ecommerce.idempotency; |
package common.ecommerce.shared.idempotency; |
||||||
|
|
||||||
import common.ecommerce.audit.CallObserver; |
import common.ecommerce.shared.audit.CallObserver; |
||||||
import common.ecommerce.audit.CallOutcome; |
import common.ecommerce.shared.audit.CallOutcome; |
||||||
import common.ecommerce.error.ChannelException; |
import common.ecommerce.shared.error.ChannelException; |
||||||
import common.ecommerce.error.CrossProviderConflictException; |
import common.ecommerce.shared.error.CrossProviderConflictException; |
||||||
import common.ecommerce.error.IdempotencyConflictException; |
import common.ecommerce.shared.error.IdempotencyConflictException; |
||||||
import common.ecommerce.spi.IdempotencyClaim; |
import common.ecommerce.shared.spi.IdempotencyClaim; |
||||||
import common.ecommerce.spi.IdempotencyRecord; |
import common.ecommerce.shared.spi.IdempotencyRecord; |
||||||
import common.ecommerce.spi.IdempotencyStatus; |
import common.ecommerce.shared.spi.IdempotencyStatus; |
||||||
import common.ecommerce.spi.IdempotencyStore; |
import common.ecommerce.shared.spi.IdempotencyStore; |
||||||
|
|
||||||
import java.time.Clock; |
import java.time.Clock; |
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
@ -1,8 +1,8 @@ |
|||||||
package common.ecommerce.idempotency; |
package common.ecommerce.shared.idempotency; |
||||||
|
|
||||||
import common.ecommerce.audit.CallObserver; |
import common.ecommerce.shared.audit.CallObserver; |
||||||
import common.ecommerce.audit.CallOutcome; |
import common.ecommerce.shared.audit.CallOutcome; |
||||||
import common.ecommerce.audit.CallRecord; |
import common.ecommerce.shared.audit.CallRecord; |
||||||
import org.slf4j.Logger; |
import org.slf4j.Logger; |
||||||
import org.slf4j.LoggerFactory; |
import org.slf4j.LoggerFactory; |
||||||
|
|
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.idempotency; |
package common.ecommerce.shared.idempotency; |
||||||
|
|
||||||
/** |
/** |
||||||
* 写操作执行结果。 |
* 写操作执行结果。 |
||||||
@ -1,8 +1,8 @@ |
|||||||
package common.ecommerce.idempotency; |
package common.ecommerce.shared.idempotency; |
||||||
|
|
||||||
import common.ecommerce.model.support.CanonicalKeys; |
import common.ecommerce.shared.support.CanonicalKeys; |
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
import common.ecommerce.model.Platform; |
import common.ecommerce.shared.model.Platform; |
||||||
|
|
||||||
import java.util.Objects; |
import java.util.Objects; |
||||||
|
|
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model; |
package common.ecommerce.shared.model; |
||||||
|
|
||||||
/** |
/** |
||||||
* 能力枚举。 |
* 能力枚举。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model; |
package common.ecommerce.shared.model; |
||||||
|
|
||||||
/** |
/** |
||||||
* 接入 provider 枚举。 |
* 接入 provider 枚举。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model; |
package common.ecommerce.shared.model; |
||||||
|
|
||||||
/** 履约模式,对应四种业务模式中的 A / C / D;B(FBA/WFS 平台仓发货)只读,不在枚举内。 */ |
/** 履约模式,对应四种业务模式中的 A / C / D;B(FBA/WFS 平台仓发货)只读,不在枚举内。 */ |
||||||
public enum FulfillmentMode { |
public enum FulfillmentMode { |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model; |
package common.ecommerce.shared.model; |
||||||
|
|
||||||
/** |
/** |
||||||
* 业务平台枚举。 |
* 业务平台枚举。 |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
import java.util.Objects; |
import java.util.Objects; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import java.util.Objects; |
import java.util.Objects; |
||||||
|
|
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
/** |
/** |
||||||
* 抢占幂等键的结果。 |
* 抢占幂等键的结果。 |
||||||
@ -1,6 +1,6 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
|
|
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
import java.util.Objects; |
import java.util.Objects; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
/** |
/** |
||||||
* 幂等键状态。 |
* 幂等键状态。 |
||||||
@ -1,6 +1,6 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
|
|
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
import java.util.Optional; |
import java.util.Optional; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import java.util.Optional; |
import java.util.Optional; |
||||||
|
|
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
/** |
/** |
||||||
* 凭证读取 SPI。{@code credentialRef} 由 {@code ChannelAccount} 提供。 |
* 凭证读取 SPI。{@code credentialRef} 由 {@code ChannelAccount} 提供。 |
||||||
@ -1,6 +1,6 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
|
|
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
|
|
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.spi; |
package common.ecommerce.shared.spi; |
||||||
|
|
||||||
import java.util.Optional; |
import java.util.Optional; |
||||||
|
|
||||||
@ -1,7 +1,7 @@ |
|||||||
package common.ecommerce.model.support; |
package common.ecommerce.shared.support; |
||||||
|
|
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
import common.ecommerce.model.Platform; |
import common.ecommerce.shared.model.Platform; |
||||||
|
|
||||||
import java.nio.charset.StandardCharsets; |
import java.nio.charset.StandardCharsets; |
||||||
import java.security.MessageDigest; |
import java.security.MessageDigest; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model.support; |
package common.ecommerce.shared.support; |
||||||
|
|
||||||
import java.math.BigDecimal; |
import java.math.BigDecimal; |
||||||
import java.math.RoundingMode; |
import java.math.RoundingMode; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model.support; |
package common.ecommerce.shared.support; |
||||||
|
|
||||||
import java.util.ArrayList; |
import java.util.ArrayList; |
||||||
import java.util.Collections; |
import java.util.Collections; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.model.support; |
package common.ecommerce.shared.support; |
||||||
|
|
||||||
import java.time.Clock; |
import java.time.Clock; |
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
@ -1,4 +1,4 @@ |
|||||||
package common.ecommerce.sync; |
package common.ecommerce.shared.sync; |
||||||
|
|
||||||
/** |
/** |
||||||
* 单次同步结果。 |
* 单次同步结果。 |
||||||
@ -1,6 +1,6 @@ |
|||||||
package common.ecommerce.sync; |
package common.ecommerce.shared.sync; |
||||||
|
|
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
|
|
||||||
import java.time.Duration; |
import java.time.Duration; |
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
@ -1,9 +1,9 @@ |
|||||||
package common.ecommerce.audit; |
package common.ecommerce.shared.audit; |
||||||
|
|
||||||
import common.ecommerce.error.ChannelException; |
import common.ecommerce.shared.error.ChannelException; |
||||||
import common.ecommerce.error.PlatformBusinessException; |
import common.ecommerce.shared.error.PlatformBusinessException; |
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
import common.ecommerce.model.Platform; |
import common.ecommerce.shared.model.Platform; |
||||||
import org.junit.jupiter.api.Test; |
import org.junit.jupiter.api.Test; |
||||||
|
|
||||||
import java.time.Instant; |
import java.time.Instant; |
||||||
@ -1,17 +1,17 @@ |
|||||||
package common.ecommerce.idempotency; |
package common.ecommerce.shared.idempotency; |
||||||
|
|
||||||
import common.ecommerce.audit.CallObserver; |
import common.ecommerce.shared.audit.CallObserver; |
||||||
import common.ecommerce.audit.CallOutcome; |
import common.ecommerce.shared.audit.CallOutcome; |
||||||
import common.ecommerce.audit.CallRecord; |
import common.ecommerce.shared.audit.CallRecord; |
||||||
import common.ecommerce.error.ChannelException; |
import common.ecommerce.shared.error.ChannelException; |
||||||
import common.ecommerce.error.CrossProviderConflictException; |
import common.ecommerce.shared.error.CrossProviderConflictException; |
||||||
import common.ecommerce.error.IdempotencyConflictException; |
import common.ecommerce.shared.error.IdempotencyConflictException; |
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
import common.ecommerce.model.Platform; |
import common.ecommerce.shared.model.Platform; |
||||||
import common.ecommerce.spi.IdempotencyClaim; |
import common.ecommerce.shared.spi.IdempotencyClaim; |
||||||
import common.ecommerce.spi.IdempotencyRecord; |
import common.ecommerce.shared.spi.IdempotencyRecord; |
||||||
import common.ecommerce.spi.IdempotencyStatus; |
import common.ecommerce.shared.spi.IdempotencyStatus; |
||||||
import common.ecommerce.spi.IdempotencyStore; |
import common.ecommerce.shared.spi.IdempotencyStore; |
||||||
import org.junit.jupiter.api.BeforeEach; |
import org.junit.jupiter.api.BeforeEach; |
||||||
import org.junit.jupiter.api.Test; |
import org.junit.jupiter.api.Test; |
||||||
|
|
||||||
@ -1,7 +1,7 @@ |
|||||||
package common.ecommerce.model.support; |
package common.ecommerce.shared.support; |
||||||
|
|
||||||
import common.ecommerce.model.ChannelProvider; |
import common.ecommerce.shared.model.ChannelProvider; |
||||||
import common.ecommerce.model.Platform; |
import common.ecommerce.shared.model.Platform; |
||||||
|
|
||||||
import org.junit.jupiter.api.Test; |
import org.junit.jupiter.api.Test; |
||||||
|
|
||||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
Reference in new issue