yueyang
f7197b4976
财务分析新增开票/不开票费用,并补齐违约赔付预览 (#480)
## 任务占用与边界
- 任务名称:财务分析开票费用与业绩明细违约赔付预览
- 实际开发者:yueyang
- 任务来源/团队分工:负责人直接指定
- 目标结果:财务经营分析表按科目映射表拆分开票费用/不开票费用;业绩明细增加违约赔付(冲减收入)列并按指定顺序展示。
- 预计修改路径:业务 Pages Controller、财务分析视图、账单明细数据服务、业绩明细配置与相关测试。
- 将写入的公共契约:财务分析费用聚合、默认补偿预览命令、业绩明细列配置。
- 仅复用、明确不修改的公共契约:store_receipt_order_match_rows、ec_account_mapping_rules。
- 数据源、表/视图和字段:店铺收款账单镜像、store_receipt_order_match_rows、store_receipt_product_cost_rows、ec_account_mapping_rules。
- 明确不修改的范围:账单抓取与上游同步链路。
## 开工碰撞检查
- [x] Codex 已执行 scripts/codex-task-preflight.ps1
- [x] 已检查最新 main 和远程任务分支
- [x] 已搜索主线既有页面、接口和数据服务
- [x] 已将写入和复用契约分开
- [x] 预检列出的残留分支均无开放 PR;当前 2 个开放 PR 与本任务无关,确认无活跃写入冲突
## 实际改动
- 财务经营分析表增加“开票费用”“不开票费用”及合计;财务类型=费用,票据口径 0.06/0.09 归入开票,不开票归入不开票,金额按支出减收入净额。
- 费用聚合并入现有月度缓存,缓存键包含科目映射哈希,映射变化后自动失效。
- 业绩明细增加违约赔付(冲减收入)列,放在冲减金额后。
- CSV 导出列同步更新。
## 验证证据
- 正常流程:2026-07/08/09 实库数据计算成功;2026-09 开票费用 3,896,538.65,不开票费用 81,377.62。
- 实际页面:2026-09 财务经营分析表 438 行,两列与合计正常展示。
- 性能:单月费用聚合 7.0–13.6 秒,PHP 峰值约 65.5 MB;页面结果缓存 5 分钟。
- 自动测试:NavigationTest 目标 2 条通过(35 assertions),StoreReceiptMappingPreviewOverrideTest 2 条通过(5 assertions)。
## 风险检查
- [x] 不涉及数据库迁移或生产数据写入
- [x] 涉及金额口径,已用实库页面和固定总额核对
- [x] 未提交 .env、密码、Token、真实数据或构建产物
- [x] 前端符合 DESIGN.md 黑金表格样式
## 合并前复查
- [x] 已基于最新 main 53bd1dc4 变基
- [x] 完整 diff 自审,无冲突标记
- [x] 目标测试通过
- [x] 负责人已授权 Squash merge 和发布
Reviewed-on: #480
2026-10-23 19:05:35 +08:00
..
2026-08-31 17:50:42 +08:00
2026-10-23 16:21:15 +08:00
2026-10-23 17:27:31 +08:00
2026-09-07 12:56:31 +08:00
2026-10-19 17:53:14 +08:00
2026-07-20 18:20:25 +08:00
2026-09-07 12:50:09 +08:00
2026-08-31 18:49:00 +08:00
2026-07-20 18:20:25 +08:00
2026-10-23 16:21:15 +08:00
2026-08-31 19:43:03 +08:00
2026-09-24 13:30:09 +08:00
2026-07-20 18:20:25 +08:00
2026-07-20 18:20:25 +08:00
2026-10-08 13:19:53 +08:00
2026-10-16 22:27:46 +08:00
2026-10-06 17:26:41 +08:00
2026-10-16 17:19:37 +08:00
2026-10-21 13:47:01 +08:00
2026-09-11 12:25:36 +08:00
2026-10-08 13:20:01 +08:00
2026-10-20 19:08:47 +08:00
2026-09-22 19:07:11 +08:00
2026-09-22 10:42:38 +08:00
2026-10-19 16:06:55 +08:00
2026-10-19 16:06:55 +08:00
2026-10-06 22:08:08 +08:00
2026-10-23 15:02:03 +08:00
2026-09-21 01:08:46 +08:00
2026-09-22 16:48:33 +08:00
2026-09-24 11:44:44 +08:00
2026-10-07 11:14:04 +08:00
2026-10-07 16:53:55 +08:00
2026-10-18 11:52:02 +08:00
2026-09-22 14:55:44 +08:00
2026-09-30 09:50:50 +08:00
2026-08-25 15:34:39 +08:00
2026-10-23 16:21:15 +08:00
2026-10-13 20:13:53 +08:00
2026-10-19 10:38:36 +08:00
2026-10-23 15:47:39 +08:00
2026-09-19 01:52:45 +08:00
2026-09-27 17:25:04 +08:00
2026-09-24 10:29:59 +08:00
2026-09-12 20:29:43 +08:00
2026-08-31 18:49:00 +08:00
2026-07-24 12:18:01 +08:00
2026-07-20 18:20:25 +08:00
2026-07-20 18:20:25 +08:00
2026-07-24 13:40:03 +08:00
2026-09-23 18:29:15 +08:00
2026-10-07 13:52:18 +08:00
2026-09-23 18:29:15 +08:00
2026-09-02 16:07:16 +08:00
2026-10-23 19:05:35 +08:00
2026-10-12 09:33:24 +08:00
2026-10-12 09:33:24 +08:00
2026-10-13 19:54:01 +08:00
2026-10-13 19:54:01 +08:00
2026-10-13 20:04:02 +08:00
2026-10-19 16:06:55 +08:00
2026-07-20 18:20:25 +08:00
2026-07-24 12:18:01 +08:00
2026-10-19 17:53:14 +08:00
2026-09-09 12:05:38 +08:00
2026-10-23 16:21:15 +08:00
2026-10-19 17:53:14 +08:00
2026-10-19 17:53:14 +08:00
2026-10-19 17:53:14 +08:00
2026-07-20 18:20:25 +08:00
2026-07-20 18:20:25 +08:00
2026-08-13 12:35:06 +08:00
2026-10-11 12:11:15 +08:00
2026-09-09 10:46:17 +08:00
2026-08-29 09:34:07 +08:00
2026-10-21 10:37:59 +08:00
2026-10-19 14:56:54 +08:00
2026-10-20 19:08:47 +08:00
2026-10-08 09:35:34 +08:00
2026-09-09 12:05:38 +08:00
2026-08-14 15:21:49 +08:00
2026-09-22 18:50:23 +08:00
2026-10-23 19:05:35 +08:00
2026-10-23 17:41:01 +08:00
2026-10-17 00:19:09 +08:00
2026-10-19 10:47:29 +08:00
2026-10-13 19:54:01 +08:00
2026-10-11 13:57:28 +08:00
2026-09-20 15:44:01 +08:00
2026-07-20 18:20:25 +08:00
2026-07-20 18:20:25 +08:00
2026-07-20 18:20:25 +08:00
2026-07-20 18:20:25 +08:00
2026-07-24 20:45:09 +08:00
2026-08-03 19:15:19 +08:00
2026-07-24 18:20:33 +08:00
2026-08-31 18:49:00 +08:00
2026-07-20 18:20:25 +08:00
2026-10-20 13:26:20 +08:00
2026-10-19 16:06:55 +08:00
2026-08-31 17:50:42 +08:00
2026-10-19 14:56:54 +08:00
2026-09-24 16:14:17 +08:00