chenchuchuan
|
dc4db1c208
|
refactor: 连接配置收敛到 SecretProvider,调用点只传身份
调用方不再每次构造 ChannelConnection 传地址和密钥,改为:
- 账户只保留业务字段(warehouseCode / provider / providerWarehouseId / credentialRef)
- 密钥与地址由 SecretProvider 按 credentialRef 统一提供
- 门面新增免连接重载:sdk.warehouses(code)、sdk.salesOrders(key) 等
主要改动:
- ChannelSecret 承接 endpointBaseUrl / auxEndpointBaseUrl,与密钥一起配置
- WarehouseAccount 删除 timeZone / endpointBaseUrl / auxEndpointBaseUrl
- ChannelAccount 增加 endpointBaseUrl
- PlatformAdapter / WarehouseAdapter 新增 defaultEndpointBaseUrl(),适配器提供内置默认地址
(运去哪 / 信仓 / 恒健 / 领星取生产地址;易达云生产地址未定,返回 null)
- WarehouseConnection 不再无条件覆盖凭据里的地址,凭据已有地址时优先采用
- 两个门面的 Builder 新增 secretProvider(...),未注入时仍可用带连接的老入口
- 旧签名(带 connection)全部保留,向后兼容
适配器内部未改动:它们只消费 ctx.secret() / ctx.endpointBaseUrl(),
来源由调用方传入改为门面装配。
Co-Authored-By: Claude <noreply@anthropic.com>
|
1 day ago |
chenchuchuan
|
96f6621bbd
|
refactor: 按 Spec W0 拆分 sdk-common / channel-sdk-core,http 并入 sdk-common
模块更名与上提(Spec W0 §11):
- shared → sdk-common,http 合并进来,channel-sdk-http 取消
- channel → channel-sdk-core,testkit → sdk-testkit
- 父 POM 更名为 channel-sdk-parent
共享层为跨域复用做的三处调整:
- IdempotencyStore / IdempotencyRecord 的 provider 改为 String,
渠道域与仓库域两套 provider 枚举落同一张幂等表
- 新增 WriteIdentity,WriteScope 实现它;幂等守卫改为面向接口
- CallSupport 从 channel 移到 sdk-common,新增 CallScope;
ChannelContext 实现 CallScope,耗时与埋点维度不再绑定渠道域
ChannelProvider 里误加的 YUNQUNA 移除:仓不是渠道,走 WarehouseProvider。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
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 |
chenchuchuan
|
c33597fae9
|
fix(lingxing): 修正 listing 搜索参数名与时间窗,按真机实测对齐
用只读探针实测 2026-11 领星各平台 listing 接口(传不存在的 SKU 做对照),
发现三处会静默出错的问题:
- 沃尔玛 / eBay:camelCase 的 searchField 被平台静默忽略并返回整页,
必须用 search_field / search_single_value;多值 search_values 同样无效,
改为单值专用方法,传多值时抛 ValidationException
- Target:时间窗三字段必须同时出现且日期只接受 Y-m-d,单边或带时分秒都 400;
改为补齐两端 + 日期格式,并用 listing_time_field=2(更新时间)
- Temu:时间窗跨度 31 天直接 500,改为按 30 天截断并补齐两端
搜索编码实测结论:沃尔玛 1/3、eBay 1/3、AliExpress 1/5、Temu/SHEIN/TikTok 9/8、
Target 1(=msku,2=item_id,4≈标题)、Amazon SC 字符串 seller_sku/sku;
Target 本地 SKU 在该 app 下恒为空,保持显式不支持。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
62150c64ba
|
refactor(lingxing): 删除 Shopify 平台,Target 独占 listing 接口
Shopify 与 Target 走同一个领星接口(/basicOpen/multiplatform/shopify/variantList),
DTO 字段完全一致,保留两套实现属于重复代码。
- 删除 platform/shopify/ 整包(SubPlatform + DTO + ProductSource,约 520 行)
- Platform.SHOPIFY 枚举移除
- LingxingSubPlatformDefaults 不再注册 Shopify
- LingxingConstants:10002(SPF-*)改为 CUSTOM,等确认业务平台后再补
- LingxingProductSearchMapper.shopify → target,本地 SKU 仍显式不支持
- 适配器 platforms() 去掉 SHOPIFY
领星接口路径里的 shopify 是历史命名,与业务平台无关,枚举名 LISTING_SHOPIFY 保留。
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,保证能力路由可用
- 凭证改为从环境变量读取,不再硬编码
|
2 weeks ago |
lml
|
6e7c15ee3f
|
fix(lingxing): 兼容订单标签字符串形态并让店铺返回真实平台名
- LingxingOrderTagDto 增加兼容反序列化器:order_tag 是对象,
pending_order_tag / exception_order_tag 可能是纯字符串(如 ["未分配物流"])
- 字符串形态只填 tagName,tagNo / tagType 留空;对象形态保持原映射
- 反序列化器挂在字段 contentUsing 上,避免类级注册导致回读递归
- SubChannel.attributes 带上领星 platform_name
- 声明为 Platform.CUSTOM 的子平台按响应 platform_code 反推,不再统一显示 CUSTOM
|
2 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>
|
2 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 包
|
2 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>
|
2 weeks ago |
chenchuchuan
|
fdc55b3f54
|
feat(product): SKU 搜索条件(平台 SKU / 本地 SKU)
SDK 层(core):
- 新增 ProductSearchField:PLATFORM_SKU / LOCAL_SKU,只定义跨平台语义一致的维度
- ProductQuery 增加 searchField / searchValue(单值模糊)/ searchValues(多值精确)
- 有搜索值但没 searchField 直接抛异常
- 单值与多值互斥,同时设置直接抛异常
- 新增 hasSearch() 与 toBuilder()
领星层(lingxing):
- LingxingProductSearchMapper:语义 → 平台枚举值
沃尔玛/eBay 1 / 3
AliExpress 1 / 5 (实测;文档写 3 但查不到)
Temu/SHEIN/TikTok 9 / 8
Shopify/Target 1 / 本地 SKU 待核对
亚马逊 SC "seller_sku" / "sku"(字符串)
- LingxingProductSearchBody:三种请求形态
camelCase(沃尔玛/eBay/Temu/SHEIN/TikTok/AliExpress)
snake_case(Shopify/Target)
amazonSc:search_value 数组 + exact_search 开关
- 八个商品 Source 接入;平台不支持的维度抛 ValidationException,不静默忽略
亚马逊 VC 不支持搜索(接入时会因 Mapper 抛异常而显式失败)。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
a37d1fe91a
|
fix(lingxing): 能力判断直接用 account.platform(),不再从 platformCode 反推
supports(account, capability) 之前用 LingxingConstants.toPlatform(platformCode)
反推平台,但 account 的 key 里本来就有调用方传入的 Platform。
两者不一致时(如 platformCode=10024 但 platform=WALMART_SC)会出现
「路由走 A、能力判断走 B」的错乱。现在统一以调用方传入的 Platform 为准,
platformCode 只用于拼请求参数。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
9df007eeb8
|
fix(lingxing): 按真实店铺列表修正 platform_code 映射
以 88 家真实店铺(/pb/mp/shop/v2/getSellerList)为准确认:
新增映射:
- 10002 → SHOPIFY(SPF-*)
- 10005 / 10031 → AEPH(AEP-* / AEPH-*)
刻意保持 CUSTOM:
- 10009 自定义平台:混有 WOT / MIC / BSB / TTK 及事业部命名,无法用一个枚举表示
- 10010 Wayfair:统一模型暂无枚举
- 10017:同时存在 Target DVS 与 WMT-1P-US,业务平台不同
注释补充:Target 没有独立商品接口,商品走 Shopify 的
/basicOpen/multiplatform/shopify/variantList,该接口由 Shopify 与 Target 共用。
另:实测 88 家店中没有 AliExpress 店铺,10002 是 Shopify。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
a4ba27e715
|
refactor(lingxing): 领星 shopify 接口按 Target 平台对接;店铺过滤改为可选
平台改名:
- platform/shopify/ → platform/target/
- ShopifySubPlatform / ShopifyProductSource / ShopifyListingDto / ShopifyLocationDto
→ Target* 系列
- Platform.SHOPIFY 保留(供直连场景),领星侧改用 Platform.TARGET
- 领星接口路径不变(/basicOpen/multiplatform/shopify/variantList)
店铺过滤:
- 各商品 Source 不再无条件拼 store_ids / storeIds / sid / vc_store_ids
- 账户 externalStoreId 为空时不传,由平台侧校验是否必填;
SDK 不做上层校验,只负责透传
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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 级接口,
不依赖子平台的订单列表能力
|
2 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>
|
2 weeks ago |
chenchuchuan
|
8596e34936
|
docs(lingxing): 标注快速出库为写操作,验证阶段禁止调用
领星无测试环境,出库会真实改变数据:
- LingxingApi.FAST_OUTBOUND 注释标明写操作,禁止验证
- MultiPlatformOutboundSource 类注释与 submit 方法注释同步标注
- FAST_OUTBOUND_RESULT 注明只读、可安全验证
约定已记入项目记忆:领星验证只做查询。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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>
|
2 weeks ago |
chenchuchuan
|
e13d86a32d
|
refactor(lingxing): 能力接口不再分包,统一放在 platform 根包
之前每个能力一个子包(order/、product/、shop/、settlement/、outbound/),
实际每个包里只有一个接口,增加了跳转层级。
现在统一放在 platform 根包:
- LingxingOrderSource / LingxingProductSource / LingxingShopSource /
LingxingSettlementSource / LingxingOutboundSource
根包现有 9 个类:5 个能力接口 + LingxingSubPlatform(组合入口)
+ LingxingSubPlatforms(注册表)+ LingxingSubPlatformDefaults(默认装配)
+ LingxingCall(调用上下文)。
子平台实现仍在各自包内(amazon/sc/order 等),保持按平台组织。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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>
|
2 weeks ago |
chenchuchuan
|
04388e1b44
|
fix(merge): 合并后去除重复实现,补齐 VC 订单能力
重复实现(合并分支与本分支各写了一份):
- amazon/vc/shop:VcShopSource 与 AmazonVcShopSource 重复,
保留带内部翻页的 VcShopSource,删除 AmazonVcShopSource;
同时去掉它按 status==1 过滤的行为(统一遵守“只转发”约定)
- amazon/vc/dto:删除不再引用的 AmazonVcShopDto
补齐:
- AmazonVcSubPlatform 接上 VcOrderSource(合并分支已实现 VC 订单,
但子平台未声明),现在 VC 支持 订单/商品/店铺 三项
全库已无同名重复类,BUILD SUCCESS。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
027346b26a
|
fix(merge): 修复合并冲突残留,统一 amazon 目录归属
合并带来的问题:
- amazon/ 下出现根包与 sc/vc 子包两套同名类(AmazonVcSubPlatform、
AmazonProductSource、AmazonShopSource、6 个订单 DTO),其中 sc/dto 下
是 0 字节冲突残留
- AmazonListingDto(更早的 14 字段版本)与 AmazonScListingDto(59 字段)
重复,删除旧版
- WalmartListingDto 合并时 itemId 字段重复声明
- AmazonFbmOrderSource 引用 dto 包,FbmOrderDetailDto 引用 FbmOrderItemDto
缺少 import
- LingxingSubPlatforms 仍指向合并前的 amazon.AmazonScSubPlatform /
amazon.AmazonVcSubPlatform
整理结果:
- 亚马逊订单/结算 DTO → amazon/sc/dto(Header 说 sc 专属)
- FBM 订单列表 DTO → amazon/dto(被 amazon/order 下的 Source 使用)
- 删除根包下重复的 AmazonVcSubPlatform / AmazonProductSource / AmazonShopSource
与 0 字节冲突文件
- 注册表改用 amazon.sc / amazon.vc 子包
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
883ed60c21
|
refactor(lingxing): 价格不做兜底与计算,只做单位/币种换算
SDK 只做整合转发,不替调用方挑选数据:
- Temu:接口没有独立价格字段(只有 supplyPriceList 分段申报价),
price / currency 直接为 null,原值保留在 attributes
- SHEIN:只取 salePrice + saleCurrency,去掉 supplyPriceList 兜底
- AliExpress:此前已改为只取 price(分 ÷ 100)
同时删除不再使用的 currentSupplyPrice / currencyOf / moneyOrNull 辅助方法。
约定已记入项目记忆。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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 日期参数文档未标时区,按北京时间解析,待真实报文核对
|
2 weeks ago |
chenchuchuan
|
f832091558
|
style(lingxing): 单行语句不再硬拆多行;AliExpress price 只做单位换算
代码风格:
- 按用户要求,能放一行的语句不拆成两行
(listAt(...)、body.put(...)、字段初始化等 11 处)
AliExpress 价格:
- 统一模型 price 只取接口自身的 price 字段(单位:分)÷ 100
- 不再用 effectiveSupplyPrice 或 supplyPriceList 替代 / 兜底
- 删除不再使用的 currentSupplyPrice 辅助方法
约定已记入项目记忆:价格只做单位换算,缺字段给 null,原始值留在 attributes。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
2ff213e3c4
|
fix(aliexpress): price 单位按分换算为标准金额
接口 price 字段单位为分,统一模型用标准金额(元),除以 100 后输出。
取值优先级:
1. effectiveSupplyPrice(已格式化的字符串,直接可用)
2. price(分)÷ 100
3. 当前生效的 supplyPriceList 条目
文档示例 99990000 与 effectiveSupplyPrice 59.99 不一致,按「单位分」处理;
原始 price 仍保留在 attributes.price。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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 文档未标时区,暂按北京时间解析,待真实报文核对
|
2 weeks ago |
chenchuchuan
|
3dd0188d39
|
feat(lingxing): 接入 AliExpress / SHEIN / TikTok 在线商品
接口(均为 POST、qps 1、返回 data.list):
- AliExpress /basicOpen/multiplatform/aliexpress/list/v2(托管模式,isParent=0 子体)
- SHEIN /basicOpen/multiplatform/shein/list(上限 1000)
- TikTok /basicOpen/multiplatform/tiktok/list(上限 1000)
映射要点:
- 三者 platformSku 均取 msku,listingId 取 productUniqueId
- AliExpress:price 取 effectiveSupplyPrice + currencyCode;
createTime 是北京时间,按 Asia/Shanghai 解析;storeIds 尽量传数字
- SHEIN:salePrice + saleCurrency;图片依次回落 imgUrl/imgMediumUrl/imgSmallUrl;
status 0 删除 / 1 在售 / 2 停售
- TikTok:salesPrice + currency;title 为空时回落 pname;
platformStatus 字符串归一,兼容示例中的无下划线写法 SELLERDEACTIVATED
Platform 新增 ALIEXPRESS,适配器与工厂的 platforms() 同步;
LingxingSubPlatforms 注册三个子平台。
其余字段全部进 attributes。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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 会变,需先删后写
|
2 weeks ago |
chenchuchuan
|
f3f7e08019
|
feat(lingxing): 接入 eBay 在线商品
接口 /basicOpen/multiplatform/ebay/list(POST, qps 1, 上限 200):
- 响应是 data 数组(不是 data.list),总数在顶层 total
- 时间过滤精度 Y-m-d,查询类型取创建时间(1),区间超 31 天截断
- EbayListingDto 全字段 + 嵌套 product_auto_restock_response
映射要点:
- platformSku ← msku,为空串时回落 item_id(保证 canonicalKey 有值)
- listingId ← item_id
- status ← listing_status(1 在售,其余文档未列,归 UNKNOWN)
- rawStatus ← listing_status_name(中文,如「在售」)
- 接口不返回币种,price / currency 均为 null,原值在 attributes.price
其余字段全部进 attributes(变体属性、站点、销售类型、起拍价/一口价、
自动补货规则、所在地、处理时间等)。
Shopify 此前已接入,本次文档与其一致,无需改动。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
6a22e9057c
|
fix(lingxing): ¥ 符号统一按日元处理,CNY 视为人民币
约定:渠道只给货币符号时,¥ / ¥ 一律映射 JPY;
人民币由平台以 ISO 代码 CNY(或 RMB)返回,显式映射 CNY。
涉及 SC 之外的全部商品实现:
- AmazonVcProductSource
- WalmartProductSource
- TemuProductSource
- ShopifyProductSource
此前 ¥ 返回 null 导致价格被置空,现可正常落库。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
dfb9ab34c0
|
feat(lingxing): 接入 Temu 与 Shopify 在线商品
Temu(/basicOpen/multiplatform/temu/list, POST, qps 1, 上限 1000):
- TemuListingDto 全字段 + 嵌套 wareHouseDataList / supplyPriceList / promotionalPriceDataList
- 固定 offset 分页(useCursor=false);总数取 data.count
- 时间窗 updateStartTime/updateEndTime 按 UTC 发送
- 映射:msku→platformSku、productUniqueId→listingId、imgUrl→imageUrls、
status(0 删除/2 正常)、当前生效申报价→price(币种符号 ¥ 无法判定时不填金额)
- 其余进 attributes(SKC/SPU、仓库库存、活动价、JIT、selectStatus 等)
Shopify(/basicOpen/multiplatform/shopify/variantList, POST, qps 1, 上限 1000):
- ShopifyListingDto 全字段 + location_infos 嵌套
- 映射:msku→platformSku、product_unique_id→listingId、
picture_url||parent_picture_url→imageUrls、status 1/2/3/4 归一、
price + currency_icon、listing_start_time→listedAt
- 其余进 attributes
Platform 新增 SHOPIFY,并在适配器与工厂的 platforms() 中登记;
LingxingSubPlatforms 注册 TemuSubPlatform / ShopifySubPlatform。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
2a046d4e9e
|
feat(lingxing): 沃尔玛在线商品;店铺列表不再按状态过滤
沃尔玛商品(/basicOpen/multiplatform/walmart/list, POST, qps 1, 上限 200):
- WalmartListingDto:34 个字段全覆盖(文档标注均为必填)
- WalmartProductSource:store_ids 传数组;时间窗按 Y-m-d,字段类型取更新时间(2),
超 31 天截断;响应在 data.list
- 映射:msku→platformSku、item_id→listingId、gtin/upc→gtin、picture_url→imageUrls、
status_name 按名称归一、price + currency_icon 反推币种、
offer_start_date→listedAt、listing_start_time→updatedAt
- 其余字段全部进 attributes
- WalmartSubPlatform 注册 productSource
店铺列表:
- 移除 SC / VC 的 status != 1 过滤,SDK 只转发
- 调用方按 SubChannel.status() 自行决定可用性
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
a4135f5862
|
feat(shop): SubChannel 补齐店铺标准字段,SC/VC 全字段映射
SubChannel 新增(均有注释说明对应领星字段):
- sellerId SC/VC 的 seller_id
- accountName account_name
- status 原始授权状态(不再只保留正常店铺后在结果里丢失状态)
- region SC/VC 的 region,如 na / eu
- regionName VC 的 region_name,如 北美洲
- country SC 的 country
- marketplaceId SC 的 marketplace_id
- marketplaceNum mid
- attributes 其余平台特有字段(seller_account_id / has_ads_setting / account_id)
保留旧的四参构造器,已有调用方无需改动;新增 Builder 便于扩展。
用途:调用方构造 ChannelAccount 时可直接从 SubChannel 取 region/country,
不必再硬编码 marketplaceZone。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
e940945174
|
feat(product): ProductListing 扩充标准字段,SC/VC 全字段映射
统一模型新增(都有注释说明对应哪个平台字段):
- platform:业务平台,落库时不必再反查账户
- listingId / asin / parentAsin / gtin:平台商品标识
- attributes:未标准化的原始字段(本地 SKU、库存、费用、排名、尺寸等)
- status 改为枚举 ProductStatus(ACTIVE/INACTIVE/DELETED/UNKNOWN),
rawStatus 保留平台原值
SC 映射:seller_sku / listing_id / asin / item_name / small_image_url /
status+is_delete / price+currency_code / on_sale_time / listing_update_date,
其余 40+ 字段进 attributes。
VC 映射:msku / asin / parent_asin / upc|ean / item_name / small_min_image_url /
status / price,其余进 attributes。
VC 只给货币符号不给 ISO 代码,按符号反推,反推不出时 currency 与 price 都为 null;
¥ 因人民币与日元无法区分,一律返回 null。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
707ecd3e11
|
refactor(lingxing): 亚马逊 SC / VC 分包,补齐能力子目录
之前 SC 的文件直接放在 amazon/ 下、VC 混着 AmazonVc 前缀,层级不一致。
现在两边同构:
amazon/sc/
AmazonScSubPlatform
dto/AmazonScShopDto, AmazonScListingDto
product/AmazonScProductSource
shop/AmazonScShopSource
amazon/vc/
AmazonVcSubPlatform
dto/AmazonVcShopDto, AmazonVcListingDto
product/AmazonVcProductSource
shop/AmazonVcShopSource
类名统一加 Sc/Vc 前缀,避免同名 DTO 混淆。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 weeks ago |
chenchuchuan
|
93fc9648fe
|
feat(lingxing): 接入亚马逊 VC 店铺列表与 Listing
接口(官方文档核对):
- SHOP_LIST_AMAZON_VC /basicOpen/platformAuth/vcSeller/pageList POST, qps 1, 上限 200
- LISTING_AMAZON_VC /basicOpen/listingManage/vcListing/pageList POST, qps 1, 上限 200
实现:
- AmazonVcShopSource:自动翻页拉全部店铺,过滤 status != 1,platform_code 10035,
externalStoreId 取 vc_store_id
- AmazonVcProductSource:vc_store_ids 传数组;msku 作为 platformSku;
on_sale_time 是 Y-m-d,按市场当地时区零点解析
- AmazonVcSubPlatform 注册到 LingxingSubPlatforms
注意:VC Listing 接口无时间窗参数,只能全量翻页后由调用方比对。
Co-Authored-By: Claude <noreply@anthropic.com>
|
2 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
|
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 |