本期作者
背景
建设低代码平台的目的,就是通过可视化的方式,加上可复用的建设能力,用较少的投入、以较快的速度来交付应用程序。
(资料图片)
我们通过aPaaS架构思路,复用已经实现了的开发能力,解构业务模型,形成更通用的能力,对业务进行快速编排。实现低代码,甚至部分无代码的快速定制应用。将开发模式从做加法,改进为做乘法,48小时内快速定制大部分基础应用。
我们不单需要解决今天的可见需求,同时还需要解决明天潜在的问题。实现更少的投入,更聪明的办法,建设更好的产品,产生更大的价值。
整体架构
我们一直在思考,如何通过简单的架构图,来方便的描述出高达的整体架构,看了一眼我们现有的复杂架构图,我们认为贴出这样一张图不会让大家更加清楚我们的架构,反而会变得非常迷茫,因此考虑到高达的组件过于庞大,中间的逻辑实在过多,我们使用一张非常简单的架构图来进行描述。
就像所有的网站一样,高达分为三个部分:页面,逻辑,数据用户通过页面,访问API接口,APi接口一方面处理大量的业务逻辑,另一方面对内部和外部的数据进行处理
更进一步的:在实现了基本的 可搭建能力之外,高达提供了大量 好搭,易搭,速搭的能力,包括内外部数据管理,服务编排等重要能力
高达平台-六大引擎
我们改变了原有的开发模式
一些业务的单个页面,我们仅通过10分钟即可完成该页面从数据库建设,后端逻辑搭建,前端页面搭建,到最终的发布上线
核心逻辑
1. 数据管理-元数据
后端逻辑
高达的数据管理我们使用业务模型进行列的管理,而并非数据库模型的方式,例如varchar,int,datetime等,因为配置的同学可能并不了解这是什么意思。因此,我们决定使用一种更加容易理解的业务模型进行数据的管理。
同时业务模型也可以将大量的业务逻辑进行封装,让用户不会感知,举个例子:
员工类型:会底层会将选择的员工转换为员工ID,整个高达全链路的数据传递中,用户并不会感知有这个ID的存在。
地理位置类型:会通过高德地图的组件进行坐标的管理,将最终的经纬度存储在数据库里,但是用户全程看到的都是一个坐标。
附件类型:会自动向BFS进行上传,并记录下文件下载路径,整个逻辑都是自动化完成的,用户只会看到最终文件的上传与下载
前端逻辑
同时最终界面的搭建,可以直接生成最终的界面表单,来提升整体的效率。将一个后端数据表,自动生成前端的增删改查,是一个非常容易的步骤,只需要将增删改查组件拖入界面中,选择对应的元数据表即可。
我们也可以针对页面做字段做更细化的管理
目前我们已经支持的字段类型如下:
1. 基础类型:单行文本,多行文本,数字,日期,单选,多选,布尔
2. 业务类型:人员,部门,地理位置,附件
3. 关联类型:单向关联,双向关联
4. 系统字段:编号,创建人,创建时间,更新人,更新时间
当然未来根据业务场景,我们还会继续增加各种各样的数据类型
数据表关联
当配置关联类型字段时,我们会在底层创建中间表,来实现表之间关联,包括一对多,多对多,多对一等关系
外部数据源管理
管理数据库:高达为达到连接外部数据能力的需求,对外部数据源进行了管理,这里的账号密码部分都为逐行秘钥进行加密。
数据表关联:在添加完数据源后,可以数据管理中添加进行数据表关联,便于后续直接对外部数据进行管理。
数据管理:外部数据添加后,在增删改查空间中选择外部数据源,可以在用户端一键完成增删改查的需求
2. 服务编排
我们整体通过逻辑编排的方式进行管理
接口管理
首先针对API,我们可以管理他的分组,名字,请求类型,以及服务间认证方式,其中服务间调用认证我们目前支持JWT,OAuth2,bilibiliToken三种方式
实现逻辑:我们会分别针对这三种不同的认证方式,开启三个不同的入口,并将开启三种认证方式的接口注册到分别的入口上
编排逻辑
创建接口之后,我们将所有的代码逻辑,区分了六大块类型:
逻辑控制:循环,分之,退出循环,继续循环,退出程序
变量管理:设置变量,编码转换
数据管理:针对数据的增删改查
服务调用:连接器,调用流程(待开发)
消息通知:短信,企微,邮件
高级:自定义脚本,加密(待开发),多线程(待开发),文件操作(待开发),SQL管理(待开发)
其中,只有逻辑控制类型的节点,才会对整条链路的走向造成改变,除此之外,所有节点都是从上往下运行。
图形的方案
为什么我们选择树形图?
DAG-有向图:如果不使用树形图,可以随意拖动节点的位置,看似灵活,但实际上,我们每个节点在图中的位置会随着管理员的不同,变得越发混乱。
空间利⽤率低,复杂逻辑难以看懂
随意连线容易导致逻辑混乱(goto)
容易死循环
树形图:经过大量的讨论于研究,决定在服务编排中使用树形图,树形图有以下优点
展现简洁,不会出现交叉连线
可折叠分⽀,容易实现复杂逻辑
可以转成等价的代码,开发者易懂
DSL编码
我们并不会将配置的逻辑,直接转换成代码,我们会在配置后,生成DSL编码作为中间层进行存储,DSL可以向上转换为界面上的配置显示,也可以向下转换为真实的运行代码。
这里源代码的显示我们会将用于处理错误,和日志记录的代码进行隐藏,但是点击【显示完整代码】的按钮后,将会显示完整代码
DSL转换逻辑:通过DSL作为中间层进行转换
代码模板化
伪代码层,我们通过MagicScript(/magic-script)引擎来实现,可以将我们预编写好的代码,进行实时执行。
早期我们使用字符串拼接的方式来拼接MagicScript代码,但是经过一段时间的尝试,我们发现这种方式开发成本过高,使用起来也非常麻烦。
因此我们开始转向模板化的方式,我们研究了freeMaker(/)的方式,并通过参数来传入对应的关键字,这样,我们代码本体的开发,就与正常写代码没有区别,可以大大提升我们的开发效率,以及后期的使用效率。
变量管理
所有的代码逻辑,对变量的管理,无论是类型,还是公式的计算,都是非常核心的部分。
公式计算器:我们精心设计了整个公式计算器,来非常方便的通过鼠标来完成核心计算逻辑的运行,我们可以在左边预设的逻辑中选择需要运行的逻辑,然后在中间【字段】列表中,选择当前上下文环境的所有变量,这里我们会对字典&映射类型,进行结构,直接获取字典下某个key的值,右边可以看到最终的公式,也可以通过键盘来手动输入
编码的转换:我们单独抽出了节点来进行转换,其中包括base64编码,URI编码,JSON编码的转换
数据映射
我们可以针对数据进行三种类型的映射,当需要将1替换为启用,2替换为禁用:
1. 字符串映射:"121" 需要替换为 "启用禁用启用"
2. 数组映射:[1,2,1]需要替换为[ "启用", " 禁用", "启用"]
3. 字典映射:{a: 1, b: 2}需要替换为{a: "启用", b: "禁用"}
我们将这类映射逻辑进行抽象,抽出单独节点,用于解决该类数据映射逻辑
调试
项目早期,我们针对调试功能做了大量的讨论,为了可以在整个API配置的过程中,可以进行充分的测试以及排错,我们大量的设计了调试的能力,来便于配置着进行调试。
其中除了看到调试的结果之外,我们会针对流程中每个节点的成功失败,耗时,当前的上下文作用域变量,进行管理。
当鼠标放在运行日志的每一行时,该行日志实际运行节点,都会进行交互提示。
其他
1. 节点的复制与粘贴:我们经常会对一段代码进行复制功能
2. 行列切换:由于正常显示器的尺寸,宽度是比高度要大的,当出现大部分单条路线的逻辑时,分支较少情况,可以进行横向的显示。
3. 注释:我们可以一键显示/隐藏全量的日志
4. 操作日志:我们分别针对当前的本次操作,以及历史保存的版本进行了日志的保存,可以随时进行回滚,以及发布
当前本地:可以通过右上角的【操作日志】按钮,查看每一次变更的内容
版本:当每次右上角点击【保存】按钮后,都会生成一个版本,可以通过【历史版本】按钮对某一次版本进行发布
5. 接口文档
通过【接口文档】按钮,可以针对接口,自动化的生成接口的文档,方便前端,或者外部系统对API进行调用
连接器
术语说明
连接器:先解释一下什么是连接器,连接器是用于连接外部资源,包括HTTP,HTTPS,discovery等外部API,我们可以提前定义好外部API的认证方式
动作:单个连接器下我们可以定义大量动作,每个动作相当于该调用方的多个API的地址
例如:我们可以针对企业微信开发一个连接器,其中发送文本消息就是该连接器的一个动作
基本信息
创建连接器之后,我们需要分别设置连接器的基本信息,包括说明,域名,协议,认证方式
认证方式可以获取获取到一串token,并且可以在未来的访问中,定义token放在哪个位置,包括header头,URL参数,body体中
动作
我们可以为一个连接器定义多个动作,每个动作代表一个请求接口,定义URL,请求方式,入参等,同时可以提前定义好入参的值,也可以定义为动态值,在后续调用侧(页面,服务编排)中进行传入
请求测试
可以针对请求进行测试,并针对返回信息进行解构,并定义多个返回参数的中文含义,最终在页面,或者服务编排中调用时,将会直接使用该中文定义进行操作,并且无需关注该字段在返回JSON中的位置。
前端页面
我们定义了企微发送消息的连接器,需要接受两个参数,1接受用户,2发送内容,我们可以在按钮上绑定一个连接器事件,并将两个入参绑定到最终的页面元素上,即可完成绑定
4. 页面搭建
创建页面
页面管理中,我们可以针对目录和页面进行管理,同时也可以通过拖动,对整个菜单的位置进行调整。
我们可以创建本地页面,也可以通过iframe嵌入外部页面
页面配置
前端组件层面,我们分成了三种类型
定制组件:经过开发,高度整合的整套组件
原子组件:按钮,输入框,文本等50+个最基本单元的组件,可以通过这类组件搭建出几乎所有页面效果
自定义组件:与其他部门合作实现的前端组件库,以及
搭建模块
页面核心模块,底层为阿里的Low-Code Engine:/site/docs/guide/quickStart/intro
依赖于通过该组件,封装了大量底层搭建逻辑,同时我们针对组件,事件,数据等模块进行了大量的二开,来满足我们更高封装度的低代码要求
发布管理
高达我们可以针对页面与接口进行发布,但是数据层面,类似于我们生产的开发模式,表和列修改都会立刻生效。
页面发布
页面发布管理中,我们可以看到当前
线上的版本:最后一次发布的版本
可发布页面:基于线上版本,出现修改的页面
历史版本:历史上每一次发布的页面
针对这些版本和页面,我们可以进行发布和回滚操作
接口发布
服务编排中,可以针对接口进行版本的发布与回滚
高度封装的可搭建能力
1. 触发器
往往我们在数据进行变更的时候,都会进行一些外部接口的同步,因此我们提供了数据触发器的能力,在数据变更的前后进行服务编排或者连接器的调用
触发时机:我们可以配置触发器触发的表,以及时机,目前支持新增,修改,删除三种场景
触发条件:我们可以提供过滤器,来过滤触发时候的判断条件
触发动作:我们可以分别选择触发的连接器还是服务编排,并将当前本次数据变更的内容作为参数传入触发动作
出参管理:最后,我们可以根据服务编排与连接器的返回信息,再次将内容回写到数据表中
2. 数据视图
往往我们并不会直接调用单独一张表的数据,我们会需要对多张表进行整合,汇总,行列计算等操作,形成一张数据更加全面的表,因此我们提供了数据视图的能力,整体原理类似于数据库的存储过程。
视图数据:我们可以对一张或者多张关联表的数据进行拼接整合
行列计算:这个过程中,我们可以将一列,或者一行的数据进行行列计算,具体行列计算的含义如下:
行列计算字段我们也提供了丰富的数据库计算公式,提升开发效率
过滤筛选:视图底部,我们提供了视图的筛选能力,同时筛选的参数,可以当场指定,也可以从调用视图的接口处进行获取
实现原理:与服务编排的理念一致,我们会将这段配置生成一段DSL,通过DSL可以生成最终的SQL,也可以还原微最初的视图配置。
页面端:当我们创建一个饼图时,我们可以再右侧选择对应的视图来选择数据源,同时设定对应的分类字段和值字段,最后我们可以在左上角,添加筛选控件,对视图本身进行筛选。
3. 定时任务
定时任务可以对服务编排的接口做定时任务处理,可以方便的配置定时器,失败通知等功能。
应用配置
应用配置是对高达当前应用的整体性配置,包括基础信息维护、菜单管理、字典管理、权限管理、通知管理、外部数据源管理
1. 基础信息
基础信息中可以对项目名称、图标和描述等信息进行修改,同时支持对前端SDK(lunar,oa酱,水印)接入做配置;
2. 菜单管理
菜单管理里可以对搭建项目的整体外层框架进行配置,包括:
菜单位置:可以是左右模式,上下模式,也可以是顶部菜单栏
主题配色:目前支持暗色系主题和明亮主体
logo:左上角的显示logo,默认为bilibili
首页信息:设置不输入PATH的情况首页地址
3. 字典管理
在高达项目中,可以创建K/V类型字典,也可以创建树状结构字典
字典管理分为两个部分:全局字典与项目字典
1. 全局的字典:全局字典可以被项目关联,例如性别,国家,银行等通用字典,都可以作为全局字典使用。
2. 项目层级的字典:项目中可以套用全局字典,也可以创建项目自身的字典,项目字典不会被其他项目所调用。
4. 权限管理
对于高达配置的C端页面,可以进行全量页面的权限配置,高达默认会提供两种角色:超级管理员、默认角色,同时也可以添加其他更多自定义角色的管理。
超级管理员:拥有所有页面的权限且页面权限不可更改,用户可以添加;
默认角色:用户是全体员工且不可更改,对应的页面权限可以修改;
5. 通知管理
服务编排等多个场景中,发送短信、邮件、企微消息的通知,此处维护了各类通知的模板。
业务接入
高达自从上线至今,已经承接 26个平台的搭建任务,其中包括包括人事,财务,法务,采购,行政,主站等各类系统,按照页面和接口数量结算,节约了300~400人日的资源投入。高达在一定程度上证明了全链路低代码系统的可行性,其中包含:
增删改查表单类:
通知管理类的系统:HR通知系统
问卷调研类系统:晋升问卷
中台管理+接口API类型:节假日管理
高达自己搭建自己的页面:高达项目管理
企微工具:服务号侧边栏
关键词: