lml
|
7886796a6b
|
fix: 修复合并后入库模块包路径与门面引用
|
2 weeks ago |
lml
|
57404c6fe8
|
feat(lingxing): 修正 AWD 入库时间解析与多平台订单分页下限,补齐店铺/订单/面单/入库探针
- fix(inbound): AWD 的 gmtCreate/gmtModified/shipBy 真实报文是 yyyy-MM-dd HH:mm:ss(无时区,按北京时间),
严格 ISO 解析会让整页货件映射失败;新增 InboundSupport.parseFlexible 做 ISO 优先 + 北京时间兜底
- fix(inbound): AWD 报文里 shipmentId(入库货件号)与 orderId(AWD 货件号)是两个字段,
前者落到 shipmentId、后者落到 shipmentNo,老报文缺 shipmentId 时回落 orderId
- fix(order): 多平台订单 length 下限 20(真机 pageSize=5 返回 code=102 length最小值为20),
适配器统一收窄到 [LingxingConstants.MIN_PAGE_SIZE, MAX_PAGE_SIZE]
- fix(order): FBM 列表确认只返回头部字段,注释写明金额与商品行必须调 getOrderDetail,DTO 同步说明
- test: 新增 FulfillmentProbeTest(probe 风格只读探针,覆盖店铺/订单/面单/入库)
- test: LingxingLiveSmokeTest 凭据改为 -Dlingxing.probe.* 系统属性,不再写死类内常量与 sid
- test: 新增 MultiPlatformOrderSourceTest、AmazonFbmOrderSourceTest,AwdCargoSourceTest 增加真实报文用例
- test: 新增 AWD 真实报文夹具 awdShipment/real-2026-11-06.json
验证:mvn -pl lingxing -am test(109 用例,0 失败,probe 默认跳过);
真实环境探针已跑通店铺/订单/面单/入库,AWD 与多平台订单报错均已消除。
|
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 |
lml
|
25066e5295
|
test(lingxing): 补齐入库接口的门面、探针与冒烟测试
- FakeDirectAdapter 增加入库货件/接收明细能力与 Builder 数据,SdkFacadeCallTest 覆盖门面分页、查询校验与能力缺失
- LingxingInboundCapabilityTest 增加 CallRecord 断言(operation/outcome/resultCount/externalStoreId)
- 新增 InboundProbeTest,只读探针核对 FBT/WFS/AWD/FBA 的待核对参数,默认跳过
- LingxingLiveSmokeTest 增加只读入库冒烟,亚马逊 SC 额外拉 FBA 接收明细
|
2 weeks ago |
lml
|
138ffe05b5
|
docs(lingxing): 补入库查询的分页、时区与字段映射注释
只加注释:分页终点判定、北京时间转换、字符串数量回退、待核对字段说明,不改逻辑。
|
2 weeks ago |
chenchuchuan
|
802613ffff
|
test(lingxing): 新增 listing 联调探针,凭据改为系统属性传入
- ListingSmokeProbeTest:从 ChannelSdk 门面逐平台拉一页 listing,
打印统一模型关键字段并用样本回查平台 SKU / 本地 SKU
- ListingParamProbeTest:核对 Target 时间窗上限、Temu 窗口边界等参数形态
- SearchFieldProbeTest / ShopListProbeTest:去掉硬编码的真实凭据,
改从 -Dlingxing.probe.appKey / -Dlingxing.probe.appSecret 读取;
未提供时 assumeTrue 跳过,避免本地与 CI 默认打真机
- SearchFieldProbeTest 的 TARGET_STORE_ID 置空(store_ids 非必填)、
样本为空不再断言失败、单个编码报错不中断整轮扫描
所有探针仍默认跳过且只做查询。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
4c75503e85
|
feat(lingxing): 接入 FBT/WFS/AWD 入库货件与 FBA 接收明细查询
|
2 weeks ago |
chenchuchuan
|
04bea3ec5e
|
test(lingxing): 补 SDK 层 listing 调用测试,契约测试对齐实测参数
- 新增 LingxingSdkListingCallTest:从 ChannelSdk 门面调领星 listing,
覆盖能力检查、snake_case 搜索参数、Target 时间窗三字段、审计记录
- 各平台契约测试同步实测结论:沃尔玛/eBay 改断言 snake_case、
多值搜索显式失败;Target 补时间窗与多值校验;Temu 补 30 天截断;
SHEIN/TikTok 补本地 SKU 编码 8
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
lml
|
7747125099
|
fix(lingxing): 保留平台 request_id 并在审计中补 platformCode
- ChannelException 新增 platformRequestId,与本地链路 requestId 分开
- LingxingEnvelope 解析响应顶层 request_id(兼容 requestId)并写入异常
- CallRecord 分别记录平台 request_id 与业务码 platformCode
- 失败日志补 platformCode,并对平台文案做换行清洗与截断
- LingxingCallObserverTest 断言 3001008 与平台 request_id 不被本地 ID 覆盖
验证:mvn -q -pl core,lingxing -am -Dtest='LingxingCallObserverTest,LingxingEnvelopeTest' -DfailIfNoTests=false test
|
2 weeks ago |
lml
|
98330ca87c
|
test(observability): 覆盖门面日志与领星调用链路
- 新增 CallObserverTest:成功/失败记录、观察者异常隔离、默认 NOOP、UTC 与本地时间转换
- 新增 LingxingCallObserverTest:用 RecordingTransport 走真实 LingxingAdapter,
覆盖成功、限流失败、无平台码三种场景
|
2 weeks ago |
lml
|
d4f334ff29
|
test(lingxing): 冒烟支持无平台码查询并打印真实平台
- pullsOnePageOfOrders 支持 PLATFORM_CODE 置 null / 0:只按 store_id 查询
- 无码时店铺列表不带 platform_code,返回全部店铺并打印真实 platform_code / platform_name
- 无码时业务平台兜底 Platform.CUSTOM,保证能力路由可用
- 凭证改为从环境变量读取,不再硬编码
|
3 weeks ago |
chenchuchuan
|
c9d60153c7
|
test: 每个平台补 listing / 售后契约测试,新增 SDK 门面调用测试
testkit(测试支撑):
- RecordingTransport:记录全部请求、按 URL 路由响应;令牌请求自动返回最小成功响应,
业务请求可断言
- JsonFixture:classpath 夹具加载
- Responses:恢复快捷响应构造
- FakeDirectAdapter:补 AfterSaleCapable,支持 afterSales(count)
lingxing(每平台一套):
- 9 个 listing 测试:walmart / ebay / temu / shein / tiktok / target /
aliexpress / amazon sc / amazon vc
覆盖请求参数(店铺、时间窗、分页、搜索编码)与响应映射
- 售后:ListSource(请求构造、过滤、上限、时间窗校验、行展开)+ Mapper(10 例)
- LingxingTestSupport:测试公共样板(账户/调用/断言)
- 夹具:每平台一套 success.json
testkit(门面调用):
- SdkFacadeCallTest:products / afterSales / salesOrders 的完整调用、分页、
参数校验、能力检查、账户缺失等错误路径
清理:
- 删除 ProductCallExampleTest、SdkCallGuideTest 与两份 AmazonScProductLiveTest
(已被上述测试覆盖)
- 探针改为 -Dlingxing.probe=true 才运行,避免真实凭证让 mvn test 变红
修复:
- TargetProductSource 的 store_ids 被误注释,恢复
- AmazonVcProductSource 传搜索条件时显式抛异常,不再静默忽略
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
lml
|
14b09069d1
|
feat(lingxing): 接入多平台店铺与订单查询并补齐长尾平台
- 多平台店铺列表按子平台声明的业务平台返回子渠道,不再由 platform_code 反推
- 抽出 MultiPlatformOrderSource,统一复用 /pb/mp/order/v2/list
- 为 Temu / SHEIN / Shopify / eBay / AliExpress / TikTok 补 shopSource 与 orderSource
- 新增 Target / Wayfair / Mirakl / BestBuy / AEPH / Michaels / ECHO / LOS-DLI-US / CUSTOM 子平台并注册
- supports 改用 AccountKey.platform 判定;platforms() 补齐新平台;toPlatform 补 10002/10005/10010/10029/10030
- 新增 LingxingOrderFilters 与 LingxingAdapter.pull(ctx, query, filters),覆盖平台单号、跟踪号、订单状态等全部查询条件
- 按平台单号/名称查询时自动省略时间窗;时间窗截断 31 天、分页截断 500
- 补全订单 DTO 并新增物流、标签、子产品 DTO,全部中文注释;SalesOrderQuery 补语义注释
- .gitignore 的 Maven target 改为锚定写法,避免忽略 platform/target 包
|
3 weeks ago |
chenchuchuan
|
6214462ba9
|
feat(lingxing): 接入售后订单列表
core:
- 新增 model/aftersale:AfterSaleType(REFUND/RETURN/EXCHANGE/UNKNOWN)、
AfterSaleQuery(时间窗必填、dateType、类型与订单号过滤)、AfterSale(按商品行展开)
- 新增 AfterSaleCapable + AfterSales 视图,ChannelSdk.afterSales(key, conn)
lingxing:
- LingxingApi.AFTER_SALE_LIST
/erp/sc/routing/amzod/order/afterSaleList(POST, qps 1)
- platform/aftersale:DTO(订单级 + item_list 行级 + 金额明细)、Mapper、ListSource
- AmazonScSubPlatform 装配 afterSaleSource;适配器声明 RETURNS 能力
映射要点:
- 领星按订单聚合,统一模型按 item_list 商品行展开
- 分页游标按「领星记录数」推进,不用展开后的条目数
- 行级 after_time / data_update_time 优先于订单级
- 唯一标识优先 md5_v2 → item_identifier → 订单号+msku+时间+row_index
- 金额只保留数字与符号位;币种按符号映射,映射不出则金额为 null
- 兼容文档笔误:示例里的 total_refund_amount__number(双下划线)
测试:Mapper 10 例 + 请求构造 1 例,夹具用官方文档示例。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
lml
|
23a08e4e9d
|
feat(lingxing): 接入销售出库单、物流面单、审核发货与编辑订单
新增 4 个 ERP 级接口,均复用 LingxingCall:
- POST /erp/sc/routing/wms/order/wmsOrderList
- POST /erp/sc/routing/wms/order/getWmsLogisticsLabels
- POST /basicOpen/openapi/multiplatform/order/review
- POST /pb/mp/order/editOrder
core:
- Capability 新增 OUTBOUND_ORDER / ORDER_EDIT / SHIPMENT_REVIEW
- 新增 OutboundOrderCapable / ShippingLabelCapable /
ShipmentReviewCapable / OrderEditCapable
- Outbounds 扩展出库单、面单、审核发货;SalesOrders 扩展编辑订单
- 新增出库单、面单、审核结果、编辑请求/结果等不可变模型
lingxing:
- 补充 4 条接口路径与分页、批量上限
- wms 包下新增 4 个 Source 与对应 DTO
- LingxingAdapter 装配 4 个 Source 并声明对应能力
注意事项:
- editOrder 的 code 0/10000/10001 都是业务结果,不能走 LingxingEnvelope,
逐单原因在 data.error_details[],且 global_order_no 按字符串解析
- 出库单默认按账户 externalStoreId 过滤,非数字时显式失败,
避免不带 sid_arr 时跨店铺返回数据
- 面单 wo_number_arr 与 order_number_arr 二选一,单次上限 50
- 商品行 currency_code 可能是符号而非 ISO 代码,此时不构造 Money
- 编辑订单独立成 Capability.ORDER_EDIT:ERP 级接口,
不依赖子平台的订单列表能力
|
3 weeks ago |
chenchuchuan
|
ee75c199b3
|
docs(sdk): 补齐 ChannelSdk / ChannelConnection / ChannelSecret 字段注释;新增拉商品示例
ChannelSdk:
- 类注释改成「构建需要三样 + 每次调用需要两样」+ 调用链图
- 每个字段、每个 Builder 方法、每个门面方法补注释(含异常说明)
- 明确能力检查发生在 pull() 调用时,不是取视图时
- 明确 clock 的作用(查询终点 + 幂等时间戳)与生产是否要传
ChannelConnection / ChannelSecret:
- endpointBaseUrl / appKey / appSecret / clientId / clientSecret / refreshToken
逐个注明是哪个平台用
新增 ProductCallExampleTest(拉商品):
- 三段配置分别是什么、拼出的请求长什么样、结果如何映射
- 传输层返回一页固定响应,不联网
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
831cd71ce2
|
test(lingxing): 新增从 ChannelSdk 调用领星的用法演示测试
六个步骤对应操作手册的调用顺序:
1. 构造 ChannelAccount(provider/platform/omsStoreId + externalStoreId + platformCode)
2. 构造 ChannelConnection(端点 + appId/appSecret)
3. 构建 ChannelSdk(accountRepository 必需;工厂或适配器实例注册)
4. capabilities() 不发网络请求
5. pull 时打印并断言真实请求:先换 token,再拉订单,含 platform_code/store_id/offset/length/时间窗
6. 三类快速失败:账户未配置、能力缺失(在调用动作时报错)、平台无适配器
注意:领星 appId 同时作为签名 AES 密钥,测试里必须是 16/24/32 字节。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
f3aefee1d3
|
refactor(lingxing): 子平台注册表改为实例级;接入快速出库
注册表(方案 A):
- LingxingSubPlatforms 从全局静态改成 builder().register(...).build()
- 同一平台重复注册在 build() 时抛异常,不再静默覆盖
- 新增 LingxingSubPlatformDefaults.all(transport, json) 装配默认实现
- LingxingAdapter 持有注册表实例;新增可注入注册表的构造器,
传 null 时用默认装配
- 路由第一层仍由调用方传入的 AccountKey(provider + platform)决定
快速出库(多平台通用,qps 10):
- LingxingApi 新增 FAST_OUTBOUND / FAST_OUTBOUND_RESULT
- core 新增 OutboundCapable / Outbounds / OutboundPackage / OutboundResult
- ChannelSdk 新增 outbounds(key, conn)
- 新增 platform/outbound/LingxingOutboundSource 能力接口
- 新增 platform/multiplatform/outbound/MultiPlatformOutboundSource
(两个接口都不带平台维度,所有子平台共用)
- 九个多平台子平台声明 outboundSource()
- 适配器 capabilities() 增加 MARK_SHIPPED,supports() 按 outboundSource 判定
注意:submit 仅表示任务受理,结果需用 results() 回查。
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
lml
|
2bbc5e3cf3
|
feat(lingxing): 接入多平台店铺与 Walmart 在线商品
- 新增 MultiPlatformShopSource:
/pb/mp/shop/v2/getSellerList,offset/length 内部翻页,
按 platform_code + is_sync/status 过滤
- 新增 WalmartProductSource:
/basicOpen/multiplatform/walmart/list,更新时间窗 ≤31 天,
兼容 data.list 与 data[] 两种响应
- WalmartSubPlatform 装配 shopSource / productSource
- LingxingApi 增加两个接口枚举,常量补分页与窗口上限
- smoke 增加 Walmart 店铺 → 商品链路
说明:
- Walmart 商品接口没有返回更新时间,ProductListing.updatedAt 暂为 null
- listing 日期参数文档未标时区,按北京时间解析,待真实报文核对
|
3 weeks ago |
lml
|
6a7cbf765d
|
feat(lingxing): 接入亚马逊 VC 店铺与订单
- 新增 AmazonVcSubPlatform,注册 AMAZON_VC(platform_code 10035)
- VcShopSource:/basicOpen/platformAuth/vcSeller/pageList,
offset/length 内部翻页,只保留 status=1 的店铺
- VcOrderSource:/basicOpen/platformOrder/vcOrder/pageList,
purchase_order_type=[0,1,2],search_field_time=3,窗口 ≤90 天
- 详情按类型分派:DF 用 vc_store_id + purchase_order_number,
PO 用 local_po_number;DI 无详情,回退列表数据
- get() 先按订单编号搜索拿类型与 local_po_number,再调对应详情
- 新增 VC 店铺/订单 DTO 与冒烟用例
说明:purchase_order_date 文档未标时区,暂按北京时间解析,待真实报文核对
|
3 weeks ago |
lml
|
4f7f9c88a5
|
feat(lingxing): 接入亚马逊订单、FBM 与结算交易明细
- 亚马逊 SC 标准订单:platform_code=10001 走 /erp/sc/data/mws/orders,
date_type=3(平台更新时间 UTC),窗口 ≤1 年,分页 ≤5000,1 req/s
- 亚马逊订单详情:/erp/sc/data/mws/orderDetail,返回单价/税额/折扣;
get() 按子平台分派,不再统一抛未实现
- 亚马逊店铺列表:GET /erp/sc/data/seller/lists,
返回的 sid 可直接作为 externalStoreId
- 亚马逊 FBM:getOrderList/getOrderDetail 单独成一路,主键是领星系统单号
order_number,列表 page 从 1 开始,详情 data 是对象
- 结算交易明细:新增 SettlementCapable / Settlements 门面与结算模型,
接口 /bd/sp/api/open/settlement/transaction/detail/list,
结算窗口 ≤7 天,修改时间按北京时间
- LingxingSubPlatform 增加 fbmOrderSource / settlementSource
- LingxingApi 统一登记接口路径与令牌桶
- 金额清洗复用 LingxingOrderMapper.cleanAmount
- smoke 测试覆盖店铺 → 订单 → 详情 → FBM → 结算链路
说明:
- FBM purchase_time 文档未标时区,暂按北京时间解析,待真实报文核对
- 结算 eventType=ServiceFeeEventList 时 uniqueKey 会变,需先删后写
|
3 weeks ago |
chenchuchuan
|
51e429b463
|
test(lingxing): 亚马逊测试类补充店铺列表,SID 可自动获取
- 新增 listsAmazonShops:调店铺列表接口,打印每个 sid 与名称
- SID 留空时自动取店铺列表第一个正常店铺,填了则直接用
Co-Authored-By: Claude <noreply@anthropic.com>
|
3 weeks ago |
chenchuchuan
|
2cb045fda9
|
test(lingxing): 亚马逊 SC 商品接口真实环境测试
- AmazonScProductLiveTest:带时间窗与不带时间窗两种拉法
- 顶部常量填 AppID / AppSecret / SID,未填时 Assumptions 跳过
- 打印脱敏请求与响应,便于核对字段映射
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
|
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
|
b305fd9608
|
docs: 新增开发指南与领星真实环境冒烟测试
- GUIDE.md:心智模型、基接口逐个讲、三条流水线、接入新平台 8 步、5 层测试、验收清单
- LingxingLiveSmokeTest:未配置环境变量时整类跳过,先验认证再验报文,打印脱敏请求响应
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 |