清理旧履约模型残留

This commit is contained in:
yml
2026-05-27 14:22:23 +08:00
parent 5583c60e72
commit 837e1c6e66
19 changed files with 218 additions and 595 deletions
+1 -1
View File
@@ -59,7 +59,7 @@ https://你的域名/api/v1/open/91
| 91字段 | 当前项目用途 | 说明 |
| --- | --- | --- |
| `orderNo` | 外部订单号 / 幂等键 | 建议映射为内部 `platformOrderId` |
| `productNo` | 商品映射 | 映射到内部 SKU 或履约绑定规则 |
| `productNo` | 商品和店铺映射 | 默认按商品名匹配 cloudtentacles 商品;可用 `商品名----店铺编号` 携带快手小店 `shopId` |
| `buyNum` | 购买数量 | 生成对应数量的履约任务 |
| `maxAmount` | 成本上限校验 | 可选,超限返回失败 |
| `callbackUrl` | 备用回调地址 | 先保留,不作为主流程依赖 |
+7 -15
View File
@@ -155,8 +155,8 @@ platforms: {
这样可直接复用现有:
- 商品匹配;
- 履约绑定
- 91 商品名到 cloudtentacles 商品名的匹配;
- cloudtentacles 覆盖规则(套装、多数量发货)
- 快手 Cloud task 创建;
- claim token 生成。
@@ -247,21 +247,13 @@ Node 侧实现等价为:
## 10. 商品匹配设计
当前项目的订单商品匹配依赖
当前项目的 `91` 下单流程直接使用 `productNo` 做履约匹配
- `provider`
- `platform`
- `shopId`
- `externalSkuCode` / `externalItemId` / `externalSkuName`
- 默认把 `productNo` 当作商品名,匹配 cloudtentacles 商品列表里的同名商品;
- 如果 `productNo` 使用 `商品名----店铺编号` 格式,前半段用于商品匹配,后半段作为快手小店 `shopId` 用于核销;
- 特殊商品通过 cloudtentacles 覆盖规则处理,例如一个 91 商品发多个 cloudtentacles 商品,或某个商品发多次。
因此接入 `91` 后,运营侧需要新增对应绑定规则,使:
- `provider = '91kaquan'`
- `platform = 'kuaishou'`
- `shopId = '91kaquan'`
- `externalSkuCode = productNo`
最终匹配到现有快手 Cloud 履约配置。
最终目标是让 91 卡券只传商品名,系统按商品名和覆盖规则自动创建快手 Cloud 履约任务。
## 11. 日志与排障