工作流手册
RuoYi Office 内置基于 Flowable 7 的工作流能力，用于覆盖请假、用印、用车、入职、转正、调动、离职、合同、付款等企业审批场景。流程引擎负责建模、流转、任务和审批操作；在线表单设计能力已单独归档到 表单设计器。
功能边界
| 能力 | 说明 |
|---|---|
| 流程模型 | 支持 BPMN 设计器和简易流程设计器 |
| 业务表单 | 使用独立业务表存储，适合复杂业务闭环 |
| 审批操作 | 通过、拒绝、驳回、转办、委派、抄送、加签、减签 |
| 多人审批 | 会签、或签、依次审批 |
| 节点扩展 | 监听器、表达式、条件分支、触发节点等 |
| RuoYi Office 扩展 | 字段权限、业务单据状态同步、移动端审批、跨服务通知 |
代码位置
| 层 | 路径 |
|---|---|
| 后端模块 | ruoyi-office/yudao-module-bpm |
| 启动入口 | 单体模式由 ruoyi-office/yudao-server 聚合启动 |
| PC 页面 | ruoyi-office-vben/apps/web-antd/src/views/bpm |
| 移动端公共能力 | ruoyi-office-uniapp/src/pages-bpm |
| 表单生成提示词 | ruoyi-office-prompt/ |
yudao-module-bpm是当前工程沿用的模块名，属于代码和架构标识，不代表文档或产品品牌仍指向上游站点。
启用方式
单体模式
确认 ruoyi-office/pom.xml 聚合了 yudao-module-bpm，并且 yudao-server 依赖中启用了 BPM 模块。启动 YudaoServerApplication 后，数据库中应能看到 Flowable 的 ACT_、FLW_ 表，以及 RuoYi Office 的 bpm_ 业务表。
微服务模式
微服务模式下，需要启动 Gateway、System、Infra、BPM 等服务，并确保服务注册到同一个 Nacos 命名空间。前端仍通过 Gateway 的 /admin-api 访问。
菜单与权限
初始化 SQL 应包含流程中心菜单。管理员登录后重点检查：
- 流程模型
- 流程分类
- 用户组
- 发起流程
- 我的流程
- 待办任务
- 已办任务
- 抄送我的
两种表单接入方式
| 维度 | 流程表单 | 业务表单 |
|---|---|---|
| 数据存储 | Flowable 变量 | 独立业务表 |
| 开发成本 | 低，在线配置 | 中高，需要前后端开发 |
| 查询统计 | 适合简单查询 | 适合复杂报表与业务分析 |
| 页面能力 | 受表单设计器约束 | 可完全定制 |
| 推荐场景 | 临时审批、轻量表单 | OA、HRM、CRM、合同、项目等业务闭环 |
- 表单开发总览：/form-designer/
- 表单设计器：/form-designer/designer/
- 流程表单接入：/form-designer/use-bpm-form/
- 流程表单上下文变量：/form-designer/bpm-form-context/
- 业务表单接入：/bpm/use-business-form/
使用流程
- 在“流程分类”维护分类，例如 OA、人力、财务。
- 在“表单设计器”或业务模块中准备表单。
- 在“流程模型”中新建模型，填写流程标识、名称、分类和图标。
- 选择表单类型并配置表单或业务页面路由。
- 使用设计器配置审批节点、审批人规则、按钮和字段权限。
- 发布流程。
- 用户在“发起流程”或业务页面提交申请。
- 审批人在“待办任务”处理，流程状态同步回业务单据。
RuoYi Office 扩展建议
- 新业务审批优先使用“业务表单”，便于与 OA、HRM、CRM 等模块形成完整业务闭环。
- 如果审批节点需要回填业务字段，表单页应暴露
beforeApproval，在审批前保存可编辑字段。 - 拒绝操作应跳过非必要业务字段校验，避免审批人无法拒绝异常单据。
- 移动端业务表单需要支持
embedded、editable、getFormValues、validate、submit等能力。
常见问题
看不到流程菜单
先确认 SQL 初始化是否包含 BPM 菜单和权限，再检查当前角色是否授权。
启动后 Flowable 表不存在
检查 BPM 模块是否启用、数据库账号是否有建表权限，以及 Flowable 的表结构初始化配置是否生效。
业务单据状态不更新
检查业务 Service 是否实现了流程状态同步逻辑，流程回调是否能定位到对应单据，以及 processInstanceId 是否正确保存。
