# bpm

**Repository Path**: fangfangfang7/bpm

## Basic Information

- **Project Name**: bpm
- **Description**: No description available
- **Primary Language**: Java
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-05-12
- **Last Updated**: 2025-05-13

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# BPM 工作流管理系统

基于 Spring Boot 3.x + Flowable 6.7.2 开发的工作流管理系统，提供完整的流程管理、表单管理、消息通知等功能。

## 技术栈

### 后端技术栈
- 后端框架：Spring Boot 3.1.7
- 工作流引擎：Flowable 6.7.2
- 数据库：MySQL 8.0
- 数据库连接池：Druid
- ORM框架：MyBatis-Plus 3.5.6
- API文档：Knife4j 4.3.0
- 工具库：Hutool 5.8.25

### 前端技术栈
- 框架：Vue 3.4.0
- UI组件库：Element Plus 2.5.0
- 状态管理：Pinia 2.1.0
- 路由：Vue Router 4.2.0
- HTTP客户端：Axios 1.6.0
- 流程设计器：bpmn-js 13.0.0
- 构建工具：Vite 4.5.0
- 开发语言：TypeScript 5.0.0

## 功能清单

### 1. 流程管理功能
- 流程定义管理：部署、查询、删除、挂起/激活流程定义
- 流程实例管理：启动、查询、挂起/激活、删除流程实例
- 任务管理：待办任务、完成任务、任务转办、任务委托
- 任务历史：历史任务、历史流程实例查询

### 2. 表单管理功能
- 表单基础管理：创建、修改、删除、查询表单
- 表单版本管理：版本发布、回退、查询
- 表单数据管理：保存、查询、删除表单数据
- 表单权限管理：权限设置、查询
- 表单导入导出：Excel导入导出、Word导出、配置管理
- 表单附件管理：上传、下载、删除附件
- 表单模板管理：创建、使用、管理模板
- 表单验证：数据验证、规则管理
- 表单统计：数据统计、统计报表

### 3. 消息管理功能
- 消息管理：发送消息、查询消息、消息模板管理

### 4. 评论功能
- 评论管理：发表评论、查询评论、删除评论

## 项目结构
```
bpm-service
├── bpm-common        // 公共模块
├── bpm-flowable      // 工作流模块
├── bpm-web          // Web应用模块
└── bpm-frontend     // 前端项目
    ├── src/
    │   ├── api/           # API 接口封装
    │   ├── assets/        # 静态资源
    │   ├── components/    # 公共组件
    │   ├── layouts/       # 布局组件
    │   ├── router/        # 路由配置
    │   ├── stores/        # 状态管理
    │   ├── styles/        # 全局样式
    │   ├── utils/         # 工具函数
    │   └── views/         # 页面组件
    ├── package.json       # 项目配置
    └── vite.config.ts     # Vite配置
```

## 快速开始

### 后端启动
1. 环境要求
   - JDK 17+
   - Maven 3.6+
   - MySQL 8.0+

2. 配置数据库
   - 创建数据库
   - 修改 `application.yml` 中的数据库配置

3. 启动项目
   ```bash
   mvn clean install
   cd bpm-web
   mvn spring-boot:run
   ```

### 前端启动
1. 环境要求
   - Node.js 16+
   - npm 8+

2. 安装依赖
   ```bash
   cd bpm-frontend
   npm install
   ```

3. 启动开发服务器
   ```bash
   npm run dev
   ```

4. 构建生产版本
   ```bash
   npm run build
   ```

## 注意事项

### 后端配置
1. 文件上传配置
   - 需要在配置文件中设置 `bpm.upload.path` 和 `bpm.upload.url-prefix`
   - 确保上传目录存在且有写入权限

2. 数据库配置
   - 使用 MySQL 8.0 版本
   - 需要创建对应的数据库和用户
   - 确保数据库字符集为 utf8mb4

### 前端配置
1. 开发环境配置
   - 配置 `.env.development` 文件
   - 设置 API 代理地址

2. 生产环境配置
   - 配置 `.env.production` 文件
   - 设置生产环境 API 地址

3. 主题配置
   - 在 `src/styles/theme` 中配置主题变量
   - 支持动态切换主题

## 开发团队

- 开发时间：2024年
- 版本：1.0.0