# Bpmn-Project-Back

**Repository Path**: tjs/bpmn-project-back

## Basic Information

- **Project Name**: Bpmn-Project-Back
- **Description**: 流程引擎后端，对应前端Bpmn-Project
- **Primary Language**: Java
- **License**: Apache-2.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 9
- **Created**: 2025-05-07
- **Last Updated**: 2025-05-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Bpmn-Project-Back

## 项目介绍

Bpmn-Project-Back 是一个基于 Flowable 工作流引擎的后端服务项目，提供工作流的设计、部署、执行等完整的流程管理功能。本项目采用
Spring Boot 3.x 框架开发，使用 Java 17，提供 REST API 接口供前端调用。

## 技术架构

- **基础框架**: Spring Boot 3.1.5
- **工作流引擎**: Flowable 7.0.1
- **数据库访问**: MyBatis-Plus 3.5.9
- **数据库**: MySQL 8.x
- **接口文档**: Knife4j 4.4.0 (基于 OpenAPI 3)
- **权限认证**: Sa-Token 1.39.0
- **工具集**:
    - Hutool 5.8.26
    - Lombok
    - transmittable-thread-local

## 项目结构

项目采用多模块设计，包含以下模块：

Bpmn-Project-Back

├── bpmn-project-api // 对外接口模块

├── bpmn-project-biz // 业务逻辑模块

└── bpmn-project-common // 公共模块

## 核心功能

1. **流程模型管理**
    - 流程模型创建
    - 流程模型编辑
    - 流程模型删除
    - 流程模型查询

2. **流程定义管理**
    - 流程定义部署
    - 流程定义查询
    - 流程定义删除
    - 流程定义激活/挂起

3. **流程实例管理**
    - 流程实例启动
    - 流程实例查询
    - 流程实例终止
    - 流程实例删除

## 快速开始

### 环境要求

- JDK 17+
- Maven 3.6+
- MySQL 8.x

### 安装步骤

1. 克隆项目到本地
2. 创建数据库并导入SQL脚本
3. 修改配置文件
   修改 `bpmn-project-biz/src/main/resources/application.yml` 中的数据库连接信息

4. 编译打包
   mvn clean package -DskipTests
5. 运行项目
   java -jar bpmn-project-biz/target/bpmn-project-biz.jar

## 接口文档

项目集成了Knife4j接口文档，启动项目后访问：http://localhost:8080/doc.html

## 开发规范

1. 代码格式遵循阿里巴巴Java开发规范
2. 接口统一使用 ResponseResult 包装返回结果
3. 异常统一使用 ServiceException 进行业务异常处理
4. 所有实体类继承 BaseEntity 获取基础字段

## 版本历史

- v1.0.0: 项目初始化版本

## 诚挚推荐

强烈推荐贺波老师的《深入Flowable流程引擎：核心原理与高阶实战》，Flowable 创始人 Tijs Rademakers 亲笔作序，该书对系统学习和深入掌握
Flowable
极有帮助，书中涵盖很多大型流程中心平台所涉及的技术架构和场景案例。[推荐购买链接](https://item.jd.com/14804836.html)

![](images/book2.jpg)

![](images/book1.jpg)