You can not select more than 25 topics
Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
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 |
| .. |
|
README.md
|
feat(edayun): 新建易达云适配器骨架
|
1 week ago |
易达云(EDAYUN)接入
当前状态:骨架
| 项 |
状态 |
| 模块 |
✅ warehouse-sdk-edayun 已建、已注册 |
| 适配器 / 工厂 |
✅ 类型就绪,能力位为空 |
| 接口 |
⬜ 等文档 |
| 回调 |
⬜ 等文档 |
| 真机验证 |
⬜ 等测试环境 |
骨架阶段的行为:任何业务调用都会抛
WarehouseUnsupportedCapabilityException——这是有意为之,不返回空集合。
待确认(问易达云)
| # |
要确认 |
| 1 |
接口文档(含回调) |
| 2 |
测试环境:域名、凭证、测试仓、测试 SKU |
| 3 |
鉴权方式:固定 token / 签名 / OAuth?是否需要换 token 与刷新? |
| 4 |
限流:每秒许可数、单日配额 |
| 5 |
能否在 PR 环境走写操作(建单 / 取消 / 销毁),决定探针设计 |
| 6 |
回调:验签算法、时间戳单位、响应体格式、是否按路径区分 |
| 7 |
费用口径:是否有费用类型码(运去哪只有中文名) |
| 8 |
库存同步:支持按时间增量还是只能全量 |
骨架已定的部分
warehouse-sdk-edayun/
├── pom.xml
└── src/main/java/common/ecommerce/edayun/
├── EdayunConstants.java 端点 / 路径 / 限流(带 TODO 占位)
├── adapter/
│ ├── EdayunAdapter.java 能力位为空,未实现能力不声明
│ └── EdayunAdapterFactory.java
├── dto/package-info.java 一个接口一个文件
├── enums/package-info.java 平台枚举约定
├── http/package-info.java 信封校验约定
└── webhook/package-info.java 回调约定
测试:EdayunAdapterTest(5 个)验证类型接对、能力位为空、
未实现能力显式拒绝、注册后可解析、能力查询不触发真实 API。
接下来怎么推进
按 onboarding-checklist.md:
- 拿到文档后补
EdayunConstants 的路径常量
- 按接口逐个补
dto/ + adapter/XxxMapper + enums/(阶段 2 的 6 步)
- 写只读探针 → 真机验证 → 全链路探针
- 补回调实现
- 更新本文档
已知的坑(从运去哪/信仓带来的经验)
| 坑 |
应对 |
文档参数名可能带 query. 前缀而实际不带 |
真机验证时必须核对 |
有些接口没有 code 只有 status |
信封校验要兼容两种 |
| 文档示例常是自动生成的占位符 |
不看示例值,看真机返回 |
| 单位可能未标注 |
真机验证量级(kg vs lb 差 2.2 倍) |
| 状态码可能依赖上下文(单据类型) |
(type, status) 一起带出去 |