# flowable

**Repository Path**: axstudio/flowable

## Basic Information

- **Project Name**: flowable
- **Description**: flowable 工作流引擎 示例 （挂载到自己的业务表）
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

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

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Flowable Sample Project

This is a sample leave management project based on Flowable, suitable for quickly getting started and learning about workflow engines.

## Project Overview

This project demonstrates how to implement a simple leave approval workflow using the Flowable workflow engine. Key features include leave application, workflow initiation, approval, rejection, and querying of historical records.

## Main Components

- **QuickStartApplication**: Spring Boot startup class.
- **BusLeave**: Business entity class for leave requests.
- **BusLeaveDao**: Data access interface, extending BaseMapper from MyBatis Plus.
- **BusLeaveService**: Business logic class for handling creation, submission, approval, and other leave process operations.
- **Status**: Enumeration for leave request statuses.
- **Test**: Test class for verifying basic workflow engine functionality.
- **QJ_BPMN.bpmn20.xml**: Leave workflow definition file.

## Technology Stack

- Spring Boot
- Flowable
- MyBatis Plus
- BPMN 2.0

## Installation and Running

1. Clone the project to your local machine:
   ```bash
   git clone https://gitee.com/axstudio/flowable.git
   ```

2. Ensure that Java and Gradle are installed.

3. Run the project:
   ```bash
   cd flowable
   ./gradlew bootRun
   ```

## Usage Instructions

- Use methods in `BusLeaveService` to create, submit, approve, or reject leave requests.
- Use the test classes `BusLeaveServiceTest` or `ProcessEnginTest` to verify workflow functionality.

## Workflow Definition

The workflow definition file `QJ_BPMN.bpmn20.xml` is located in the `src/main/resources/flowable` directory and describes the complete leave approval process.

## Contribution Guide

Contributions to code and documentation improvements are welcome. Please follow these steps:

1. Fork the project.
2. Create a new branch.
3. Submit a Pull Request.

## License

This project is licensed under the MIT License. For details, please refer to the LICENSE file included in the project.