/weflow

工作流(golang版本的流程引擎、规则引擎、表单引擎)、表单编辑器、流程编辑器

Primary LanguageGoApache License 2.0Apache-2.0

weflow

介绍

工作流(golang版本的流程引擎、规则引擎、表单引擎)、表单编辑器、流程编辑器。 weflow 是一款成长中的项目/框架,借鉴了一些工作流框架(activiti,钉钉)的设计理念和**。如果 weflow 有不足地方,或者你有更好的想法,欢迎提交 ISSUE 或者 PR。

Workflow (a Golang-based flow engine, rule engine, form engine), form editor, process editor. weflow is a growing project/framework that borrows some design concepts and ideas from workflow frameworks (activiti, Nail). If weflow falls short, or if you have a better idea, feel free to submit an ISSUE or PR.

软件架构

|-- bin # 二进制文件目录
|-- cmd # 编译入口
|   `-- app
|-- deploy # 环境和部署相关目录
|   |-- docker-compose # docker-compose 容器编排目录
|   `-- kubernetes # k8s 编排配置目录
|-- docs # 文档目录
|-- config # 配置文件目录
|-- internal
|   `-- app
|       |-- command # 命令行功能模块
|       |   |-- handler
|       |   `-- script # 临时脚本
|       |-- component # 功能组件,如:db, redis 等
|       |-- config # 配置模型
|       |-- cron # 定时任务功能模块
|       |   `-- job
|       |-- common # 数据库模型
|       |-- model # 数据库模型
|       |-- pkg # 功能类库
|       |-- dao # 数据处理层
|       |-- service # 业务逻辑层
|       |-- controller # 控制层
|       |-- router # 路由层
|       `-- transport
|           |-- grpc
|           |   |-- api # proto 文件目录
|           |   |-- handler # 控制层
|           |   `-- middleware # 中间件
|           `-- http
|               |-- api # swagger 文档
|               |-- handler # 控制层
|               |-- middleware # 中间件
|               `-- router # 路由
|-- logs # 日志目录
|-- pkg # 功能类库
`-- proto # 第三方 proto 文件目录

软件架构说明

支持特性

  • 流程模板支持版本化管理,支持流程模板的导入导出,支持流程模板的复制、删除、发布、禁用、启用等
  • 流程模板可以上线新版本,支持旧流程模板的版本切换
  • 流程支持发起、终止、挂起、恢复、删除等
  • 用户任务支持同意、不同意、转办、委托、退回(上节点、任意、发起节点)、加签、减签、撤回、撤销、保存、会签、或签、并行、串行、自定义任务等
  • 支持退回任务,退回到指定任意节点,退回到上一节点(上处理任务),退回到发起节点
  • 支持转办任务,将任务交接给他人办理,办理完成后继续下一步骤
  • 支持委托任务,将任务委托给他人,他人办理完成后再回到委托人
  • 支持撤销任务,发起人可撤销未办理的任务,撤销后流程回到发起人
  • 支持催办任务,处理人可以催办任务,催办后任务处理人会收到消息提醒
  • 支持智能提交,相同处理人自动跳过,支持自由指定下一步处理人
  • 支持作废流程,允许发起人快速终止流程,管理员维护终止流程
  • 支持流程撤回,下一步未办理的任务,可进行取回撤销重做任务
  • 支持流程跟踪图,流程实例,实例节点任务,实例用户任务,实例任务参数
  • 支持节点表单权限,控制人员表单权限,如:只读、编辑、隐藏、必填等
  • 待办任务,已办任务、已发任务、流程跟踪、审批记录
  • 流程管控,在无关联表单情况下流程调试,如流程发起、挂起;流程定义、实例、任务等查询;任务办理,重定位等
  • 支持流程组件标签定义(流程按钮、意见审批、下一步流程信息等)快速与自定义的业务表单建立关系。

设计文档

设计文档:

https://www.processon.com/view/link/6459ef517ca03d041ea38cba

流程编辑器设计

节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】

节点字段描述:

  • 节点模型:nodeModel
  • 节点名称:nodeName
  • 节点ID:nodeId
  • 父节点ID:parentId

开始节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"发起节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID"
    }

案例:

{
        "nodeModel":1,
        "nodeName":"发起人",
        "nodeId":"1640993392605401001",
        "parentId":""
    }

审批节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"审批节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID",
        "formPer":[{
            "elemId": "表单元素ID",
            "elemPId": "表单元素父ID",
            "per": "表单权限【可编辑:1;只读:2;隐藏:3】默认只读2--数字"
        }],
        "approveType": "审批类型【人工审批:1;自动通过:2;自动拒绝】默认人工审批1--数字",
        "nodeSetting":{
            "execCheck":"审批执行校验,设计中可忽略",
            "timeout":"审批限时处理,设计中可忽略"
        },
        "nodeHandler": {
            "type": "常用审批人【指定成员:1;发起人自己:2;发起人自选:3:角色:4;部门:5】主管(相对岗位)【直属主管:1;部门主管:2;连续多级主管:3;部门控件对应主管:4】其他【表单人员控件:1;部门控件:2;角色控件:3】--数字",
            "handlers": [{
                "id": "处理人ID",
                "name": "处理人名称",
                "sort": "排序--数字"
            }],
            "strategy":"处理人策略【常用审批人:1;主管(相对岗位):2;其他:3】--数字",
            "obj": "扩展字段,设计中可忽略",
            "relative":"相对发起人的直属主管,设计中可忽略"
        },
        "noneHandler":"审批人为空时【自动通过:1;自动转交管理员:2;指定审批人:3】默认自动通过1--数字",
        "appointHandler":"审批人为空时指定审批人ID",
        "handleMode":"审批方式【依次审批:1、会签(需要完成人数的审批人同意或拒绝才可完成节点):2、或签(其中一名审批人同意或拒绝即可):3】默认会签2--数字",
        "finishMode":"完成人数:依次审批默认0所有人不可选人,会签默认0所有人(可选人大于0),或签默认1一个人(可选人大于0)--数字"
    }

案例:

{
        "nodeModel":2,
        "nodeName":"审批节点1",
        "nodeId":"1640993392605401002",
        "parentId":"",
        "formPer":[{
            "elemId": "param1",
            "elemPId": "",
            "per": 1
        }],
        "approveType": 1,
        "nodeSetting":{
            "execCheck":"",
            "timeout":""
        },
        "nodeHandler": {
            "type": "1",
            "handlers": [{
                "id": "547",
                "name": "xuch01",
                "sort": 1
            }],
            "strategy":1,
            "obj": "",
            "relative":""
        },
        "noneHandler":1,
        "appointHandler":"",
        "handleMode":2,
        "finishMode":0
    }

办理节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"办理节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID",
        "formPer":[{
            "elemId": "表单元素ID",
            "elemPId": "表单元素父ID",
            "per": "表单权限【可编辑:1;只读:2;隐藏:3】默认只读2--数字"
        }],
        "nodeSetting":{
            "timeout":"审批限时处理,设计中可忽略"
        },
        "nodeHandler": {
            "type": "常用审批人【指定成员:1;发起人自己:2;发起人自选:3:角色:4;部门:5】主管(相对岗位)【直属主管:1;部门主管:2;连续多级主管:3;部门控件对应主管:4】其他【表单人员控件:1;部门控件:2;角色控件:3】--数字",
            "handlers": [{
                "id": "处理人ID",
                "name": "处理人名称",
                "sort": "排序--数字"
            }],
            "strategy":"处理人策略【常用审批人:1;主管(相对岗位):2;其他:3】--数字",
            "obj": "扩展字段,设计中可忽略",
            "relative":"相对发起人的直属主管,设计中可忽略"
        },
        "noneHandler":"审批人为空时【自动通过:1;自动转交管理员:2;指定审批人:3】默认自动通过1",
        "appointHandler":"审批人为空时指定审批人:3,指定审批人ID",
        "handleMode":"审批方式【依次审批:1、会签(需要完成人数的审批人同意或拒绝才可完成节点):2、或签(其中一名审批人同意或拒绝即可):3】默认会签2",
        "finishMode":"完成人数:依次审批默认0所有人不可选人,会签默认0所有人(可选人大于0),或签默认1一个人(可选人大于0)"
    }

案例:

{
                    "nodeModel":3,
                    "nodeName":"办理节点1",
                    "nodeId":"1640993392605401005",
                    "parentId":"1640993392605401003",
                    "formPer":[{
                        "elemId": "param1",
                        "elemPId": "",
                        "per": 1
                    }],
                    "nodeSetting":{
                        "timeout":""
                    },
                    "nodeHandler": {
                        "type": "1",
                        "handlers": [{
                            "id": "547",
                            "name": "xuch01",
                            "sort": 1
                        }],
                        "strategy":1,
                        "obj": "",
                        "relative":""
                    },
                    "noneHandler":1,
                    "appointHandler":"",
                    "handleMode":2,
                    "finishMode":0
                }

抄送节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"抄送节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID",
        "formPer":[{
            "elemId": "表单元素ID",
            "elemPId": "表单元素父ID",
            "per": "表单权限【可编辑:1;只读:2;隐藏:3】默认只读2--数字"
        }],
        "nodeSetting":{
            "allowNotify":"允许发起人添加抄送人,先忽略"
        },
        "nodeHandler": {
            "type": "常用审批人【指定成员:1;发起人自己:2;发起人自选:3:角色:4;部门:5】主管(相对岗位)【直属主管:1;部门主管:2;连续多级主管:3;部门控件对应主管:4】其他【表单人员控件:1;部门控件:2;角色控件:3】--数字",
            "handlers": [{
                "id": "处理人ID",
                "name": "处理人名称",
                "sort": "排序--数字"
            }],
            "strategy":"处理人策略【常用审批人:1;主管(相对岗位):2;其他:3】--数字",
            "obj": "扩展字段,设计中可忽略",
            "relative":"相对发起人的直属主管,设计中可忽略"
        }
    }

案例:

{
                    "nodeModel":4,
                    "nodeName":"抄送节点1",
                    "nodeId":"1640993392605401007",
                    "parentId":"1640993392605401003",
                    "formPer":[{
                        "elemId": "param1",
                        "elemPId": "",
                        "per": 1
                    }],
                    "nodeSetting":{
                        "allowNotify":""
                    },
                    "nodeHandler": {
                        "type": "1",
                        "handlers": [{
                            "id": "547",
                            "name": "xuch01",
                            "sort": 1
                        }],
                        "strategy":1,
                        "obj": "",
                        "relative":""
                    }
                }

分支节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"分支节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID",
        "branchMode":"分支执行方式【单分支:1;多分支:2】默认多分支2--数字",
        "defaultBranch":"单分支处理需要默认分支,在条件优先级无法处理时候执行默认分支,取值分支下标--数字",
        "children":[
            [
                {
                    "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
                    "nodeName":"条件节点",
                    "nodeId":"节点ID",
                    "parentId":"节点父ID对应分支节点ID",
                    "level":"优先级,分支执行方式为多分支处理方式无优先级应为0--数字",
                    "conditionGroup":"条件组前端描述展示条件组",
                    "conditionExpr":"条件组解析后的表达式"
                },
                {
                    "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
                    "nodeName":"抄送节点",
                    "nodeId":"节点ID",
                    "parentId":"节点父ID",
                    "...":""
                }
            ]
        ]
    }

条件节点

{
                    "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
                    "nodeName":"条件节点",
                    "nodeId":"节点ID",
                    "parentId":"节点父ID对应分支节点ID",
                    "level":"优先级,分支执行方式为多分支处理方式无优先级应为0--数字",
                    "conditionGroup":"条件组前端描述展示条件组",
                    "conditionExpr":"条件组解析后的表达式"
                }

汇聚节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"汇聚节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID"
    }

案例:

{
        "nodeModel":8,
        "nodeName":"分支汇聚",
        "nodeId":"1640993392605401008",
        "parentId":""
    }

自定义节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"自定义节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID"
    }

设计中

结束节点

{
        "nodeModel":"节点模型【1:开始节点;2:审批节点;3:办理节点;4:抄送节点;5:自定义节点;6:条件节点;7:分支节点;8:汇聚节点;9:结束节点】--数字",
        "nodeName":"结束节点",
        "nodeId":"节点ID",
        "parentId":"节点父ID"
    }

案例

{
        "nodeModel":9,
        "nodeName":"流程结束",
        "nodeId":"1640993392605401009",
        "parentId":""
    }

规则引擎设计

流程的不同分支,根据流程连线的配置的条件项流转不同节点

条件类型单条件和组合条件

表单之外的条件项

条件值的数据源

条件语法

比较操作

操作 操作语法 备注
等于 ==
不等于 !=
大于 >
小于 <
大于等于 >=
小于等于 <=

时间类型的比较:将时间转成时间戳(毫秒)进行比较

逻辑操作

操作 操作语法 备注
且、与 &&
或、或者 ||
非、否 ~/!

集合操作

操作 操作语法 备注
包含 contains
不包含 !contains 包含操作的前面加非
属于 contains

字符操作

操作 操作语法 备注
包含 contains

https://www.processon.com/view/link/626b58a31e08535fe53d1e6b

条件解析:

数量大于等于100:number>=100

数量小于100:number<100

产品==短信且部门==研发部:proId=='短信' && deptName=='研发部'

产品!=短信或部门!=研发部:proId!='短信' || deptName!='研发部'

条件优先级:

括号()的优先执行

注意事项:

组合条件配置覆盖每一个分支

补充:

条件配置项:

表单字段或者参数中额外的参数条件,连线条件中存在表单之外的条件需要在表单条件配置项表中添加这个条件的具体条件的信息以及作用域

数据源管理:

选择条件选择项的数据来源

使用说明

引入本地module

require "github.com/wegoteam/weflow" v0.0.1
replace "github.com/wegoteam/weflow" => "../"
  1. cwgo语法
cwgo  model --db_type mysql --out_file dao_gen.go --out_dir ./backend/pkg/dao --dsn "root:root@tcp(localhost:3306)/weflow?charset=utf8&parseTime=True&loc=Local"

cwgo server --service flow --module github.com/wegoteam/weflow/internal --type HTTP  --idl ./idl/flow.thrift
cwgo server --service flow --module github.com/wegoteam/weflow/api --type RPC  --idl ./idl/flow.thrift
$ cwgo -h
NAME:
   cwgo - All in one tools for CloudWeGo

USAGE:
   cwgo [global options] command [command options] [arguments...]

COMMANDS:
   init      交互式命令行
   server    生成 RPC 或者 HTTP Server
   client    生成 RPC 或者 HTTP Client
   model     生成 DB Model
   fallback  回退到 kitex 或者 hz 工具

GLOBAL OPTIONS:
   --verbose      打开冗余日志模式
   --version, -v  打印工具版本


数据库模型语法
USAGE:
   cwgo model [command options] [arguments...]

OPTIONS:
   --dsn value                        Specify the database source name. (https://gorm.io/docs/connecting_to_the_database.html)
   --db_type value                    Specify database type. (mysql or sqlserver or sqlite or postgres) (default: mysql)
   --out_dir value                    Specify output directory (default: biz/dao/query)
   --out_file value                   Specify output filename (default: gen.go)
   --tables value [ --tables value ]  Specify databases tables
   --unittest                         Specify generate unit test (default: false)
   --only_model                       Specify only generate model code (default: false)
   --model_pkg value                  Specify model package name
   --nullable                         Specify generate with pointer when field is nullable (default: false)
   --type_tag                         Specify generate field with gorm column type tag (default: false)
   --index_tag                        Specify generate field with gorm index tag (default: false)
   --help, -h                         show help (default: false)
解释:
--dsn         指定数据库 DSN
--db_type     指定数据库类型
--out_dir     指定输出文件夹,默认 biz/dao/query
--out_file    指定输出文件名,默认 gen.go
--tables      指定数据库表名称
--unittest    是否生成单测,默认不生成
--only_model  是否只生成 model 代码,默认关闭
--model_pkg   指定 model package 名
--nullable    当字段为 null 时,指定是否生成指针,默认关闭
--type_tag    是否给字段生成 gorm column type tag,默认不生成  
--index_tag   是否给字段生成 gorm index tag,默认不生成  

 
客户端、服务端语法
USAGE:
   cwgo client [command options] [arguments...]

OPTIONS:
   --service value                                                              Specify the service name.
   --type value                                                                 Specify the generate type. (RPC or HTTP) (default: "RPC")
   --module value, --mod value                                                  Specify the Go module name to generate go.mod.
   --idl value                                                                  Specify the IDL file path. (.thrift or .proto)
   --out_dir value, -o value                                                    Specify the output path. (default: biz/http)
   --registry value                                                             Specify the registry, default is None
   --proto_search_path value, -I value [ --proto_search_path value, -I value ]  Add an IDL search path for includes. (Valid only if idl is protobuf)
   --pass value [ --pass value ]                                                pass param to hz or kitex
   --help, -h                                                                   show help (default: false)
解释:
--service    指定服务名称
--type       指定生成类型
--module     指定生成 module 名称
--idl        指定 IDL 文件路径
--out_dir    指定输出路径
--template   指定 layout 模板路径
--registry   指定服务注册组件
--proto_search_path 添加 IDL 搜索路径,只对 pb 生效
--pass value 传递给 hz 和 kitex 的参数

2.swagger语法

swag init --parseDependency --parseInternal --parseDepth 6 --instanceName "weflow"

swag init

http://localhost:18080/weflow/swagger/index.html

https://github.com/swaggo/swag/blob/master/README.md#declarative-comments-format

https://github.com/swaggo/swag/blob/master/README_zh-CN.md

Swagger注解

描述 @Summary 摘要 @Produce API 可以产生的 MIME 类型的列表,MIME 类型你可以简单的理解为响应类型,例如:json、xml、html 等等 @Param 参数格式,从左到右分别为:参数名、入参类型、数据类型、是否必填、注释 @Success 响应成功,从左到右分别为:状态码、参数类型、数据类型、注释 @Failure 响应失败,从左到右分别为:状态码、参数类型、数据类型、注释 @Router 路由,从左到右分别为:路由地址,HTTP 方法

// @Summary 获取列表
// @Produce  json
// @Param name query string false "名称" maxlength(100)
// @Param page query int false "页码"
// @Param page_size query int false "每页数量"
// @Success 200 {object} model.Article"成功"
// @Failure 400 {object} dict.Error "请求错误"
// @Failure 500 {object} dict.Error "内部错误"
// @Router /api/articles [get]

常见问题

使用carbon问题

window 系统下部署二进制文件时区报错

window 系统如果没有安装 golang 环境,部署时会报 GOROOT/lib/time/zoneinfo.zip: no such file or directory 异常,原因是由于 window 系统没有内置时区文件,只需要手动下载并指定 zoneinfo.zip 路径即可,如 go/lib/time/zoneinfo.zip

os.Setenv("ZONEINFO", "./go/lib/time/zoneinfo.zip")

docker 容器部署二进制文件时区报错

docker 容器如果没有安装 golang 环境,部署时会报 open /usr/local/go/lib/time/zoneinfo.zip: no such file or directory 异常,只需要把 zoneinfo.zip 复制到容器中即可,即在 Dockerfile 中加入

COPY ./zoneinfo.zip /usr/local/go/lib/time/zoneinfo.zip