lml
|
e716a2593e
|
feat(walmart): 沃尔玛 Marketplace 直连适配器(只读一期)
通道 ChannelProvider.DIRECT + Platform.WALMART_SC,新增模块 channel-sdk-walmart。
一期只做只读:鉴权、订单、商品、售后。标发、退款、商品写入不在本期,
对应能力位也不声明——门面调用会显式抛 UnsupportedCapabilityException。
【core 模型增量】全部是可选字段,不影响领星现有行为:
- 新增 ShipToAddress(收件信息;toString 只输出城市/州/邮编,不输出街道与姓名)
- SalesOrder 增加 buyerEmail / shipToAddress
- OrderLine 增加 status(行状态原值)与 lineAmount(行金额,金额权威来源)
- OrderLine.unitPrice 明确为「单价」:行金额除以数量,除不尽时留 null
而不是四舍五入倒推,否则 unitPrice × quantity 与原金额会差出分差
【适配器】
- POST /v3/token(Basic Auth + client_credentials),按 clientId 缓存,
提前 120s 续期;401/403 时 forceRefresh 后重发一次
- GET /v3/orders、/v3/orders/{id}:updatedAfter/Before 映射到创建时间窗
(沃尔玛没有更新时间过滤),跨度超 180 天本地拒绝
- GET /v3/items、/v3/items/{sku}:limit 上限 200;syncStrategy=FULL_PULL_DIFF,
传更新时间窗直接报错而不是静默忽略
- GET /v3/returns:一个退货单按商品行展开成多个 AfterSale,
nextCursor 是整段查询串,翻页时整串拼到路径后
- 扩展查询:getReturn(退货详情)、getShipping(发货信息),沙箱均 404
增量语义拆成两条车道:pull 走创建时间窗语义可预测,老单状态变化由
pullOpenOrders 按行状态对账,不混在一个方法里。
脏数据处理:缺订单号/下单时间/退货单号的记录跳过并 WARN,不崩整页,
也不用假值兜底写脏主键。运费不冒充商品单价,行金额除不尽时 unitPrice 留 null。
【测试】108 个:订单 22、商品 18、售后 13、脏数据 10、扩展查询 12、
状态映射 16、错误 11、门面 5、沙箱探针 1(默认跳过)。
【文档】仅新增 docs/walmart/README.md,以及 README / 操作手册.md 里
沃尔玛相关的两处能力表条目。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
3 days ago |
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 |