RuoYi-Vue-Pro工作流实战：企业级请假审批系统搭建指南

1. 工作流系统在企业应用中的核心价值

现代企业运营中，流程化管理已成为提升效率的关键。传统纸质审批或简单的电子表单已经无法满足企业对于流程透明化、标准化和自动化的需求。RuoYi-Vue-Pro集成的BPM（业务流程管理）系统正是为解决这一问题而生。

为什么选择工作流引擎？想象一下这样的场景：当员工提交请假申请后，系统能自动根据请假天数判断审批路径——3天以内直接主管审批即可，3-7天需要部门负责人审批，超过7天则必须经过HR总监批准。这种智能路由正是BPM系统的核心能力。

RuoYi-Vue-Pro的工作流模块基于Activiti7深度定制，主要解决以下痛点：

• 审批流程可视化：通过拖拽方式设计流程，告别硬编码
• 动态路由：根据业务条件自动选择审批路径
• 审批委托：主管出差时可临时授权他人代审
• 数据穿透：审批时可直接查看申请人历史考勤记录
• 多租户支持：同一套系统可服务不同组织的差异化流程需求

sql复制-- 核心流程分类表结构
CREATE TABLE `bpm_category` (
  `id` bigint NOT NULL AUTO_INCREMENT COMMENT '分类编号',
  `name` varchar(255) DEFAULT NULL COMMENT '分类名',
  `code` varchar(255) DEFAULT NULL COMMENT '分类标志',
  `status` int DEFAULT NULL COMMENT '状态',
  `tenant_id` bigint NOT NULL DEFAULT 0 COMMENT '租户编号'
) ENGINE=InnoDB COMMENT='流程分类';

2. 环境准备与基础配置

2.1 系统依赖检查

确保开发环境满足以下要求：

• JDK 1.8+
• MySQL 5.7+
• Redis 5.0+
• Maven 3.5+
• Node.js 12+

提示：生产环境建议使用MySQL主从架构，工作流的历史数据会随时间增长而累积

2.2 数据库初始化

执行项目中的SQL脚本，重点关注以下表：

• bpm_form：表单定义表
• bpm_process_definition_info：流程定义表
• bpm_oa_leave：请假业务表

bash复制# 初始化数据库
mysql -u root -p < ruoyi-vue-pro.sql

2.3 前端工作流配置

在src/views/bpm目录下，主要功能模块包括：

• modeler：流程设计器
• process：流程实例管理
• task：待办任务中心
• form：动态表单设计

配置前端API请求基地址：

javascript复制// .env.development
VUE_APP_BASE_API = '/dev-api'

3. 请假审批流程实战搭建

3.1 设计请假表单

使用内置表单设计器创建请假申请单，包含以下字段：

表单JSON配置示例：

json复制{
  "fields": [
    {
      "type": "select",
      "name": "type",
      "label": "请假类型",
      "options": [
        {"label":"病假","value":1},
        {"label":"年假","value":2}
      ]
    }
  ]
}

3.2 绘制审批流程图

在流程设计器中构建如下节点：

1. 开始节点：关联请假表单
2. 主管审批：
   • 设置审批人为申请人直属上级
   • 添加条件：day <= 3时自动通过
3. 部门审批：
   • 配置会签模式（多人审批需全部同意）
   • 设置超时自动提醒
4. HR备案：
   • 指定固定审批角色
   • 连接电子签章系统
5. 结束节点：更新请假状态

注意：网关分支必须设置明确的condition表达式，避免流程卡死

3.3 业务表与流程关联

在bpm_oa_leave表中关键字段：

• process_instance_id：关联流程实例
• result：存储最终审批结果

审批逻辑代码片段：

java复制@Transactional
public void approve(Long leaveId, Boolean result) {
    Leave leave = leaveMapper.selectById(leaveId);
    if (leave.getResult() != 0) {
        throw new ServiceException("该申请已处理");
    }
    leave.setResult(result ? 1 : 2);
    leaveMapper.updateById(leave);
    
    // 触发流程推进
    taskService.complete(
        taskService.createTaskQuery()
            .processInstanceId(leave.getProcessInstanceId())
            .singleResult().getId());
}

4. 高级功能实现

4.1 动态审批人配置

实现三种审批人指定方式：

1. 固定角色：如HR角色
2. 上级关系：通过组织架构API获取
3. 自定义选择：申请时手动指定

java复制// 获取部门负责人示例
public List<Long> getDeptLeaders(Long deptId) {
    return sysUserMapper.selectList(
        new QueryWrapper<SysUser>()
            .eq("dept_id", deptId)
            .eq("post_code", "dept_leader")
    ).stream().map(SysUser::getUserId)
     .collect(Collectors.toList());
}

4.2 审批链自动跳转

在流程定义中添加监听器实现自动审批：

