feat(finance): 接单模板发单金额落规则级成本版本

此前接单平台成本版本只有 sys_work_order_reward 的全局 0 元占位，662 个模板的发单金额从未进入 cost_versions。\n\n现在为 662 个模板各生成一条规则级版本：634 条固定发单金额 + 28 条按件单价；全局 0 元版本仅作“按工单实际结算”占位。成本版本页新增“用户实付均价”和“平均实发/项”，支持按模板名称/规则键搜索，按商品筛选也能命中规则版本。\n\n历史工单快照关联到对应模板版本；模板保存时自动同步单条成本版本；删除模板会先把历史版本脱钩停用，保留快照可追溯。\n\n新增迁移 112 覆盖索引，用户实付聚合从约 1.1s 降到约 150ms。
2026-10-22 19:29:53 +08:00
parent 72e1141c8a
commit 7c8832078f
12 changed files with 547 additions and 43 deletions
@@ -55,7 +55,7 @@
 | 客服备用金台账 | **已实施 P0** | `fund_accounts` / `fund_entries` / `manual_expenses` / `fund_reconciliations`；后台页面、权限、审计已完成 |
 | 后台用户中文显示名 | **已实施** | `admin_users.display_name`，备用金姓名触发器同步；审计、登录记录、任务处理人优先显示中文名 |
 | 商品主数据 + 渠道 SKU 映射 | **已实施 P0（dev 分支）** | 迁移 `103`（映射消歧在 `106`）；`product_catalog` / `channel_product_mappings`，后台「商品与成本」页支持维护、历史订单项回填与按载体分区 |
-| 成本中心 | **已实施 P0（dev 分支）** | 迁移 `104/105/107/108/110`；`cost_items` / `cost_versions` / `cost_snapshots` / `cost_exceptions` 支持版本、预览、快照、异常队列、自动发货价格导入；自动发货订单项按履约任务 SKU 直接归一为 `aff:<skuCode>`（不建渠道映射），接单平台按工单模板回填并补齐长尾商品/映射，人工按支出登记写入实际快照 |
+| 成本中心 | **已实施 P0（dev 分支）** | 迁移 `104/105/107/108/110/112`；`cost_items` / `cost_versions` / `cost_snapshots` / `cost_exceptions` 支持版本、预览、快照、异常队列、自动发货价格导入；自动发货订单项按履约任务 SKU 直接归一为 `aff:<skuCode>`（不建渠道映射），接单平台按工单模板回填商品并为 662 个模板生成规则级发单金额版本，人工按支出登记写入实际快照 |
 | 销售事实 / 订单毛利 | **已实施 P0（dev 分支）** | 迁移 `109`；`sales_daily_facts` 按店铺×日期×标准商品×载体汇总，未归一商品单独成行；后台新增「销售毛利」页，成本缺失会显式告警 |
 | 公司人工支出登记 | **已实施 P0（dev 分支）** | 迁移 `111`；`manual_expense_records` / `manual_expense_events`，后台「人工支出」页支持登记、审批、驳回、报销；与客服备用金 `manual_expenses` 通过 `fund_expense_id` 关联 |
 | 影子总账 | 未实施 | 现有财务页仍是 `UNION ALL` 业务事件拼装，不是复式总账 |
@@ -144,7 +144,7 @@ product_catalog

 接单平台与人工客服各有一个系统成本项（迁移 `110_system_cost_items.sql`）：

- `sys_work_order_reward`：已验收工单按 `work_orders.reward_amount` 写 `actual`；未验收但已确定报酬的工单先按同一金额写 `estimated`（metadata `source=work_order_reward_committed`），验收后升级为 `actual`；取消工单不计成本。版本金额 0 只是占位，不进入商品预估。本地全量已回填 95,870 条 `actual` + 21,217 条 `estimated`。
+- `sys_work_order_reward`：662 个接单模板各生成一条规则级成本版本（634 条固定发单金额 + 28 条按件发单单价），全局 0 元版本只作「按工单实际结算」的占位。已验收工单按 `work_orders.reward_amount` 写 `actual`；未验收但已确定报酬的工单先按同一金额写 `estimated`（metadata `source=work_order_reward_committed`），验收后升级为 `actual`；取消工单不计成本。本地全量已回填 95,870 条 `actual` + 21,217 条 `estimated`，其中 111,831 条快照已关联到对应模板成本版本。
 - `sys_manual_service`：人工支出登记通过后按登记金额写 `actual` 快照；成本版本先为 `draft` 占位，不参与预估，但允许人工支出使用实际金额入账。财务填写正式按单单价后可将版本改为 `active`。

 ### 3.2 渠道 SKU 映射
@@ -407,10 +407,12 @@ orders + order_items + channel_product_mappings + cost_snapshots
 - 模板改价必须生成 `cost_versions`，不能直接改历史工单。
 - 工单实际结算金额写入 `cost_snapshot(actual)`；未验收但已确定报酬的工单先写 `actual` 以外的 `estimated`，验收后升级。
 - 商品归一入口：后台「接单平台」→「按工单回填商品」，接口 `POST /api/v1/admin/cost-center/work-order-products/backfill`。优先按工单真实使用的 `work_orders.product_rule_id` 指向 `tpl:<rule_key>`；仍无法归一的 341 个长尾订单项，再按 `provider + shop_id + sku_code + normalized_sku_name` 自动补 45 个 `wo:` 标准商品和 115 条 `sku_code_name` 渠道映射。两次回填后接单平台归一率 100%。
+- 成本版本入口：后台「接单平台」→「成本版本」→「同步模板发单金额」，接口 `POST /api/v1/admin/cost-center/work-order-template-costs/sync`。662 个模板各生成一条规则级版本（634 固定金额 + 28 按件单价），页面同时显示该模板的「用户实付均价」，用于对比用户付款与发单金额；全局 0 元版本只作实际结算占位。
 - 成本异常：966 个订单项没有成本快照（601 个已取消工单 + 365 个零报酬未验收工单），保留在异常队列；取消/零报酬不等于 0 成本，不自动写 0。
+- 删除模板：历史成本版本会脱钩并停用，`cost_snapshots` 继续引用原版本，保证历史毛利可追溯；不会因为外键把模板卡死。
 - 影子总账负责收入/成本/押金/提现/售后的复式记录；成本中心负责“金额是多少、用了哪个版本”。

-本地实测（2026-10-22）：接单平台 118,053 个订单项全部归一；未归一收入 ¥775,641.19（14.54%）→ ¥0.00。成本 95,870 条 `actual`（¥3,773,401.32）+ 21,217 条 `estimated`（¥754,912.45），合计 ¥4,528,313.77；销售收入 ¥5,335,734.45，毛利率 15.13%。
+本地实测（2026-10-22）：接单平台 118,053 个订单项全部归一；未归一收入 ¥775,641.19（14.54%）→ ¥0.00。成本 95,870 条 `actual`（¥3,773,401.32）+ 21,217 条 `estimated`（¥754,912.45），合计 ¥4,528,313.77；销售收入 ¥5,335,734.45，毛利率 15.13%。成本版本从 39 条增至 701 条（38 自动发货商品 + 662 模板规则 + 1 全局占位）。

 生产数据提示：91/PDD/抖音已验收工单的报酬/订单金额分别约 86%/80%/96.5%。在收入口径未确认前，这个比例只能作为量级参考，不能直接当毛利率。