 yml2213andClaude Opus 4.5
|
d07d88e25c
|
feat(finance): 积分钱包操作 + 客服「确认履约」闭环
把「配置 → 待办 → 确认履约 → 扣额度 → 写成本快照」整条链路打通，
客服点一下就完成履约，不需要填复杂的东西。
积分钱包（P1.3）：
- platform-credit-service.ts：充值 / 调整 / 消耗 / 流水查询。
- 三平台积分互不通用，每客服每平台一个账户；余额只能由流水产生，
消耗不足直接拒绝（409），不允许负余额，与备用金口径一致。
- 换算率按平台：南航、乐玩 1 积分 = 1 分，ROCK 1 积分 = 1 元。
- 充值 / 调整只对 admin/operator/finance 开放；客服只能看自己的钱包。
- 备用金现金不在这里，走现有 fund_* 链路。
确认履约（P1.4）：
- manual-fulfillment-service.ts：待办列表 + 确认履约。
- 待办口径：order_items.fulfillment_mode='manual' 且已配 fulfillment_config_id。
人工单**不建 fulfillment_tasks**——那是自动发货通道的体系，人工单历来不走它
（本地 102,955 个人工单的任务行数为 0）。
- 「已履约」判定：该订单项存在有效 manual_case 成本快照。
- 固定成本（消耗积分 > 0）→ 零输入；成本不固定（= 0）→ 只填实际成本金额。
- 确认时：积分平台扣积分钱包、备用金现金走 writeFundExpense，
随后写 actual 成本快照（主体 = 积分流水 id 或备用金支出单 id）。
- 渠道与消耗积分永远提前配好，客服不选；重复履约直接拒绝。
前端：
- 新增「人工履约」页（客服菜单）：待确认 / 已履约 / 全部，确认履约弹窗。
- 备用金页新增「平台积分」Tab（客服端与管理端各一份）：
余额卡片、积分流水、管理员充值与调整。
E2E 实测：配置 ROCK 100 积分 → 成本 ¥100.00（1 积分 = 1 元）；充值 5000 积分
= ¥5000；确认履约后积分 5000 → 4900，成本快照 actual ¥100.00 写入；
重复履约被拒绝。测试数据已清理，登记表保留 357 条扫描结果供运营使用。
校验：后端 765 项 / 0 失败，前端 143 项全通过（含 tsc -b 与 build）。
Co-Authored-By: Claude Opus 4.5 (1M context) <noreply@anthropic.com>
|
2026-10-24 13:21:34 +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
|
74b62f3494
|
feat(finance): 订单页人工录单按单实际金额计入成本
|
2026-10-22 19:48:56 +08:00 |
|
|
yml2213
|
0889235870
|
feat(finance): 完成成本快照运行层、销售事实与人工支出登记
迁移 108-111：快照业务时间与预估转实际、销售事实表、系统成本项、公司人工支出登记。接单平台按工单实际 reward 入账；人工支出支持登记/审批/驳回/报销并写 actual 快照。新增销售毛利页、人工支出页与订单入口。
|
2026-10-22 16:41:03 +08:00 |
|
|
yml2213
|
bf167d98ed
|
新增财务角色与财务报表并完善后台权限
|
2026-09-02 13:58:03 +08:00 |
|