# loonflow

**Repository Path**: blackholll/loonflow

## Basic Information

- **Project Name**: loonflow
- **Description**: 工作流引擎，ticket, workflow,python,django
- **Primary Language**: Python
- **License**: AGPL-3.0
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 29
- **Forks**: 6
- **Created**: 2021-12-13
- **Last Updated**: 2025-12-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# loonflow 3.0 - 智能化、可视化的流程自动化系统
致力于提供企业级的统一工作流解决方案

[![Python](https://img.shields.io/badge/Python-3.12-3776AB?logo=python&logoColor=white)](https://www.python.org/)
[![Django](https://img.shields.io/badge/Django-5.2-092E20?logo=django&logoColor=white)](https://www.djangoproject.com/)
[![React](https://img.shields.io/badge/React-18.x-61DAFB?logo=react&logoColor=black)](https://reactjs.org/)
[![MUI](https://img.shields.io/badge/MUI-5.x-007FFF?logo=mui&logoColor=white)](https://mui.com/)
[![License](https://img.shields.io/badge/license-AGPL%20v3-blue)](https://www.gnu.org/licenses/agpl-3.0)


[English](./README.md) | 简体中文

# 🚀 全新出发的 Loonflow 3.0

Loonflow 是一个基于 Django 开发的开源流程自动化平台。历经多个版本的迭代与重构，我们自豪地推出 Loonflow 3.0 —— 一个在可视化、灵活性和扩展性上都实现质的飞跃的版本。

3.0 版本的核心是 「让复杂的业务流程变得简单可视，让个性化的定制需求触手可及」。不仅重铸了流程与表单设计器，更构建了一套强大的扩展框架，旨在成为企业数字化转型中最核心的流程引擎。

# 功能演示
[![功能演示](https://img.youtube.com/vi/IpLePpajyfU/0.jpg)](https://www.youtube.com/watch?v=IpLePpajyfU)

# ✨ 核心特性
## 🎯 革命性的可视化设计
- 拖拽式流程设计器：无需繁杂的配置，通过直观的拖拽连线即可完成复杂业务流程的建模。支持条件分支、并行任务、hook等高级节点。
- 智能表单设计器：强大的可视化表单构建工具，提供丰富的字段类型（文本、数字、下拉框、人员选择、附件等），布局随心所欲。
- 实时预览与验证：设计流程时实时预览效果，内置流程逻辑校验，提前规避设计错误。
- 流程配置支持多版本: 你可以配置多个版本的流程，并轻松测试和切换版本。

## 🔧 极致的灵活性与扩展性
- 插件化架构：我们为几乎所有关键节点都提供了插件扩展能力（如自定义动作、权限验证、通知方式等）。您的独特业务逻辑可以像搭积木一样轻松接入。
- 强大的 API 体系：提供全面、清晰的 RESTful API，便于与您的客服系统、CMDB、监控系统、CI/CD、OA 等第三方系统无缝集成。
- 高度可定制的权限模型：支持基于角色、部门、甚至特定业务条件的精细权限控制，满足企业复杂的权限管控需求。

## 💼 开箱即用的企业级功能
- 多类型工单支持：轻松管理 IT 运维、人事审批、财务报销、客户服务等各类流程。
- 自动化与智能路由：支持基于表单数据的条件路由，自动指派处理人，实现工单的智能化流转。
- 详尽的审计日志：完整记录工单从创建到关闭的每一个操作，满足合规与审计要求。
- 多租户支持（可选）：为 SaaS 服务商或大型集团企业提供数据隔离能力(需要额外授权)。


# 🛠️ 安装与部署
1. 下载docker-compose相关文件
```
wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/docker-compose.yml
wget https://raw.githubusercontent.com/blackholll/loonflow/refs/heads/master/docker_compose_deploy/.env
```
2. 修改.env文件
请至少修改password部分
3. 启动docker-compose
进入docker-compose.yml所在目录下执行：
```
docker-compose up -d
```
3. 创建admin用户
```
cd /app/loonflow
python manage.py createsuperuser
```
4. 访问loonflow
使用3中你创建用户的email和密码登录loonflow


# 📖 深入探索

- 📚 完整文档 - 了解安装、配置、使用和开发的全部细节. https://loonflow.readthedocs.io
- 🔌 hook开发指南 - 学习如何为 Loonflow 开发自定义插件（编写中）。
- 🌐 API 参考 - 查看完整的 API 接口文档. https://documenter.getpostman.com/view/15031929/2sB3WyJbap

# 🗺️ 项目规划
[项目规划](./Roadmap_zh.md)

# 🤝 参与贡献

热烈欢迎社区的贡献！无论您是修复错别字、改进文档、报告 Bug 还是开发新功能。

请先 Fork 本仓库，然后提交 Pull Request。


# ❓ 获取帮助

- 📝 GitHub Issues - 提交 Bug 报告和功能请求。
- 💬 讨论区  - 与社区和其他用户交流 [Discord](https://discord.gg/WuppaG638k)。
- 📧 商业支持与定制：如有企业级深度定制、技术培训或部署支持需求，请通过 [blackholll@163.com;blackholll.cn@gmail.com] 联系我。
- 💰 会员权益

# 会员权益(可单次支持以享受月度权益)
因国内没有合适靠谱的平台，故依旧采用支付宝付款码的形式.国外用户可以点击github项目首页上的"sponsor"按钮进行赞助。
##  社区伙伴 - 5元/月
适合所有欣赏我的工作并希望它蓬勃发展的人。
- 🛡️ 在我的官方Discord社区获得专属身份组

## 核心贡献者 - 10元/月
适合依赖本项目并希望更深入参与的重度用户。

- ✅ 享有上一层级所有权益。
- 🎧 入门及年度通话：首次赞助可获得30分钟语音/视频答疑，之后每年还可获得一次60分钟答疑。

## 项目协作者 - 50元/月
适合其工作流程与本项目的健康发展息息相关的专业人士和小型团队。
- ✅ 享有上一层级所有权益。
- 🔥 优先处理：您提交的 Bug 报告或功能请求将被移至优先开发队列。
- 🎧 增强年度支持：每年共计享有3次 60分钟语音/视频答疑，用于深度探讨问题或制定策略。

## 战略赞助商 - 100元/月
为希望确保项目成功并获得显著品牌曝光的企业量身定制。

- ✅ 享有上一层级所有权益。
- 🌐 显著位置展示：您公司的 Logo 将作为关键支持者，展示在项目 GitHub 主页的显著位置。
- 🎧 专属年度支持：每年共计享有10次 60分钟语音/视频答疑，获得持续的专属技术支持。


# 🙏 致谢
感谢所有为 Loonflow 贡献代码、提交 Issue、以及帮助改进文档的 贡献者们。

如果 Loonflow 对您有帮助，请给我们一个 ⭐️ Star 支持！



# 欢迎捐助
您的支持是我最大的动力,欢迎支付宝扫码捐助

![donation_code](/static/images/donation_code.png)


# 许可证与法律声明
本项目基于AGPLv3协议开源。您可以自由地查看、修改和分发代码，但请注意：

如果您将本项目作为SaaS服务对外提供，根据AGPLv3，您必须开源您的所有修改。

如果您希望在不开源修改的前提下将本项目用于SaaS服务，或者您需要在企业内部使用其多租户功能，您需要从我们这里获取商业许可。请联系 [blackholll@163.com;blackholll.cn@gmail.com]。