5.9 KiB
Executable File
财务管理模块 - 待确认问题清单
在实现财务管理前后端前，请逐条回答或标注「暂不考虑」。回答完成后再补充前后端代码。
一、结算管理
1.1 需求写「新增结算单（导出下游合同结算单）」：
「导出下游合同结算单」是指：(a) 从系统中已有的下游合同数据（如中尚鹏合同/业务合同）里选一份合同，一键生成并下载一份结算单文档（PDF/Excel）？(b) 还是仅在前端提供「结算单表单」，手动录入后保存，再支持导出为文件？(c) 其他方式？
1.2 「根据单号查询」：结算单号规则是否由系统自动生成（如 STL2026030001）？还是允许用户手动填写单号？
1.3 「上传结算单（已交易且结算完毕的，主要为了备份）」：
上传的结算单是否需要和「已录入的结算单记录」关联（例如上传后关联到某条结算单号）？还是仅作为独立附件存储，按文件夹/时间归类即可？
1.4 结算单「录入扫描件内容数据的表格」除当前模型已有字段（结算单号、合同编号、合同类型、公司名、商品、数量、单价、金额、结算日期、状态、附件路径、备注）外，是否还需要增加或删减字段？若有，请列出。
二、发票管理
2.1 需求为「上游发票（上传）、下游发票（上传）、货代杂费发票（上传）」且已确认三张独立表。
当前三张表均含：发票号、合同编号、提单号、金额/税额/价税合计、开票日期、状态、附件路径、备注；上游多了「供应商名」、下游多了「客户名」、货代杂费多了「公司名」「费用项目」。
是否还需要其他字段（如税率、发票类型、购方/销方税号等）？
2.2 发票的「合同编号」是否需要与系统内已有合同（业务合同/中尚鹏合同）做下拉关联选择？还是自由文本即可？
2.3 上传发票后，附件存储方式是否与「合同管理/公司信息」一致：按文件夹归类 + 记录文件路径到该条发票记录的 file_path？
三、利润明细
3.1 需求为「2025年业务利润表」「关联其他表格中数据 + 设置好栏目以及函数，后续自行手动录入」。
当前理解：收入来自合同金额，成本 = 货代费用 + 杂费 + 服务费，利润 = 收入 − 成本。
请确认：(a) 利润表是按「年度」一张总表（如 2025 年一整年），(b) 还是按「合同/业务单」逐条有对应利润记录？(c) 或两者都要（既有年度汇总，又有单笔明细）？
3.2 「栏目以及函数」除「利润 = 收入 − 成本」、以及可能的「利润率 = 利润/收入」外，是否还有其它公式或统计维度（如按商品、按公司汇总）？若甲方尚未提供，是否先只做「收入、成本、利润、利润率」四栏？
3.3 利润明细的数据来源：(a) 完全由后端根据合同、货代/杂费/服务费自动汇总计算，前端只读展示；(b) 支持在前端表格中手动改写部分单元格（覆盖自动结果）；(c) 以手动录入为主，仅部分字段可从其他表带出。请选一种或说明组合方式。
四、货代费用 + 杂费（与菜单结构）
4.1 需求表里写「4.货代费用+其他杂费」合并为一条二级菜单，但当前前端是「货代费用」「杂费管理」两个并列子菜单。
是否保持现有两个子菜单（货代费用、杂费管理）不变？还是希望合并为一个「货代费用与杂费」页面，用 Tab 或筛选区分「货代」与「杂费」？
4.2 货代费用、杂费、服务费三者是否都需要「支持上传附件」（如发票扫描件）？当前货代/杂费/服务费模型是否需增加 file_path 或类似字段？
五、对账单
5.1 需求仅写「5.对账单」，无具体说明。当前后端有 ZSPReconciliation 模型（对账单号、合同编号、公司名、账期起止、总金额、已付、未付、状态、附件路径等）。
请确认对账单的业务含义：(a) 与「结算单」一一对应或一对多（如多笔结算汇总成一张对账单）？(b) 与结算单无关，是独立与客户/供应商的阶段性对账？(c) 其他（请简要说明）。
5.2 对账单的「总金额 / 已付 / 未付」是否由系统根据结算单或付款记录自动汇总？还是完全手动录入？
5.3 对账单是否也需要「上传已确认的对账单扫描件」作为备份？若需要，是否与结算单一样按「记录 + 附件路径」即可？
六、接口与路由约定
6.1 结算、发票、对账单的后端 API 是否统一放在现有 /api/zsp-finances/ 下，例如：
- 结算：
/api/zsp-finances/settlements（CRUD） - 上游/下游/货代杂费发票：
/api/zsp-finances/upstream-invoices、downstream-invoices、freight-misc-invoices - 对账单：
/api/zsp-finances/reconciliations
是否同意？若有不同路径规范请说明。
6.2 财务相关列表接口是否需要分页、按结算单号/合同号/公司名/日期范围等筛选？若需要，请列出各模块的常用筛选条件。
七、其他
7.1 财务管理各子模块（结算、发票、利润、货代、杂费、服务费、对账单）的菜单顺序是否与当前前端路由一致（结算 → 发票 → 利润明细 → 货代费用 → 杂费管理 → 服务费管理 → 对账单）？如需调整请说明。
7.2 是否有「财务数据不可删除、仅可作废/红冲」等合规要求？若有，哪些表需要支持状态为「作废」而不是物理删除？
回答方式：可在每题后直接写答案，或另起文档写「题号 + 答案」。完成后告知，再开始补充前后端实现。