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

云

2026-09-29 a0d62d13f1d537e84e13d8ee4d8b37b27439fa00

 docs/project-business/index.html

@@ -213,7 +213,7 @@
    "businessModules": 16,
    "coreObjects": 56,
    "documentFlows": 9,
    "approvalListeners": 14,
    "approvalListeners": 15,
    "aiCapabilities": 8,
    "wmBillTypes": 15
  },
@@ -333,20 +333,22 @@
    "转正申请(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 已存在但流程定义待部署）"
}</script>
<script type="application/json" id="data-modules">{
  "modules": [
@@ -385,10 +387,10 @@
    {"key": "fin", "name": "财务报销（独立）", "color": "#3ec9a7", "tag": "FIN", "flow": "finance",
     "positioning": "独立的发票报销单据与归档",
     "problem": "纸质发票难归集、报销审批无留痕、归档后无法追溯",
     "features": ["报销单(主表 + 1..n 明细行)", "发票附件多文件上传(附件中心多态关联 storage_attachment)", "单号 Redis 生成 BX+yyyyMMdd+6位流水·每日重置", "明细随主表一次性提交(先删后增全量覆盖)", "BPM 审批(通过20/驳回35/取消退回草稿0)", "已驳回可改发票后重新提交", "归档终态 40 并记录归档时间", "费用类型/报销状态双字典 + Excel 导出"],
     "features": ["报销单(主表 + 1..n 明细行)", "发票附件多文件上传(附件中心多态关联 storage_attachment)", "单号 Redis 生成 BX+yyyyMMdd+6位流水·每日重置", "明细随主表一次性提交(先删后增全量覆盖)", "BPM 审批(通过20/驳回35/取消退回草稿0)", "已驳回可改发票后重新提交", "归档终态 40 并记录归档时间", "费用类型/报销状态双字典 + Excel 导出", "对外提供 FinanceReimbursementApi(yudao-module-finance-api)供课题管理经费拨付自动建单并提交(1 行明细·费用类型=其他·金额一致)"],
     "objects": ["报销单", "报销明细"],
     "roles": ["报销人", "财务", "审批人"],
     "upstream": [], "downstream": [],
     "upstream": ["课题管理(经费拨付 1:1 自动生成报销单·走 yudao-module-finance-api·本地 Bean 调用)"], "downstream": [],
     "coreTables": ["finance_reimbursement", "finance_reimbursement_item"]},
    {"key": "pro", "name": "生产管理", "color": "#e0b34f", "tag": "MES-PRO", "flow": "production",
     "positioning": "生产执行核心：计划-工单-任务-报工",
@@ -457,16 +459,16 @@
    {"key": "res", "name": "课题管理（独立）", "color": "#e070a8", "tag": "RES", "flow": "research",
     "positioning": "学会/协会型科研课题全生命周期：指南发布 → 在线申报 → 专家评审 → 立项审批 → 经费拨付（立项通知走系统公告）",
     "problem": "课题指南靠线下发布、申报书靠纸质或邮件收集、专家评分散落在表格里无法自动汇总排名、立项与拨款无留痕",
     "features": ["课题指南(重点1/一般2 分类标注)", "指南状态 0草稿/20已发布/30已截止·发布/截止两个动作", "指南编号 GL+yyyyMMdd+6位流水(Redis 每日重置)", "在线申报书(选指南+选会员带出申报人信息+课题组成员+申请经费+申报书正文)", "申报编号 SB+同日流水·类别冗余自指南不信任前端", "申报状态 0草稿/15审批中/20已立项/35已驳回", "提交前校验指南已发布且在申报期内(逐条报具体维度与时间)", "专家评审明细子表(一位专家一行·四项加权 0.3/0.3/0.2/0.2)", "后端自动重算加权合计与排名·回写主单均分与推荐结论", "BPM 三级审批 research_topic_approve(秘书处形式审查→专家评审→学会立项审批)", "审批通过生成立项编号 LX+同日流水 与立项时间(幂等)", "发布立项通知(生成 system_notice 公告·写回 noticeId 防重复)", "经费拨付记录(批次/金额/日期/收款单位/状态/凭证附件)·金额不得超申请经费", "附件走 system 附件中心(recordType=research_guideline / research_application / research_fund_record)"],
     "features": ["课题指南(重点1/一般2 分类标注)", "指南状态 0草稿/20已发布/30已截止·发布/截止两个动作", "指南编号 GL+yyyyMMdd+6位流水(Redis 每日重置)", "在线申报书(选指南+选会员带出申报人信息+课题组成员+申请经费+申报书正文)", "申报编号 SB+同日流水·类别冗余自指南不信任前端", "申报状态 0草稿/15审批中/20已立项/35已驳回", "提交前校验指南已发布且在申报期内(逐条报具体维度与时间)", "专家评审明细子表(一位专家一行·四项加权 0.3/0.3/0.2/0.2)", "后端自动重算加权合计与排名·回写主单均分与推荐结论", "BPM 三级审批 research_topic_approve(秘书处形式审查→专家评审→学会立项审批)", "审批通过生成立项编号 LX+同日流水 与立项时间(幂等)", "发布立项通知(生成 system_notice 公告·写回 noticeId 防重复)", "经费拨付记录(批次/金额/日期/收款单位/备注/凭证附件)·凭证必填·金额不得超申请经费", "经费拨付 1:1 自动生成并提交财务报销单(FinanceReimbursementApi·1 行明细·费用类型=其他)", "拨付状态 0待拨付/15报销审批中/20已拨付/30已驳回·由 BPM 监听器回写(含驳回原因与时间)", "已驳回可改金额/凭证后重新发起报销·待拨付可删并联动清理财务侧草稿报销单", "附件走 system 附件中心(recordType=research_guideline / research_application / research_fund_record)"],
     "objects": ["课题指南", "课题申报书", "专家评审明细", "经费拨付记录"],
     "roles": ["课题申报人(会员)", "课题管理员", "评审专家", "学会秘书处", "学会理事会"],
     "upstream": ["会员管理(ums_member 取申报人姓名/单位/职称/电话)", "BPM(流程定义 research_topic_approve)"],
     "downstream": ["system(system_notice 立项通知公告)", "system(附件中心)", "财务(二期预期待对接·一期不接)"],
     "roles": ["课题申报人(会员)", "课题管理员", "评审专家", "学会秘书处", "学会理事会", "学会财务"],
     "upstream": ["会员管理(ums_member 取申报人姓名/单位/职称/电话)", "BPM(流程定义 research_topic_approve / finance_reimbursement_approve)"],
     "downstream": ["system(system_notice 立项通知公告)", "system(附件中心)", "财务(经费拨付生成 finance_reimbursement 报销单·已对接)"],
     "coreTables": ["research_guideline", "research_application", "research_topic_review", "research_fund_record"]},
    {"key": "bpm", "name": "协同审批", "color": "#e6a23c", "tag": "BPM", "flow": null,
     "positioning": "全系统单据审批中枢（Flowable）",
     "problem": "多模块单据需要灵活可配的多级审批",
     "features": ["BPMN+钉钉风格双设计器", "流程定义部署", "审批事件统一回调(BpmProcessInstanceStatusEvent)", "14个业务监听器", "表单·用户组·抄送·加签"],
     "features": ["BPMN+钉钉风格双设计器", "流程定义部署", "审批事件统一回调(BpmProcessInstanceStatusEvent)", "15个业务监听器(同一流程 key 允许多个监听器并行·各自按 key 过滤)", "表单·用户组·抄送·加签"],
     "objects": ["流程模型", "流程实例", "审批任务"],
     "roles": ["审批人(按流程配置)", "流程管理员"],
     "upstream": ["各业务提交审批"], "downstream": ["回调更新各业务单据状态"],
@@ -536,14 +538,14 @@
    {"name": "排班计划", "module": "设备", "table": "mes_cal_plan", "doc": "班组×班次×日期排班，供生产与考勤引用", "upstream": [], "downstream": ["生产任务", "考勤"], "keywords": "排班 班组 班次 日历"},
    {"name": "报告模板", "module": "质检报告", "table": "qc_report_template", "doc": "智能质检报告模板，启用0/停用1；画布内容存在 qc_report_template_version（草稿0/已发布1/已停用2，已发布不可覆盖），currentVersion 指向当前已发布版本；源文件经 AI 导入识别成草稿后由人工确认才成为版本；同一模板重复导入按【替换】处理——先删旧附件（连带 blob 行与磁盘文件）再绑新的，不留孤儿文件；删除模板会连带清附件", "upstream": ["人工设计(GrapesJS 设计器)", "AI 导入草稿(qc-report/ai-import/draft)"], "downstream": ["模板版本", "报告实例"], "keywords": "报告模板 质检报告 template 设计器 版本 AI导入 识别 草稿 源文件替换"},
    {"name": "报告实例", "module": "质检报告", "table": "qc_report_instance", "doc": "出件产物，编号 QR+yyyyMMdd+4位流水按天独立且业务唯一，可显式指定覆盖（注意 uk_report_no 不区分软删除，删掉的号不回收）；两条出件入口：通用 generate（调用方自带 context）与 generate-from-qc（数据从 MES 质检单取，权限码 qc-report:instance:generate 已入 system_menu id=1075416，五道校验按业务优先级只报第一处：105_000 类型非法 / 105_001 单据不存在 / 105_002 未完成 / 105_003 未判定 / 105_005 模板类型不符 / 105_006 无可用检验项；四张质检单列表的行操作「出报告」仅在 status=已完成时可见，弹窗只列 reportType 一致、模板启用、且 currentVersion 指向的版本已发布的模板（后端 /qc-report/template/selectable 判定——停用版本不清空 currentVersion，前端拿分页结果自己推导会漏），结果就地展示并跳本页列表）；冻结 data_snapshot（判定后数据，含后端算好的 PASS/FAIL 与合格率）与 render_html；regenerate 只重渲排版、数据与编号不变；business_id/business_type 存 MES 表名（mes_qc_iqc 等）与单据 ID，可反查、一单可出多份；报告头另带单据原判定 qcResult(数)/qcResultText(中文，合格/特采/不合格退货/不合格报废)，与引擎三态判定并存互不覆盖；响应带 undecidableCount=快照中 result 为空串的项数与 warnings（分组标题跳过/指标已删/未录实测值/样品超3），两者都不落库、事后看不到", "upstream": ["报告模板版本", "质检单上下文(通用 generate 由调用方传入)", "MES 质检单 IQC/IPQC/OQC/RQC(generate-from-qc 经 MesQcReportApi 取数)"], "downstream": ["前端实例页 /qc/report-instance(列表·iframe预览·快照页签·导出PDF)", "PDF归档(system_storage_attachment recordType=qc_report_instance)"], "keywords": "报告实例 出件 QR编号 快照 复现 regenerate PDF归档 报告实例页 导出PDF generate-from-qc 质检单出报告 出报告弹窗 qcResult undecidableCount warnings 待判定 反查 业务单据筛选"},
    {"name": "报销单", "module": "财务报销", "table": "finance_reimbursement", "doc": "单号可自定义(中间不允许空格，与已有单号重复则报错)；新增时留空或纯空格由系统生成 BX+yyyyMMdd+6位流水(Redis 每日重置)，修改时留空表示保持不变。status: 0草稿/15审批中/20已通过/35已驳回/40已归档；仅草稿可删、草稿与已驳回可改、仅已通过可归档；提交后由 BPM 监听器按结果回写状态(取消退回草稿)，审批中 processInstanceId 被回写；独立模块，不与其它业务模块产生单据关联", "upstream": [], "downstream": ["报销明细", "发票附件(storage_attachment·recordType=finance_reimbursement)"], "keywords": "报销单 报销 发票 reimbursement BX 归档 财务 费用 自定义单号"},
    {"name": "报销单", "module": "财务报销", "table": "finance_reimbursement", "doc": "单号可自定义(中间不允许空格，与已有单号重复则报错)；新增时留空或纯空格由系统生成 BX+yyyyMMdd+6位流水(Redis 每日重置)，修改时留空表示保持不变。status: 0草稿/15审批中/20已通过/35已驳回/40已归档；仅草稿可删、草稿与已驳回可改、仅已通过可归档；提交后由 BPM 监听器按结果回写状态(取消退回草稿)，审批中 processInstanceId 被回写。来源两条：① 财务模块页面人工填报 ②课题管理「经费拨付」经 FinanceReimbursementApi(yudao-module-finance-api)自动建单并立即提交(1:1、金额一致、系统固定 1 行明细·费用类型=其他)——后者的审批结果由课题侧 ResearchFundStatusListener 订阅同一流程回写拨款台账，报销单本身不回写任何外部单据", "upstream": ["课题管理(经费拨付·经 FinanceReimbursementApi 自动建单)", "人工填报"], "downstream": ["报销明细", "发票附件(storage_attachment·recordType=finance_reimbursement)", "课题拨款台账(仅经 BPM 事件回写状态)"], "keywords": "报销单 报销 发票 reimbursement BX 归档 财务 费用 自定义单号 课题经费拨付 自动建单 FinanceReimbursementApi"},
    {"name": "报销明细", "module": "财务报销", "table": "finance_reimbursement_item", "doc": "报销单的费用行：费用类型(1差旅/2办公/3招待/4交通/5其他)、发票号码、发票金额、发票日期、开票方、费用说明；随主表一次性提交(先删后增全量覆盖)，提交时必须剥掉行 id 与 reimbursementId —— 明细删除是软删，回传原 id 会与已软删行主键冲突", "upstream": ["报销单"], "downstream": [], "keywords": "报销明细 费用明细 费用类型 发票金额 item 明细行 差旅"},
    {"name": "入会申请单", "module": "会员管理", "table": "ums_application", "doc": "单号 SQ+yyyyMMdd+6位流水(Redis 每日重置)，后端生成不可自定义；memberType 1个人/2单位决定字段分叉(个人用 workUnit/title，单位用 legalPerson/organizationCode)；memberGrade 按类型取不同字典；status: 0草稿/15审批中/20已通过/35已驳回。仅草稿可删(连带清附件)、草稿与已驳回可改可重提；提交后由 BPM 监听器按结果回写(取消退回草稿)，审批中回写 processInstanceId；审批通过触发自动建会员与系统账号。独立模块，不与其它业务模块产生单据关联", "upstream": ["人工填报(申请人)", "证明材料附件(storage_attachment·recordType=ums_application)"], "downstream": ["会员(审批通过自动创建)", "BPM 流程实例(ums_membership_approve 分类)"], "keywords": "入会申请 入会 会员申请 application SQ 秘书处 理事会 审批 会员类型 个人 单位 法定代表人 研究方向 申请等级"},
    {"name": "会员", "module": "会员管理", "table": "ums_member", "doc": "单号 HY+yyyyMMdd+6位流水(Redis 每日重置)；两个来源：①入会申请审批通过自动创建(回填 applicationId 与 userName/系统账号) ②会员列表手工新增。status: 1正常/0暂停；memberGrade 按 memberType 取对应字典，校验规则是单位会员(type=2)不可选『理事长』(grade=5)。自动建档时入会日期=当天、不搬运 contactUser/unitIntro/expireDate(申请单无对应字段)；自动建的系统账号用户名为联系电话且初始密码同为联系电话，部门固定为「学会会员」；手机号重复会明确报错且整单事务回滚", "upstream": ["入会申请单(审批通过)", "人工新增", "附件(storage_attachment·recordType=ums_member)"], "downstream": ["会员通讯录(按 regionCode/industry 检索)", "system_users(登录账号)"], "keywords": "会员 member HY 会员编号 会员等级 会员类型 通讯录 地区 行业 入会日期 有效期"},
    {"name": "课题指南", "module": "课题管理", "table": "research_guideline", "doc": "指南编号 GL+yyyyMMdd+6位流水(Redis 每日重置)；category 1重点课题/2一般课题；publishStatus 0草稿/20已发布/30已截止，仅草稿可改可删，publish 发布回写 publishTime，close 截止置 30；已产生申报单(applicationMapper.selectCountByGuidelineId 大于 0)的指南禁止删除并在提示中报出该指南下已有多少张申报单；正文 content 为长文本；附件 recordType=research_guideline", "upstream": ["人工维护(学会秘书处)", "指南附件(storage_attachment·recordType=research_guideline)"], "downstream": ["课题申报书(申报时引用且必须已发布并在申报期内)"], "keywords": "课题指南 指南 发布 截止 重点课题 一般课题 GL 指南编号 申报期 申报起止"},
    {"name": "课题申报书", "module": "课题管理", "table": "research_application", "doc": "申报编号 SB+yyyyMMdd+6位流水(Redis 每日重置)；guidelineId 关联指南、memberId 关联 ums_member(软关联无外键，会员删除后会留下悬空 memberId 需容错显示)；applicantName/workUnit/jobTitle/contactPhone/contactEmail 由选会员自动带出可手改；category 冗余自指南且不信任前端传值；budgetAmount 申请经费为拨付上限；status: 0草稿/15审批中/20已立项/35已驳回。仅草稿可删(连带清附件)、草稿与已驳回可改可重提；submit 前逐条校验「指南已发布」与「现在在申报期内」，任一不满足即拒绝并按维度给出指南名与实际值；审批通过由监听器生成立项编号 researchNo(LX+同日流水)与 approveTime(已有编号幂等跳过)；reviewAvgScore/reviewPass 为评审汇总回写值，明细删空时清成未汇总；noticeId 记录已发布的立项通知公告，重复发布被拦截", "upstream": ["课题指南(必须已发布且在申报期内)", "会员(ums_member·带出申报人信息)", "申报附件(storage_attachment·recordType=research_application)"], "downstream": ["专家评审明细", "经费拨付记录", "立项通知(system_notice 公告)", "BPM 流程实例(research_topic_approve 分类)", "附件中心"], "keywords": "课题申报 申报书 申报单 SB 申报编号 立项 立项编号 LX 申请经费 申报书正文 课题组成员 专家评审 评审汇总 立项通知 发布通知 提交审批 驳回 重提"},
    {"name": "专家评审明细", "module": "课题管理", "table": "research_topic_review", "doc": "一位专家一行的一主多行子表：evaluatorName/evaluatorUnit/evaluatorTitle + topicScore 选题价值与意义(权重0.3) + planScore 研究方案可行性(0.3) + teamScore 团队与研究基础(0.2) + resultScore 预期成果与效益(0.2) + conclusion 1推荐立项/2不推荐立项 + opinion 评审意见 + reviewTime。compositeScore 由后端 weightedScore 计算、ranking 由后端按加权分降序重排，均不接受前端传值；每次增删改后调 recalculate 回写主单 reviewAvgScore(全部专家加权分均值·保留2位)与 reviewPass(均分达标 且 多数结论为推荐立项时为 1)；四项分值超出 0~100 时提示指出具体维度与实际值；仅在申报单 status=15 审批中可增删改", "upstream": ["课题申报书(仅审批中可写)"], "downstream": ["课题申报书(回写 reviewAvgScore/reviewPass)"], "keywords": "专家评审 评审明细 评分 加权 权重 排名 ranking compositeScore 推荐立项 评审意见 均分"},
    {"name": "经费拨付记录", "module": "课题管理", "table": "research_fund_record", "doc": "一主多行的拨款记录：batchName 批次名称/amount 拨付金额/payDate 拨付日期/payee 收款单位/status 0待拨付 20已拨付/remark，凭证附件走 system 附件中心 recordType=research_fund_record(表内不存文件地址)。仅申报单 status=20 已立项可登记；金额校验：已登记金额(该单全部记录求和) + 本次金额 不得超出申报单 budgetAmount，超出时提示报出本次、已登记、合计、预算四项数值；status=20 已拨付 时凭证附件必填(前端先行拦截，后端 validateVoucherRequired 兜底)；仅待拨付状态可改可删，编辑时把本行金额加回可用余额展示避免误解", "upstream": ["课题申报书(必须已立项)"], "downstream": ["拨付凭证(storage_attachment·recordType=research_fund_record)", "财务(二期预期待对接·一期不接)"], "keywords": "经费拨付 拨款 拨付记录 批次 拨付金额 凭证 待拨付 已拨付 收款单位 资助金额 预算 超额"}
    {"name": "经费拨付记录", "module": "课题管理", "table": "research_fund_record", "doc": "一主多行的拨款台账：batchName 批次名称/amount 拨付金额/payDate 拨付日期/payee 收款单位/remark，凭证附件走 system 附件中心 recordType=research_fund_record(表内不存文件地址)。status: 0待拨付/15报销审批中/20已拨付/30已驳回，由系统与 BPM 驱动，新增/修改接口已移除 status 入参(防伪造「已拨付」)。登记即一条龙：落台账 → 同一批 blob 双绑 → 经 FinanceReimbursementApi 自动生成 1:1 的 finance_reimbursement 并立即提交 BPM → 回写 reimbursement_id/reimbursement_no 并置 15；审批结果由监听器回写：通过→20、驳回→30(+reject_reason/reject_time)、撤回或取消→退回 0。仅申报单 status=20 已立项可登记；凭证必填；金额校验：已登记金额(该单全部记录求和) + 本次金额 不得超出申报单 budgetAmount，超出时提示报出本次、已登记、合计、预算四项数值；仅「待拨付」可删(联动删除财务侧草稿报销单，非草稿则拒绝)，「待拨付」「已驳回」可改并重新发起报销(已驳回改后清空 reject_reason/reject_time)，编辑时把本行金额加回可用余额展示避免误解。与报销单为软关联(无外键)，财务侧直接删单会留下悬空 reimbursement_id，此时修改报「报销单已不存在，请删除本条记录后重新登记」", "upstream": ["课题申报书(必须已立项)", "财务报销单(1:1 自动生成·软关联 reimbursement_id)"], "downstream": ["拨付凭证(storage_attachment·recordType=research_fund_record)", "财务报销单(生成并提交出账·审批结果回写本台账)"], "keywords": "经费拨付 拨款 拨付记录 批次 拨付金额 凭证 待拨付 报销审批中 已拨付 已驳回 驳回原因 财务报销单号 reimbursement_id 收款单位 资助金额 预算 超额 重新发起报销"}
  ]
}</script>
<script type="application/json" id="data-flows">{
@@ -622,7 +624,7 @@
       {"stage": "建档", "action": "审批通过钩子自动建会员：①生成会员编号 HY+yyyyMMdd+6位流水 ②AdminUserApi.createUser 建系统账号（用户名与初始密码=联系电话、昵称=申请人姓名、部门=学会会员）③会员落库（入会日期=当天、状态 1 正常、applicationId 回填来源申请单）；手机号重复会明确报错", "roles": ["系统自动"]},
       {"stage": "管理与检索", "action": "会员列表支持手工新增/编辑/删除（等级与类型校验：单位会员不可选『理事长』）；会员通讯录为只读页，按地区编码与行业检索", "roles": ["会员管理员", "全体可查通讯录"]}]},
    {"id": "research", "name": "课题管理流程", "mermaid": "mermaid/14-research-flow.mmd", "color": "#e070a8",
     "summary": "独立科研模块（yudao-module-research）：学会发布课题指南（重点/一般分类）→ 会员在线提交课题申报书 → 提交 BPM 三级审批（秘书处形式审查 → 专家评审 → 学会立项审批），专家评分以结构化明细子表记录并由后端自动汇总加权均分、排名与推荐结论 → 审批通过生成立项编号并发布系统公告 → 按批次登记经费拨付记录（含凭证附件）。院级二期再补结项验收与成果归档。",
     "summary": "独立科研模块（yudao-module-research）：学会发布课题指南（重点/一般分类）→ 会员在线提交课题申报书 → 提交 BPM 三级审批（秘书处形式审查 → 专家评审 → 学会立项审批），专家评分以结构化明细子表记录并由后端自动汇总加权均分、排名与推荐结论 → 审批通过生成立项编号并发布系统公告 → 按批次登记经费拨付（凭证必填），每条拨款记录自动生成并提交一张 1:1 的财务报销单（finance_reimbursement），走 BPM 两级审批后由监听器把结果回写台账。院级二期再补结项验收与成果归档。",
     "steps": [
       {"stage": "发布指南", "action": "新建指南选类别 1重点课题 / 2一般课题，填申报起止时间与指南正文；编号 GL+yyyyMMdd+6位流水（Redis 每日重置）；status: 0草稿/20已发布/30已截止。仅草稿可改可删，发布后即冻结；已产生申报单的指南禁止删除（提示该指南下已有 N 张申报单）", "roles": ["学会秘书处", "课题管理员"]},
       {"stage": "在线申报", "action": "从已发布且在申报期内的指南新建申报书；选会员（ums_member）自动带出姓名/工作单位/职称/联系电话/邮箱，可改；填课题名称、课题组成员、申请经费、申报书正文；编号 SB+yyyyMMdd+6位流水；类别冗余自指南，不信任前端传值；status: 0草稿", "roles": ["课题申报人（会员）", "课题管理员"]},
@@ -630,7 +632,7 @@
       {"stage": "专家评审", "action": "申报单处于审批中(15)时录入专家评分明细（一位专家一行：姓名/单位/职称 + 选题价值0.3/研究方案0.3/团队基础0.2/预期成果0.2 四项分值 + 结论 + 意见）；后端每次增删改后重算 compositeScore 加权合计、按加权分降序重排 ranking，并回写主单 reviewAvgScore（全部专家均分）与 reviewPass（均分达标且多数结论为推荐立项）；明细全部删除时汇总值清空为未汇总；四项分值均在 0~100 之外时提示指出具体维度与实际值", "roles": ["评审专家", "学会秘书处", "课题管理员"]},
       {"stage": "立项审批", "action": "BPM 流程 research_topic_approve 顺序走三节点：秘书处形式审查 → 专家评审 → 学会立项审批。审批方法与审批人在流程定义内配置，部署后由管理员在 BPM 流程设计器按学会实际组织调整；审批中心内的自定义表单只读回显申报单 + 评审明细 + 拨付记录。通过→20 已立项、驳回→35 已驳回、取消→退回 0 草稿", "roles": ["学会秘书处（形式审查）", "评审专家（评审节点）", "学会理事会（立项审批）"]},
       {"stage": "立项与通知", "action": "监听器 ResearchApplicationStatusListener 先回写审批状态，审批通过后再调 approveApplication：生成立项编号 LX+yyyyMMdd+6位流水 与 approveTime（已有编号则幂等跳过）。点「发布立项通知」生成 system_notice 公告（标题『关于公布立项课题的通知』，正文含课题名/立项编号/类别/申报人/单位/资助金额），写回 noticeId 防重复——重复点击按已发布拦截并告知上次发布时间", "roles": ["课题管理员", "学会秘书处"]},
       {"stage": "经费拨付", "action": "仅「已立项(20)」的申报单可登记拨款记录（批次名称/拨付金额/拨付日期/收款单位/状态/备注/凭证附件）；金额校验：已登记金额 + 本次金额 不得超出该单申请经费，超出时提示报出本次、已登记、合计、预算四项数值；status: 0待拨付/20已拨付，凭证明细走 system 附件中心 recordType=research_fund_record，状态改为已拨付时凭证必填；仅待拨付状态可改可删，编辑时会把本行金额加回余额显示", "roles": ["学会财务", "课题管理员"]}]},
       {"stage": "经费拨付", "action": "仅「已立项(20)」的申报单可登记拨款记录（批次名称/拨付金额/拨付日期/收款单位/备注/凭证附件），凭证必填。登记时一条龙完成：① 课题侧落 research_fund_record 台账（先置待拨付）② 同一批 blob 双绑到课题台账与财务报销单 ③ 经 yudao-module-finance-api 自动生成 1:1 的 finance_reimbursement 报销单（1 行明细：费用类型=其他、发票金额=拨付金额、发票日期=拨付日期、费用说明=「课题〔课题名〕第N期/第N次经费拨款」）④ 立即提交 BPM 报销审批 ⑤ 台账回写报销单号并置「报销审批中(15)」。金额校验：已登记金额 + 本次金额 不得超出该单申请经费，超出时提示报出本次、已登记、合计、预算四项数值。状态由系统驱动：0待拨付/15报销审批中/20已拨付/30已驳回；只有「待拨付」可删（删除联动清理财务侧草稿报销单），「待拨付」「已驳回」可改并重新发起报销（已驳回改后清空驳回原因与时间）；财务端撤回或取消则退回「待拨付(0)」。财务审批分类下没有已发布流程时直接报错且不建单，不留孤儿草稿报销单", "roles": ["学会财务", "课题管理员", "财务审核人", "财务主管"]}]},
    {"id": "ai", "name": "AI 业务流程", "mermaid": "mermaid/11-ai-business-flow.mmd", "color": "#56c8d8",
     "summary": "统一模式：业务侧收集上下文(必要时调 MDM/SRM/CRM API 取名称)→组装 Prompt→chat/chatWithImage→解析 JSON→前端预填或建议；无 Function Calling；RAG 知识库已建成但暂无业务消费。",
     "steps": [
@@ -1010,7 +1012,7 @@
  MES -->|退货质检入库回调| AS[售后工单维修退货]
  CRM -->|客户主数据| AS
  HRM[HRM 员工入转调离交接考勤薪酬] -.->|expandUserIds 数据可见性扩展·接口已就绪待各模块接入| CRM
  BPM[BPM Flowable 审批引擎] -.->|状态事件回调·14个监听器| ERP
  BPM[BPM Flowable 审批引擎] -.->|状态事件回调·15个监听器| ERP
  BPM -.-> CRM
  BPM -.-> SRM
  BPM -.-> MES
@@ -1029,7 +1031,7 @@
  STG[附件中心 storage-blob+attachment 全模块统一挂附件] --- ERP
  FIN[财务报销 独立模块 yudao-module-finance 报销单 明细 发票附件] -.->|复用 BPM 审批与状态回调| BPM
  FIN -.->|发票走附件中心 recordType=finance_reimbursement| STG
  FIN -.->|独立模块·不与其它业务模块产生单据或数据关联| ERP
  FIN -.->|"对外仅提供 yudao-module-finance-api(FinanceReimbursementApi)供他模块建单"| ERP
  UMS[会员管理 独立模块 yudao-module-ums 入会申请 会员 通讯录] -.->|复用 BPM 两级审批与状态回调| BPM
  UMS -.->|证明材料走附件中心 recordType=ums_application / ums_member| STG
  UMS -.->|审批通过经 AdminUserApi.createUser 建系统登录账号| SYS
@@ -1038,6 +1040,8 @@
  RES -.->|附件走附件中心 recordType=research_guideline / research_application / research_fund_record| STG
  RES -->|选会员取申报人姓名 工作单位 职称 联系电话| UMS
  RES -->|立项通知写 system_notice 公告| SYS
  RES -->|经费拨付 1:1 自动生成 finance_reimbursement 报销单并提交审批·走新建的 yudao-module-finance-api| FIN
  FIN -.->|报销审批结果经 BPM 事件回调 ResearchFundStatusListener 回写课题拨款台账| RES
</pre>
<pre style="display:none" class="mmd-src" data-mmd="09-data-flow">
flowchart LR
@@ -1122,7 +1126,7 @@
  RBM -->|submit 带 id 与 processDefinitionKey 走 query| RBS
  RBS -.->|BPM 监听器结果回写 通过20 驳回35 取消退回0| RBM
  RBA -.->|上传与保存分离·禁在业务表存文件地址| PDFARCH
  FINNOTE[独立模块·销售采购链条任意单据均不生成报销单·报销单亦不回写任何外部单据] -.-> RBM
  FINNOTE[独立模块·销售采购链条任意单据均不生成报销单·报销单亦不回写任何外部单据·唯一例外是课题经费拨付] -.-> RBM
  subgraph S6 [独立课题管理 research]
    RGL[课题指南 research_guideline] --> RAP[课题申报书 research_application]
    RAP --> RRV[专家评审明细 research_topic_review]
@@ -1139,10 +1143,13 @@
  RRV -.->|"明细删空时主单汇总清为 null"| RAP
  RAP -->|"publishNotice 生成 system_notice 公告并回写 noticeId·重复发布拦截"| SYS2[system_notice 系统公告]
  RFR -->|"金额校验 已登记 + 本次 不得超出 budgetAmount 申请经费"| RAP
  RFR -.->|"凭证走附件中心 recordType=research_fund_record·表内不存文件地址"| PDFARCH
  RFR -.->|"凭证走附件中心 recordType=research_fund_record·同一批 blob 双绑 finance_reimbursement·表内不存文件地址"| PDFARCH
  RAP -.->|"申报附件 recordType=research_application"| PDFARCH
  RGL -.->|"指南附件 recordType=research_guideline"| PDFARCH
  RESNOTE[独立模块·一期经费拨付只在本模块落记录·与财务模块无数据同步·二期再对接] -.-> RFR
  RFR -->|"1:1 生成报销单·经 FinanceReimbursementApi 本地 Bean 建单并立即 submit·回写 reimbursement_id/reimbursement_no·台账置 15 报销审批中"| RBM
  RBM -->|"报销单进入同一条 BPM 流程 finance_reimbursement_approve(财务审核 → 财务主管审批)·businessKey=报销单 ID"| RBS
  RBS -.->|"BPM 监听器 ResearchFundStatusListener 回写课题台账 通过20 驳回30(+驳回原因/时间) 撤回0"| RFR
  RESNOTE[一期已对接财务·课题台账为拨款台账·报销单为财务出账凭证·两边以 reimbursement_id 软关联无外键·财务侧直接删单会留下悬空 ID 由业务报错兜底] -.-> RFR
</pre>
<pre style="display:none" class="mmd-src" data-mmd="10-business-object">
erDiagram
@@ -1188,6 +1195,7 @@
  research_guideline ||--o{ research_application : "被申报引用"
  research_application ||--o{ research_topic_review : "专家评分明细"
  research_application ||--o{ research_fund_record : "经费拨付记录"
  research_fund_record ||--|| finance_reimbursement : "1:1 生成出账报销单(软关联 reimbursement_id)"
  ums_member ||--o{ research_application : "申报人(软关联无外键)"
</pre>
<pre style="display:none" class="mmd-src" data-mmd="11-ai-business-flow">
@@ -1235,7 +1243,7 @@
</pre>
<pre style="display:none" class="mmd-src" data-mmd="12-finance-flow">
flowchart TD
  U1[报销人填报报销单·主表: 报销单号(选填) 报销标题 报销总金额 申请日期 备注] --> U2[录入报销明细 1..n 行: 费用类型 发票号码 发票金额 发票日期 开票方 费用说明]
  U1["报销人填报报销单·主表: 报销单号(选填) 报销标题 报销总金额 申请日期 备注"] --> U2["录入报销明细 1..n 行: 费用类型 发票号码 发票金额 发票日期 开票方 费用说明"]
  U2 --> U3[发票附件: 图片或 PDF 先传 system storage-blob upload 取 blobId]
  U3 --> S1[保存 create·主表与明细与全部 blobIds 一次性提交]
  S1 --> G1["报销单号：可自定义；留空(含纯空格)则由后端生成 BX + yyyyMMdd + 6位流水(Redis·每日重置)"]
@@ -1251,7 +1259,7 @@
  K3 -->|archive 归档| K5[已归档 40·终态·写入 archiveTime]
  D1["仅草稿 0 可 delete·连带清理明细与发票附件"] -.-> K1
  E1["仅草稿 0 与已驳回 35 可 update·其余状态只读"] -.-> K4
  N1["独立模块·不与其他业务模块产生单据或字段带入"] --- K1
  N1["独立模块·与销售采购链条任何单据均无关联；唯一例外是被课题经费拨付 1:1 自动生成(经 yudao-module-finance-api)"] --- K1
</pre>
<pre style="display:none" class="mmd-src" data-mmd="13-ums-membership-flow">
flowchart TD
@@ -1322,18 +1330,26 @@
  KA -->|驳回| K5
  K5 -->|修改后重新 submit| K2
  K4 -->|publishNotice 发布立项通知| N1["system_notice 公告·标题『关于公布立项课题的通知』·正文含课题名 立项编号 类别 申报人 单位 资助金额·回写 noticeId·重复发布被拦截"]
  K4 -->|登记拨款记录 research_fund_record| F1[填批次名称 拨付金额 拨付日期 收款单位 拨付状态 凭证附件]
  F1 -->|"金额校验: 已登记金额 + 本次金额 不得超出申报单申请经费·超出时报出本次 已登记 合计 预算四项数值"| F2[待拨付 0]
  F2 -->|"仅待拨付 0 可改可删"| F2
  F2 -->|"状态改为已拨付时必须已有凭证附件"| F3[已拨付 20]
  K4 -->|登记拨款记录 research_fund_record| F1[填批次名称 拨付金额 拨付日期 收款单位 备注·凭证附件必填]
  F1 -->|"金额校验: 已登记金额 + 本次金额 不得超出申报单申请经费·超出时报出本次 已登记 合计 预算四项数值"| FGEN["自动生成 1:1 财务报销单 finance_reimbursement(1 行明细: 费用类型=其他 发票金额=拨付金额 发票日期=拨付日期 费用说明=课题名+批次)·附同一批凭证·立即提交 BPM·回写报销单号"]
  FGEN -->|回写台账状态| F3[报销审批中 15]
  F3 -->|"财务审核 Activity_finance_review"| FAPP[财务主管审批 Activity_finance_approve]
  FAPP -->|BPM 审批通过| F4[已拨付 20]
  FAPP -->|BPM 审批驳回| F5["已驳回 30·回写驳回原因与驳回时间"]
  F5 -->|"修改金额或凭证后重新发起报销"| F3
  FAPP -->|"财务端撤回或取消"| F2["待拨付 0·可编辑可删除"]
  F2 -->|"仅待拨付 0 可改可删·删除时联动清理财务侧草稿报销单"| F2
  F2 -->|"修改后重新发起报销"| F3
  ATT1["附件 recordType = research_guideline"] -.-> G3
  ATT2["附件 recordType = research_application"] -.-> K1
  ATT3["附件 recordType = research_fund_record"] -.-> F1
  ATT3["附件 recordType = research_fund_record·同一批 blob 双绑 finance_reimbursement(按 recordType+recordId 隔离互不影响)"] -.-> F1
  ROL["审批中心看单: 流程定义表单类型=自定义表单·创建路径 /research/application/index · 查看路径 /research/application/detail/approve/index.vue·按 businessKey 回显申报单"] -.-> K3
  ROL2["审批人取值: 三节点在流程定义内配好审批方法(依次审批)与审批人策略·部署后由管理员在 BPM 流程设计器按学会实际组织调整·提交时前端只让选流程不选审批人"] -.-> K3
  RES1["一期边界: 经费拨付只在本模块落拨款记录·与财务模块无数据同步(不做跨模块对接)"] -.-> F1
  LIS2["监听器 ResearchFundStatusListener(流程 key=finance_reimbursement_approve·businessKey=报销单 ID): 通过→台账已拨付 20·驳回→已驳回 30+原因与时间·撤回/取消→退回待拨付 0·与 finance 自己的监听器订阅同一 key 并行触发"] -.-> F3
  FINAPI["跨模块走新建的 yudao-module-finance-api(FinanceReimbursementApi·本地 Bean 非 HTTP): 无已发布报销审批流程时先解析即报错·不建单·避免留下孤儿草稿报销单"] -.-> FGEN
  RES1["一期已对接财务: 拨款必须走 finance_reimbursement 报销单出账·课题侧台账=拨款台账·财务报销单=出账凭证·两边以 reimbursement_id 软关联(无外键)·财务审批结果自动回写本台账"] -.-> F1
  RES2["二期范围(本图未覆盖): 结项验收 结项证书 成果归档知识库 采纳情况与社会效益标注"] -.-> K4
  BOUND["独立模块 yudao-module-research·对 ums_member 为软关联(无外键)·仅复用 BPM 审批、system 公告与附件中心"] --- K1
  BOUND["独立模块 yudao-module-research·对 ums_member 为软关联(无外键)·对财务模块走 -api 子模块本地调用·仅复用 BPM 审批、system 公告与附件中心"] --- K1
</pre>

<script type="module">