cont/mjava-sairui/modules/付款流程

付款流程模块

业务范围

付款流程覆盖员工付款申请、总经理审批、协议上传、财务付款与凭证上传、员工发票提交和最终归档。

状态流转：DRAFT（草稿） -> PENDING_APPROVAL（待审批） -> AGREEMENT_PENDING（待上传协议） -> FINANCE_PROCESSING（财务待付款） -> INVOICE_PENDING（待上传发票） -> ARCHIVED（已归档）。总经理驳回后状态为 REJECTED。

已交付功能

1. 付款申请：付款类型、收款单位/个人、申请金额、打款说明、关联业务、申请人和申请日期。
2. 总经理审批：待审批申请支持通过或驳回；审批通过后自动进入协议上传环节。
3. 协议管理：上传协议或合同文件后自动流转至财务付款。
4. 财务付款：填写财务经办人并上传付款凭证后，自动流转至发票提交。
5. 发票与归档：员工上传发票后自动记录提交和归档时间，流程完成。
6. 前端工作台：待审批、财务待付款、待上传发票和已归档统计；申请录入、列表查询、分页、流程详情、文件预览与下载操作。

数据库

执行 sairui-server/src/main/resources/db/schema/V5__payment_process.sql，创建：

• payment_request：付款申请、审批、协议、付款凭证、发票和归档信息。

本地开发中附件以 Base64 数据保存，单个文件由前端限制在 8MB 内；正式环境可替换为钉钉文件或对象存储地址。

API

方法	地址	说明
GET	/api/v1/payments	查询付款申请，支持关键字和状态筛选
GET	/api/v1/payments/{id}	查询申请详情
POST	/api/v1/payments	创建付款申请草稿
PUT	/api/v1/payments/{id}	编辑草稿
POST	/api/v1/payments/{id}/submit	提交总经理审批
POST	/api/v1/payments/{id}/approve	总经理审批通过或驳回
POST	/api/v1/payments/{id}/agreement	上传协议/合同
POST	/api/v1/payments/{id}/finance-pay	财务付款并上传凭证
POST	/api/v1/payments/{id}/invoice	上传发票并自动归档

联调步骤

1. 导入 V5 数据库脚本并重启后端。
2. 打开 http://127.0.0.1:5173/payments。
3. 填写申请后点击“提交总经理审批”。
4. 在详情中完成审批通过、协议上传、付款凭证上传和发票上传。
5. 发票上传成功后，确认状态为“已归档”。

当前边界

本地版本以流程审批位模拟总经理和财务操作，未接入真实钉钉审批、电子签章、文件服务、银行支付和发票验真。模块已保留相应状态和附件字段，后续接入不影响主数据结构。