修复接单模板商品成本范围可见性

docs/生产升级操作手册.md

@@ -3,7 +3,7 @@ type: 生产运维操作手册
 description: order_site 生产结构升级、数据切换、验收与回滚的唯一执行步骤。
 tags: [生产, 部署, 数据库, 迁移, 备份, 回滚, 财务]
 status: current
-version: 1.1
+version: 1.2
 updated_at: 2026-11-14
 ---
 
@@ -25,13 +25,15 @@ updated_at: 2026-11-14
 > 不得按旧的 `147–150` 一条路径直接上线。
 >
 > 2026-11-14 增量待发布基线：在 `161` 之上依次新增
-> `162_fulfillment_queue_buckets.sql`、`163_work_order_hall_price_version.sql`。
+> `162_fulfillment_queue_buckets.sql`、`163_work_order_hall_price_version.sql`、
+> `164_template_product_cost_visibility.sql`。
 > `162` 建立履约待办四桶只读投影、补载体扫描专用索引和新单优先扫描口径；
 > `163` 增加接单大厅价格成本版本引用、改价同步候选索引和版本闸门，不重写历史工单金额。
+> `164` 增加接单模板到标准商品的显式关联，修复无订单模板商品落入未路由、无法先配置成本的问题。
 > 两项迁移都不改写原始订单、履约尝试或售后事实；仍须完成停写、最终备份、隔离恢复验证、
 > 迁移、健康检查、履约审计和大厅价格审计后才可恢复营业。
 
-### 1.1 迁移 `151 → 163` 增量门禁
+### 1.1 迁移 `151 → 164` 增量门禁
 
 - 升级前必须确认生产最高迁移仍为 `151`；分支合并后重新核对迁移号，禁止回退或改写 `151` 及以前文件。
 - 半自动迁移已收敛为单个 `161_semi_auto_fulfillment.sql`，不得在已应用 main `158–160`
@@ -44,7 +46,10 @@ updated_at: 2026-11-14
   `v_fulfillment_queue`、补载体部分索引存在；
 - `163` 新增 `work_orders.hall_price_version_id`、模板工单进入 `open` 的版本闸门和
   改价同步候选索引；正在使用寄卖现货的合同态工单豁免版本闸门。
-- 用测试库完成 `001 → 163` 空库迁移，并在隔离库验证 `151 → 163`。
+- `164` 新增 `work_product_rules.canonical_product_id` 及唯一索引，并重建
+  `v_product_current`，让无订单的模板商品明确归属接单平台成本范围。
+- 用测试库完成 `001 → 164` 空库迁移，并在隔离库验证 `151 → 164`。
+- 迁移后必须验证新建停用模板能在“接单平台”成本页签看到并配置成本，且不出现在“未路由”。
 - 迁移后执行 `npm run audit:work-order-hall-pricing`，`critical` 必须为 0。
 - 该增量仍包含迁移，普通停机发布不能使用 `deploy/ubuntu-deploy.sh` 在旧后端运行时直接换库；
   必须沿用本手册的停写、最终备份、隔离恢复验证、迁移、新后端健康检查和验收流程。
@@ -431,7 +436,7 @@ docker compose --profile tools run --rm --no-deps tools \
 
 ### 6.3.1 接单大厅价格审计
 
-迁移 `163` 后必须执行：
+迁移 `163`、`164` 后必须执行：
 
 ```bash
 docker compose --profile tools run --rm --no-deps tools \
@@ -445,6 +450,7 @@ docker compose --profile tools run --rm --no-deps tools \
 - 普通工单金额和拼单剩余份额单价必须与当前模板一致。
 - 已加入拼单份额的合同金额不得因审计或改价被重写。
 - 寄卖合同态工单不参与模板价审计覆盖。
+- 新建停用模板必须已出现在“接单平台”标准商品范围，并能先配置成本；不得显示为“未路由”。
 
 `warning` 可包含尚未发布的 `pending_material / unassigned` 工单价格待同步项，
 但必须由发布负责人在恢复营业前执行模板同步或记录结构化待办，不得手工猜价。

docs/统一订单履约与财务模型-权威版.md

@@ -3,7 +3,7 @@ type: 权威架构与实施计划
 description: 订单、内部 SKU、履约路由、履约执行、商品、成本与财务的唯一权威口径及重构计划。
 tags: [订单, 内部SKU, 履约, 商品, 成本, 财务, 迁移]
 status: authoritative
-version: 2.19
+version: 2.20
 updated_at: 2026-11-14
 ---
 
@@ -12,7 +12,7 @@ updated_at: 2026-11-14
 > 状态：**唯一权威文档**。
 > 最后校准：2026-11-14。
 > 生产基线：迁移 `151`。
-> 开发基线：迁移 `163`（仅本地，尚未部署生产）。
+> 开发基线：迁移 `164`（仅本地，尚未部署生产）。
 >
 > 从本文件生效起，订单、内部 SKU、履约渠道、履约载体、标准商品、成本和财务相关实现，
 > 只能以本文件为业务口径。其他旧分析只作为历史资料，不再具备设计或验收效力。
@@ -380,6 +380,20 @@ manual fulfillment
 - 只读审计命令为 `npm run audit:work-order-hall-pricing`；`open` 工单的版本、金额或份额单价
   不一致属于 critical，必须停止继续放大并修复，不自动猜测补价。
 
+### 3.4.4 接单模板标准商品归属
+
+接单模板和它的标准成本商品通过 `work_product_rules.canonical_product_id` 显式关联。
+该关系只用于确定成本商品归属和页面范围，不用于订单履约路由。
+
+- 新模板创建时必须同步生成 `tpl:` 标准商品并写入该关联。
+- 即使还没有订单、没有命中内部 SKU、没有 `sku_channel_routes`，模板商品也必须出现在
+  “商品与成本中心 → 接单平台”范围，能够先配置成本再启用模板。
+- 模板商品不得因为缺少内部 SKU 路由而显示为“未路由”；“未路由”只用于确实等待渠道配置的内部
+  SKU 商品。
+- 不得从 `tpl:` 前缀、商品名或模板名称反推该关系。
+- 已有模板商品在迁移 `164` 中按模板生成的标准 SKU 一次性回填关联；删除仍被模板引用的商品时
+  必须拒绝并提示改为归档。
+
 ### 3.5 商品与财务域
 
 标准商品目标结构：
@@ -1027,18 +1041,20 @@ docs/archive/
 
 ## 十三、当前下一步
 
-截至 2026-11-14，生产基线为 `151`，集成分支开发基线为 `163`。迁移 `152` 保护订单来源快照，
+截至 2026-11-14，生产基线为 `151`，集成分支开发基线为 `164`。迁移 `152` 保护订单来源快照，
 迁移 `158–160` 收口寄卖登记人同步、寄卖平台与自动匹配设置；
 迁移 `161` 一次建立人工渠道半自动任务、内置 Connector 默认值、账号级 Cookie JSON 凭证、
 任务凭证引用和最终约束；迁移 `162` 建立履约待办四桶只读投影、补载体专用索引和新单优先扫描口径。
 迁移 `163` 增加接单大厅价格成本版本引用、改价同步候选索引和旧版本进入大厅的数据库闸门；
 该迁移不重写历史工单金额，寄卖合同态显式豁免。
+迁移 `164` 增加接单模板到标准商品的显式关联，并同步商品渠道投影，保证新模板在无订单时也能
+进入接单平台成本范围。
 迁移中保留的 `semi_auto.credential.export` 权限仅作兼容记录，
 不再作为 CK 导出门禁。
 
 1. 生产升级只按 [生产升级操作手册](生产升级操作手册.md) 执行。
 2. 升级前备份必须完成隔离恢复验证；恢复验证未通过时禁止迁移。
-3. `147 → 163` 按生产升级手册分批执行，迁移后刷新统计并完成商品、履约、
+3. `147 → 164` 按生产升级手册分批执行，迁移后刷新统计并完成商品、履约、
    财务和大厅价格审计；无法确定的数据进入未路由或待分类，不做猜测。
 4. 执行 `finance:rebuild-derived` 的 dry-run，核对 A 级数据守恒后，
    再按窗口执行 `--execute --confirm=REBUILD_DERIVED`，并验证第二次重建幂等。