lml
|
f1d6d80dd8
|
fix(observability): 批处理部分失败不再记为 SUCCESS
- CallOutcome 增加 PARTIAL;CallRecord 增加 failedCount / resultCode
- CallSupport 增加 ResultSummary/ResultMapper 与 observeSummary,支持成功/部分成功/失败三态
- 审核发货、编辑订单按逐单结果记录 PARTIAL 与失败数
- 审核发货全部失败、编辑订单 code=10000 时抛 PlatformBusinessException,
避免 sdk.writes() 把业务键记成 SUCCEEDED 后阻断重试
- outbounds.submit 返回 false 时记 FAILURE
- 新增 PartialFailureAuditTest 覆盖四种场景
验证:mvn -q -pl core -am -Dtest='PartialFailureAuditTest,CallObserverTest' -DfailIfNoTests=false test
|
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
|
cb9c04c80f
|
feat(observability): 增加 SDK 调用日志与审计扩展点
- 新增 CallObserver SPI 与 CallRecord/CallOutcome:SDK 只产出结构化记录,落库/发 MQ 由宿主实现
- 新增 CallSupport:统一计时、结果数量、异常捕获;观察者异常吞掉并打 WARN,不影响业务调用
- 新增 Slf4jCallObserver:成功 INFO、失败 WARN,时间格式 yyyy-MM-dd HH:mm:ss,时区与格式可配置
- ChannelSdk.Builder 增加 callObserver(...),默认 NOOP
- salesOrders / products / settlements / afterSales / outbounds / subChannels 全部埋点,能力检查失败也记录
- CallRecord 覆盖 requestId、provider/platform、omsStoreId/storeId、operation、outcome、耗时、结果数、
参数摘要、错误类型/消息、retryable、平台 request_id
- 时间内部统一存 UTC,另提供 occurredAt(zone) / finishedAt(zone) 供本地展示
|
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 包
|
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 |
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>
|
3 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>
|
3 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>
|
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
|
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 |
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>
|
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
|
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>
|
3 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>
|
3 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>
|
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
|
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
|
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
|
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
|
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
|
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 |