chenchuchuan
|
ec3e7b330c
|
feat(warehouse): 新增仓库域 SDK 内核与运去哪 P1 出库闭环
按 Spec W0《三方仓域 SDK 设计》落地 W1 + W2。
warehouse-sdk-core:
- 与 ChannelSdk 平级的 WarehouseSdk 门面,两个域互不依赖,只在 sdk-common
上共享幂等 / 水位线 / 审计 / HTTP
- 主键是 OMS 下发的 warehouseCode,出库单双号
outboundRequestNo(SDK 生成)+ providerOrderId(仓生成)
- 17 个能力位、9 个能力接口;未实现的能力显式抛
WarehouseUnsupportedCapabilityException,不静默返回空
- 取消三态 FREE / CHARGED / BLOCKED;收费取消必须显式 acceptCharge,
否则抛 OutboundCancelChargeRequiredException —— 资金动作不默认放行
- 出库创建强制经 IdempotencyGuard,幂等键
warehouseCode + outboundRequestNo + action;没注入幂等存储直接失败,
调用方无法绕过
- 领域模型不可变 + Builder;收件人 PII 的 toString 只输出国家与城市
warehouse-sdk-testkit:
- InMemory 仓仓库 / 落库 / 回调去重 / 未匹配回调留档
- FakeWarehouseAdapter 覆盖出库、收费取消、可重试失败路径
warehouse-sdk-yqn(运去哪 P1):
- 组织级固定 token 放请求头,不走 TokenManager(Spec §7.1)
- 出库 create / get / query / checkCancel / cancel / packages
- 面单模式为 PLATFORM_LABEL 且账户未声明 PLATFORM_LABEL_DELIVERY 时拒绝,
不静默降级为仓自有面单
- 默认 2 req/s/仓令牌桶(三家仓均未公开限流值)
待打样核对(Spec §8.6 第 1/2/5 项):token 头名与有效期、出库是否支持
外部单号、取消收费判定字段。这些全部集中在 YqnConstants / YqnDtos /
YqnEnvelope,核实后只改这三处。
测试:238 个,0 失败(7 个跳过的是需要真实凭据的联调探针)。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
86843c4b5a
|
docs(readme): 包结构改为按当前代码目录展开
- 「一、包职责」改为「一、包结构」,按 shared / channel / http / lingxing
实际包与类逐目录列出,lingxing 下展开到子平台(含各自 dto/product/order/shop)
- testkit 归到 shared.testkit 下展示,与实际包名一致
- GUIDE / 操作手册 中指向 README 的说法同步
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
e1d6621d3d
|
docs: GUIDE / 操作手册 对齐 shared/channel 与领星现状
GUIDE:
- 能力接口清单补齐结算/售后/出库/面单/审核/订单编辑,门面 API 补全视图
- 接入示例改为「适配器不持凭据」,端点与密钥取自 ChannelContext
- 测试分层改为 单测 → 契约(RecordingTransport+夹具)→ 真实冒烟(系统属性传凭据)→ 分页水位线 → 门面能力
- 验收与实现状态表按 channel/shared 模块名更新
操作手册:
- 商品搜索维度 searchField / searchValue / searchValues,及 Target LOCAL_SKU 的显式拒绝
- 商品 / 店铺 / 订单详情的支持范围按实际子平台修正
- platform_code 对照与实现状态表按实测补齐
代码:ChannelAccount 的 credentialRef 注释去掉已废弃的 SecretProvider 说法
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
|
71a451f3b9
|
feat(sdk): listSubChannels 收 ChannelContext,新增 subChannels 门面与操作手册
- AggregatorCapable.listSubChannels 改为 (ChannelContext),
此前只收 ChannelAccount,拿不到端点与凭据,无法真实调店铺接口
- ChannelSdk.subChannels(key, conn):聚合器子店铺列表入口
- LingxingAdapter.listSubChannels 分派到子平台的 shopSource
- 新增《操作手册.md》:依赖、连接信息、订单/商品/店铺、增量同步、
写操作幂等、异常对照、SPI 清单
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |