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
|
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
|
8e7fbb294a
|
test(http): TokenManager 等锁超时可注入,测试从 5s 降到 50ms
生产默认仍是 50ms 轮询 / 5s 超时;新增仅测试可见的构造器,
避免 lockHeldByAnotherInstanceIsNotBrokenThrough 真等 5 秒。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
eeb0b71efa
|
feat(http): TokenManager 按设计文档 9.1 补齐五条要求
- 按 AccountKey 隔离缓存:缓存键由适配器按账户维度拼出
- 提前续期:保留原有 needsRefresh 逻辑
- LockProvider 防击穿:拿不到锁时轮询等待(50ms × 最多 5s),
期间重读缓存;对方刷成功后直接复用,超时才抛 AuthException
- 刷新失败不返回旧 token:不做宽限兜底,异常直接抛给调用方
- 日志只打指纹:沿用 AccessToken.fingerprint()
- 人工失效/重授权:forceRefresh 删缓存后重取
领星侧 tokenKey 从 externalStoreId 改为 appKey:领星 token 按 app 发放,
同 app 多店铺应共用一个 token,避免重复换 token 烧配额。
新增 TokenManagerTest,覆盖缓存、提前续期、强制刷新、失败不留旧值、
锁被占用时不重复刷新、指纹脱敏六类场景。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
37cc2dbc58
|
fix(lingxing): 令牌接口按官方文档修正出入参
原实现与文档不符,联调时必然失败。
入参:
- Content-Type 由 application/json 改为 multipart/form-data(文档要求,curl 用 --form)
- HttpRequest 新增 contentType 字段,OkHttpTransport 按类型选择 MediaType;
未指定时保持 JSON,不影响其它请求
出参:
- 先校验业务码 code == "200",失败抛 AuthException 并带 msg(HTTP 层仍返回 200)
- expires_in 按文档为秒,expiresAt 改用注入的 Clock 计算(原来用 Instant.now())
- 删除 data.0.access_token / 顶层 access_token 的猜测性兜底
- 缺 access_token 时抛带上下文的 AuthException,而不是 NullPointerException
测试:
- 新增 LingxingTokenClientTest,覆盖 multipart 构造、成功解析、业务错误码、
缺 token、HTTP 5xx 五条路径
- token 夹具改为文档示例结构(code 为字符串 "200"),新增 auth_failed 夹具
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
3140aaf328
|
chore: 删除重构遗留的 apelet 旧包目录
包名迁移时旧路径下的 79 个文件未被移除,形成新旧两套源码并存。
旧文件内容仍是改名前版本(包声明为 apelet.common.ecommerce),
且与新路径文件功能重复。删除后 src 下仅保留 common.ecommerce。
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
|
d87d9dec53
|
feat(http): HTTP 传输、JSON 编解码、签名与令牌管理模板
- HttpTransport 接口 + OkHttpTransport(连接 5s / 读 30s / 统一 UA)
- HttpRequest / HttpResponse 保留原始 header 与 body 供留痕
- JsonCodec + JacksonJsonCodec(点路径取值、数组反序列化)
- Signer 接口:签名差异收敛到各适配器
- TokenManager:按账户隔离、提前续期、LockProvider 防击穿、
刷新失败不返回旧 token、日志只打指纹
- Responses:401→Auth、429→RateLimit(带 Retry-After)、5xx→Transient、
其他 4xx→Validation
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 |