lml
|
c761af121e
|
feat(channel-core): 新增标发与退款能力位
统一门面原来只有读能力,补上两个写能力:
- MarkShippedCapable / SalesOrders#markShipped(ShipmentCommand) → ShipmentResult
- RefundCapable / AfterSales#refund(RefundCommand) → RefundResult
未声明对应能力位时门面抛 UnsupportedCapabilityException,不会静默成功;
两个命令模型都按「平台动作」建模,幂等键由调用方经 sdk.writes() 给出。
|
1 day ago |
lml
|
3b381be0ce
|
feat(channel-core): 订单模型补充直连平台的可选字段
沃尔玛订单里有几项领星模型没有的信息,补成可选字段(缺省为 null,不影响现有适配器):
- SalesOrder:买家邮箱、平台订单原始状态、备注等
- OrderLine:行级税费、折扣、行状态原文
- ShipToAddress:街道二行、县区、门牌等直连平台常见字段
新增 SalesOrderOptionalFieldsTest 锁住「字段缺失时为 null、不抛异常」。
|
1 day ago |
chenchuchuan
|
a6bfba6fa9
|
fix: 同步引擎查询窗口与水位线对齐,库存增量字段显式拒绝
1. SyncEngine 的查询窗口补上上界
原来 fetch(from, cursor) 只传起点,水位线却推进到 to。窗口内尚未入账的
数据会被永久跳过。改为 PageFetcher(from, to, cursor),查询与推进都限定在
[from, to)。同时补 syncProducts。
2. 新增首次全量建底 API
增量同步要求先有水位线,但此前没有任何方法能建底,只能手工 advance。
新增 bootstrapSalesOrders / bootstrapProducts:分页拉全量 → 落库 →
成功后播种水位线;已有水位线时拒绝执行,避免把线上水位线回退。
3. 库存 updatedAfter 四家仓统一显式拒绝
恒健原本就拒绝;运去哪 / 易达云 / 信仓此前静默忽略该字段,调用方以为
是按增量拉、实际拿到全量,容易误用。现统一抛 ValidationException,
与各仓 inventorySyncStrategy()=FULL_PULL_DIFF 保持一致。
补 4 个同步测试:窗口上界、无水位线、to 早于起点、建底与重复建底拒绝。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 days ago |
chenchuchuan
|
dc4db1c208
|
refactor: 连接配置收敛到 SecretProvider,调用点只传身份
调用方不再每次构造 ChannelConnection 传地址和密钥,改为:
- 账户只保留业务字段(warehouseCode / provider / providerWarehouseId / credentialRef)
- 密钥与地址由 SecretProvider 按 credentialRef 统一提供
- 门面新增免连接重载:sdk.warehouses(code)、sdk.salesOrders(key) 等
主要改动:
- ChannelSecret 承接 endpointBaseUrl / auxEndpointBaseUrl,与密钥一起配置
- WarehouseAccount 删除 timeZone / endpointBaseUrl / auxEndpointBaseUrl
- ChannelAccount 增加 endpointBaseUrl
- PlatformAdapter / WarehouseAdapter 新增 defaultEndpointBaseUrl(),适配器提供内置默认地址
(运去哪 / 信仓 / 恒健 / 领星取生产地址;易达云生产地址未定,返回 null)
- WarehouseConnection 不再无条件覆盖凭据里的地址,凭据已有地址时优先采用
- 两个门面的 Builder 新增 secretProvider(...),未注入时仍可用带连接的老入口
- 旧签名(带 connection)全部保留,向后兼容
适配器内部未改动:它们只消费 ctx.secret() / ctx.endpointBaseUrl(),
来源由调用方传入改为门面装配。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 days ago |
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 |