chenchuchuan
|
5962988f86
|
feat(edayun): token 接口真机验证通过,按实际报文修正解析
真机调用(PR 环境):
POST https://test.omniselling.com.cn/saas-service/openapi/microService/oauth/token
{"client_id":"openapi-test","client_secret":"123456"}
→ HTTP 200 {"access_token":"0dabff46-...","token_type":"bearer","scope":"server"}
文档与实际不符的两处,已按实测调整:
1. 响应是**扁平结构**,没有 code、没有 data 包裹。
原来强制要求 code,会把成功当失败。改为:缺 code 不算失败,
交给「有没有 access_token」判断;显式给了非 200 的 code 才判失败。
2. 响应**没有有效期字段**(文档说「永久,建议留窗口刷新」),也没有
refresh_token。expiresAt 改为明确的估算值语义:让 TokenManager 定期
重登一次,不是真的到期。
DTO 补了顶层 access_token / token_type / scope,data 保留为兼容分支。
探针 EdayunTokenProbeTest 实跑结果:token 取到(脱敏输出)、
tokenType=bearer、剩 7200 秒、refreshToken=null。
测试 13 个(新增 acceptsFlatShapeWithoutCode 固化实测形态;
missingCodeIsRejected 改为 missingCodeWithoutTokenIsRejected,
报「no access token」而不是「no code」)。
全量 535 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
e522c08377
|
feat(edayun): 对接获取 token(POST /oauth/token)
按文档实现鉴权第一段:
- auth/EdayunTokenClient:POST /oauth/token,body 用 client_id / client_secret
(下划线风格照文档),无业务请求头
- http/EdayunRequestFactory:构造 token 请求;另备了业务请求构造(token / appKey /
timestamp / sign 四个头)与 sign() = MD5(body + "." + appSecret)
- adapter/EdayunAdapter.token(ctx):走 TokenManager 缓存,按 appKey + clientId 维度
- 工厂构造函数接收 TokenStore / LockProvider / Clock,与信仓同构
**文档只给了 code 取值(200/500/503/504),没给响应体结构**,所以做了兼容:
优先 data.access_token + data.expires_in,其次 data.expiry(绝对时刻),
再其次顶层 token;都没有则失败并带出截断的原始报文,不猜。
有效期同样三级兜底,最后按 2 小时(常量里标了「待联调确认」)。
错误分级:
- 500 明确失败,不重试
- 503 网关无效 / 504 超时,标记 retryable
- HTTP 非 2xx 单独处理,5xx(除 504)可重试
测试 12 个:请求形状、三种响应形态、无 token、500 不可重试、
503/504 可重试、缺 code、非 2xx、凭据缺失不发请求、MD5 签名(独立实现对照)、
空 body 签名。
全量 533 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
lml
|
85e1fed8d4
|
docs(warehouse): 新增信仓接入汇总文档
参照 docs-warehouse/yqn/README.md 的结构,补一份信仓的:
- 基本信息:测试端点、query token 鉴权、2h 无 refresh、客户级 token、
成功判定(errno + rst.code)、北京时间、英寸/磅/美元
- 接口清单:19 个已对接接口与能力位,另列 3 个已声明常量但未接入的
- 业务流程:出库 / 转运 / 头程预报 / 商品四条链路的分步说明
- 枚举映射:订单 12 码、转运 8 码、预报 10 码、order_type 两套字典
并标注转运「列表与详情码表不一致」的差异
- 字段口径:ckh 唯一、amount 必填美元、po / rfc_sku_count 兜底规则、
is_pallet 必填、库存单仓限制等 13 条
- 平台限制与协议待核对:生产域名缺失、限流未公开、
calculate_order_v3 的 GET + JSON body 与 OkHttp 冲突
- 联调探针:三个探针的运行命令与全部可选属性,标明哪些会留数据
Co-Authored-By: Claude Code <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
ae25e73b50
|
feat(edayun): 新建易达云适配器骨架
按 docs-warehouse/onboarding-checklist.md 阶段 1 搭好模块:
- warehouse-sdk-edayun:pom、注册到根 modules
- EdayunConstants:端点 / 限流(带 TODO 占位,等文档)
- EdayunAdapter / EdayunAdapterFactory:类型就绪,能力位为空
- dto / enums / http / webhook 四个包的 package-info 写明约定,
后续按约定往里填
骨架阶段的行为:任何业务调用抛 WarehouseUnsupportedCapabilityException。
未实现的能力不声明——声明了就必须有实现,否则调用方看能力位会以为能用。
测试 EdayunAdapterTest(5 个):适配器标识、能力位为空、注册后可解析、
未实现能力显式拒绝、能力查询不触发真实 API。
文档 docs-warehouse/edayun/README.md 记了当前状态和 8 项待确认
(文档、测试环境、鉴权、限流、能否走写、回调、费用口径、库存同步)。
全量 510 个测试通过。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
a82379cc07
|
docs: 接入清单补充「出入参怎么处理」和「枚举怎么处理」
两节详述,都是这段时间实际踩出来的规则:
出入参(阶段 2.5):
- 三层各管什么:DTO 只反序列化、Mapper 做换算与映射、标准模型不认识任何仓
- 入参四种情况分别怎么处理(直搬 / 换算 / 码值映射 / 平台没有)
- 出参必做四件事:rawStatus 必填、sourceProvider 必填、认不出归 UNKNOWN、
平台没给的不伪造
- 平台有模型没有 / 模型有平台没有 分别怎么标注
- 子结构别图省事重复建(退货 Attachment 合并的教训)
枚举(阶段 2.6):
- 为什么必须两层(只放 core 会认识仓方码,只放适配器宿主没法统一 switch)
- 底层枚举规则:code 步长 10、UNKNOWN 固定 0、只追加不合并、不含仓方码
- 平台枚举规则:精确匹配不用 contains、未知归 UNKNOWN、容器类型按原样、
提供反向 codeOf
- 三套码表不能混(运去哪退货三套)
- 状态码依赖上下文时把 (type, status) 一起带出去
- 什么时候不建枚举(>50 个透传、按中文名归类、只展示用)
- 枚举测试必须覆盖什么(全量映射 / 未知兜底 / 精度陷阱)
文档索引同步更新。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
bedb52e6a1
|
docs: 新增「接入新三方仓操作清单」
按运去哪 / 信仓的实践整理成 6 个阶段,每步带验收标准:
0. 先确认文档、测试环境、能否走写操作
1. 模块骨架(目录结构 + 注册 + 别漏 callObserver)
2. 每个接口的 6 步固定动作(DTO / Mapper / 平台枚举 / Capability /
门面 observe / 测试)
3. 真机验证:只读探针 + 全链路探针,重点核对参数名/成功码/单位
4. 回调:实现 WarehouseWebhookCapable + 确认时间戳单位与响应体
5. 收尾:文档、平台限制标注、待确认清单
附「踩过的坑速查」10 条,都是这段时间实际踩到的。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |
chenchuchuan
|
a4cfd6cbfe
|
docs: 新增 docs-warehouse/ 三方仓文档
四篇:
- README.md 索引
- architecture.md 分层、枚举分层、能力矩阵、幂等、SPI、设计约定
- callback.md 回调链路、出参模型、验签、宿主要做什么、四个注意点
- notes.md 通用注意事项(写操作/状态/时区/单位/字段口径/测试)
- yqn/README.md 运去哪接入汇总:19 个接口、业务流程、真机联调结论、
平台限制、字段口径、两套码表、单位、探针用法
运去哪这篇记录了真机验证的结果,包括 4 处文档与实际不符
(库存/物流产品的参数名、仓库目录的成功码、运费试算无 code 字段)。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 week ago |