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 @@
@@ -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 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.audit; |
||||
package common.ecommerce.shared.audit; |
||||
|
||||
/** |
||||
* SDK 调用观察者:操作日志 / 审计日志的宿主扩展点。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.audit; |
||||
package common.ecommerce.shared.audit; |
||||
|
||||
/** |
||||
* 一次 SDK 调用的结果状态。 |
||||
@ -1,8 +1,8 @@
@@ -1,8 +1,8 @@
|
||||
package common.ecommerce.audit; |
||||
package common.ecommerce.shared.audit; |
||||
|
||||
import common.ecommerce.error.ChannelException; |
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.shared.error.ChannelException; |
||||
import common.ecommerce.shared.model.ChannelProvider; |
||||
import common.ecommerce.shared.model.Platform; |
||||
|
||||
import java.time.Instant; |
||||
import java.time.ZoneId; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.audit; |
||||
package common.ecommerce.shared.audit; |
||||
|
||||
import org.slf4j.Logger; |
||||
import org.slf4j.LoggerFactory; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 认证失败:401/403、token 失效。刷新后重试一次;仍失败则告警并停用账户。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 跨 provider 冲突:同一业务动作已由另一个 provider 完成。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 写操作幂等冲突:重复写。返回已完成结果,不视为失败。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 平台业务错误码。是否重试视错误码而定,保留 code/message/raw。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 限流:429。遵守 Retry-After 并退避。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 瞬时错误:5xx / 网络 / 超时。退避加抖动后重试,超过上限进入补偿队列。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.error; |
||||
package common.ecommerce.shared.error; |
||||
|
||||
/** |
||||
* 参数或映射错误:4xx。不重试,保留原始报文由人工修正映射。 |
||||
@ -1,14 +1,14 @@
@@ -1,14 +1,14 @@
|
||||
package common.ecommerce.idempotency; |
||||
package common.ecommerce.shared.idempotency; |
||||
|
||||
import common.ecommerce.audit.CallObserver; |
||||
import common.ecommerce.audit.CallOutcome; |
||||
import common.ecommerce.error.ChannelException; |
||||
import common.ecommerce.error.CrossProviderConflictException; |
||||
import common.ecommerce.error.IdempotencyConflictException; |
||||
import common.ecommerce.spi.IdempotencyClaim; |
||||
import common.ecommerce.spi.IdempotencyRecord; |
||||
import common.ecommerce.spi.IdempotencyStatus; |
||||
import common.ecommerce.spi.IdempotencyStore; |
||||
import common.ecommerce.shared.audit.CallObserver; |
||||
import common.ecommerce.shared.audit.CallOutcome; |
||||
import common.ecommerce.shared.error.ChannelException; |
||||
import common.ecommerce.shared.error.CrossProviderConflictException; |
||||
import common.ecommerce.shared.error.IdempotencyConflictException; |
||||
import common.ecommerce.shared.spi.IdempotencyClaim; |
||||
import common.ecommerce.shared.spi.IdempotencyRecord; |
||||
import common.ecommerce.shared.spi.IdempotencyStatus; |
||||
import common.ecommerce.shared.spi.IdempotencyStore; |
||||
|
||||
import java.time.Clock; |
||||
import java.time.Instant; |
||||
@ -1,8 +1,8 @@
@@ -1,8 +1,8 @@
|
||||
package common.ecommerce.idempotency; |
||||
package common.ecommerce.shared.idempotency; |
||||
|
||||
import common.ecommerce.audit.CallObserver; |
||||
import common.ecommerce.audit.CallOutcome; |
||||
import common.ecommerce.audit.CallRecord; |
||||
import common.ecommerce.shared.audit.CallObserver; |
||||
import common.ecommerce.shared.audit.CallOutcome; |
||||
import common.ecommerce.shared.audit.CallRecord; |
||||
import org.slf4j.Logger; |
||||
import org.slf4j.LoggerFactory; |
||||
|
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.idempotency; |
||||
package common.ecommerce.shared.idempotency; |
||||
|
||||
/** |
||||
* 写操作执行结果。 |
||||
@ -1,8 +1,8 @@
@@ -1,8 +1,8 @@
|
||||
package common.ecommerce.idempotency; |
||||
package common.ecommerce.shared.idempotency; |
||||
|
||||
import common.ecommerce.model.support.CanonicalKeys; |
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.shared.support.CanonicalKeys; |
||||
import common.ecommerce.shared.model.ChannelProvider; |
||||
import common.ecommerce.shared.model.Platform; |
||||
|
||||
import java.util.Objects; |
||||
|
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model; |
||||
package common.ecommerce.shared.model; |
||||
|
||||
/** |
||||
* 能力枚举。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model; |
||||
package common.ecommerce.shared.model; |
||||
|
||||
/** |
||||
* 接入 provider 枚举。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model; |
||||
package common.ecommerce.shared.model; |
||||
|
||||
/** 履约模式,对应四种业务模式中的 A / C / D;B(FBA/WFS 平台仓发货)只读,不在枚举内。 */ |
||||
public enum FulfillmentMode { |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model; |
||||
package common.ecommerce.shared.model; |
||||
|
||||
/** |
||||
* 业务平台枚举。 |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
import java.time.Instant; |
||||
import java.util.Objects; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
import java.util.Objects; |
||||
|
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
/** |
||||
* 抢占幂等键的结果。 |
||||
@ -1,6 +1,6 @@
@@ -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.util.Objects; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
/** |
||||
* 幂等键状态。 |
||||
@ -1,6 +1,6 @@
@@ -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.util.Optional; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
import java.util.Optional; |
||||
|
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
/** |
||||
* 凭证读取 SPI。{@code credentialRef} 由 {@code ChannelAccount} 提供。 |
||||
@ -1,6 +1,6 @@
@@ -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; |
||||
|
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.spi; |
||||
package common.ecommerce.shared.spi; |
||||
|
||||
import java.util.Optional; |
||||
|
||||
@ -1,7 +1,7 @@
@@ -1,7 +1,7 @@
|
||||
package common.ecommerce.model.support; |
||||
package common.ecommerce.shared.support; |
||||
|
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.shared.model.ChannelProvider; |
||||
import common.ecommerce.shared.model.Platform; |
||||
|
||||
import java.nio.charset.StandardCharsets; |
||||
import java.security.MessageDigest; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model.support; |
||||
package common.ecommerce.shared.support; |
||||
|
||||
import java.math.BigDecimal; |
||||
import java.math.RoundingMode; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model.support; |
||||
package common.ecommerce.shared.support; |
||||
|
||||
import java.util.ArrayList; |
||||
import java.util.Collections; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.model.support; |
||||
package common.ecommerce.shared.support; |
||||
|
||||
import java.time.Clock; |
||||
import java.time.Instant; |
||||
@ -1,4 +1,4 @@
@@ -1,4 +1,4 @@
|
||||
package common.ecommerce.sync; |
||||
package common.ecommerce.shared.sync; |
||||
|
||||
/** |
||||
* 单次同步结果。 |
||||
@ -1,6 +1,6 @@
@@ -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.Instant; |
||||
@ -1,9 +1,9 @@
@@ -1,9 +1,9 @@
|
||||
package common.ecommerce.audit; |
||||
package common.ecommerce.shared.audit; |
||||
|
||||
import common.ecommerce.error.ChannelException; |
||||
import common.ecommerce.error.PlatformBusinessException; |
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.shared.error.ChannelException; |
||||
import common.ecommerce.shared.error.PlatformBusinessException; |
||||
import common.ecommerce.shared.model.ChannelProvider; |
||||
import common.ecommerce.shared.model.Platform; |
||||
import org.junit.jupiter.api.Test; |
||||
|
||||
import java.time.Instant; |
||||
@ -1,17 +1,17 @@
@@ -1,17 +1,17 @@
|
||||
package common.ecommerce.idempotency; |
||||
|
||||
import common.ecommerce.audit.CallObserver; |
||||
import common.ecommerce.audit.CallOutcome; |
||||
import common.ecommerce.audit.CallRecord; |
||||
import common.ecommerce.error.ChannelException; |
||||
import common.ecommerce.error.CrossProviderConflictException; |
||||
import common.ecommerce.error.IdempotencyConflictException; |
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.spi.IdempotencyClaim; |
||||
import common.ecommerce.spi.IdempotencyRecord; |
||||
import common.ecommerce.spi.IdempotencyStatus; |
||||
import common.ecommerce.spi.IdempotencyStore; |
||||
package common.ecommerce.shared.idempotency; |
||||
|
||||
import common.ecommerce.shared.audit.CallObserver; |
||||
import common.ecommerce.shared.audit.CallOutcome; |
||||
import common.ecommerce.shared.audit.CallRecord; |
||||
import common.ecommerce.shared.error.ChannelException; |
||||
import common.ecommerce.shared.error.CrossProviderConflictException; |
||||
import common.ecommerce.shared.error.IdempotencyConflictException; |
||||
import common.ecommerce.shared.model.ChannelProvider; |
||||
import common.ecommerce.shared.model.Platform; |
||||
import common.ecommerce.shared.spi.IdempotencyClaim; |
||||
import common.ecommerce.shared.spi.IdempotencyRecord; |
||||
import common.ecommerce.shared.spi.IdempotencyStatus; |
||||
import common.ecommerce.shared.spi.IdempotencyStore; |
||||
import org.junit.jupiter.api.BeforeEach; |
||||
import org.junit.jupiter.api.Test; |
||||
|
||||
@ -1,7 +1,7 @@
@@ -1,7 +1,7 @@
|
||||
package common.ecommerce.model.support; |
||||
package common.ecommerce.shared.support; |
||||
|
||||
import common.ecommerce.model.ChannelProvider; |
||||
import common.ecommerce.model.Platform; |
||||
import common.ecommerce.shared.model.ChannelProvider; |
||||
import common.ecommerce.shared.model.Platform; |
||||
|
||||
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