课题经费拨付对接财务报销 - 前端联调方案

涉及模块：yudao-module-research（课题管理）↔ yudao-module-finance（财务报销），跨模块通过新建的 yudao-module-finance-api 本地 Bean 调用。
后端接口前缀：/research/fund-record
附件关联：课题侧 recordType = research_fund_record，财务侧 recordType = finance_reimbursement，application = file（同一批 blob 双绑，互不影响）

涉及页面

前端 finance 模块页面**无需改动**：报销单由后端自动创建并提交，财务人员在既有的「财务报销 → 报销单」列表里正常审批即可。

字典已由 SQL 脚本补齐，前端继续用 getDictOptions(DICT_TYPE.RESEARCH_FUND_STATUS) / CellDict 取值，无需新建枚举：

字典项 id 段：8100401 待拨付 / 8100403 报销审批中 / 8100402 已拨付 / 8100404 已驳回。

按钮权限标识（无变化，沿用一期）：

research:fund:create、research:fund:update、research:fund:delete、research:fund:query

业务流程与数据带入

课题详情 → 经费拨付面板
        │
        登记拨款（拨付批次、拨付金额、拨付日期、收款单位、备注、拨付凭证）
        │  ← 凭证必填：先上传拿 blobId，再把全部 blobId 放进本次请求体一起提交
        ▼
   create 接口（一条龙，前端只需调一次）
        ├── 1. 课题侧落 research_fund_record 台账（状态先置「待拨付」）
        ├── 2. 同一批 blob 绑定到课题台账（research_fund_record）
        ├── 3. 自动创建财务报销单 finance_reimbursement（1:1、金额一致）
        │      标题 = 课题〔课题名〕第N期/第N次经费拨款
        │      明细固定 1 行：费用类型=其他(5)、发票金额=拨款金额、发票日期=拨付日期、费用说明=标题
        ├── 4. 立即提交 BPM 审批（finance_reimbursement_approve）
        └── 5. 台账回写 reimbursementId / reimbursementNo，状态置「报销审批中(15)」
        ▼
财务审核 → 财务主管审批（在财务模块的报销单审批中心完成）
        │
        ├── 通过  → 台账自动变「已拨付(20)」
        ├── 驳回  → 台账自动变「已驳回(30)」，并回写驳回原因 + 驳回时间
        └── 撤回/取消 → 台账退回「待拨付(0)」，可编辑后重新发起

信息带入（关键）

API

请求参数（create / update 共用同一个 VO）：

⚠ status 字段已从请求体中移除：拨付状态由系统驱动（登记 → 报销审批中 → 已拨付/已驳回），前端不要再传，也不要在表单里放状态下拉。

响应字段新增（/list 返回的每条记录）：

响应示例：

{
  "code": 0,
  "data": [
    {
      "id": 3,
      "applicationId": 2,
      "batchName": "第一期",
      "amount": 50000.0,
      "payDate": "2026-12-01",
      "payee": "XX大学",
      "status": 15,
      "reimbursementId": 7,
      "reimbursementNo": "BX20260929000007",
      "rejectReason": "",
      "rejectTime": null,
      "remark": "第一期拨款",
      "creatorName": "超级管理员",
      "createTime": "2026-09-29 10:00:00",
      "attachmentList": [],
      "hasAttachment": true
    }
  ]
}

字段展示规则

业务规则说明

注意事项

• 必须先部署财务报销审批流程：bpm_category 中 finance_reimbursement_approve 分类已存在，但其下必须有一个**已发布**的流程定义（2 节点：财务审核 → 财务主管审批），否则登记拨款会报「请先在 BPM 创建并发布报销审批流程后重试」。
• 拨付明细由系统生成，不可编辑：报销单的明细固定 1 行（费用类型=其他、发票金额=拨款金额、发票日期=拨付日期），前端不要在课题侧做明细编辑。
• 状态只读：拨付状态由系统与 BPM 驱动，前端任何表单都不要再提交 status。
• 删除是"两清"：删待拨付记录时会联动删除财务侧的草稿报销单；财务侧已提交/已通过的报销单必须先撤回或处理，否则删除被拒。
• 软关联无外键：台账与报销单靠 reimbursement_id 关联。若财务侧**直接删除**了报销单，台账会留下悬空 ID，此时再次修改会提示「关联的财务报销单已不存在，请删除本条拨款记录后重新登记」。
• 附件为全量替换语义：修改记录时 blobIds 传的是全部凭证；不传或传空数组会清空凭证（且后端会先校验必填并直接拒绝）。
• 列表页余额提示仅供参考：可用余额 = 申请经费 − 已登记拨付合计，最终以服务端累计校验为准（超出会返回带「本次/已登记/合计/上限」四要素的精确报错）。