ApprovaPlat
基于 RuoYi、Flowable 8、Spring Boot 4 和 Vue 3 的开源审批中台。
覆盖流程设计、发布、发起、办理、权限、数据与审计。
中文 | English
项目简介
ApprovaPlat 是一套基于 Flowable 8 的审批系统实现。
目前已经跑通：
流程设计
→ 校验与部署
→ 流程发起
→ Flowable 执行
→ 任务办理
→ 历史与审计
流程、表单、权限、业务数据和运行状态统一在项目中维护，可用于 Flowable 8 学习、审批系统开发和二次开发参考。
为什么做这个项目
我在一次 B 端 AI 产品实习中接触到企业审批，也开始关注一套审批中台是怎样把流程、表单、权限和业务数据串起来的。
在调研 RuoYi-Vue、芋道、Flowable 和 bpmn.io 等项目后，我希望建立一套技术栈较新、开放范围清晰、代码与数据库资产完整公开的 Flowable 8 工程实现。
ApprovaPlat 因此以 Flowable 8 为运行核心，把设计、部署、发起、办理、权限、数据与审计完整串起来，并将业务规则、SQL、文档和验证入口放在同一仓库持续维护。
项目目前还在早期，核心代码、SQL、文档和测试会保持公开。欢迎各位大佬多提建议，也希望正在开发、准备开发或迁移审批系统的人，能从这里找到一些真正用得上的实现和经验。
目前支持
流程设计与发布
- 流程分类、动态表单、BPMN 模型和版本管理。
- BPMN.js 流程设计器，支持导入、导出、源码预览、Lint、Token 模拟和节点配置。
- 后端 BPMN 部署校验。
- 部署时保存表单、扩展配置、DMN 和 SLA 快照。
- 新版本发布后挂起旧流程定义，在途实例继续运行。
发起与办理
提供：
- 新建流程
- 我的流程
- 待办
- 待签
- 已办
- 抄送
支持：
- 发起、认领、通过
- 退回、驳回、撤回
- 转办、委派
- 取消、终止、挂起
- ALL 会签、ANY 或签
- 动态加签、减签
多人审批和退回等场景包含 revision 冲突处理。
提交表单和部署表单保留对应快照；附件支持权限、配额、绑定、下载、删除和物理清理。
复杂流程与集成
目前包括：
- 排他、并行、包容和事件网关
- BPMN Error / Escalation
- Boundary Timer
- 业务日历
- SLA
- DMN 决策
- 带退出条件和最大次数的受控整改循环
- Participant / MessageFlow 多池协作
- CEL
- 受控 Java
- HTTP Connector
- SQL Connector
多池协作支持持久化、幂等、顺序控制、重试、死信和审计。
权限与运行
- 区分设计、发起、办理、管理和审计职责。
- 对实例、任务、部署、附件和审计数据进行对象级授权。
- Flowable 数据和业务数据共用主数据源与事务边界。
- 运行状态从 Flowable Runtime 和正式数据库读取。
- 支持重新加载实例、已部署 BPMN 和历史执行路径。
- 提供 Health Check、Runtime Snapshot、Micrometer / Prometheus 指标和运行就绪检查。
运行效果
采购申请表单
采购事项、金额、到货日期和报价附件，可在表单设计器中配置。
采购审批流程
采购初审、财务与法务并审、金额分支、定时等待和归档子流程。
发起表单与实例列表
填写采购申请，保存草稿或提交审批。
在“我的流程”中查询申请，查看当前环节和审批状态。
流程执行轨迹
这条采购申请金额为 3,000，经财务与法务并审、大额审批、税务复核后归档。绿色标出实际经过的节点与连线。
审批记录
按节点查看办理人、耗时、认领记录和审批意见。
动态多人会签
快速开始
环境要求
- JDK 17+
- Maven 3.9+
- Node.js 20+
- npm 10+
- Docker（包含 Docker Compose）
1. 启动 MySQL 和 Redis
在仓库根目录执行：
docker compose up -d
docker compose ps
第一次创建 approvaplat-mysql-data Volume 时，MySQL 会执行：
等待 MySQL 和 Redis 均显示 healthy。已有 Volume 不会重复初始化。
2. 安装前端依赖
Set-Location ruoyi-ui
npm ci
3. 启动后端
在 IDEA 中打开 ruoyi-admin，运行：
RuoYiApplication
4. 启动前端
npm run dev
访问：
http://127.0.0.1:1024
本地初始账号：
username: admin
password: wang
初始凭据仅用于本地开发，对外开放服务前请修改密码。
本地开发无需设置数据库、Druid 或上传目录环境变量。更多开发和测试说明见 CONTRIBUTING.md。
日常开发
在仓库根目录执行：
docker compose up -d
随后在 IDEA 中运行 RuoYiApplication，并在 ruoyi-ui 目录执行：
npm run dev
日常停止与本地默认值
普通停止只执行：
docker compose down
本地 MySQL 固定使用 127.0.0.1:3306、数据库 approvaplat、账号 root、密码 root123；Redis 使用 127.0.0.1:6379 且无密码。上传目录默认为 ${user.home}/.approvaplat/uploads。
Druid Monitor 默认关闭。需要临时启用时设置 DRUID_MONITOR_ENABLED=true，访问 http://localhost:8080/druid/，本地默认账号为 ap、密码为 123456。
生产验收边界
ApprovaPlat 当前处于 Early Stage。
仍需在目标环境验证：
- 异步执行器、定时器与 SLA 的执行协调和监控
- 多节点部署与故障恢复
- 共享附件存储
- HTTP / SQL 等外部调用的幂等与异常恢复
- 容量、备份恢复与长时间稳定性
生产环境使用 flowable.database-schema-update=false，数据库结构由仓库 SQL 维护。异步执行器在数据库、拓扑、容量、监控和唯一执行协调验收通过后启用。业务重复审批使用受控整改循环；标准循环保留 XML 往返能力。
开发与测试
后端：
mvn clean verify
前端：
Set-Location ruoyi-ui
npm run lint
npm run test:contracts
npm run build:prod
现有测试覆盖 Flowable 核心流程、事务、权限、幂等与并发冲突、前端请求契约及浏览器场景。
MySQL 集成测试和浏览器回归的运行方式见 CONTRIBUTING.md。
技术栈
| 领域 | 技术 |
|---|---|
| 后端 | Java 17、Spring Boot 4.0.6 |
| 流程与决策 | Flowable 8.0.0 Process / DMN |
| 数据 | MyBatis、MySQL 8、Redis |
| 前端 | Vue 3.5.26、Vite 6.4.3、Element Plus 2.13.1 |
| 设计器 | BPMN.js 18.22.0 |
| 规则与连接器 | CEL、JSqlParser、受控 Java / HTTP / SQL |
| 可观测性 | Spring Boot Actuator、Micrometer、Prometheus |
| 测试 | JUnit 5、前端 Contract Test、Browser E2E |
仓库结构
ApprovaPlat/
├── pom.xml Maven 聚合入口
├── ruoyi-*/ Spring Boot 后端与 Flowable 领域模块
├── ruoyi-ui/ Vue 3 前端、流程设计器与前端测试
├── sql/ 数据库基线、业务结构与菜单权限
└── docs/ README 图片等文档资源
参与项目
欢迎提交 Issue 和 Pull Request。
Bug 建议附上运行环境、复现步骤、预期结果和实际结果；功能建议可以直接描述具体的审批场景。
开发规范、验证入口和提交要求见 CONTRIBUTING.md。
增加新的 BPMN 元素或审批动作时，请同时说明它如何配置、如何执行、谁能操作、数据保存在哪里，以及如何验证。
上游项目与许可证
ApprovaPlat 建立在以下开源项目之上：
项目使用 MIT License。
