chenchuchuan
|
96f6621bbd
|
refactor: 按 Spec W0 拆分 sdk-common / channel-sdk-core,http 并入 sdk-common
模块更名与上提(Spec W0 §11):
- shared → sdk-common,http 合并进来,channel-sdk-http 取消
- channel → channel-sdk-core,testkit → sdk-testkit
- 父 POM 更名为 channel-sdk-parent
共享层为跨域复用做的三处调整:
- IdempotencyStore / IdempotencyRecord 的 provider 改为 String,
渠道域与仓库域两套 provider 枚举落同一张幂等表
- 新增 WriteIdentity,WriteScope 实现它;幂等守卫改为面向接口
- CallSupport 从 channel 移到 sdk-common,新增 CallScope;
ChannelContext 实现 CallScope,耗时与埋点维度不再绑定渠道域
ChannelProvider 里误加的 YUNQUNA 移除:仓不是渠道,走 WarehouseProvider。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
8bca2bff73
|
refactor: 模块更名 shared/channel,README 补架构图
- common → shared(跨域共享层),core → channel(渠道域),
包名同步为 common.ecommerce.shared.* / common.ecommerce.channel.*
- GUIDE / 操作手册 的 Maven 坐标随之更新
- README 增加架构图:分层依赖、模块依赖、一次查询的调用链;
包职责表与 lingxing 适配器结构对齐当前实现
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
aaeb0c23f5
|
refactor: 拆出 common 模块,渠道域与仓库域共享基础设施
把与渠道域无关的基础设施从 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>
|
2 weeks ago |
chenchuchuan
|
984077faee
|
docs(core): 为公开模型、门面与 SPI 补齐字段与方法注释
core 模块所有 private 字段、Builder 字段与 setter、public 方法与接口方法
都补上 Javadoc,说明语义、单位、必填性、null 含义与来源平台字段。
顺带修正 4 处既有的 Javadoc 错误:
- AfterSale / AfterSaleType 引用了不存在的 AfterSaleItem,改指 AfterSale 自身
- IdempotencyGuard 注释里的裸 > 导致 doclint 报错,改成「大于」
纯注释改动:剥离注释后与 HEAD 逐行一致,代码零变更。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
f1d6d80dd8
|
fix(observability): 批处理部分失败不再记为 SUCCESS
- CallOutcome 增加 PARTIAL;CallRecord 增加 failedCount / resultCode
- CallSupport 增加 ResultSummary/ResultMapper 与 observeSummary,支持成功/部分成功/失败三态
- 审核发货、编辑订单按逐单结果记录 PARTIAL 与失败数
- 审核发货全部失败、编辑订单 code=10000 时抛 PlatformBusinessException,
避免 sdk.writes() 把业务键记成 SUCCEEDED 后阻断重试
- outbounds.submit 返回 false 时记 FAILURE
- 新增 PartialFailureAuditTest 覆盖四种场景
验证:mvn -q -pl core -am -Dtest='PartialFailureAuditTest,CallObserverTest' -DfailIfNoTests=false test
|
2 weeks ago |
lml
|
cb9c04c80f
|
feat(observability): 增加 SDK 调用日志与审计扩展点
- 新增 CallObserver SPI 与 CallRecord/CallOutcome:SDK 只产出结构化记录,落库/发 MQ 由宿主实现
- 新增 CallSupport:统一计时、结果数量、异常捕获;观察者异常吞掉并打 WARN,不影响业务调用
- 新增 Slf4jCallObserver:成功 INFO、失败 WARN,时间格式 yyyy-MM-dd HH:mm:ss,时区与格式可配置
- ChannelSdk.Builder 增加 callObserver(...),默认 NOOP
- salesOrders / products / settlements / afterSales / outbounds / subChannels 全部埋点,能力检查失败也记录
- CallRecord 覆盖 requestId、provider/platform、omsStoreId/storeId、operation、outcome、耗时、结果数、
参数摘要、错误类型/消息、retryable、平台 request_id
- 时间内部统一存 UTC,另提供 occurredAt(zone) / finishedAt(zone) 供本地展示
|
2 weeks ago |