feat(cost-center): 统一接单模板成本并自动同步商品
This commit is contained in:
yml2213
+20
-13
@@ -151,23 +151,30 @@ normalized_sku_series -- 剥离数量并归一同义字后的名称系列
|
||||
|
||||
**`normalized_quantity` 不预填。** 预填会把"5 个"类 SKU 永久锁死成 1，必须由回填脚本按 SKU 名称解析后写入。`quantity` 长期几乎恒为 1，禁止直接拿它当销量。
|
||||
|
||||
### 2.4 接单模板批量初始化
|
||||
### 2.4 接单模板商品与成本自动投影
|
||||
|
||||
接单模板不允许逐个手工建商品。后台「从接单模板全量同步商品与映射」按以下规则批量生成：
|
||||
日常流程不再依赖「从接单模板初始化」：
|
||||
|
||||
1. **商品全量同步，不依赖订单**：所有启用模板都建/刷新标准商品，内部编码 `tpl:<rule_key>`；模板改名、改分类、改发单金额都会刷新到商品上。新模板还没有工单也能在「商品与成本中心」直接定价。停用模板默认不建商品，勾选后可一并建成「归档」商品。
|
||||
2. **渠道映射仍只按工单证据建**：默认最近 30 天，可在页面日期筛选里调整；范围内没有工单的模板只建商品、不建映射——没有订单就没有平台 SKU 可映射。
|
||||
3. **范围内的工单直接命中模板**，以 `work_orders.product_rule_id` 作为映射的第一手证据，不只看原始 `sku_code`。
|
||||
4. 同一 `provider + shop_id + sku_code` 只命中一个模板时，生成 `sku_code` 精确映射。
|
||||
5. 编码被多个模板复用时，继续用"编码 + 归一名称系列"和"编码 + 精确名称"消歧；只有唯一归属才生成映射。
|
||||
6. 同一编码 + 同一名称仍命中多个模板时，**不选最新、不按次数猜**；跳过并列入冲突清单。
|
||||
7. 来源 + 店铺内名称系列唯一时，额外生成 `sku_name_series` 兜底，永远排在编码类映射之后。
|
||||
8. 数量系列（1个/2个/5个/10个，秘钥/密钥等等价写法）归为同一标准商品；数量写入 `normalized_quantity`，**不能把"5个"再写成 `quantity_multiplier=5`**，否则会重复乘算。
|
||||
9. 重跑初始化只清理**所选时间范围内**由 `source='import'`、备注为"接单模板 … 自动初始化"的映射带出的订单项 `canonical_product_id`，并删除范围内使用到的导入映射；范围外的人工映射、成本版本、快照和真实订单/工单、已建商品都不删除。
|
||||
1. **商品事件驱动**：接单模板保存时，在同一事务内自动创建/更新 `tpl:<rule_key>` 标准商品；模板改名、改分类和启停都会同步投影。新模板默认停用，但商品立即出现在成本中心等待配置价格。
|
||||
2. **成本唯一写入口**：固定金额、按件单价和待抢单价格同步只允许从「商品与成本中心 → 标准商品 → 配置成本」写入。接单模板 API 拒绝新增或修改价格。
|
||||
3. **事务一致性**：成本中心改价会在同一事务内新增/退休成本版本、更新 `work_product_rules` 运行价格和商品价格属性；事务成功后才同步未领取的大厅工单。
|
||||
4. **启用前校验**：模板必须有当前生效且金额大于 0 的规则级成本版本，才允许启用。历史已领取工单保持原价。
|
||||
5. **历史修复工具**：「修复历史商品/映射」只用于补历史渠道映射和修复异常商品，不再同步模板价格，也不是新模板或新成本的必经步骤。
|
||||
|
||||
历史渠道映射修复仍按以下规则执行：
|
||||
|
||||
1. **映射只按工单证据建**：默认最近 30 天，可在页面日期筛选里调整；范围内没有工单的模板不会凭空生成平台 SKU 映射。
|
||||
2. **范围内的工单直接命中模板**，以 `work_orders.product_rule_id` 作为映射的第一手证据，不只看原始 `sku_code`。
|
||||
3. 同一 `provider + shop_id + sku_code` 只命中一个模板时，生成 `sku_code` 精确映射。
|
||||
4. 编码被多个模板复用时，继续用"编码 + 归一名称系列"和"编码 + 精确名称"消歧；只有唯一归属才生成映射。
|
||||
5. 同一编码 + 同一名称仍命中多个模板时，**不选最新、不按次数猜**；跳过并列入冲突清单。
|
||||
6. 来源 + 店铺内名称系列唯一时，额外生成 `sku_name_series` 兜底，永远排在编码类映射之后。
|
||||
7. 数量系列（1个/2个/5个/10个，秘钥/密钥等等价写法）归为同一标准商品；数量写入 `normalized_quantity`，**不能把"5个"再写成 `quantity_multiplier=5`**，否则会重复乘算。
|
||||
8. 重跑修复只清理**所选时间范围内**由 `source='import'`、备注为"接单模板 … 自动初始化"的映射带出的订单项 `canonical_product_id`，并删除范围内使用到的导入映射；范围外的人工映射、成本版本、快照和真实订单/工单、已建商品都不删除。
|
||||
|
||||
本地验证结果（2026-10-18）：启用模板 662 个；分层映射 4,426 条（编码精确 2,302、编码 + 精确名称 440、编码 + 名称系列 160、名称系列兜底 1,524）；可唯一归一 86,533 个有证据订单项，另有 25,918 个订单项属于 32 组真实冲突，保持未映射。
|
||||
|
||||
全量同步改版后（2026-10-29，本地库预览 09-30 ~ 10-29）：模板 710 个全部启用、范围内有工单证据 388 个；商品新建 704 个 / 复用 6 个，候选映射 3,198 条。之前被跳过的 322 个无单模板，现在也会有商品（可定价），只是暂时没有渠道映射。
|
||||
迁移 122 后（2026-11-02 本地核对）：714 个接单模板全部有 `tpl:` 商品，无缺失；没有工单证据的模板也可以直接在成本中心定价，只是暂时没有渠道映射。
|
||||
|
||||
### 2.5 自动发货商品
|
||||
|
||||
@@ -223,7 +230,7 @@ cost_versions
|
||||
|
||||
| 编码 | 成本模型 | 说明 |
|
||||
| --- | --- | --- |
|
||||
| `sys_work_order_reward` | `work_order_reward` | 662 个接单模板各一条规则级版本；全局 0 元版本只作"按工单实际结算"的占位 |
|
||||
| `sys_work_order_reward` | `work_order_reward` | 每个可启用的接单模板各一条规则级版本；全局 0 元版本只作"按工单实际结算"的占位 |
|
||||
| `sys_affiliate_purchase` | `affiliate_purchase` | 上游 SKU 固定成本版本，38 个商品级 |
|
||||
| `sys_manual_service` | `manual_actual` | 订单页确认履约写入 `actual` 快照；版本为 0 元占位 |
|
||||
|
||||
|
||||
@@ -26,6 +26,7 @@
|
||||
119_fulfillment_pending_reason
|
||||
120_fulfillment_routing_invariants
|
||||
121_internal_sku_single_primary
|
||||
122_work_order_template_product_projection
|
||||
```
|
||||
|
||||
重点检查：
|
||||
@@ -36,11 +37,12 @@
|
||||
- 119：只加列和索引，风险低。
|
||||
- 120：建立统一内部 SKU SQL 函数、回填人工配置、迁移可确定的旧 sku_code 规则。
|
||||
- 121：建立唯一主渠道索引；若仍有并列主渠道会主动阻断迁移。
|
||||
- 122：按接单模板补齐/刷新 `tpl:` 商品，只做 UPSERT，不删除商品、成本、订单或工单。
|
||||
- SQL 护栏默认只保护到生产已发布的迁移 119；部署 120 后应把 `PUBLISHED_MIGRATION_MAX_VERSION` 提升为 120。
|
||||
|
||||
## 3. 部署顺序
|
||||
|
||||
1. 执行迁移 116–121；
|
||||
1. 执行迁移 116–122；
|
||||
2. 部署 backend；
|
||||
3. 部署 frontend；
|
||||
4. 启动/恢复定时任务。
|
||||
@@ -161,6 +163,6 @@ npx tsx scripts/reclassify-post-cutover.ts --apply
|
||||
|
||||
- 代码：回退到部署前镜像/commit；
|
||||
- 数据库：
|
||||
- 116–121 均为新增表/列/函数/数据，不删旧表，可保留；
|
||||
- 116–122 均为新增表/列/函数/投影数据，不删旧表，可保留；
|
||||
- 若必须回滚，恢复到部署前备份；
|
||||
- 迁移 118–121 不改旧字段语义，回滚代码后旧逻辑仍可运行；121 的唯一主渠道索引会阻止旧代码写入并列主渠道。
|
||||
|
||||
+2
-2
@@ -244,10 +244,10 @@ bash deploy/post-deploy.sh --only=backfill # ① 收入回填 + ② 履约
|
||||
|
||||
1. 钱包管理 → 补建客服备用金账户 → 按需拨付；
|
||||
2. 商品与成本 → 积分钱包 → 给客服发放三平台积分；
|
||||
3. 商品与成本 → 标准商品 → 从接单模板初始化 → 按工单回填商品 → 归一人工商品；
|
||||
3. 商品与成本 → 标准商品：迁移 122 会自动补齐接单模板商品；新模板保存时也会自动建商品。按需执行「按工单回填商品」和「归一人工商品」，不再需要从接单模板初始化；
|
||||
4. 商品与成本 → 人工 SKU 配置 → 扫描并逐项配置（保存后自动回填订单项）。
|
||||
|
||||
> 第 3 步的商品目录/工单回填必须先于下一节 `--only=sync`。商品目录为空时同步会为每个
|
||||
> 第 3 步的工单回填必须先于下一节 `--only=sync`。商品目录为空时同步会为每个
|
||||
> 未归一订单项写一条 `product_mapping_missing` 异常（实测 90 天约 36 万条）。
|
||||
|
||||
### 3. 财务同步
|
||||
|
||||
Reference in New Issue
Block a user