# FlowableSystemDemo

**Repository Path**: rinpu/graduation-project

## Basic Information

- **Project Name**: FlowableSystemDemo
- **Description**: 毕业设计：基于Flowalbe的工作流设计与实现
- **Primary Language**: Java
- **License**: MIT
- **Default Branch**: springboot3
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-11-05
- **Last Updated**: 2026-06-22

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 基于Flowable的工作流设计与实现

> 毕业设计项目

## 项目介绍

本项目基于 [RuoYi v3.9.2](https://gitee.com/y_project/RuoYi-Vue) 并集成 [RuoYi-Flowable](https://gitee.com/tony2y/RuoYi-flowable) 实现，是一个基于 Flowable 工作流引擎的流程管理系统。系统提供了流程定义、流程实例管理、任务审批、请假流程等核心工作流功能，同时保留了若依框架的用户管理、角色权限、菜单管理等基础能力。

## 技术栈

| 技术 | 版本 | 说明 |
| --- | --- | --- |
| Spring Boot | 3.5.4 | 后端核心框架 |
| Vue | 3 | 前端框架 |
| Element Plus | - | 前端UI组件库 |
| Flowable | 7.2.0 | 工作流引擎 |
| MyBatis-Plus | 3.5.10 | ORM框架 |
| MySQL | 8.x | 数据库 |
| Redis | - | 缓存 |
| Druid | 1.2.23 | 数据库连接池 |
| JWT | 0.9.1 | Token认证 |
| Knife4j | 4.5.0 | API文档 |
| Java | 17 | 开发语言 |

## 模块说明

```
RuoYi-Vue-springboot3
├── ruoyi-admin        # 后台入口模块（Controller、配置文件）
├── ruoyi-framework    # 框架核心（安全配置、数据源、AOP等）
├── ruoyi-system       # 系统模块（用户、角色、菜单、字典等）
├── ruoyi-common       # 通用工具模块（注解、常量、工具类等）
├── ruoyi-generator    # 代码生成模块
├── ruoyi-flowable     # 工作流模块（流程定义、实例、任务、表单等）
├── sql                # 数据库脚本
├── doc                # 项目文档
└── bin                # 运行脚本
```

## 环境要求

- JDK 17+
- MySQL 8.0+
- Redis
- Maven 3.8+
- Node.js 16+（前端开发）

## 快速开始

### 1. 克隆项目

```bash
git clone https://gitee.com/rinpu/graduation-project.git
cd graduation-project
```

### 2. 初始化数据库

- 创建 MySQL 数据库，导入 `rp-vue.sql` 脚本

### 3. 修改配置

编辑 `ruoyi-admin/src/main/resources/application-druid.yml`，修改数据库连接信息：

```yaml
url: jdbc:mysql://localhost:3306/你的数据库名?...
username: 你的用户名
password: 你的密码
```

编辑 `ruoyi-admin/src/main/resources/application.yml`，修改 Redis 连接信息（如需要）：

```yaml
spring:
  data:
    redis:
      host: localhost
      port: 6379
      password: 你的密码
```

### 4. 启动后端

```bash
# Maven 编译打包
mvn clean package -DskipTests

# 运行
java -jar ruoyi-admin/target/ruoyi-admin.jar
```

或使用提供的脚本：

```bash
# Windows
bin\run.bat

# Linux
bin/run.sh
```

后端启动成功后访问：`http://localhost:8080`

### 5. 启动前端

前端项目需单独获取并启动（基于 Vue3 + Element Plus），参考 [RuoYi-Vue3](https://github.com/yangzongzhuan/RuoYi-Vue3)。

## 核心功能

- **用户管理**：用户增删改查、分配角色、重置密码等
- **角色管理**：角色权限分配、数据权限设置
- **菜单管理**：菜单配置、权限标识
- **部门管理**：部门树形结构管理
- **字典管理**：系统常用数据字典维护
- **通知公告**：系统通知公告发布
- **操作日志**：系统操作记录查询
- **登录日志**：系统登录记录查询
- **在线用户**：在线用户监控与强退
- **代码生成**：根据数据库表自动生成代码
- **流程定义**：BPMN 流程模型设计与部署
- **流程实例**：流程实例的发起与查询
- **任务审批**：待办任务处理、已办任务查询
- **请假流程**：请假申请与审批示例

## 已知问题

- 集成 Bpmn.js 问题：目前中间事件无法使用
- ServiceTask 无法使用

## 开源协议

[MIT License](LICENSE)