lml
|
ca6d00ba18
|
fix(xincang): 补齐下单与转运缺失的字段
上一版按文档只实现了部分字段,这次对齐到 schema 全量:
一单多件 api.add_order_multiple:
- 补 gzh(trackingNumber)/ face_base64(labelContentBase64)/
shop_name / sfp;order_type=wayfair 时前两者必填,缺失在下单前拦下,
不再等仓返回看不懂的错误
- 移除 remark:该接口 schema 没有这个字段,之前是多发的
新增转运 fba.do_fba:
- 补 4 个单附件(product_label_att / ctn_label_att / express_label_att /
pallet_label_att)、2 个数组附件(other_att / bol_att)、
express_print_copies
- products 明细补 fn_sku / ctn_sku / remark
模型配套:
- OutboundCommand 增加 trackingNumber / labelContentBase64 / shopName / sfp
- TransferCommand 增加 6 个附件字段与快递份数;TransferLine 增加三方 SKU、
箱标 SKU 与备注(保留原两参构造,YQN 不受影响)
- 新增 TransferAttachment 承载 upload.files 返回的附件元数据,
SDK 只搬运、不下载不落盘
字段覆盖已与文档逐项核对:两个接口均无缺、无多。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
3338a185e9
|
Merge remote-tracking branch 'common-ecommerce/feature/supplier-lingxing' into feature/supplier-lingxing
冲突处理:远端新增的信仓代码沿用旧的枚举位置
(common.ecommerce.warehouse.WarehouseCapability / …model.TransferStatus 等),
本地已把枚举下沉到 warehouse.enums,故按新包名改写以下文件的 import:
- TransferCapable(新增 approve 默认方法)
- XincangOrderMapper / XincangTransferMapper / XincangUnsupportedOutbound
- XincangAdapter(合并 import 段,保留两侧新增能力)
- XincangOrderTest / XincangProductTest / XincangTransferTest
TransferCommand 冲突只是 import 顺序,两侧合并即可。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
06961c6781
|
feat(yqn): 按 API 121 对接订单测算(运费试算)
新能力,与既有结算明细(API 133 / FEE_SETTLEMENT)是两条路径:
后者查已发生的账单,这个在发货前按包裹 + 地址 + 渠道询价。
- FeeEstimateQuery:cm / g 为单位,适配器负责换算成仓方单位,
调用方不用按仓猜单位;isResidential 用 Boolean 三态,null 表示不传
- FeeEstimateResult:按仓库维度返回,一个仓下多个渠道报价,
每个渠道一笔总价 + 若干细分成本项
- WarehouseFeeEstimateCapable.estimate(ctx, query),入口
sdk.warehouses(...).fees().estimate(query),校验 FEE_ESTIMATE 能力位
logisticsServiceCode 有 29 个固定取值,建 YqnLogisticsService 枚举放 yqn 模块
(不映射到 core——各仓渠道划分口径不同,强行归一会失真);查询类仍接受字符串,
文档未收录的新渠道可直接透传。
报价仅供参考,实际费用以 BillingDocument 结算为准,已在 Javadoc 标注。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
a8dfb08e69
|
refactor(warehouse): 枚举下沉 core + 平台枚举分层映射
枚举原来散在各模型内部(OutboundStatus 嵌在 OutboundOrder 里、DealMethod 嵌在
ReturnCommand 里),且直接带仓方的数字码,导致 core 知道运去哪的协议值。改成两层:
- 底层枚举(warehouse-sdk-core/enums):只含 SDK 自编稳定 code + 中文名,
不认识任何仓的码值。code 从 10 起按 10 递增、只追加不重排,落库用。
- 平台枚举(warehouse-sdk-yqn/enums):带仓方原始码,toCore() 映射到底层。
运去哪出库状态是自由文本(无码表),按关键字收敛;其余按文档码表 1:1。
Mapper 里 9 个散落的 switch 全部删除,改为一行 of(raw).toCore()。
顺带修两处会误导下游的问题:
- OutboundStatus 缺 UNKNOWN,认不出的状态被兜底成 SUBMITTED(已下发)。
补 UNKNOWN(0, rank=-1),认不出归它;对应测试断言一并修正,
新增 unknownStatusIsNotGuessed 覆盖 null / 空串 / 未知值。
- InboundOrder / TransferOrder / WarehouseReturn / BillingDocument 缺
sourceProvider,rawStatus 无法解释(同一数字在不同仓含义不同)。补上字段,
运去哪的 Mapper 全部标注 YQN。
落库契约写进 WarehouseSink:rawStatus 必须与 sourceProvider 成对保存,
它是映射调整后唯一能重跑、修正历史数据的依据。
删除 WarehouseEnum 接口——在该规模下各枚举自带 code()/label()/ofCode() 足够,
不引入额外抽象。合并 ReturnDisposition 到 ReturnProcessDisposition(后者加
UNKNOWN),退货只保留「预约预报」与「检验后决定」两套语义。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
cde4bac44a
|
feat(xincang): 对接一单多件下单与转运创建 / 审核
- 新增订单一单多件:POST api.add_order_multiple,multipart/form-data,
products 字段是 JSON 字符串;返回 rst.order_no 作为仓侧单号
- 新增转运:POST fba.do_fba,application/json,返回 rst.order_no,
创建后处于待审核
- 转运审核:POST fba.do_approve,无请求体,token 与 order_no 都在 query
仓库域内核的配套扩展(YQN 不受影响,原有测试全绿):
- OutboundCommand 增加 splitOrder,仅声明了 SPLIT 的仓解释
- TransferCommand 增加 po / orderType / deliveryMode / deliveryWay /
otherWarehouseName / labelRequirements / palletRequired / 各类贴标份数
- TransferCapable 增加默认 approve(不支持的仓显式拒绝),
WarehouseOperations.approveTransfer 走幂等守卫,动作键 approve
字段映射的取舍:
- logistics_type 用 carrierCode 承载;ckh 用 outboundRequestNo(要求唯一)
- is_sign 模型无对应字段,固定发「否」
- order_type:Wayfair → wayfair,其余 → common
- 地址超过 32 字符的部分自动拆到 address2
- 字典字段(orderType / deliveryMode / deliveryWay / labelRequirements)
只接受仓方字典原值,SDK 不做归一
- 信仓这版不收申报信息与包裹尺寸,统一模型里的对应字段不发送
- 转运仅支持 TransferType.OUTBOUND(信仓转运 = 仓到平台仓)
|
2 weeks ago |
lml
|
952033ba88
|
Merge remote-tracking branch 'origin/feature/supplier-lingxing' into feature/supplier-lingxing
|
2 weeks ago |
lml
|
8078e72de9
|
feat(xincang): 对接商品新增 / 更新(api.add_product / api.update_product)
信仓没有 upsert 接口,createOrUpdate 按「先查临时产品,有则更新、无则新增」实现:
- GET api.productlist?state=0 按 SKU 查临时产品,结果再按 product_no 精确比对,
防止 key 模糊匹配把相似 SKU 误判为已存在
- 命中走 api.update_product(只对临时产品有效),否则 api.add_product
- 写接口 token 同时放 query(文档通用约定)与请求体(产品接口 schema 要求)
- WarehouseProduct 的 cm / g 按常量换算成信仓的 inch / lbs,保留 4 位小数;
金额取 declaredValue 并固定 USD,非美元直接拒绝,避免静默按美元记错价
- bar_code 缺失时退回 SKU;packing_rate 固定 1(必填项);
包装方式 / SN / 海关等信仓未定义的字段不发送
- 适配器改为实现 WarehouseProductCapable,能力位声明 PRODUCT
未接入 api.pub_product:建档结果仍是临时产品(state=0),上架正式产品另行接入。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
eb98688c4b
|
feat(yqn): 按 API 81 / 77 对接创建销售退货与退货条目处理
- 路径 /salereturn/SalesReturnCreate → /v3/saleReturn/createSaleReturnPlan
- 路径 /salereturn/SaleReturnAddProcessMode → /v3/saleReturn/addProcessMode
两套「处理方式」不能混用,各建各的枚举:
- ReturnCommand.DealMethod(预约预报):0 客户自提 / 1 拍照确认 /
2 销毁 / 5 仓库确认
- ReturnProcessCommand.Disposition(检验后决定):0 客户自提 / 2 销毁 /
3 上架良品 / 4 换标上架
码值完全不同,共用一套会静默错处理。
接口层面的两个硬约束:
- API 81 响应只有 code/message,没有单号。providerReturnId 只能是 null,
按仓单号回查这条路走不通,只能用来源单号;已在 Javadoc 里写明
- API 77 按明细行 id 操作,所以幂等键是
warehouseCode + providerReturnNo + lineId + process,
而不是整单——一张退货单的多行可以分别上架/销毁
另外修了一处会导致编译失败的设计冲突:InboundCapable 与
WarehouseReturnCapable 原本都有 get(ctx, String) / query(ctx, String),
同一适配器实现两者时泛型擦除后签名冲突。退货侧改名为
getReturn / queryReturns。
ReturnView.setDisposition 换成 process(ReturnProcessCommand):
原方法只有整单 + 枚举,装不下「哪一行 + 换标新 SKU」。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
1d3ebce5ab
|
feat(yqn): 按 API 139 对接创建调拨单
上门 8 个接口都是单仓内动作,这个是第一个跨仓写操作:会同时改两个仓的库存。
- 路径 /transferoutboundplan/TransferOutboundPlanCreate →
/v2/transferOutboundPlan/create
- 新增 TRANSFER 能力位与 TransferCapable:直接建独立能力接口,不塞进
InventoryCapable.adjust —— 调拨是跨仓单据,不是单仓库存调整
- 门面 createTransfer() 强制经幂等守卫,幂等键
warehouseCode + transferRequestNo + create
新增模型:
- TransferCommand:调出/调入仓、两种运输类型、期望出入库日期、
FBA shipmentId/removeOrderId、收货地址、增值服务、标签、批次
- TransferOrder:双号 + 归一化状态
- TransferType / TransferStatus:运去哪的 0/1/2/3 与 16 个状态码各自映射,
未知归 UNKNOWN
三条本地校验:
- 期望入库日期不能早于期望出库日期
- 调拨出库类型必须给收货地址;仓到仓由仓自己处理
- inventoryType 只接受 0/1
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
7b459dfd23
|
Merge remote-tracking branch 'origin/feature/supplier-lingxing' into feature/supplier-lingxing
|
2 weeks ago |
lml
|
c6241dddc7
|
feat(xincang): 新增信仓三方仓模块与登录换 token
- GET /api.login?appkey=&secret= 换取客户级 token,token 放 query 参数,
不是 Authorization 头
- token_expire_time 按北京时间 yyyy-MM-dd HH:mm:ss 解析为 UTC expiresAt;
字段缺失按文档 2 小时兜底,格式非法直接失败
- TokenManager 按 appkey 缓存(同客户多仓共用一个 token),提前 10 分钟续期;
信仓无 refresh 接口,到期即重新登录
- XincangEnvelope 统一校验顶层 errno 与 rst.code,HTTP 401/403/429/5xx 照常分类,
trace_id 落到 platformRequestId
- 本期不声明任何 WarehouseCapability,业务能力后续逐个接入
- 附登录只读探针,默认跳过,凭据走 -Dxincang.probe.*
待核对:生产基址(文档只给测试地址)与限流值(文档未公开,暂按 2 req/s)。
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
29d41da00f
|
feat(yqn): 按 API 101 对接查询入库计划
- 路径 /inbound/InboundPlanQuery → /v1/inbound/getInboundPlanInfo
- 入参只有 orderNo,入库单号与来源单号都能传
- 补齐 create 之后空着的能力:get() 返回完整详情,query() 按单号查一条
入库单模型按响应重写:
- 新增 InboundStatus 枚举,把运去哪的 0/5/6/8/10/16/17/20/25/70/100
归一化;未知码归 UNKNOWN,不猜
- InboundOrder 补 estimatedArrivalAt / actualArrivalAt / shipper 四项 /
totalWeightKg / totalVolumeCbm / inventoryType / lines
- 新增 InboundOrderLine:计划 / 装箱 / 实收 / 可售 / 不可售五个数量分开存,
并给 quantityMatchesPlan() 供对账判断短少与溢装
两点保守处理:
- createdAt 留 null:响应里只有 estimateArrive / actualArrive /
firstReception,没有下单时间
- 状态码按精确匹配,不做包含判断:运去哪的码是整数枚举,模糊匹配会把
6(审核拒回) 误判成 16(收货中)
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
eea3161634
|
feat(yqn): 按 API 97 对接创建入库计划单
- 路径 /inbound/inboundCreate → /v1/inbound/createInboundPlan
- 响应回 data.inboundPlanOrderNo(字符串),直接作 providerInboundId
入库模型按文档重写,补齐此前缺的维度:
- InboundCommand 补 inventoryType(必填) / factoryBatchNo / currency /
三个日期 / 原产地 / 发货方四项 / 集装箱号 / 装箱 / 批次
- InboundLine 的 boxNo 换成 cost(采购成本影响仓侧库存成本)
- 新增 InboundCarton(箱规 + sid 归并物理箱)、InboundBatch(批次属性
开放式 key/value,各仓支持的 key 不同,不做枚举)
两条本地校验:
- 集装箱号必须是 4 位大写字母 + 7 位数字,传错仓侧直接拒
- expectArriveDate 不能早于 estimateArriveDate
两个显式放弃:
- logisticsType 固定 0:文档写明运去哪头程只支持 web 端,openapi 不开放
- 入库单查询未接:文档只给了创建接口,get/query 抛
UnsupportedCapability,不返回空页
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
2472cba6f0
|
feat(yqn): 按 API 107 对接批量库存查询
- 路径 /inventory/BatchQueryInventory → /v2/inventory/get_inventory_by_page
- 方法是 GET,但文档把参数写在 Body 里;按重复 query 参数下发
(query.warehouseCodes=a&query.warehouseCodes=b),待联调核对
- 响应是 Spring Data 分页结构,翻页以 data.last 为准
- 该接口的 code 是字符串,其它接口是数字;信封按数值解析,两种都能过
库存模型补齐 API 107 的维度:
- InventorySnapshot 补 inventoryType(可售/不可售) / parentSku / saleType /
standardQuantity / 箱套四个库存字段
- InventoryQuery 补 warehouseCodes / inventoryType
两条防护:
- warehouseCodes 必填;没给时用账户配置的仓,都没有直接拒绝,
空列表会把整个租户的库存都拉下来
- inventory_current 文档标为 string,按 BigDecimal 解析,脏值归 0
同步策略固定 FULL_PULL_DIFF:运去哪没有按时间增量查的接口。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
d0649fed38
|
feat(yqn): 按 API 133 对接结算明细,费用查询改用 FeeQuery
API 133 是「一个接口按条件查四种费用」,不是 Spec §6.2 设想的
settlements/orderCosts/rentDetails/accountFlows 四个方法:
- 路径 /fee/SettlementDetails → /v1/warehouse/operation/costs/detail
- 入参:saleOrderNo / billingTransNo / costType / sku / externalOrderNo /
snapshotStartDate / snapshotEndDate,全部可选
所以 WarehouseFeeCapable 收敛为单个 settlements(ctx, FeeQuery),删掉
orderCosts / rentDetails / accountFlows / estimate:文档里没有对应接口,
留着就是四个永远抛 Unsupported 的空壳。
新增 FeeQuery / WarehouseFeeType,映射层做三条文档约束:
- 空条件直接拒绝,避免无条件下拉全量
- 按日期查只支持仓储费,且区间不超过 30 天
- saleOrderNo 在运去哪是数字,非数字直接拒绝(传错类型仓侧静默查不到)
BillingDocument 按响应重写:补 feeName / feeType / settledAt / estimated /
saleOrderNo;estimated 由 settlementType 决定(1 实际 / 2 预估),
对账时必须把预估和实际分开,否则会把预估值当已发生成本。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
f144e26827
|
feat(yqn): 按 API 122 对接取消销售订单
- 路径 /saleorder/OrderCancel → /v1/saleOrder/cancel
- 入参只有 orderNo,没有 acceptCharge / cancelReason
- 响应只有 statusCode/status/code/message,没有 data
运去哪没有取消费概念,也没有取消预判。因此:
- cancel() 只发 orderNo,acceptCharge 在此仓不生效(字段保留给易达云那类
有收费取消的仓)
- 仓拒绝取消(已拣货/已出库)时业务码非 200,统一映射为
OutboundCancelBlockedException,而不是笼统的 PlatformBusinessException
- 删掉 toEligibility(),它依赖的 cancelType 字段在文档里不存在
CancelCommand 的注释同步说明 acceptCharge 只对有收费取消的仓有效。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
ac8a164982
|
feat(yqn): 按 API 128 对接订单详情
- 路径 /saleorder/FindOrderInfor → /v1/saleOrder/findOne
- 响应只有 code/message/data,没有 statusCode/status
- data 里没有顶层 carrier / trackingNo:运单在 shipmentPackages
按 API 128 改统一模型:
- OutboundOrder 补 lines / shipTo / exceptionCode / estimatedShippingFee /
paidAt / carrierCode / currency
- PackageResult 补 carrierServiceCode / erpSku / shippedQuantity
三个语义坑的处理:
- 运去哪没有订单列表接口,query() 只支持按单号查;不给单号直接拒绝,
避免被当成增量同步用
- shipmentPackages 里 packageFlag=1 是面单信息行,会与实际包裹同 trackingNo
重复出现,按 trackingNo 去重且实际包裹优先
- errorCode=unexception 视为无异常,避免带异常标记的空串流进业务
ShipTo 的必填校验从模型挪到适配器:「哪些字段必填」是仓方协议,
查询回来的详情本来就可能缺字段。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
89ed0101f9
|
feat(yqn): 按 API 123 对接创建销售订单
文档把出库下单的契约定死了,替换掉此前按命名习惯猜的字段:
- 路径 /saleorder/OrderCreate → /v1/saleOrder/create
- 响应只有 data.orderId(仓内部数字 id),没有字符串单号;
幂等结果引用改存这个 id
- 必填扩到 10 项:来源单号、完整收件地址、联系人电话、销售平台、商品行
OutboundCommand 补 API 123 需要的维度:
- salesPlatform 改必填,类型用渠道域的 Platform 枚举,由适配器映射到
仓方平台码。仓按平台做路由与面单归属,不给就猜错,所以宁可构造期失败
- 新增 carrierCode / shipServiceLevel / latestShipDate /
estimatedDeliveryTime / currency / packages
- ShipTo 补 addressLine3(运去哪要求地址最多三行)
新增 OutboundPackageSpec:多包裹拆单,尺寸 cm、重量 g、含包裹内 SKU 与
打包耗材编码。不传则由仓按默认规则打包。
未接的部分保持原样:FindOrderInfor / OrderCancel 仍是旧假设,
取消预判与包裹查询等查询类接口等文档再对齐。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
067d815888
|
feat(yqn): 接入商品创建/编辑(API 115 /v1/product/save)
按官方文档落三条此前只能靠猜的契约:
- 鉴权头确认是 x-api-key(原来猜的 token)
- 响应信封确认是 statusCode/status/code/message,code=200 成功;
空响应体或缺失 code 不再当作成功处理
- 商品路径确认是 /v1/product/save
新增 YqnProductMapper:统一 WarehouseProduct → SaveProductRequest。
customs 按“国家 + HS + 申报价值”整组下发,币种固定 USD;
没给全时整个 customs 不发。WarehouseProduct 在构造期就挡住半组字段。
WarehouseProduct 按 API 115 的必填项重写:packingType / 长宽高 / 重量 / SN
改为必填,单位写进字段名(cm、g),避免适配器之间靠注释约定换算。
出库相关的字段仍待打样核对(Spec §8.6 第 2/5/9 项)。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks 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
|
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
|
65e5460e0d
|
refactor(http): 删除从未被实现的 Signer 接口
签名参数往往要在构造 HttpRequest 之前算出来(领星要把业务参数、
access_token、app_key、timestamp 一起签名后拼进 query),事后补头的
sign(HttpRequest, ChannelSecret) 表达不了这种时序;签名落点也不统一
(query / header / body 内嵌 / 整包 hash)。实际实现都是静态工具类,
如 LingxingSigner。
README / GUIDE 中「实现 Signer」的接入指引同步改为写静态工具类。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
7886796a6b
|
fix: 修复合并后入库模块包路径与门面引用
|
2 weeks ago |
lml
|
e83fa60a25
|
Merge remote-tracking branch 'origin/feature/supplier-lingxing' into feature/supplier-lingxing
# Conflicts:
# channel/src/main/java/common/ecommerce/channel/capability/InboundReceiptCapable.java
# channel/src/main/java/common/ecommerce/channel/capability/InboundShipmentCapable.java
# channel/src/main/java/common/ecommerce/channel/capability/Inbounds.java
# channel/src/main/java/common/ecommerce/channel/sdk/ChannelSdk.java
# lingxing/src/main/java/common/ecommerce/lingxing/adapter/LingxingAdapter.java
# lingxing/src/test/java/common/ecommerce/lingxing/adapter/LingxingLiveSmokeTest.java
# testkit/src/main/java/common/ecommerce/shared/testkit/FakeDirectAdapter.java
# testkit/src/test/java/common/ecommerce/shared/testkit/SdkFacadeCallTest.java
|
2 weeks ago |
lml
|
57404c6fe8
|
feat(lingxing): 修正 AWD 入库时间解析与多平台订单分页下限,补齐店铺/订单/面单/入库探针
- fix(inbound): AWD 的 gmtCreate/gmtModified/shipBy 真实报文是 yyyy-MM-dd HH:mm:ss(无时区,按北京时间),
严格 ISO 解析会让整页货件映射失败;新增 InboundSupport.parseFlexible 做 ISO 优先 + 北京时间兜底
- fix(inbound): AWD 报文里 shipmentId(入库货件号)与 orderId(AWD 货件号)是两个字段,
前者落到 shipmentId、后者落到 shipmentNo,老报文缺 shipmentId 时回落 orderId
- fix(order): 多平台订单 length 下限 20(真机 pageSize=5 返回 code=102 length最小值为20),
适配器统一收窄到 [LingxingConstants.MIN_PAGE_SIZE, MAX_PAGE_SIZE]
- fix(order): FBM 列表确认只返回头部字段,注释写明金额与商品行必须调 getOrderDetail,DTO 同步说明
- test: 新增 FulfillmentProbeTest(probe 风格只读探针,覆盖店铺/订单/面单/入库)
- test: LingxingLiveSmokeTest 凭据改为 -Dlingxing.probe.* 系统属性,不再写死类内常量与 sid
- test: 新增 MultiPlatformOrderSourceTest、AmazonFbmOrderSourceTest,AwdCargoSourceTest 增加真实报文用例
- test: 新增 AWD 真实报文夹具 awdShipment/real-2026-11-06.json
验证:mvn -pl lingxing -am test(109 用例,0 失败,probe 默认跳过);
真实环境探针已跑通店铺/订单/面单/入库,AWD 与多平台订单报错均已消除。
|
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
|
6a8796cc0b
|
fix: 补齐包更名遗留的 package 声明与 GUIDE 示例
- IdempotencyGuardTest 的 package 由 common.ecommerce.idempotency
改为 common.ecommerce.shared.idempotency,与文件路径一致
- GUIDE 示例里的 import 与子包说明同步到 channel / shared
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 |
lml
|
25066e5295
|
test(lingxing): 补齐入库接口的门面、探针与冒烟测试
- FakeDirectAdapter 增加入库货件/接收明细能力与 Builder 数据,SdkFacadeCallTest 覆盖门面分页、查询校验与能力缺失
- LingxingInboundCapabilityTest 增加 CallRecord 断言(operation/outcome/resultCount/externalStoreId)
- 新增 InboundProbeTest,只读探针核对 FBT/WFS/AWD/FBA 的待核对参数,默认跳过
- LingxingLiveSmokeTest 增加只读入库冒烟,亚马逊 SC 额外拉 FBA 接收明细
|
2 weeks ago |
lml
|
138ffe05b5
|
docs(lingxing): 补入库查询的分页、时区与字段映射注释
只加注释:分页终点判定、北京时间转换、字符串数量回退、待核对字段说明,不改逻辑。
|
2 weeks ago |
lml
|
0a126986ce
|
Merge remote-tracking branch 'origin/feature/supplier-lingxing' into feature/supplier-lingxing
|
2 weeks ago |
chenchuchuan
|
802613ffff
|
test(lingxing): 新增 listing 联调探针,凭据改为系统属性传入
- ListingSmokeProbeTest:从 ChannelSdk 门面逐平台拉一页 listing,
打印统一模型关键字段并用样本回查平台 SKU / 本地 SKU
- ListingParamProbeTest:核对 Target 时间窗上限、Temu 窗口边界等参数形态
- SearchFieldProbeTest / ShopListProbeTest:去掉硬编码的真实凭据,
改从 -Dlingxing.probe.appKey / -Dlingxing.probe.appSecret 读取;
未提供时 assumeTrue 跳过,避免本地与 CI 默认打真机
- SearchFieldProbeTest 的 TARGET_STORE_ID 置空(store_ids 非必填)、
样本为空不再断言失败、单个编码报错不中断整轮扫描
所有探针仍默认跳过且只做查询。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
4c75503e85
|
feat(lingxing): 接入 FBT/WFS/AWD 入库货件与 FBA 接收明细查询
|
2 weeks ago |
chenchuchuan
|
04bea3ec5e
|
test(lingxing): 补 SDK 层 listing 调用测试,契约测试对齐实测参数
- 新增 LingxingSdkListingCallTest:从 ChannelSdk 门面调领星 listing,
覆盖能力检查、snake_case 搜索参数、Target 时间窗三字段、审计记录
- 各平台契约测试同步实测结论:沃尔玛/eBay 改断言 snake_case、
多值搜索显式失败;Target 补时间窗与多值校验;Temu 补 30 天截断;
SHEIN/TikTok 补本地 SKU 编码 8
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
c33597fae9
|
fix(lingxing): 修正 listing 搜索参数名与时间窗,按真机实测对齐
用只读探针实测 2026-11 领星各平台 listing 接口(传不存在的 SKU 做对照),
发现三处会静默出错的问题:
- 沃尔玛 / eBay:camelCase 的 searchField 被平台静默忽略并返回整页,
必须用 search_field / search_single_value;多值 search_values 同样无效,
改为单值专用方法,传多值时抛 ValidationException
- Target:时间窗三字段必须同时出现且日期只接受 Y-m-d,单边或带时分秒都 400;
改为补齐两端 + 日期格式,并用 listing_time_field=2(更新时间)
- Temu:时间窗跨度 31 天直接 500,改为按 30 天截断并补齐两端
搜索编码实测结论:沃尔玛 1/3、eBay 1/3、AliExpress 1/5、Temu/SHEIN/TikTok 9/8、
Target 1(=msku,2=item_id,4≈标题)、Amazon SC 字符串 seller_sku/sku;
Target 本地 SKU 在该 app 下恒为空,保持显式不支持。
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 |
chenchuchuan
|
62150c64ba
|
refactor(lingxing): 删除 Shopify 平台,Target 独占 listing 接口
Shopify 与 Target 走同一个领星接口(/basicOpen/multiplatform/shopify/variantList),
DTO 字段完全一致,保留两套实现属于重复代码。
- 删除 platform/shopify/ 整包(SubPlatform + DTO + ProductSource,约 520 行)
- Platform.SHOPIFY 枚举移除
- LingxingSubPlatformDefaults 不再注册 Shopify
- LingxingConstants:10002(SPF-*)改为 CUSTOM,等确认业务平台后再补
- LingxingProductSearchMapper.shopify → target,本地 SKU 仍显式不支持
- 适配器 platforms() 去掉 SHOPIFY
领星接口路径里的 shopify 是历史命名,与业务平台无关,枚举名 LISTING_SHOPIFY 保留。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
73ba122d04
|
fix(observability): 修正幂等审计的 stage 错位与 capabilities 上下文
跑通 core 全量测试后发现 12 个失败,其中 11 个是提交 e889cbc / 7ce2468
引入的真实缺陷,本次一并修正。
生产代码:
- WriteAudit.record 签名改为「单一额外键值对」,businessKey / providerKey /
stage 三个字段由 scope 与 stage 参数统一生成,调用方无法覆盖。
此前 record 的 stage 与 params 里的 stage 来自两个入口,不一致时审计记录
与实际裁决脱节,出现过 CLAIMED 冒充 REPAIRED_FROM_PROVIDER_KEY、
FAILED 冒充 FAILED_RETRYABLE
- WriteAudit 参数拼装移出 try:此前校验抛出的 IllegalArgumentException
被观察者兜底 catch 吞掉,导致审计记录静默丢失
- ChannelContext 新增 ofAccount(account, requestId, clock):capabilities 这类
不联网的调用用它埋点。此前误用 of() 传入 null connection,直接 NPE
- endpointBaseUrl() / secret() 在无连接时抛 IllegalStateException,
不再是 NPE
- 删除 WriteAudit.params 的公开重载,从源头消除双 stage 入口
测试:
- WriteAuditTest.paramsCarryBothKeysAndStage 改为通过真实执行校验 params
- 新增 extraKeyCannotOverrideDerivedFields 覆盖字段防篡改
- RequestIdAndCoverageTest 修正 cachedViewCanRefreshRequestIdPerCall 的期望值:
4 次调用中前两次共用缓存 ID,不同 ID 数是 3 而不是 4
- missingAdapterIsObservedAsFailure 去掉未被使用的多余 SDK 实例
验证:core 模块 62 个用例全部通过。
|
2 weeks ago |
lml
|
7ce2468d75
|
test(observability): 补 Slf4jCallObserver 与失败路径测试
- Slf4jCallObserver 抽出 successLine / failedLine,日志渲染与绑定解耦
- 新增 Slf4jCallObserverTest、WriteAuditTest、RequestIdAndCoverageTest
|
2 weeks ago |
lml
|
e889cbc40f
|
feat(observability): 幂等层审计与每次调用独立 requestId
- IdempotencyGuard 注入 CallObserver,EXECUTED / 回放 / 崩溃窗口修复 / 并发冲突 /
终态失败 / 跨 provider 冲突 / 可重试与不可重试失败全部留痕
- 新增 WriteAudit,操作名 writes.<action>,params 带 businessKey / providerKey / stage
- ChannelContext 增加 withRequestId / ofKey,门面各视图可刷新链路 ID
- ChannelSdk 增加 requestIdSupplier;capabilities 纳入埋点;build 时打启动自检日志
|
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
|
7747125099
|
fix(lingxing): 保留平台 request_id 并在审计中补 platformCode
- ChannelException 新增 platformRequestId,与本地链路 requestId 分开
- LingxingEnvelope 解析响应顶层 request_id(兼容 requestId)并写入异常
- CallRecord 分别记录平台 request_id 与业务码 platformCode
- 失败日志补 platformCode,并对平台文案做换行清洗与截断
- LingxingCallObserverTest 断言 3001008 与平台 request_id 不被本地 ID 覆盖
验证:mvn -q -pl core,lingxing -am -Dtest='LingxingCallObserverTest,LingxingEnvelopeTest' -DfailIfNoTests=false test
|
2 weeks ago |
lml
|
98330ca87c
|
test(observability): 覆盖门面日志与领星调用链路
- 新增 CallObserverTest:成功/失败记录、观察者异常隔离、默认 NOOP、UTC 与本地时间转换
- 新增 LingxingCallObserverTest:用 RecordingTransport 走真实 LingxingAdapter,
覆盖成功、限流失败、无平台码三种场景
|
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 |
lml
|
d4f334ff29
|
test(lingxing): 冒烟支持无平台码查询并打印真实平台
- pullsOnePageOfOrders 支持 PLATFORM_CODE 置 null / 0:只按 store_id 查询
- 无码时店铺列表不带 platform_code,返回全部店铺并打印真实 platform_code / platform_name
- 无码时业务平台兜底 Platform.CUSTOM,保证能力路由可用
- 凭证改为从环境变量读取,不再硬编码
|
2 weeks ago |
lml
|
6e7c15ee3f
|
fix(lingxing): 兼容订单标签字符串形态并让店铺返回真实平台名
- LingxingOrderTagDto 增加兼容反序列化器:order_tag 是对象,
pending_order_tag / exception_order_tag 可能是纯字符串(如 ["未分配物流"])
- 字符串形态只填 tagName,tagNo / tagType 留空;对象形态保持原映射
- 反序列化器挂在字段 contentUsing 上,避免类级注册导致回读递归
- SubChannel.attributes 带上领星 platform_name
- 声明为 Platform.CUSTOM 的子平台按响应 platform_code 反推,不再统一显示 CUSTOM
|
2 weeks ago |
chenchuchuan
|
c354109ec8
|
merge: 合并同事的亚马逊长尾平台与 WMS 能力
远端新增(e13d86a..14b0906):
- 长尾子平台:Wayfair / Mirakl / Target / BestBuy / AEPH / Michaels / Echo /
LOS-DLI-US / Custom
- WMS:销售出库单、物流面单、审核发货、编辑订单
- 多平台订单支持领星专有过滤条件(LingxingOrderFilters)
- MultiPlatformShopSource 支持显式传入业务平台(长尾平台无法按平台码反推)
- 亚马逊 SC 订单/结算 DTO 扩展
冲突解决:
- LingxingApi:两侧条目全部保留(售后 + WMS 四个接口)
- LingxingConstants:保留实测 platform_code 表,同时采纳远端的
Wayfair=10010、AliExpress=10029/10030、Shopify=10002
- LingxingAdapter:implements 与能力并集合并;supports() 采用「以账户 platform 为准」
- LingxingSubPlatformDefaults:恢复 ShopifySubPlatform 注册,去掉重复的 Target 注册
- TargetSubPlatform:保留本分支的 outboundSource,商品复用 Shopify 的变体接口
- PlatformInfoDto:合并两边的注释
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
c9d60153c7
|
test: 每个平台补 listing / 售后契约测试,新增 SDK 门面调用测试
testkit(测试支撑):
- RecordingTransport:记录全部请求、按 URL 路由响应;令牌请求自动返回最小成功响应,
业务请求可断言
- JsonFixture:classpath 夹具加载
- Responses:恢复快捷响应构造
- FakeDirectAdapter:补 AfterSaleCapable,支持 afterSales(count)
lingxing(每平台一套):
- 9 个 listing 测试:walmart / ebay / temu / shein / tiktok / target /
aliexpress / amazon sc / amazon vc
覆盖请求参数(店铺、时间窗、分页、搜索编码)与响应映射
- 售后:ListSource(请求构造、过滤、上限、时间窗校验、行展开)+ Mapper(10 例)
- LingxingTestSupport:测试公共样板(账户/调用/断言)
- 夹具:每平台一套 success.json
testkit(门面调用):
- SdkFacadeCallTest:products / afterSales / salesOrders 的完整调用、分页、
参数校验、能力检查、账户缺失等错误路径
清理:
- 删除 ProductCallExampleTest、SdkCallGuideTest 与两份 AmazonScProductLiveTest
(已被上述测试覆盖)
- 探针改为 -Dlingxing.probe=true 才运行,避免真实凭证让 mvn test 变红
修复:
- TargetProductSource 的 store_ids 被误注释,恢复
- AmazonVcProductSource 传搜索条件时显式抛异常,不再静默忽略
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |