feat(finance): 完成成本快照运行层、销售事实与人工支出登记

迁移 108-111：快照业务时间与预估转实际、销售事实表、系统成本项、公司人工支出登记。接单平台按工单实际 reward 入账；人工支出支持登记/审批/驳回/报销并写 actual 快照。新增销售毛利页、人工支出页与订单入口。
2026-10-22 16:41:03 +08:00
parent 15989af87c
commit 0889235870
39 changed files with 4824 additions and 143 deletions
@@ -1,12 +1,10 @@
 -- ============================================================================
 -- 人工支出登记 + 轻量人工处理记录（建表草案）
 -- ----------------------------------------------------------------------------
-- 状态：草案（DRAFT）。**未接入** apps/backend/src/db/migrations。
--       依赖：本文引用 product_catalog / cost_items / cost_snapshots / manual_expenses，
--             必须**在** `2026-10-17-成本中心与销售事实-DDL草案.sql` **之后**应用；
--             `manual_expenses` 已由迁移 100 创建（客服备用金支出）。
--       当前已使用迁移至 107（成本中心落在 103–107）；本文建议顺延为
--       `108_manual_cases.sql`、`109_manual_expenses.sql`，接入时按实际最大号调整并先跑 `npm run check:sql`。
+-- 状态：已实施 P0。`manual_expense_records` / `manual_expense_events` 已接入
+--       `111_manual_expense_records.sql`；`manual_fulfillment_cases` 仍未实施。
+--       依赖：product_catalog / cost_items / cost_snapshots / manual_expenses。
+--       当前已使用迁移至 111（成本中心 103–108，系统成本项 110，人工支出 111）。
 -- 基线：main @ 7542d547；依据：2026-10-17 业务口径确认 + 2026-10-18 备用金落地复核。
 --
 -- 重要命名边界：
@@ -1,13 +1,14 @@
 -- ============================================================================
 -- 通用成本中心 + 标准商品 + 销售事实（建表草案）
 -- ----------------------------------------------------------------------------
-- 状态：部分落地。商品主数据 + 渠道映射 + 成本中心已接入 `103_product_catalog.sql`、
--       `104_cost_center.sql`、`105_cost_center_bootstrap_fix.sql`；本文件仅保留设计追溯。
--       尚未实施的 `sales_daily_facts` 等后续内容，接入时从新迁移号继续，并先跑 `npm run check:sql`。
+-- 状态：商品、成本、销售事实均已落地。商品主数据 + 渠道映射接入 `103_product_catalog.sql`，
+--       成本中心接入 `104_cost_center.sql` / `105_cost_center_bootstrap_fix.sql` / `108_cost_snapshot_runtime.sql`，
+--       销售事实接入 `109_sales_daily_facts.sql`；本文件仅保留设计追溯。
+--       注意：实际 `sales_daily_facts.canonical_product_id` 允许为空（未归一桶），与下方草案的 NOT NULL 不同。
 -- 基线：main @ 7542d547；数据依据：本地只读克隆（生产快照，orders 316,597，数据截至 2026-10-14）。
 -- 金额单位：分（BIGINT）。本文件所有 *_fen 列均为分。
 -- 设计依据：docs/成本中心与三块履约模型.md（三块载体、成本版本与快照）、docs/财务系统集成方案.md。
-- 当前状态：商品主数据、渠道映射、成本中心已实施 P0；销售事实未实施。客服备用金支出已实施，但不是本文件的成本中心。
+-- 当前状态：商品主数据、渠道映射、成本中心、销售事实均已实施 P0。
 --
 -- 目标（业务原话）：以后改成本只在一个地方。
 --   -> 所有成本金额只写 cost_versions；业务表只保存 cost_snapshot_id 与派生金额，永不回写历史。