 yml2213
|
472769a977
|
refactor(db): 财务迁移收敛为 103–107
把 103–112 十个迁移收敛为五个，删除在「生产 102 → 当前」路径上的空操作与补丁：
- 108（下线人工支出登记）与 109（隔离历史快照主体）在生产库和重建库上都是空操作，
口径注释并入 104；
- 111 是给 104 自身种子打的补丁，合并后 104 直接写入 active 0 元占位；
- 112 的 cost_exceptions.resolution_note 并入 104，退款表独立为 106；
- 106（备用金编号可读化）与 110（积分钱包）合并为 107（人工履约资金层）；
- 107（履约方式列）并入 105，履约方式本就是销售事实的维度键。
配套调整：
- check-sql-guard 改为以 main 为基线校验迁移字节，删除 103–114 的永久豁免；
未合并分支上的新迁移仍可重写，已发布迁移不可修改。
- 本地库原地改造脚本移入 docs/archive，禁止对新环境执行。
验证：清掉 schema_migrations 里 103–112 的记录后重跑，升级结果与全新构建的
schema 完全一致（pg_dump --schema-only 仅随机 token 不同），种子数据一致；
升级前后业务数据量不变（成本版本 713 → 712，差异来自删除占位草稿）。
|
2026-10-25 11:38:12 +08:00 |
|
|
yml2213andClaude Opus 4.5
|
fb679d76f6
|
refactor(finance): 人工成本收敛为「人工录单 → 扣备用金 → 写快照」
公司人工支出登记单与审批报销状态机整链下线，人工成本只留一条链路。
口径调整（2026-10-23 确认）：
- 历史人工支出找不回来，直接放弃：不补录、不做样本校准、不做均价估算，
只保证上线后的新单不丢。
- 人工成本逐单按实际金额，从客服备用金扣款，客服只能用本人账户；
没有登记单、没有审批、没有报销，录入即计入毛利。
后端：
- 新增 services/finance/manual-order-cost-service.ts：扣备用金 + 写 actual
成本快照，同一事务，余额不足直接拒绝不允许负余额。
- 成本快照主体从「人工支出登记单 id」改为「客服备用金支出单 id」
（subject_type='manual_case'，subject_id=manual_expenses.id）。
- 删除 services/finance/manual-expense-service.ts（1263 行）与
routes/admin/finance.ts 下 /finance/manual-expenses* 全套接口。
前端：
- 删除 AdminManualExpensePage.tsx（778 行）与 /admin/manual-expenses 菜单页。
- ManualOrderCostModal 去掉「提交审核 / 立即计入成本」开关，录入即生效。
- 新增 services/admin/manual-order-cost.ts。
迁移：
- 106_manual_expense_records.sql → 106_fund_account_no_readable.sql，
只保留备用金账户编号可读化。
- 108_drop_manual_expense_records.sql：删除 manual_expense_records 与
manual_expense_events 两张表。
- 109_isolate_legacy_manual_snapshots.sql：把来源为旧登记链的历史孤儿快照
subject_id 改为负数，与 manual_expenses.id 彻底隔离。
踩坑修复（E2E 实测发现）：主体 id 换空间后与历史孤儿快照撞唯一索引
uq_cost_snapshots_active_subject_item，INSERT ... ON CONFLICT DO NOTHING
静默跳过，导致「钱从备用金扣了、成本快照却没写成」。修法是迁移 109 隔离
legacy 主体 + 后端快照写失败必须抛错回滚（409），杜绝账实不符。
文档：现行 5 篇 + README 基线校准为 dev @ 43f402cf + 迁移 103–109，
修正已删除的旧迁移号，删除「人工支出登记 + 审批 + 报销」口径，
已作废 DDL 草案移入 docs/archive/2026-10-23/。
校验：后端 765 项 / 0 失败（含 check:sql 迁移护栏），前端 143 项全通过；
E2E 实测两笔同订单项各自独立主体、余额扣减与快照金额一一对应；
本地库迁移 108/109 执行后数据量与改造前完全一致。
Co-Authored-By: Claude Opus 4.5 (1M context) <noreply@anthropic.com>
|
2026-10-24 11:31:29 +08:00 |
|
|
yml2213
|
43f402cf72
|
docs(finance): 现行财务文档收敛为 5 篇，履约口径只定义一次
原 9 篇 3,647 行，履约分类口径在总纲、模型文档、交接总结里重复三遍，
且仍留着"三块履约""按小时人工成本"等已作废表述。本次收敛为 5 篇
1,778 行：
- 财务与履约口径总纲-2026-10-23.md（300 行）：唯一口径来源
七条硬口径、三个正交维度、真实履约构成、成本模型规则、人工全覆盖、
实施顺序、进度、验收 SQL、防回归清单
- 成本中心与履约模型.md（471 行）：数据模型、迁移 103–107、履约回填、
销售事实、本地库原地改造、索引与性能
- 成本中心API契约.md（270 行）：字段替换总表、枚举、前后端模块边界
- 人工支出与备用金.md（218 行）：人工支出登记字段/状态机/权限 +
客服备用金台账
- 财务系统集成方案.md：复式总账层（未实施）
旧的 4 篇（成本中心与三块履约模型、人工支出登记落地方案、
客服备用金台账实施方案、财务履约改造交接总结）移入
docs/archive/2026-10-23/ 并加归档提示。
履约分类判定 SQL 只在总纲保留一份，其它文档改为链接。
|
2026-10-23 16:06:40 +08:00 |
|