# camunda工作流引擎Demo

**Repository Path**: bingbingyihao/camunda-workflow-engine-demo

## Basic Information

- **Project Name**: camunda工作流引擎Demo
- **Description**: camunda工作流引擎Demo
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 1
- **Created**: 2025-10-29
- **Last Updated**: 2025-11-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# camunda工作流引擎Demo

#### 介绍
这是一个基于 Camunda BPM 工作流引擎的前后端分离 Demo 项目，旨在展示如何通过 Spring Boot 集成 Camunda 并结合 Vue3 前端实现流程定义管理、流程实例启动、任务办理等核心功能。适用于学习和快速搭建工作流系统的原型开发。

本项目包含：
- 后端：Spring Boot + Camunda BPM 引擎 + MySQL
- 前端：Vue3 + Element Plus + Vue Router
- 流程模型：BPMN 2.0 格式（示例流程 simple-process.bpmn）

#### 软件架构
系统采用典型的前后端分离架构：

1. **前端（Vue）**
   - 使用 Vue 3 + Composition API 开发
   - UI 框架：Element Plus
   - 路由管理：Vue Router
   - HTTP 请求：Axios
   - 运行在 `http://localhost:8081`

2. **后端（Spring Boot）**
   - 集成 Camunda BPM 流程引擎（版本 7.18.0）
   - 提供 RESTful API 接口供前端调用
   - 自动部署 BPMN 流程文件
   - 数据库：MySQL 存储流程历史与运行数据
   - 运行在 `http://localhost:8080`

3. **通信方式**
   - 前端通过代理 `/api` 请求转发到后端服务
   - 支持跨域访问（CORS）

#### 安装教程

1. **环境准备**
   - JDK 1.8
   - Maven 3.6+
   - Node.js 14+ / npm
   - MySQL 5.7+

2. **数据库配置**
   - 创建数据库 `test`
   - 修改 `application.properties` 中的数据库连接信息（可选）

3. **启动后端服务**
   ```bash
   cd code/SpringBoot
   mvn spring-boot:run
   ```
启动成功后，Camunda 会自动部署 `simple-process.bpmn` 文件。

4. **启动前端服务**
   ```bash
   cd code/vue
   npm install
   npm run serve
   ```
   前端将运行在 `http://localhost:8081`

5. **访问系统**
   打开浏览器访问：[http://localhost:8081](http://localhost:8081)

#### 使用说明

1. **流程定义列表**
    - 进入“流程定义列表”页面，点击【刷新列表】获取所有已部署的流程。
    - 可查看流程的 ID、Key、名称、版本、部署状态等。
    - 点击【开启流程】按钮可启动一个新流程实例。

2. **启动流程**
    - 在弹窗中填写“负责人”（assignee），如 `user1`。
    - 系统将以该用户身份创建第一个任务。

3. **任务列表**
    - 进入“任务列表”页面，输入用户ID（如 `user1`）并查询。
    - 查看该用户的待办任务，点击【完成】即可推进流程。

4. **流程实例列表**
    - 显示当前正在运行的流程实例。
    - 可查看实例 ID 和对应的流程定义。

> 💡 示例流程说明：  
> 包含两个用户任务节点：“提交申请” → “审批”，由 assignee 推进流转。

#### 参与贡献

1.  Fork 本仓库
2.  新建 Feat_xxx 分支
3.  提交代码
4.  新建 Pull Request

#### 特技

1.  使用 Readme\_XXX.md 来支持不同的语言，例如 Readme\_en.md, Readme\_zh.md
2.  Gitee 官方博客 [blog.gitee.com](https://blog.gitee.com)
3.  你可以 [https://gitee.com/explore](https://gitee.com/explore) 这个地址来了解 Gitee 上的优秀开源项目
4.  [GVP](https://gitee.com/gvp) 全称是 Gitee 最有价值开源项目，是综合评定出的优秀开源项目
5.  Gitee 官方提供的使用手册 [https://gitee.com/help](https://gitee.com/help)
6.  Gitee 封面人物是一档用来展示 Gitee 会员风采的栏目 [https://gitee.com/gitee-stars/](https://gitee.com/gitee-stars/)