AntFlow 开源OA审批工作流系统技术文档

【免费下载链接】AntFlow-activiti 🐜AntFlow is an activiti based,🛩︎battle tested,enterprise grade workflow engine.It is easy to use,easy to maintenance. If you love it,please ⭐️ it 🐜 AntFlow是一款基于Activiti深度定制的，久经生产考验的企业级低代码工作流平台,包含前端设计器和后端代码。设计上参考了钉钉工作流，比钉钉工作流功能更强大，更易于扩展，可以作为钉钉工作流的开源替代。如果喜欢请给颗⭐️,你的鼓励是我在开源路上前进的最大动力 项目地址: https://gitcode.com/zypqqgc/AntFlow

1. 安装指南

环境要求

• Java版本: Java 8-21 (主分支为Java 8版本，如需使用更高版本请切换到java17_support分支)
• 数据库: MySQL 5.7+
• 其他依赖: Maven 3.6+

安装步骤

1. 克隆项目:

   git clone https://github.com/xxx/AntFlow.git
   

2. 数据库准备:

   • 创建MySQL数据库
   • 执行项目中的SQL初始化脚本

3. 配置修改:

   • 修改application.yml中的数据库连接配置
   • 根据需求调整其他应用参数

4. 项目构建:

   mvn clean install
   

5. 启动应用:

   java -jar antflow-application.jar
   

2. 项目使用说明

2.1 系统登录

• 默认管理员账号: admin
• 默认密码: 123456 (首次登录后请修改)

2.2 工作流配置

1. 新建流程:

   • 点击"流程设计"菜单
   • 选择"新建流程"按钮
   • 填写基础信息(流程名称、分类等)

2. 节点配置:

   • 拖拽左侧节点到画布
   • 点击节点配置属性
   • 支持审批人节点、条件节点等

3. 流程发布:

   • 完成配置后点击"发布"按钮
   • 系统会自动校验流程有效性

2.3 流程发起

1. 用户可在"我的申请"页面发起流程
2. 选择已发布的流程模板
3. 填写表单数据并提交

2.4 流程审批

1. 审批人会在待办事项中收到审批任务
2. 可查看流程详情和审批历史
3. 支持通过/拒绝/转交等操作

3. 项目API使用文档

3.1 核心API接口

流程定义API

• POST /api/process/definition 创建流程定义
• GET /api/process/definition/{id} 获取流程定义详情
• PUT /api/process/definition/{id} 更新流程定义
• DELETE /api/process/definition/{id} 删除流程定义

流程实例API

• POST /api/process/instance 启动流程实例
• GET /api/process/instance/{id} 获取流程实例详情
• POST /api/process/instance/{id}/cancel 取消流程实例

任务API

• GET /api/task/list 获取待办任务列表
• POST /api/task/{taskId}/complete 完成任务
• POST /api/task/{taskId}/reject 拒绝任务

3.2 API调用示例

// 启动流程示例
ProcessInstanceStartRequest request = new ProcessInstanceStartRequest();
request.setProcessDefinitionId("leave_approval");
request.setVariables(Map.of("days", 3));

ResponseEntity<ProcessInstance> response = restTemplate.postForEntity(
    "http://localhost:8080/api/process/instance",
    request,
    ProcessInstance.class
);

4. 项目安装方式

4.1 标准安装

1. 下载预编译的发行版jar包
2. 确保已安装Java运行环境
3. 执行命令:

   java -jar antflow-application.jar
   

4.2 Docker安装

1. 拉取镜像:

   docker pull antflow/official
   

2. 运行容器:

   docker run -d -p 8080:8080 \
   -e SPRING_DATASOURCE_URL=jdbc:mysql://mysql_host:3306/antflow \
   -e SPRING_DATASOURCE_USERNAME=root \
   -e SPRING_DATASOURCE_PASSWORD=123456 \
   antflow/official
   

4.3 开发模式安装

1. 克隆项目源码
2. 导入IDE(推荐IntelliJ IDEA)
3. 配置Maven依赖
4. 直接运行Application主类

5. 常见问题解答

Q: 流程配置后无法发布? A: 请检查是否有未配置的节点属性，系统会在发布前自动验证流程完整性。

Q: 如何扩展自定义审批人规则? A: 实现ApproverRule接口并注册为Spring Bean即可。

Q: 支持哪些数据库? A: 默认支持MySQL，但可通过修改配置支持其他关系型数据库。

【免费下载链接】AntFlow-activiti 🐜AntFlow is an activiti based,🛩︎battle tested,enterprise grade workflow engine.It is easy to use,easy to maintenance. If you love it,please ⭐️ it 🐜 AntFlow是一款基于Activiti深度定制的，久经生产考验的企业级低代码工作流平台,包含前端设计器和后端代码。设计上参考了钉钉工作流，比钉钉工作流功能更强大，更易于扩展，可以作为钉钉工作流的开源替代。如果喜欢请给颗⭐️,你的鼓励是我在开源路上前进的最大动力 项目地址: https://gitcode.com/zypqqgc/AntFlow