|
|
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 |
|
|
|
cdabffb3a6
|
业绩明细删除费用项列及相关归集逻辑
|
2026-10-20 10:20:55 +08:00 |
|
|
|
366dcc1da7
|
业绩明细新增费用项并按科目映射费用备注归集
|
2026-10-20 10:00:53 +08:00 |
|
|
|
951fde9c46
|
账单页签：总账备注下拉候选合并科目映射表的财务备注
- 之前候选只来自总账备注映射表，科目映射表里新加的备注在下拉里选不到
- 现在两个来源取并集，改完映射表下一次请求即可筛选
|
2026-10-10 11:20:18 +08:00 |
|
|
|
dd03037105
|
账单页签/账单明细：财务备注按科目映射表关键词取最具体规则
- 行内财务备注把 channel/business_type/order_type 等业务字段纳入关键词匹配（得物退款行可识别）
- 「总账备注/财务备注」筛选折算 SQL 时支持同一账单项目多条规则的关键词条件与兜底反向条件
- 与业绩明细、科目映射表口径对齐（得物退款行统一显示/筛选为退款）
|
2026-10-10 11:13:46 +08:00 |
|
|
|
217b953a03
|
唯品会JX账户：科目映射与总账备注按行内「账单项目」匹配
- AccountLedgerRemarkMap：JX 页签取 payload.second_remark 作为映射的账单项目，
与「科目映射表」里按账单项目（处罚款/客服特殊退款-仅退款/盘盈盘亏…）维护的规则对齐
- AccountBills：总账备注筛选对 JX 改为按行内账单项目过滤，其余页签不变
- 测试同步（总账备注筛选按账单项目命中）
|
2026-10-09 16:57:28 +08:00 |
|
|
|
ae694004cf
|
总账备注匹配：账单项目自动去 wx 前缀再查一次
先原样匹配，不中则去掉开头 wx 前缀（wx基础软件服务费 → 基础软件服务费）再匹配；原样命中优先，不影响既有结果。
科目映射表优先级链路与回落原总账备注链路都按此顺序匹配。
|
2026-10-07 15:58:42 +08:00 |
|
|
|
0933941533
|
总账备注取科目映射表：平台/账单项目键做大小写与空格归一
科目映射表平台写「唯品会JX」、页签内部键「唯品会jx」，原样索引匹配不到；统一小写去空格后索引与查找。
|
2026-10-07 15:30:56 +08:00 |
|
|
|
1cbc8312a6
|
店铺收款账户账单：总账备注优先取「科目映射表」的财务备注
账单项目在「科目映射表」里能匹到（同平台+同项目）时，总账备注取该规则的「财务备注」；
多规则时按业务备注/商品名称关键词取最具体的一条；匹不到则保留原有总账备注映射。规则按平台+项目预索引，避免逐行扫全表。
|
2026-10-07 15:24:58 +08:00 |
|
|
|
d76b102bca
|
总账备注平台口径：1688 / 新佰广 前缀按阿里巴巴匹配
新佰广1688、1688xxx 店铺名不带「阿里巴巴」前缀，之前落到页签默认平台（淘系支付宝=淘宝），
1688 系账单项目匹配不到总账备注；新增两条前缀映射（1688、新佰广 → 阿里巴巴）并补单测断言。
|
2026-10-07 13:20:06 +08:00 |
|
|
|
13a9697447
|
店铺收款账户账单新增「总账备注」筛选；每日账单脚本支持胜算异步分片导出
- 所有账户页签在「店铺」右侧新增「总账备注」下拉：按（平台+账单项目）翻译成账单项目集合过滤，页面/列设置/导出同口径；淘系支付宝、淘系微信同页签混多平台时按店铺名前缀细分
- 每日账单脚本：胜算超出同步导出上限（url=null+taskId）时自动从「异步导出下载管理」取回本次任务全部分片并合并成一份 CSV，导入前按页面笔数核对（不一致则跳过导入）
- 实测：京东 7 月异步导出两片 219158+235846=455004 笔 / 收入 17695094.84 / 支出 8035128.21，与已导入口径一致
|
2026-10-06 18:46:57 +08:00 |
|
|
|
e147c90a2c
|
店铺收款账户账单新增「总账备注」列（按平台+账单项目映射表取值）
- 新增 ec_account_ledger_remarks 映射表与 account-ledger-remarks:import 导入命令（平台/账单项目/总账备注）
- 新增 AccountLedgerRemarkMap：按店铺名前缀识别平台，无前缀时用页签默认平台；缺失匹配保持空白
- 全部账户页签（含淘系支付宝自有列定义）在「店铺/店铺名称」右侧新增「总账备注」列，页面/列设置/导出共用同一份列定义
- 控制器在分页与导出流读取时补齐 payload.ledger_remark，不改动上游账单与共享镜像数据
- 用例：新增 AccountLedgerRemarkMapTest；修正唯品会 JX/MP 列清单断言
|
2026-10-06 15:42:57 +08:00 |
|