xml复制<activiti:executionListener 
    event="take"
    class="com.ruoyi.bpm.listener.AutoApproveListener"/>

监听器逻辑判断：

java复制public class AutoApproveListener implements ExecutionListener {
    @Override
    public void notify(DelegateExecution execution) {
        Integer days = (Integer)execution.getVariable("day");
        if (days < 1) {
            execution.setVariable("approved", true);
        }
    }
}

4.3 数据权限控制

在application.yml中配置数据隔离策略：

yaml复制ruoyi:
  workflow:
    data-isolation: tenant # 可选user/dept/tenant

SQL查询自动注入条件：

sql复制SELECT * FROM bpm_oa_leave 
WHERE ${dataScope} 
AND deleted = 0

5. 性能优化与生产建议

5.1 数据库索引优化

为高频查询字段添加索引：

sql复制ALTER TABLE `bpm_oa_leave` 
ADD INDEX `idx_user_status` (`user_id`, `result`);

ALTER TABLE `bpm_process_instance_copy`
ADD INDEX `idx_task_user` (`task_id`, `user_id`);

5.2 历史数据归档方案

创建归档表并配置定时任务：

java复制@Scheduled(cron = "0 0 2 * * ?")
public void archiveHistoricProcess() {
    // 归档3个月前的完成流程
    historicService.createHistoricProcessInstanceQuery()
        .finishedBefore(DateUtils.addMonths(new Date(), -3))
        .list()
        .forEach(instance -> {
            archiveService.saveArchive(instance);
            runtimeService.deleteProcessInstance(instance.getId());
        });
}

5.3 集群部署注意事项

1. 配置共享存储用于流程定义缓存
2. 使用Redis分布式锁控制流程部署
3. 设置统一的Quartz集群配置

properties复制# application-cluster.properties
spring.activiti.async-executor-activate=true
spring.activiti.job-executor-activate=false

6. 常见问题排查

流程卡住怎么办？

1. 检查ACT_RU_TASK表当前任务
2. 查询ACT_RU_EVENT_SUBSCR事件订阅
3. 使用runtimeService.trigger()手动触发事件

审批人看不到待办？

1. 确认用户角色是否匹配
2. 检查ACT_RU_IDENTITYLINK身份关联
3. 验证数据权限过滤条件

性能慢如何优化？

1. 限制流程变量大小（避免存储大对象）
2. 启用异步执行器
3. 增加历史日志清理频率

sql复制-- 查询运行中流程耗时统计
SELECT PROC_DEF_ID_, avg(DURATION_) 
FROM ACT_RU_TASK 
GROUP BY PROC_DEF_ID_
ORDER BY 2 DESC;

7. 扩展开发指南

7.1 与钉钉集成

实现钉钉审批同步：

1. 配置钉钉回调地址
2. 实现消息加解密
3. 状态同步逻辑

java复制@DingTalkEventListener
public void handleApproveEvent(ApproveEvent event) {
    String instanceId = event.getProcessInstanceId();
    if (event.isAgree()) {
        taskService.complete(
            taskService.createTaskQuery()
                .processInstanceId(instanceId)
                .singleResult().getId());
    }
}

7.2 添加电子签章

集成e签宝示例：

1. 配置SDK参数
2. 创建签约流程
3. 回调验签

yaml复制esign:
  app-id: your_app_id
  app-secret: your_secret
  api-host: https://openapi.esign.cn

7.3 生成审批报表

使用EasyExcel导出数据：

java复制public void exportLeaveRecord(HttpServletResponse response) {
    List<LeaveRecordVO> records = leaveService.getLeaveRecords();
    ExcelUtil.export(response, "请假记录", records);
}

报表统计SQL示例：

sql复制SELECT 
    u.user_name,
    COUNT(*) as total,
    SUM(IF(l.result=1,1,0)) as approved
FROM bpm_oa_leave l
JOIN sys_user u ON l.user_id = u.user_id
GROUP BY u.user_id

8. 最佳实践总结

在实际项目中，我们总结出以下经验：

1. 流程版本控制：每次修改都生成新版本，避免影响运行中实例
2. 表单字段冗余：在业务表中存储关键字段，减少流程变量查询
3. 审批日志完善：记录每个环节的操作人和意见
4. 移动端适配：确保审批页面在手机端友好显示
5. 压力测试：模拟并发审批场景，验证系统稳定性

调试技巧：

• 使用act_ge_bytearray表查看流程定义XML
• 通过ACT_RU_VARIABLE检查运行时变量
• 启用DEBUG日志级别观察流程跳转

java复制// 流程调试工具方法
public void debugProcess(String instanceId) {
    DelegateExecution execution = runtimeService
        .createExecutionQuery()
        .executionId(instanceId)
        .singleResult();
    log.info("当前节点：{}", execution.getCurrentActivityId());
    log.info("流程变量：{}", runtimeService.getVariables(instanceId));
}