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

云

2026-09-29 a0d62d13f1d537e84e13d8ee4d8b37b27439fa00

 docs/project-business/data/business.json

@@ -27,7 +27,7 @@
    "businessModules": 16,
    "coreObjects": 56,
    "documentFlows": 9,
    "approvalListeners": 14,
    "approvalListeners": 15,
    "aiCapabilities": 8,
    "wmBillTypes": 15
  },
@@ -147,18 +147,20 @@
    "转正申请(hrm_regularize_application)、培训证书等仅有 SQL 与菜单初始化，Java 侧 Service/Controller 未实现",
    "NCR 处置结果（返工/退货）未回写触发源单据，仅台账记录",
    "MPS 状态枚举独立编号(0/1/2/3)，与通用单据常量(0/1/4/5)不一致",
    "财务报销：BPM 分类 finance_reimbursement_approve 下尚无已发布的流程定义（act_re_cprocdef 为空），且流程需把「自定义表单路径」配为 /finance/reimbursement/detail/approve/index.vue，否则前端「提交审批」被禁用、审批中心看不到报销单内容【需 BPM 设计器侧配置】",
    "财务报销：BPM 分类 finance_reimbursement_approve 下尚无已发布的流程定义（act_re_procdef 为空）——该流程现已是「课题经费拨付自动建单并提交」的硬前置，本方案已手写 2 节点 BPMN（docs/sql/finance_reimbursement_approve.bpmn：财务审核 → 财务主管审批）待部署；部署后还需把「自定义表单路径」配为 /finance/reimbursement/detail/approve/index.vue（form_type=20），否则前端「提交审批」被禁用、审批中心看不到报销单内容【需 BPM 设计器侧配置】",
    "财务报销：菜单仅授予 super_admin（超管由代码直返全部菜单），普通角色未配 system_role_menu，非超管登录看不到「报销单」菜单【待确认是否补授权】",
    "会员管理：会员管理菜单(1075490~1075503)仅 super_admin 可见，普通角色未配 system_role_menu，非超管登录看不到会员管理目录【待确认是否补授权】",
    "会员管理：审批通过自动建系统账号用「联系电话」同时作用户名与初始密码，若联系电话为空会用字面量 unknown 兜底，存在弱口令与重名风险【待确认是否改造】",
    "会员管理：自动建档不搬运 contactUser/unitIntro/expireDate（ums_application 无对应字段），单位会员的「联系人/单位简介/有效期」只能在会员列表手工补录【待确认是否需要申请单增字段】",
    "会员管理：单位会员的等级字典 ums_unit_grade 仅到「会长单位」(4)，但校验逻辑额外硬编码禁止单位选「理事长」(grade=5)——该值本不在单位字典内，属防御性冗余校验【待确认是否精简】",
    "课题管理：专家评分权重（选题0.3/方案0.3/团队0.2/成果0.2）与「加权均分≥60 且 多数结论为推荐立项」的通过阈值是占位规则，需学会最终确认；已集中为常量便于调整【待确认，改动只需改常量】",
    "课题管理：一期经费拨付只在本模块落拨款记录，与财务模块无任何数据同步，同一笔钱在两处记录存在不一致风险；二期对接时需明确以哪侧为准【待确认】",
    "课题管理：经费拨付已对接财务报销（1:1 生成 finance_reimbursement 并自动提交审批），但台账与报销单是软关联（无外键，仅靠 reimbursement_id），财务侧直接删除报销单会留下台账的悬空 reimbursement_id；已用 FUND_REIMBURSEMENT_NOT_EXISTS 精确提示兜底，不做数据库级约束【已接受的风险】",
    "课题管理：新建的财务报销审批流程 finance_reimbursement_approve 为 2 节点（财务审核 → 财务主管审批），节点默认审批人策略为「角色 = 超级管理员(1)、依次审批」；上线前需在 BPM 设计器中按学会/财务实际审批人调整，否则该角色下多用户会变成逐人会签【环境配置项，非代码缺陷】",
    "课题管理：经费拨付台账的「已拨付(20)」等价于报销单「已通过(20)」，不含出纳实际付款动作；若日后需要独立的「已付款」状态，需另增状态与审批节点【二期可扩展】",
    "课题管理：申报单与 ums_member 是软关联（无外键），会员被删除后申报单会留下悬空 memberId；成员列表需容错展示「会员已删除」【待确认是否加外键或删除保护】",
    "课题管理：BPM 流程 research_topic_approve 三节点默认审批人为「角色=超级管理员(1) + 依次审批」，该 dev 库超级管理员角色下有 4 个用户（admin/张娟/马芳/马贞），每个节点需 4 人会签才推进；全新安装库该角色仅 admin 一人、流程可开箱即用。dev 库需减少超级管理员用户或改在 BPM 设计器中为每节点指定审批人【环境配置项，非代码缺陷】",
    "课题管理：立项通知复用 system_notice 系统公告，不新增 system_notify_template、不发站内信；如需短信/站内信定向通知需另行配置【待确认通知渠道】"
  ],
  "generatedAt": "2026-09-28",
  "analysisBasis": "基于 dev_business 分支 87bf4a99 源码，6 组并行源码走读（MES 生产质量 / MES 仓储 / ERP / CRM+SRM / 售后+HRM / AI+BI+MDM+BPM+底座）；2026-09-28 增量补充 yudao-module-finance 独立财务报销模块（报销单 + 明细 + 发票附件 + BPM 审批 + 归档）与 yudao-module-ums 独立会员管理模块（入会申请 + BPM 两级审批 + 审批通过自动建会员与登录账号 + 会员列表/通讯录）；2026-09-28 增量：BPM 流程定义 ums_membership_approve（入会审批）已在 mom-jssm 部署并并入 config_export_all 阶段一（分类 ums_membership_approve，秘书处初审 → 理事会审议，两节点审批人均为「角色」策略、角色=超级管理员(1) 兜底，表单类型=自定义表单，查看路径 /ums/application/detail/approve/index.vue）；同时修复 mom-jssm 由 CREATE TABLE ... LIKE 克隆导致的 47 个指向 ruoyi-vue-pro 的 act_*/flw_* 跨库外键（重建为指向 mom-jssm 自身，孤儿行预检为 0）；2026-09-28 增量：新增 yudao-module-research 独立科研课题模块一期（课题指南发布 + 在线申报 + 专家评审明细 + BPM 三级立项审批 + 立项通知公告 + 经费拨付记录，4 张 research_* 表 / 5 个字典 / bpm_category id=8002 / 流程 research_topic_approve / 菜单 1075510~1075553），并并入 config_export_all_20260928 阶段一；申报人取 ums_member（软关联）、立项通知复用 system_notice 公告、拨款凭证走 system 附件中心 recordType=research_fund_record"
  "generatedAt": "2026-09-29",
  "analysisBasis": "基于 dev_business 分支 87bf4a99 源码，6 组并行源码走读（MES 生产质量 / MES 仓储 / ERP / CRM+SRM / 售后+HRM / AI+BI+MDM+BPM+底座）；2026-09-28 增量补充 yudao-module-finance 独立财务报销模块（报销单 + 明细 + 发票附件 + BPM 审批 + 归档）与 yudao-module-ums 独立会员管理模块（入会申请 + BPM 两级审批 + 审批通过自动建会员与登录账号 + 会员列表/通讯录）；2026-09-28 增量：BPM 流程定义 ums_membership_approve（入会审批）已在 mom-jssm 部署并并入 config_export_all 阶段一（分类 ums_membership_approve，秘书处初审 → 理事会审议，两节点审批人均为「角色」策略、角色=超级管理员(1) 兜底，表单类型=自定义表单，查看路径 /ums/application/detail/approve/index.vue）；同时修复 mom-jssm 由 CREATE TABLE ... LIKE 克隆导致的 47 个指向 ruoyi-vue-pro 的 act_*/flw_* 跨库外键（重建为指向 mom-jssm 自身，孤儿行预检为 0）；2026-09-28 增量：新增 yudao-module-research 独立科研课题模块一期（课题指南发布 + 在线申报 + 专家评审明细 + BPM 三级立项审批 + 立项通知公告 + 经费拨付记录，4 张 research_* 表 / 5 个字典 / bpm_category id=8002 / 流程 research_topic_approve / 菜单 1075510~1075553），并并入 config_export_all_20260928 阶段一；申报人取 ums_member（软关联）、立项通知复用 system_notice 公告、拨款凭证走 system 附件中心 recordType=research_fund_record；2026-09-29 增量：课题经费拨付对接财务报销——新建 yudao-module-finance-api（FinanceReimbursementApi：建单+提交/改单+重提/删除/查询四方法，本地 Spring Bean 调用，无需 Feign），课题侧登记拨款时 1:1 自动生成 finance_reimbursement（系统生成 1 行明细：费用类型=其他 5、发票金额=拨付金额、发票日期=拨付日期、说明=「课题〔名〕第 N 期拨款」）并立即提交 BPM，回写 reimbursement_id/reimbursement_no、台账置「报销审批中(15)」；凭证改为登记时必填并双绑（research_fund_record + finance_reimbursement）；新增 ResearchFundStatusListener（第 15 个业务监听器，与 finance 自己的 FinanceReimbursementStatusListener 订阅同一流程 key 并行触发）按审批结果回写台账：通过→已拨付(20)、驳回→已驳回(30)+驳回原因/时间、撤回或取消→退回待拨付(0)可改后可重新发起；新造 2 节点 BPMN docs/sql/finance_reimbursement_approve.bpmn（财务审核 → 财务主管审批，category id=216 已存在但流程定义待部署）"
}