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): 新建易达云适配器骨架 1 week ago
..
README.md feat(edayun): 新建易达云适配器骨架 1 week ago

README.md

易达云(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:

  1. 拿到文档后补 EdayunConstants 的路径常量
  2. 按接口逐个补 dto/ + adapter/XxxMapper + enums/(阶段 2 的 6 步)
  3. 写只读探针 → 真机验证 → 全链路探针
  4. 补回调实现
  5. 更新本文档

已知的坑(从运去哪/信仓带来的经验)

坑 应对
文档参数名可能带 query. 前缀而实际不带 真机验证时必须核对
有些接口没有 code 只有 status 信封校验要兼容两种
文档示例常是自动生成的占位符 不看示例值,看真机返回
单位可能未标注 真机验证量级(kg vs lb 差 2.2 倍)
状态码可能依赖上下文(单据类型) (type, status) 一起带出去