Files
zsp-project/docs/dev/财务管理-待确认问题.md
2026-06-03 20:59:39 +08:00

86 lines
5.9 KiB
Markdown
Executable File
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 财务管理模块 - 待确认问题清单
> 在实现财务管理前后端前,请逐条回答或标注「暂不考虑」。回答完成后再补充前后端代码。
---
## 一、结算管理
**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** 是否有「财务数据不可删除、仅可作废/红冲」等合规要求?若有,哪些表需要支持状态为「作废」而不是物理删除?
---
*回答方式:可在每题后直接写答案,或另起文档写「题号 + 答案」。完成后告知,再开始补充前后端实现。*