feat(finance): 对接课题经费拨付与财务报销模块

云

2026-09-29 a0d62d13f1d537e84e13d8ee4d8b37b27439fa00

 docs/project-business/README.md

@@ -8,7 +8,7 @@
- **业务定位**：离散制造工厂产供销人财物一体化：覆盖『销售接单 → 采购/生产 → 质检 → 仓储 → 发货 → 回款 → 售后』全链路闭环
- **技术底座**：yudao（ruoyi-vue-pro）二开，Spring Boot + MyBatis + Flowable + Redis + MySQL 8.4 + Milvus + 通义千问；前端 mom-pro2-before（Vue3）
- **核心主线**：CRM 合同 → ERP 销售订单 → MES 主计划/工单/报工 → 质检与仓储 → 销售出库 → 开票回款 → 售后闭环
- **独立模块**：财务报销（`yudao-module-finance`，报销单/明细/发票附件/审批/归档）与会员管理（`yudao-module-ums`，入会申请/秘书处与理事会两级审批/会员/通讯录）各自成一条链路，均不与其他业务模块产生单据关联（UMS 例外：审批通过会经 AdminUserApi 创建系统登录账号）；课题管理（`yudao-module-research`，课题指南/在线申报/专家评审/三级立项审批/立项通知/经费拨付）为另一条独立科研主线，仅向外取 `ums_member` 作为申报人、向内写 `system_notice` 立项公告
- **独立模块**：财务报销（`yudao-module-finance`，报销单/明细/发票附件/审批/归档，对外提供 `yudao-module-finance-api` 供他模块建单）与会员管理（`yudao-module-ums`，入会申请/秘书处与理事会两级审批/会员/通讯录）各自成一条链路（UMS 例外：审批通过会经 AdminUserApi 创建系统登录账号）；课题管理（`yudao-module-research`，课题指南/在线申报/专家评审/三级立项审批/立项通知/经费拨付）为另一条独立科研主线，向外取 `ums_member` 作为申报人、写 `system_notice` 立项公告，**并已对接财务**：经费拨付 1:1 自动生成财务报销单并提交审批，审批结果经 BPM 监听器回写课题侧拨款台账

## 2. 目录结构

@@ -46,9 +46,9 @@
| 09-data-flow | 跨模块数据流（单据生成、字段带入、数量回写、事件） |
| 10-business-object | 核心业务对象 ER（只含业务对象，非全库表） |
| 11-ai-business-flow | AI 业务链路（OCR/质检判定/四类预测/RAG，含 API 依赖） |
| 12-finance-flow | 财务报销（独立模块）：报销单+明细+发票附件 → 提交 BPM 审批 → 通过/驳回 → 归档终态 |
| 12-finance-flow | 财务报销（独立模块）：报销单+明细+发票附件 → 提交 BPM 审批 → 通过/驳回 → 归档终态；单据来源含手工新建与「课题经费拨付自动生成」两类 |
| 13-ums-membership-flow | 会员入会（独立模块）：入会申请 + 材料附件 → 提交 BPM 两级审批（秘书处初审→理事会审议）→ 通过自动建会员与登录账号 → 会员列表/通讯录检索 |
| 14-research-flow | 课题管理（独立模块）：指南发布(重点/一般)→在线申报(选会员带出申报人)→专家评分明细加权排名→BPM 三级审批(秘书处形式审查→专家评审→学会立项审批)→立项编号与公告→经费拨付记录 |
| 14-research-flow | 课题管理（独立模块）：指南发布(重点/一般)→在线申报(选会员带出申报人)→专家评分明细加权排名→BPM 三级审批(秘书处形式审查→专家评审→学会立项审批)→立项编号与公告→经费拨付（凭证必填→1:1 自动生成并提交财务报销单→财务审核/财务主管两级审批→结果经监听器回写台账：通过已拨付/驳回已驳回可重发/撤回回待拨付）|

图中状态数字均为源码枚举真实值（如工单 0草稿/1已确认/2完成/3取消；ERP 审批 15审批中/20已审核）。

@@ -69,8 +69,8 @@
- 本目录由项目技能 **project-business-analysis** 管理（`.claude/skills/project-business-analysis/`），并有规则 `.claude/rules/business-visualization-maintenance.md` 强制：业务模块/流程/状态/对象/角色/AI 变更后需同步维护本目录。
- 增量维护：改对应的 `mermaid/*.mmd` + `data/*.json` → 运行上面的 sync 脚本 → 浏览器验证受影响图。
- 全量重做（偏差过大时）：对 Claude 说「重新生成业务全景」，技能会重新走读源码并按生成模式重建。
- 生成基线：dev_business @ 87bf4a99，2026-09-10；2026-09-28 增量补充财务报销模块（`yudao-module-finance`）、会员管理模块（`yudao-module-ums`）与课题管理模块（`yudao-module-research`，一期项 1~5；二期结项验收与成果归档尚未做，图中已标注未覆盖范围）。
- 生成基线：dev_business @ 87bf4a99，2026-09-10；2026-09-28 增量补充财务报销模块（`yudao-module-finance`）、会员管理模块（`yudao-module-ums`）与课题管理模块（`yudao-module-research`，一期项 1~5；二期结项验收与成果归档尚未做，图中已标注未覆盖范围）；**2026-09-29 增量**：课题经费拨付对接财务报销——新建 `yudao-module-finance-api`（`FinanceReimbursementApi` 本地 Bean 调用：建单+提交/改单+重提/删除/查询），登记拨款时 1:1 自动生成 `finance_reimbursement`（系统生成 1 行明细）并自动提交 `finance_reimbursement_approve` 两级审批，新增第 15 个业务监听器 `ResearchFundStatusListener` 按审批结果回写课题拨款台账（通过 20 / 驳回 30 / 撤回 0），影响图 08 / 09 / 10 / 14 与 data 全部四份 json。

## 7. 已知待确认业务

见 `data/business.json` 的 `pendingConfirm`（页面「待确认事项」栏），要点：仓库类型/合格仓改造未落地、HRM 交接 expandUserIds 尚未被业务查询接入、回款与收款单未走 BPM、财务勾稽回写方法为空、NCR 处置不回写源单、财务报销的 BPM 流程定义未发布与普通角色未授菜单、会员管理的 BPM 流程未发布且缺审批自定义表单页、自动建账号用手机号作初始密码存在弱口令风险、课题管理的评分权重与通过阈值为占位规则待学会确认、一期经费拨付与财务模块无数据同步、申报单与会员为软关联可能悬空等。
见 `data/business.json` 的 `pendingConfirm`（页面「待确认事项」栏），要点：仓库类型/合格仓改造未落地、HRM 交接 expandUserIds 尚未被业务查询接入、回款与收款单未走 BPM、财务勾稽回写方法为空、NCR 处置不回写源单、财务报销的 BPM 流程定义未发布与普通角色未授菜单、会员管理的 BPM 流程未发布且缺审批自定义表单页、自动建账号用手机号作初始密码存在弱口令风险、课题管理的评分权重与通过阈值为占位规则待学会确认、课题经费拨付虽已对接财务报销但台账与报销单为软关联（财务侧删单会留悬空 `reimbursement_id`）、新建的财务报销审批流程节点审批人需上线前在 BPM 设计器按实际组织调整、申报单与会员为软关联可能悬空等。