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
|
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
|
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 |
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
|
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 |
chenchuchuan
|
20d6bbe975
|
refactor(lingxing): 搭子平台分派骨架,删除全部假数据
结构:
- 新增 LingxingApi 枚举:路径 + 限流,一条路径只写一次
- 新增 platform/ 包:LingxingSubPlatform 接口、LingxingSubPlatforms 注册表、
LingxingCall 调用上下文、walmart/WalmartSubPlatform 首个实现
- LingxingAdapter.pull 改为按 Platform 分派,supports 委托子平台
删除假数据:
- LingxingApi 里凭空猜测的 SHOP_LIST_* / PRODUCT_LIST_* 路径
- LingxingAdapter.listSubChannels 由账户拼出的假子渠道,改为显式抛异常
- LingxingConstants 中与 LingxingApi 重复的路径与限流常量
- README / GUIDE 中已删除的 FakeTransport、Fixtures 相关内容
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
54877562d1
|
refactor(sdk): 连接信息改由调用方每次传入,SDK 不保存
端点与凭据此前固化成常量或注入的 SecretProvider,等于 SDK 在替宿主保存连接配置。
现在改为调用方每次调用显式传入:
- 新增 ChannelConnection(endpointBaseUrl + ChannelSecret)
- ChannelContext 持有 connection;新增 endpointBaseUrl() / secret()
- ChannelSdk.salesOrders(key, conn) / products(key, conn) 必须传连接
- LingxingAdapter 构造函数不再接收 baseUrl 与 SecretProvider
- LingxingRequestFactory 的 baseUrl 改为每次 post 传入
- LingxingTokenClient.fetch(baseUrl, appId, appSecret)
- ChannelSecret 增加 endpointBaseUrl:TokenManager 的 refresh 回调只拿得到凭据对象
- LingxingConstants.DEFAULT_BASE_URL 改名 PRODUCTION_BASE_URL,明确仅作参考/测试常量
TokenManager 仍按设计文档 9.1 管理 token 生命周期(缓存、提前续期、防击穿、
失效重取),token 存储仍走宿主 TokenStore SPI——文档没要求 SDK 自己存。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
8560c2ea47
|
build(lingxing): DTO 使用 Lombok 生成访问器
两个领星 DTO 是纯数据容器,访问器占 47 行样板代码。改用 @Getter/@Setter 后:
- LingxingOrderDto 196 → 82 行
- LingxingOrderItemDto 88 → 40 行
范围限定在 lingxing/dto:core 的领域模型是不可变 + Builder,不使用 Lombok。
依赖 scope=provided,不进宿主运行时。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
b694116aa6
|
build: Maven groupId 改为 ecommerce
Java 包名去掉 apelet 前缀后,Maven 坐标同步对齐。
- 根 pom 与四个子模块的 groupId、parent、依赖坐标
- GUIDE 第三章示例中的 groupId
- README 移除「groupId 待处理」事项
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
ff9ec456c2
|
refactor: 包名去掉 apelet 前缀并按职责拆分 model 子包
- 包路径 apelet.common.ecommerce → common.ecommerce(四个模块的 main/test 全量迁移)
- model 拆为 account / order / product / support 四个子包,枚举留在根包
- 同步更新 README 包结构与导入路径
行为无变化,仅重命名与目录调整。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
9341181936
|
feat(core): ChannelSdk 门面、ProviderResolver 与能力视图
修复空壳门面可被 build 出来的问题:
- ChannelSdk.build() 强校验 accountRepository、clock、至少一个适配器,
缺项直接抛 IllegalStateException,不再返回不可用的空对象
- 同一 provider+platform 重复注册适配器时报错
- ProviderResolver:按 AccountKey 解析,无适配器时显式失败
- 能力视图 SalesOrders / Products:调用前做能力检查,
缺失抛 UnsupportedCapabilityException
- CapabilityReport + AdapterCapabilityReport:逐项询问 supports(),
聚合器可给出子平台级精确结果
- 支持 register(AdapterFactory) 与 register(Adapter) 两种注册方式
- ChannelSdkTest 9 个用例覆盖 build 校验、路由、能力检查
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
3f0d424dcd
|
docs: README 补充包职责、调用方式与扩展方式
- 一、包职责:model/capability/error/sdk/sync/spi/http/testkit/lingxing
逐项说明,标注 UnsupportedCapabilityException 与同名 Responses 的坑
- 二、标识体系:canonicalKey / sourceKey / 双锁幂等键的使用
- 三、调用方式:单次查询、SyncEngine 增量同步、门面目标形态(标注未实现)、
能力检查
- 四、扩展方式:新增直连平台 7 步、新增聚合器、新增能力、新增 SPI,
以及扩展红线
- 五、测试:分层、夹具约定、FakeTransport 写法、执行命令
- 六、待办与待核对清单
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
3b8c99d9b1
|
chore: 初始化 common-ecommerce 多模块骨架
四个模块:core / http / testkit / lingxing。
JDK 1.8 编译,依赖版本在 parent 统一管理,
core 仅依赖 slf4j-api,保证无第三方运行时耦合。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |