Nginx+Django-Python+BPMN-JS的整合工作流实战项目

前言

找一个好用的画图工具真心不容易,Activiti 工作流自带的 Web 版画图工具,外表挺华丽,其实使用起来各种拧巴;Eclipse 的 Activiti 画图插件,对于相对复杂的流程也是很不友好。

环境搭建

网上有许多详细的安装配置步骤,这里就不一一赘述,只列出相关版本。

软件 版本 功能 地址
Python 3.7.1 脚本语言 https://www.python.org/
Django 2.1.3 Web框架 https://www.djangoproject.com/
PyCharm 2018.2.4 可视化开发工具 http://www.jetbrains.com/pycharm/
BPMN-JS 3.2.2 BPMN前端插件 https://github.com/bpmn-io/bpmn-js

项目截图

Nginx+Django-Python+BPMN-JS的整合工作流实战项目

Nginx+Django-Python+BPMN-JS的整合工作流实战项目

Nginx+Django-Python+BPMN-JS的整合工作流实战项目

Nginx+Django-Python+BPMN-JS的整合工作流实战项目

项目开发

功能模块

这是一个Python版本,Java版本功能已经基本开发完毕,需要进行功能迁移。

  • 用户登录
  • 流程列表(CURD)
  • 用户注册(待实现)
  • 游客访问在线作图,可实现在线导入导出,本地缓存

创建项目

切换到工作空间,执行以下命令:

django-admin.py startproject bpmn

最终目录结构,省略部分代码:

├─bpmn
│  │  settings.py
│  │  urls.py
│  │  wsgi.py
│  │  __init__.py
├─script
│      uwsgi.ini
├─static
├─templates
│      bpmn.html
└─view
    │  index.py

核心代码

var bpmnModeler = new BpmnJS({
     container: '#canvas',
     keyboard: {
        bindTo: window
    }
});
function openDiagram() {
                  bpmnXML='<?xml version="1.0" encoding="UTF-8"?>\n' +
                '<bpmn2:definitions xmlns:xsi="http://www.w3.org/2001/XMLSchema-instance" xmlns:bpmn2="http://www.omg.org/spec/BPMN/20100524/MODEL" xmlns:bpmndi="http://www.omg.org/spec/BPMN/20100524/DI" xmlns:dc="http://www.omg.org/spec/DD/20100524/DC" xmlns:di="http://www.omg.org/spec/DD/20100524/DI" xsi:schemaLocation="http://www.omg.org/spec/BPMN/20100524/MODEL BPMN20.xsd" id="sample-diagram" targetNamespace="http://bpmn.io/schema/bpmn">\n' +
                '  <bpmn2:process id="Process_1">\n' +
                '    <bpmn2:startEvent id="StartEvent_1"/>\n' +
                '  </bpmn2:process>\n' +
                '  <bpmndi:BPMNDiagram id="BPMNDiagram_1">\n' +
                '    <bpmndi:BPMNPlane id="BPMNPlane_1" bpmnElement="Process_1">\n' +
                '      <bpmndi:BPMNShape id="_BPMNShape_StartEvent_2" bpmnElement="StartEvent_1">\n' +
                '        <dc:Bounds height="36.0" width="36.0" x="412.0" y="240.0"/>\n' +
                '      </bpmndi:BPMNShape>\n' +
                '    </bpmndi:BPMNPlane>\n' +
                '  </bpmndi:BPMNDiagram>\n' +
                '</bpmn2:definitions>'; //BPMN 2.0 xml
           }
            // import diagram
            bpmnModeler.importXML(bpmnXML, function(err) {
                  if (err) {
                    return console.error('could not import BPMN 2.0 diagram', err);
                  }
            });
}

巴拉巴拉,代码还有一吨,这里就不贴了,后面会放源码地址。

部署

服务器还是选择Linux,部署前需要做以下操作。

Django

由于之前外网没有安装 Django,需要先安装:

pip install Django

sqlite

为了测试方便,这里我们选择 Django 默认自带的 sqlite 数据库:

yum install sqlite*

安装成功以后需要重新配置并编译安装 Python3:

# 配置编译
./configure
# 编译安装
make && make install

uwsgi

安装服务器 uwsgi,你可以把它想象成Java界的Tomcat

pip3 install uwsgi

这里你可以直接使用项目中script文件夹中的uwsgi.ini配置,只需修改项目路径即可。

然后使用以下命令启动:

uwsgi  --ini uwsgi.ini

执行命令,查看是否启动成功:

[root@AY140216131049Z script]# ps -ef|grep uwsgi  
root      3040     1  0 Nov21 ?        00:00:03 uwsgi --ini uwsgi.ini
root      3041  3040  0 Nov21 ?        00:00:00 uwsgi --ini uwsgi.ini
root      3042  3040  0 Nov21 ?        00:00:00 uwsgi --ini uwsgi.ini
root      3043  3040  0 Nov21 ?        00:00:00 uwsgi --ini uwsgi.ini
root      3044  3040  0 Nov21 ?        00:00:00 uwsgi --ini uwsgi.ini
root      3045  3040  0 Nov21 ?        00:00:00 uwsgi --ini uwsgi.ini
root      3046  3040  0 Nov21 ?        00:00:00 uwsgi --ini uwsgi.ini
root      6606  6580  0 18:13 pts/0    00:00:00 grep --color=auto uwsgi

重启:

uwsgi --reload uwsgi.pid

停止:

uwsgi --stop uwsgi.pid

Nginx

最后一步,配置Nginx 转发,具体安装这里不再说明,直接上配置(HTTPS安全证书请自行申请):

server {
        listen 80;
        listen 443 ssl;
        server_name  bpmn.52itstyle.vip;
        index index.php;
        #ssl on;
        #证书路径
        ssl_certificate    /usr/local/openresty/nginx/cert/1961848_bpmn.52itstyle.vip.pem;
        #私钥路径
        ssl_certificate_key   /usr/local/openresty/nginx/cert/1961848_bpmn.52itstyle.vip.key;
        #缓存有效期
        ssl_session_timeout 5m;
        #可选的加密算法,顺序很重要,越靠前的优先级越高.
        ssl_ciphers ECDHE-RSA-AES128-GCM-SHA256:ECDHE:ECDH:AES:HIGH:!NULL:!aNULL:!MD5:!ADH:!RC4;
        #安全链接可选的加密协议
        ssl_protocols TLSv1 TLSv1.1 TLSv1.2;
        ssl_prefer_server_ciphers on;

        location / {
           include uwsgi_params; # 导入一个Nginx模块他是用来和uWSGI进行通讯的
           uwsgi_connect_timeout 30; # 设置连接uWSGI超时时间
           uwsgi_pass unix:/www/bpmn/script/uwsgi.sock; # 指定uwsgi的sock文件所有动态请求就会直接丢给他
        }
        # 动静分离 Nginx 处理静态请求
        location /static {
            root /www/bpmn/;
        }
   }

演示

以下是基于 bpmn-js 开发的一个 Activiti 工作流作图管理系统,可以增删查改流程图,系统还在优化中。

游客访问:https://bpmn.52itstyle.vip/

源码

https://gitee.com/52itstyle/BPMN