# flowable

**Repository Path**: huijz_admin/flowable

## Basic Information

- **Project Name**: flowable
- **Description**: 流程组件
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-09-15
- **Last Updated**: 2025-10-08

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flowable工作流管理系统

这是一个基于Spring Boot 3、Java 21、MySQL和Flowable工作流引擎的工作流管理系统，前端使用Vue 3实现，采用前后端分离架构。

## 项目结构

```
flowable/
├── flowable-backend/        # 后端项目
│   ├── src/                 # 源代码
│   │   ├── main/
│   │   │   ├── java/        # Java代码
│   │   │   └── resources/   # 资源文件
│   │   └── test/            # 测试代码
│   └── pom.xml              # Maven配置
└── flowable-frontend/       # 前端项目
    ├── public/              # 静态资源
    ├── src/                 # 源代码
    ├── package.json         # NPM配置
    └── vue.config.js        # Vue配置
```

## 技术栈

### 后端

- Spring Boot 3.2.0
- Java 21
- MySQL 8.0
- Flowable 7.0.0
- Spring Data JPA
- Lombok

### 前端

- Vue 3
- Element Plus
- Vue Router
- Pinia
- TypeScript
- Axios

## 功能特性

- 用户认证与授权
- 流程定义管理
- 流程实例管理
- 任务管理（个人任务、组任务）
- 流程图可视化
- 表单动态渲染

## 快速开始

### 准备工作

1. 安装JDK 21
2. 安装Node.js (推荐v16+)
3. 安装MySQL 8.0
4. 创建数据库：
   ```sql
   CREATE DATABASE flowable DEFAULT CHARACTER SET utf8mb4 COLLATE utf8mb4_unicode_ci;
   ```

### 后端启动

1. 修改数据库配置（如需要）：
   ```
   flowable-backend/src/main/resources/application.yml
   ```

2. 构建并运行后端：
   ```bash
   cd flowable-backend
   ./mvnw spring-boot:run
   ```

### 前端启动

1. 安装依赖：
   ```bash
   cd flowable-frontend
   npm install
   ```

2. 启动开发服务器：
   ```bash
   npm run serve
   ```

3. 访问应用：
   ```
   http://localhost:8080
   ```

## 示例流程

系统内置了一个请假审批流程（leave-approval.bpmn20.xml），包含以下节点：

1. 开始事件
2. 填写请假单（用户任务）
3. 领导审批（用户任务）
4. 排他网关（审批决定）
5. 人事记录（用户任务，仅当审批通过时）
6. 结束事件（审批通过/拒绝）

## API文档

启动后端服务后，可以通过以下地址访问API文档：

```
http://localhost:8080/api/swagger-ui/index.html
```

## 开发指南

### 添加新的流程定义

1. 使用Flowable Modeler或其他BPMN设计工具创建流程定义文件
2. 将生成的.bpmn20.xml文件放入`flowable-backend/src/main/resources/processes/`目录
3. 重启应用，Flowable会自动部署新的流程定义

### 自定义表单

1. 在前端创建新的表单组件
2. 在流程定义中通过formKey属性关联表单
3. 在TaskList.vue中添加对应的表单渲染逻辑

## 许可证

MIT