qqflowengine-backend

qqflowengine-backend

通用型流程审批设计与管理系统 — 后端服务

技术栈

• Java 17
• Spring Boot 3.2.5 + Spring Security 6 + JWT
• MyBatis-Plus 3.5.7
• MySQL 5.7（生产/测试） / H2（本地开发）
• Redis + Redisson（分布式锁）
• EasyExcel 3.3（导入导出）
• SpringDoc OpenAPI（Swagger）

快速启动

cd qqflowengine-backend
mvn spring-boot:run

• API 服务：http://localhost:8080
• Swagger 文档：http://localhost:8080/swagger-ui/index.html

Profile 说明

Profile	数据库	用途
dev（默认）	H2 文件数据库	本地开发，每次启动重建表和数据
test	MySQL	测试环境，连接 192.168.1.139

切换 Profile：修改 application.yml 中的 spring.profiles.active。

默认账号

密码均为 123456a：

账号	类型	说明
admin	super_admin	超级管理员
zhangsan	common_user	普通用户
lisi	dept_manager	部门管理员
wangwu	flow_manager	流程管理员

角色账号（审批使用，不登录）：role_super_admin、role_flow_admin、role_normal_user、role_dept_manager

账户体系

• sys_user — 个人账号，登录时用用户名或手机号 + 密码
• sys_role — 审批角色（纯权限，不登录），通过 sys_user_role 关联到用户
• 菜单和接口权限由 sys_user.employeeType 控制

构建部署

mvn clean package -DskipTests
java -jar target/qqflowengine-backend-1.0.0.jar

项目结构

src/main/java/com/qqflow/engine/
├── common/             # 公共组件（Result、RedisCache、RedissonService、ExcelParseService、PageRequest）
├── config/             # Spring 配置 + Security（JWT、CORS）
├── domain/
│   ├── flow/           # 流程引擎（定义、实例、任务、审批记录、分析、导入）
│   ├── system/         # 用户、角色、部门、认证
│   └── ewechat/        # 企业微信回调集成
└── QqFlowEngineApplication.java

src/main/resources/
├── application.yml / application-dev.yml / application-test.yml
├── schema-mysql.sql / data-mysql.sql    # MySQL 初始化
├── schema-dev.sql / data-dev.sql        # H2 开发初始化
├── mapper/                              # MyBatis XML
└── migration-*.sql                      # 增量迁移脚本