chenchuchuan
|
2cb045fda9
|
test(lingxing): 亚马逊 SC 商品接口真实环境测试
- AmazonScProductLiveTest:带时间窗与不带时间窗两种拉法
- 顶部常量填 AppID / AppSecret / SID,未填时 Assumptions 跳过
- 打印脱敏请求与响应,便于核对字段映射
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
71a451f3b9
|
feat(sdk): listSubChannels 收 ChannelContext,新增 subChannels 门面与操作手册
- AggregatorCapable.listSubChannels 改为 (ChannelContext),
此前只收 ChannelAccount,拿不到端点与凭据,无法真实调店铺接口
- ChannelSdk.subChannels(key, conn):聚合器子店铺列表入口
- LingxingAdapter.listSubChannels 分派到子平台的 shopSource
- 新增《操作手册.md》:依赖、连接信息、订单/商品/店铺、增量同步、
写操作幂等、异常对照、SPI 清单
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
c1b283fbeb
|
feat(lingxing): 拆分能力 Source,接入亚马逊 SC 店铺与 Listing
结构(避免单个平台类随能力增长膨胀):
- LingxingSubPlatform 瘦成能力组合入口:orderSource / productSource / shopSource
- 新增 platform/order|product|shop 三个能力接口
- 沃尔玛订单迁到 walmart/order/WalmartOrderSource
- AmazonScSubPlatform 组合 AmazonShopSource + AmazonProductSource
- LingxingAdapter 实现 ProductCapable,按子平台分派
接口(官方文档核对):
- LingxingApi 新增 SHOP_LIST_AMAZON_SC (/erp/sc/data/seller/lists, GET, qps 1)
- LingxingApi 新增 LISTING_AMAZON_SC (/erp/sc/data/mws/listing, POST, qps 1)
- LingxingRequestFactory 增加 get(...):GET 无业务参数时 query 只带 app_key/timestamp/sign
- LingxingCall 增加 get(...) 与 execute(...)
映射要点:
- 店铺:sid 作为 externalStoreId,platform_code 10001
- Listing:seller_sku 作为 platformSku(参与 canonicalKey)
- listing_update_date 是零时区时间,按 UTC 解析
订单接口未核对,亚马逊暂不声明订单能力。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
782225fe32
|
feat(lingxing): 令牌续约接口
按官方文档 /api/auth-server/oauth/refresh 实现:
- 表单 appId + refreshToken,multipart/form-data
- 每个 refresh_token 只能使用一次,响应返回新的 refresh_token
- 成功码 "200",失败时 HTTP 仍 200,靠 code 区分
LingxingAdapter 的刷新策略:
1. previous 有 refresh_token → 走续约
2. 续约抛 AuthException → 退回 appId + appSecret 全量换新
3. previous 为空(首次/被 forceRefresh 删除)→ 全量换新
顺带清理:
- LingxingApi 新增 TOKEN_REFRESH
- 删除 LingxingAdapter 中已迁往子平台的 buildOrderListBody / signedRequest
- 删除相应未使用 import
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 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
|
89f29d7767
|
refactor(lingxing): 按职责拆分 adapter / auth / http / mapper / dto 五个包
- adapter:LingxingAdapter、LingxingAdapterFactory(入口)
- auth:LingxingTokenClient(换 token)
- http:RequestFactory / Signer / Envelope / RateLimiter(出网与响应判定)
- mapper:LingxingOrderMapper(DTO → 统一模型)
- dto:领星原始报文结构(不变)
- 根包只留 LingxingConstants
跨包使用后 RateLimiter / RequestFactory 的构造器与 post/acquire 提升为 public。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
71389aae5d
|
test(lingxing): 冒烟测试改为直接填常量,不再读环境变量
占位常量未填时用 Assumptions 跳过,不会拿占位串去打真实接口。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
f6d301b16d
|
test(lingxing): 移除假响应测试,保留真实环境冒烟
按要求只测真实接口,删除依赖录制报文的部分:
- LingxingAdapterTest / LingxingTokenClientTest / LingxingOrderMapperTest
- fixtures/lingxing 下全部夹具
- testkit 的 FakeTransport / Fixtures / Responses
保留 LingxingLiveSmokeTest(未配环境变量整类跳过),
以及不涉及网络用例(Signer / Envelope / RateLimiter / RequestFactory)。
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 |
lml
|
703694c3df
|
fix(lingxing): 按真实响应重写订单 DTO 与字段映射
真实 /pb/mp/order/v2/list 响应与文档摘录不一致,原 DTO 字段名全部落空,
channelOrderId 为 null,导致 SalesOrder 构造抛 NPE。
- 订单字段改为 global_order_no / amount_currency / status /
item_info / platform_info / transaction_info
- 平台单号从 platform_info[] 取,合并单排序后取第一个,保证 canonicalKey 稳定
- 收货国家取 platform_info[].store_Country_code
- 下单时间取 global_purchase_time,缺失时回落 platform_info[].purchase_time
- 金额清洗币种符号与千分位(¥49.16 → 49.16)
- 夹具与映射测试按真实结构重写
|
3 weeks ago |
lml
|
2bc5da043a
|
feat(lingxing): 按 2026 版官方算法重写签名并抽出统一请求层
签名:
- 签名范围改为「业务参数 + access_token + app_key + timestamp」,按 key 升序拼接
- MD5 输出 32 位大写,再用 appId 做 AES/ECB/PKCS5Padding 加密并 Base64
- 集合参数先 JSON 序列化再参与签名
- appId 不是 16/24/32 字节时直接抛 IllegalArgumentException,不静默补齐
请求层:
- 新增 LingxingEnvelope,业务错误看 body.code,映射限流/鉴权/业务异常
- 新增 LingxingRateLimiter,按接口路径分桶,订单列表 10 req/s
- 新增 LingxingRequestFactory,access_token 只进 Authorization 但参与签名
- 订单列表请求体改为 start_time/end_time(epoch 秒)+ platform_code/store_id 数组
- 分页改为「满页 + total 兜底」,避免最后一页多发一次请求
- 令牌缓存键从 store_id 改为 appKey,同 app 多店铺共用 token
- 映射异常包装成 ValidationException 并保留原始报文,避免以 NPE 形式冒出
|
3 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
|
5bd69e7f1c
|
docs(guide): 补充端点写成常量、SDK 不碰存储不读配置两条约定
|
3 weeks ago |
chenchuchuan
|
64209629ff
|
refactor(sdk): 明确 AdapterConfig 不是配置项
SDK 的初衷是不读任何配置、不碰任何存储。原 AdapterConfig 带 endpointBaseUrl +
sandbox 两个字段,容易被误解为可配置端点;sandbox 更是与 ChannelAccount.sandbox
重复且从未被工厂使用。
- AdapterConfig 收敛为单一字段 endpointBaseUrl,仅用于测试/联调覆盖目标地址
- 新增 AdapterConfig.NONE 常量,替换 ChannelSdk 里内联的 new AdapterConfig(null, false)
- LingxingConstants 补注释:端点与路径属于协议,必须写在代码里
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
|
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
|
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
|
b305fd9608
|
docs: 新增开发指南与领星真实环境冒烟测试
- GUIDE.md:心智模型、基接口逐个讲、三条流水线、接入新平台 8 步、5 层测试、验收清单
- LingxingLiveSmokeTest:未配置环境变量时整类跳过,先验认证再验报文,打印脱敏请求响应
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
a6f3b3060f
|
feat(core): 写操作幂等守卫与 IdempotencyStore SPI
业务键 + provider 请求键双锁:业务键不带 provider,直连与聚合器共用;
provider 键只防单 provider 内重试。
- 新增 idempotency 包:WriteScope / WriteResult / IdempotencyGuard
- 新增 SPI:IdempotencyStore 及 Claim / Record / Status 四态
- ChannelSdk.writes() 装配守卫;未注入 store 时显式失败,无降级路径
- 崩溃窗口由 provider 键恢复:平台已写但业务键未记成功时回放,不重复写
- testkit 新增 InMemoryIdempotencyStore / MutableClock,junit 改为 test 作用域
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
9e6b8c5c61
|
refactor(capability): 详情参数改用 SalesOrderRef / ProductRef
裸 String 在擦除后使 SalesOrderCapable.get 与 ProductCapable.get 签名相同,
一个适配器无法同时实现订单与商品两种能力。改为包装类型后两者可共存。
- 新增 common.ecommerce.model.order.SalesOrderRef / model.product.ProductRef
- SalesOrderCapable / ProductCapable 的 get 参数改为引用类型
- 门面 SalesOrders.get(String) / Products.get(String) 对外签名不变
- LingxingAdapter、ChannelSdkTest 同步适配
- testkit 新增 FakeDirectAdapter 及其测试,验证 core 抽象未被聚合器带偏
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
|
b7e6df462a
|
feat(lingxing): 领星订单拉取适配器
- LingxingAdapter:SalesOrderCapable + AggregatorCapable,
按 platform_code 细化能力(eBay/SHEIN/Mirakl/自定义平台只有订单)
- LingxingSigner:公共参数 ASCII 升序拼接 appSecret 前后包裹后 MD5
- LingxingTokenClient + TokenManager:约 2h 令牌,提前 10 分钟续期
- 时间窗 ≤31 天截断、length ≤500、offset 游标、10 req/s 令牌桶
- channelOrderId 优先平台单号,platform_order_names 排序取首,缺失回落领星 order_id
- LingxingAdapterFactory:与直连适配器同一套注册机制
契约测试 16 个,全部基于录制夹具,无网络/数据库/Spring。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
0f929a6be3
|
feat(testkit): InMemory SPI、FakeTransport 与夹具加载
- FakeTransport:按 URL 子串+方法路由,记录全部请求,可直接返回录制响应
- InMemory*:Accounts/TokenStore/CursorStore/Sink/LockProvider
- Fixtures:fixtures/{platform}/{operation}/{case}.json 约定加载
- Responses/TestData:响应与同步测试的快捷构造
目标:适配器单测不依赖网络、数据库、Spring。
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
|
a6dc2d2691
|
feat(core): 领域模型、能力接口、SPI 与同步引擎骨架
- 标识体系:AccountKey(provider+platform+omsStoreId)、CanonicalKeys
三级标识(canonicalKey 不含 provider)与四类指纹
- 模型:Platform/ChannelProvider/Capability/FulfillmentMode、
Money(BigDecimal+Currency)、PlatformTime 三轴、SalesOrder/OrderLine/
ProductListing/Page/Query
- 能力接口:PlatformAdapter、AggregatorCapable、SalesOrderCapable、
ProductCapable
- 异常:ChannelException 基类 + Auth/RateLimit/Transient/Validation/
PlatformBusiness/IdempotencyConflict/CrossProviderConflict/Unsupported
- SPI:ChannelAccountRepository、SecretProvider、TokenStore、
SyncCursorStore、Sink、LockProvider(均只定义,宿主实现)
- SyncEngine:from = watermark - overlap,整批成功才推进水位线
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 |