RuoYi-Flowable-Plus 工作流审批系统部署指南:5 步从零跑通一条请假审批流
2026/9/22 8:10:12 网站建设 项目流程

RuoYi-Flowable-Plus 工作流审批系统部署指南:5 步从零跑通一条请假审批流

【免费下载链接】RuoYi-Flowable-Plus本项目基于 RuoYi-Vue-Plus 进行二次开发扩展Flowable工作流功能,支持在线表单设计和丰富的工作流程设计能力。如果觉得这个项目不错,麻烦点个star🌟。项目地址: https://gitcode.com/gh_mirrors/ru/RuoYi-Flowable-Plus

请假审批还停留在微信群里 @ 人,谁批了、谁卡住了全靠翻聊天记录;月底统计进度时又得打开 Excel 逐条对。这类问题的根源是 BPM 流程缺少一个能留痕、能追溯的系统。RuoYi-Flowable-Plus 是一个把 Flowable 引擎封装进 RuoYi-Vue-Plus 脚手架的开源工作流项目,可视化流程设计器与在线表单设计器已经内置,前后端各启动一次即可得到一套可用的企业审批系统。技术栈为 Spring Boot 2.7 + Vue,数据库支持 MySQL、Oracle、PostgreSQL、SQLServer。

环境准备与部署顺序

依赖只有 JDK 8、Maven、MySQL 5.7+、Node.js 和 Redis 5,搭建顺序固定为:数据库、后端、前端。先拿到完整源码:

git clone https://gitcode.com/gh_mirrors/ru/RuoYi-Flowable-Plus

如何初始化 Flowable 数据库

在 MySQL 中建库并导入仓库提供的初始化脚本:

CREATE DATABASE ry_flowable DEFAULT CHARACTER SET utf8mb4; USE ry_flowable; SOURCE script/sql/mysql/mysql_ry_v0.8.X.sql;

脚本包含系统基础表、用户菜单以及工作流相关菜单。导入后,把ruoyi-admin/src/main/resources/application-dev.yml中数据源 URL 的库名改成你刚建的库名,账号密码按本机环境填写。

启动后端与前端

mvn clean install -Dmaven.test.skip=true

在仓库根目录执行,编译并安装全部 Maven 模块,跳过单测加快速度。

cd ruoyi-admin && mvn spring-boot:run

启动后端服务,监听 8080 端口,首次启动会自动创建 Flowable 引擎所需的数据表。

cd ruoyi-ui && npm install && npm run dev

启动前端开发服务器,默认占用 80 端口,接口请求会自动代理到 8080。

浏览器打开 http://localhost,用默认的 admin / admin123 登录,左侧已能看到流程分类、表单配置、流程模型、部署管理等工作流菜单。

请假审批流程走完全程:设计到部署

进入工作流菜单,按下面四步操作一次即可:

  1. 流程分类:新建"请假管理"分类,作为后续流程的归属
  2. 表单配置:新建一张请假申请表单,添加请假类型、开始时间、结束时间、请假事由四个字段
  3. 流程模型:新建模型后打开设计器,从左侧拖入开始事件、一个用户任务(部门主管审批)、结束事件并连线;在右侧属性面板里为该任务设置候选人,并绑定刚建的请假表单
  4. 部署:保存后点击部署,模型即成为可发起的流程定义,可在部署管理中查看

设计器的前端实现位于ruoyi-ui/src/components/ProcessDesigner/,画布上的每次拖拽最终保存为 BPMN 文件提交给后端。

发起流程与办理待办

  • 发起人:新建流程 → 选择请假模型 → 填写表单 → 提交,实例出现在"我的流程"
  • 审批人:登录后打开待办任务菜单,对任务点"同意"或"驳回"并填写意见;团队共办的任务先出现在待签任务里,签收后才进入待办
  • 发起人追踪:在"我的流程"详情中查看流转记录,每个节点的办理人、意见和时间都留痕

用流程监控掌握进度

已处理的数据在已办任务、抄送我的菜单中可查;详情页的流程跟踪会把当前节点在 BPMN 图上高亮出来,卡在哪一步一目了然。流程引擎相关代码集中在ruoyi-flowable/src/main/java/com/ruoyi/flowable/包下,想了解引擎行为时优先读application.yml中 flowable 配置段。

什么时候需要写代码:监听器与集成点

以下三件事,基本流程跑通之前都可以不碰:

  • ✅ 自定义监听器:ruoyi-flowable/src/main/java/com/ruoyi/flowable/listener/下已有全局事件与用户任务两个监听器示例,当任务完成后要发消息通知或回写业务表时再参考它扩展
  • ✅ 第三方集成:项目自带 springdoc 接口文档,外部系统可通过 REST API 发起和查询流程;数据定时同步可复用内置的 xxl-job 模块
  • ✅ 性能调优:生产环境给act_ru_task的高频查询字段加索引,保持 Redis 缓存开启,并定期清理历史表,避免库体积无限增长

常见卡点与排查思路

  • 后端起不来:多数是数据库或 Redis 连不上。先确认两个服务在运行,再核对application-dev.yml里的库名、账号密码;若 Flowable 表缺失,可执行仓库script/sql/mysql/下的 Flowable 建表脚本
  • 审批人看不到待办:检查任务节点的候选人/候选角色配置,与实际登录账号是否一致,再看流转记录判断流程停在哪
  • 流程卡在网关:逐条核对各分支条件表达式,确认表达式引用的变量名与表单字段名完全一致
  • 设计器加载慢:清浏览器缓存,或重装ruoyi-ui的 node 依赖

下一步做什么

  • 用同一套操作搭第二条更复杂的流程:在审批上加金额或天数的条件分支,走通网关
  • 在用户管理中拆分发起人与审批角色,多账号登录验证权限隔离
  • 通读监听器源码,给一个任务挂上自定义完成回调,完成第一次二次开发

【免费下载链接】RuoYi-Flowable-Plus本项目基于 RuoYi-Vue-Plus 进行二次开发扩展Flowable工作流功能,支持在线表单设计和丰富的工作流程设计能力。如果觉得这个项目不错,麻烦点个star🌟。项目地址: https://gitcode.com/gh_mirrors/ru/RuoYi-Flowable-Plus

创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考

需要专业的网站建设服务?

联系我们获取免费的网站建设咨询和方案报价,让我们帮助您实现业务目标

立即咨询