zhennann (健哥)

一文讲透 CabloyJS 全栈框架的来龙去脉

zhennann — Thu, 24 Nov 2022 11:53:35 +0800

本文受众

咱们做软件开发，就好比是建造一幢幢房屋，一座座桥梁，既可以是北方宫殿的巍峨，也可以有南方庭院的雅致，更可以是横跨群山的峻险与孤悬。那么，不同的语言、不同的框架也都由其内在的秉质吸引着一批粉丝，坚持不懈的耕耘，营造出不同的生态，呈现出不同的开发风格和开发体验。正如Rails之于Ruby，Lavaral之于PHP，Django之于Python，Spring Boot之于Java。那么，又是什么之于 Javascript 呢？毋庸置疑，Javascript 面对着更多的使用场景，前端、后端、移动端、IOT，等等。不同的场景都有出色的解决方案存在。而且，基于不同的使用偏好，又分裂出 Javascript 和 Typescript 两个风格体系。那么，基于业务开发而言，就目前的 Node 生态可以说，Nest之于Typescript，Cabloy之于Javascript

正因为面对业务开发，不同的语言、不同的框架，会有不同的解决方案和风格体验。因此，不论您使用 CabloyJS 或者不使用 CabloyJS，都有必要进来看看在坚守原生Javascript（Vanilla JS）的土壤上，可以开出怎样的花朵。因此，不论您是前端开发、后端开发、全栈开发，或者其他语言的粉丝，或者技术经理、产品经理、项目经理，都可以从 CabloyJS 提供的文档和视频中汲取不一样的解题思路和方法，相互交流，相互借鉴，共同进步！

在英语语境中，原生 Javascript 有一个专属名称：Vanilla JS。而 Vanilla 有香草🌿之意，看来所言不虚

语言	框架
Ruby	Rails
PHP	Lavaral
Python	Django
Java	Spring Boot
Typescript	Nest
Javascript	Cabloy

CabloyJS 是什么

CabloyJS 是一款自带工作流引擎的 Node.js 全栈框架，一款面向开发者的低代码开发平台，更是一款兼具低代码的开箱即用和专业代码的灵活定制的 PAAS 平台。只需一套代码，即可同时实现中后台管理系统和前台应用。只需一套代码，即可同时跨端pc和mobile，并且mobile端是接近原生体验

CabloyJS 内置的每一项特性都做到精心调校，均体现了从开箱即用到灵活定制的无缝衔接，包括：角色系统、用户认证、菜单权限、数据权限、表单渲染、表单验证、工作流引擎、字典、仪表板、在线推送、页面主题、多语言国际化、CMS 渲染引擎、微信接口、企业微信接口、钉钉接口，等等

技术栈

场景	技术栈
前端	vue2 + framework7
后端	koa2 + egg2
数据库	mysql
分布式（缓存/队列/消息）	redis、bullmq、websocket
Markdown 富文本编辑	Prosemirror

在线演示

CabloyJS 提供了大量在线演示：

演示如何在一套代码中同时开发B端中后台管理系统和C端前台应用
演示如何在一套代码中同时跨端pc和mobile，并且mobile端是接近原生体验

因此，强烈建议您移步查看：在线演示

引言

凡是可以用 JavaScript 来写的应用，最终都会用 JavaScript 来写 | Atwood 定律

目前市面上出现的大多数与 NodeJS 相关的框架，基本都将 NodeJS 定位在工具层、聚合层、中间层、代理层，很少在业务层面进行深耕，认为这是 JAVA 的领域，NodeJS 不适合。这种思潮明显是与Atwood 定律相悖的

如果您想感受不同的 NodeJS 全栈开发体验，一定要试试自带工作流引擎的 CabloyJS 全栈开源框架。为了提升业务层面的开发效率和开发体验，CabloyJS 在前端和后端均提供了大量实用的工具和组件

CabloyJS 解决了哪些现实痛点问题？

在 NodeJS 开发领域，目前 (截止 2022 年 11 月) 存在以下几个痛点问题：

1. 中后台管理系统如何更优雅的支持移动端？

随着移动终端的普及和升级换代，大量业务场景都需要移动端的支持，比如管理层需要通过手机查看统计数据、审核业务单据；运维人员通过手机远程查看服务器状态，并进行调整优化

我们知道，市面上大多数中后台管理系统，都是优先适配 PC 端，然而移动端体验却不佳，处于勉强可用，但不好用的阶段

此外，大多数XXX Admin框架和中后台管理框架其本质是代码模版。在具体开发项目时，直接在代码模版中编写代码。这样，虽然修改起来很直接，但是不利于模版的持续升级和优化；也不利于业务代码的持续沉淀和迁移（至其他项目）。因此，当把代码模版从源码仓库下载下来之后，修改三分之一，增加三分之一，删减三分之一，从此就与代码模版的后续升级版本绝缘了

2. NodeJS 领域没有好用的工作流引擎！

如果单说 CRUD，大多数编程语言的开发框架都可以轻松实现，这不应该成为 NodeJS 开发业务系统的核心优势。若要让 NodeJS 深入业务领域的开发，工作流引擎是一个绕不过去的核心组件

3. 拖拽式低代码平台已经成为鸡肋方案！

大多数业务表单不仅仅是一些字段的简单组合和增删改查，不同的业务都有自己独特的业务诉求，往往需要前端界面的定制和后端逻辑的定制。拖拽式低代码平台，对于业务人员而言没有足够的工具进行深入定制，对于研发人员而言也没有足够的机制深入开发

许多拖拽式低代码平台认识到了这一点，所以针对不同的业务场景提供官方预配置的套装解决方案，这同样也把业务人员和研发人员置于不上不下的尴尬境地，成为食之无味弃之可惜的鸡肋平台

CabloyJS 亮点介绍

基于上述分析的问题，CabloyJS 实现了如下功能三大亮点和架构三大亮点

1. 功能三大亮点

1）自适应布局：pc = mobile + pad

CabloyJS 首创独树一帜的pc = mobile + pad跨端自适应布局机制：只需要一套代码，就可以同时兼容mobile端和pc端。mobile端达到原生效果，同时将mobile端的操控体验和开发模式无缝带入pc端

请大家分别在 PC 端和手机端打开演示链接: https://test.cabloy.com/ ，来体会与众不同的自适应机制

2）基于 JSON Schema 的表单自动渲染与数据验证引擎

通过在一处定义JSON Schema，就可以同时支持前端的表单自动渲染和后端的数据验证，既能开箱即用又可灵活定制

3）内置 NodeJS 工作流引擎

CabloyJS 充分利用 JS 语言的灵活性和 JSON 格式的便捷性，提供的 NodeJS工作流引擎远比 JAVA 领域的Activiti 简洁易用

比如，我们一般只知道如何使用Activiti中提供的活动节点和边界事件，却很少有途径来了解如何开发自定义的活动节点和自定义的边界事件。由于Activiti的架构繁杂，大多数人甚至不愿意尝试去阅读源码。但是 CabloyJS 提供的工作流引擎却可以轻松的定制所有的工作流元素，而且源码层次清晰，易于学习

2. 架构三大亮点

作为一款面向开发者的低代码开发平台，为了将低代码的开箱即用和专业代码的灵活定制有机融合，CabloyJS 在架构层面主要做了以下几点：

1）模块化开发体系与模块隔离

为了满足大型业务系统开发的诉求，CabloyJS 采用模块思维规划系统架构，以业务功能为单位（比如出差申请），将与业务功能相关的前端组件与后端逻辑组织为一个业务模块，从而有利于业务功能的内聚与重用，也有利于以业务为单位进行团队分工

此外，业务模块内部的页面、数据、逻辑、路由、配置等元素均进行了命名空间隔离处理，从而避免模块之间的变量污染与冲突。换句话说，当我们在自己的业务模块中为某个资源命名时，不用担心其他业务模块是否存在相同名称的资源，从而减少心智负担

2）原生分布式架构

EggJS 的定位是框架的框架，CabloyJS 后端在 EggJS 的基础上采用自定义Loader机制扩展出来了一套适配业务场景的新特性

比如，EggJS 原有的Worker + Agent进程模型，对于单机而言非常便利。但是面对多机集群，特别是基于docker的集群部署而言，Agent进程就失去了用武之地。更重要的是，如果一开始基于Agent进程进行开发，后续很难平滑的过渡到分布式场景。因此，CabloyJS 后端采用Redis，从框架底层就开始原生分布式的架构设计，并衍生出了Broadcast、Queue、Schedule、Startup等一系列分布式的开发组件，方便我们从一开始就进行分布式的开发。因此当系统起量后，可以轻松做集群扩展，参见：Broadcast, Queue, Schedule, Startup

3）前后端分离，全平台跨端开发

通过前后端分离的架构设计，只需要一套代码就可以支持全平台业务的跨端开发，包括B端后台管理应用和C端前台应用

平台	前端	后端
PC：Web	CabloyJS 前端	CabloyJS 后端
PC：Exe	CabloyJS 前端 + Electron	CabloyJS 后端
Mobile：IOS	CabloyJS 前端 + Cordova	CabloyJS 后端
Mobile：Android	CabloyJS 前端 + Cordova	CabloyJS 后端
微信公众号	CabloyJS 前端 + 微信 API	CabloyJS 后端
企业微信	CabloyJS 前端 + 企业微信 API	CabloyJS 后端
钉钉	CabloyJS 前端 + 钉钉 API	CabloyJS 后端
Slack	CabloyJS 前端 + Slack API	CabloyJS 后端
小程序：微信、支付宝等	Uni-app + CabloyJS 前端 SDK	CabloyJS 后端

后端：由于完整的前后端分离设计，只需开发一套 CabloyJS 后端代码即可
前端：所有可基于 H5 的场景，只需开发一套 CabloyJS 前端代码即可
小程序：提供 CabloyJS 前端 SDK 让 Uni-app 可以轻松对接 CabloyJS 后端代码

CabloyJS 可以开发什么系统

可以开发多租户SAAS业务系统
可以开发前后端分离的后台业务管理系统，如 OA、CRM、ERP、电商，等等
可以开发JAMStack架构的CMS内容管理系统，支持 SEO 优化，如博客、技术文档、社区、知识店铺，等等
既可以先开发后台业务管理系统，再延伸开发CMS内容管理系统；也可以反过来，先开发CMS内容管理系统，再延伸开发后台业务管理系统
可以通过Cordova开发各类 App 应用，支持 IOS、Android
可以通过Electron开发桌面应用
可以开发微信公众号、企业微信、钉钉，等第三方平台的应用，解决信息孤岛的问题
可以为Uniapp小程序开发后端 API 接口

CabloyJS 的研发历程

CabloyJS 从 2016 年启动开发，主要历经两个研发阶段：

1. 第一阶段：EggBornJS

EggBornJS 关注的核心就是模块化体系与模块隔离，并以此实现一套完整的全栈开发框架

比如模块egg-born-front是框架前端的核心模块，模块egg-born-backend是框架后端的核心模块，模块egg-born是框架的命令行工具，用于创建项目骨架

这也是为什么所有业务模块都是以egg-born-module-为命名前缀的原因

2. 第二阶段：CabloyJS

EggBornJS 只是一个基础的全栈开发框架，如果要支持业务的快速开发，还需要考虑许多与业务相关的支撑特性，如：工作流引擎、用户管理、角色管理、权限管理、菜单管理、参数设置管理、表单验证、登录机制，等等。特别是在前后端分离的场景下，对权限管理的要求就提升到一个更高的水平

CabloyJS 在 EggBornJS 的基础上，提供了一套核心业务模块，从而实现了一系列业务支撑特性，并将这些特性进行有机的组合，形成完整而灵活的上层生态架构，从而支持具体的业务开发进程

有了 EggBornJS，从此可复用的不仅仅是组件，还有业务模块

有了 CabloyJS，您就可以快速开发各类业务应用

信念

凡是可以用 JavaScript 来写的应用，最终都会用 JavaScript 来写 | Atwood 定律

相信，Javascript 的深度探索者都会被这句名言激发，共同努力，为 Javascript 生态添砖加瓦，构建更繁荣的应用生态

CabloyJS 正是对这一名言的探索之作。欢迎您也加入 CabloyJS 的社区生态，一起促进 Javascript 的繁荣与应用

名称的由来

1. EggBorn

这个名称的由来比较简单，因为有了 Egg(后端框架)，所以就有了 EggBorn。有一部动画片叫《天书奇谭》，里面的萌主就叫 “蛋生”，我很喜欢看（不小心暴露了年龄😅）

2. Cabloy

Cabloy 来自蓝精灵的魔法咒语，拼对了 Cabloy 这个单词就会有神奇的效果。同样，CabloyJS 是有关化学的魔法，基于模块的组合与生化反应，您将实现您想要的任何东西

License

MIT，免费商用

在一个项目中同时实现 “后台管理系统” 和 “前台应用”

zhennann — Thu, 27 Oct 2022 07:34:04 +0800

微信一起点菜

一个月紧张而愉快的开发又过去了。在这个月，开发了一个微信一起点菜项目，用来再次验证CabloyJS全栈框架定制开发的灵活性和扩展性。实践再次证明，使用 CabloyJS 全栈框架开发项目确实可以做到多快好省。因为：

只需一个项目，既可同时实现 “后台管理系统” 和 “前台应用
只需一个项目，既可同时跨端 pc、mobile。mobile 端是接近原生体验

下面就以微信一起点菜为例：

前台点菜应用：https://test.cabloy.com/?appKey=diancai-h5%3AappDianCaiWechatH5&appIsolate=true
后台商家管理系统：https://test.cabloy.com/
以上两个链接可以分别用 pc 和 mobile 打开。全新交互体验，全新架构设计，试过便知

截图

后台商家管理系统

PC 端

Mobile 端

前台点菜应用

PC 端

Mobile 端

CabloyJS 4.22 重磅推出弹出式页面交互风格

zhennann — Thu, 30 Jun 2022 21:43:38 +0800

升级说明

我们知道 CabloyJS 提供了pc=mobile+pad自适应布局机制，可以通过一套代码同时适配 mobile 端和 pc 端。基本思路就是优先适配 mobile 端，然后再把 mobile 端的交互体验带入 pc 端。因此，pc 端可以看作是许多 mobile 尺寸和 pad 尺寸页面组件的组合。在旧版本中，这些页面组件就像大大小小的手机和平板依次向右展开，可以称作展开式交互风格

新版本CabloyJS 4.22提供了弹出式交互风格。这样，用户可以根据 pc 电脑的尺寸大小和个人喜好，在这两个交互风格中随时切换

关于pc=mobile+pad自适应布局机制的详细信息，请参见文档：自适应布局：pc = mobile + pad

意义

CabloyJS 4.22的发布，重磅引入弹出式页面交互风格，是及其主要的里程碑，将 CabloyJS 推入一个新的发展阶段

是以为记2022年6月30日

预览

1. PC 端（展开式）

2. PC 端（弹出式）

3. Mobile 端

演示站点

直接浏览 CabloyJS 的演示站点，增加更直观的感性认知

体验 CabloyJS 应对大型项目的三驾马车：套件、模块、App应用
体验与众不同的pc=mobile+pad自适应布局风格，强烈推荐：分别用PC和Mobile单独体验演示站点。此言不虚，请您品鉴！！！

演示站点：https://test.cabloy.com/
演示站点的二维码：

CabloyJS 的商业模式采用免费 + 增值模式，欢迎赐教

zhennann — Tue, 18 Jan 2022 16:52:22 +0800

Cabloy 商业模式

为了支撑 CabloyJS 开源之路的长期发展，采用免费+增值的商业模式，是否可行？如何改进？请大家多提意见

1. 免费、开源

CabloyJS 采用免费+增值的商业模式。CabloyJS 框架本身是开源、免费的，并且采用MIT授权协议，同时还提供了大量的免费文档和免费视频。我们不需要花费一分钱，就可以使用 CabloyJS 开发各类中小型项目，以及大型项目

除了可以免费开发项目，我们还可以通过 CabloyJS 源码学习NodeJS全栈开发方方面面的知识。有网友反馈说：CabloyJS是一款教科书级的框架。我为 CabloyJS 注入了大量的心血，从宏观架构到微观编码，都反复的进行抉择和重构。如果您用 CabloyJS 做过项目，或者看过源码，一定可以感受到 “字里行间” 的诚意。希望每一位有缘的您可以少一些加班、少一些 996，多一些休闲，多一些与家人的陪伴

2. 增值、周边

CabloyJS 通过增值模块和周边产品服务来获取回报。比如，有一款测试模块test-party，包含大量前端和后端的测试用例和代码范例。在实际业务系统中不需要使用这个测试模块。但是这个测试模块却可以帮助我们更快的学习 CabloyJS，并且加速实际项目的开发。毋庸讳言，在实际开发中，针对不同的业务场景，我们可以把代码范例拷贝过来，再进行修正和调整，往往是最快的开发模式。而测试模块test-party恰恰可以起到范例的作用。因此，把测试模块test-party作为收费模块，就很好的平衡了免费+增值的商业模式

当然，不仅官方可以提供增值模块，网友也可以提供增值模块，为自己提供额外的增收途径

此外，官方还会提供一系列免费课程和收费课程，提供专业培训和技术咨询等服务，从而构成 CabloyJS 的周边产品和服务

CabloyJS：一款 NodeJS 全栈开源框架，接单快手，创业神器

zhennann — Fri, 17 Dec 2021 19:34:05 +0800

CabloyJS 是什么

CabloyJS 是一款自带工作流引擎的 Node.js 全栈框架, 接单快手、创业神器

更进一步来说，CabloyJS 是一款直达业务场景诉求的 PAAS 平台，兼具低代码的开箱即用和专业代码的灵活定制，角色系统、用户认证、菜单权限、数据权限、表单渲染、表单验证、工作流引擎、字典、仪表板、在线推送、页面主题、多语言国际化、CMS 渲染引擎、微信接口、企业微信接口、钉钉接口，等等，每一项特性都做到精心调校，均体现了从开箱即用到灵活定制的无缝衔接

开发 CabloyJS 的初心

凡是可以用 JavaScript 来写的应用，最终都会用 JavaScript 来写 | Atwood 定律

目前市面上出现的大多数与 NodeJS 相关的框架，基本都将 NodeJS 定位在工具层、中间层、代理层，很少在业务层面进行深耕，认为这是 JAVA 的领域，NodeJS 不适合。这种思潮明显是与Atwood 定律相悖的

为了打造与众不同的 NodeJS 全栈开发体验和用户体验，历经 5 年时间，全职研发 CabloyJS，代码提交数达 8000 多次，在前端和后端均提供了大量实用的工具和组件，主要实现了以下功能三大亮点和架构三大亮点

1. 功能三大亮点

自适应布局：pc = mobile + pad
- 请大家分别在 PC 端和移动端打开演示链接: https://test.cabloy.com/ ，来体会与众不同的自适应机制
- 市面上大多数后台管理系统，都是优先适配 PC 端，然而移动端体验却极差，想必大家都深有同感
基于 JSON Schema 的表单自动渲染与数据验证引擎：
- 通过在一处定义 JSON Schema，就可以同时支持前端的表单自动渲染和后端的数据验证，既能开箱即用又可灵活定制
内置 NodeJS 工作流引擎：
- 若要让 NodeJS 深入业务领域的开发，工作流引擎是一个绕不过去的核心组件。CabloyJS 充分利用 JS 语言的灵活性和 JSON 格式的便捷性，提供的 NodeJS 工作流引擎远比 Activiti 简洁易用
- 比如我们都知道Activiti中提供的活动节点和边界事件怎么使用，却很少有途径来了解如何开发自定义的活动节点和自定义的边界事件。但是 CabloyJS 提供的工作流引擎却可以轻松的定制所有的工作流元素，而且源码层次清晰，易于学习

2. 架构三大亮点

模块化开发体系与模块隔离
- 为了满足大型业务系统开发的诉求，CabloyJS 采用模块思维规划系统架构，以业务功能为单位，将与业务功能相关的前端组件与后端逻辑组织为一个业务模块，从而有利于业务功能的内聚与重用，也有利于以业务为单位进行团队分工
- 此外，业务模块内部的页面、数据、逻辑、路由、配置等元素均进行了命名空间隔离处理，从而避免模块之间的变量污染与冲突
原生分布式架构
- EggJS 的定位是框架的框架，CabloyJS 后端就是在 EggJS 的基础上采用自定义Loader扩展出来了一套适配业务场景的新特性
- 比如，EggJS 原有的Worker + Agent进程模型，对于单机而言非常便利。但是面对多机集群，特别是基于docker的集群部署而言，Agent进程就失去了用武之地。更重要的是，如果一开始基于Agent进程进行开发，后续很难平滑的过渡到分布式场景。因此，CabloyJS 后端采用Redis，从框架底层就开始原生分布式的架构设计，并衍生出了Broadcast、Queue、Schedule、Startup等一系列分布式的开发组件，方便我们从一开始就进行分布式的开发。因此当系统起量后，可以轻松做集群扩展，参见：Broadcast, Queue, Schedule, Startup
前后端分离，全场景开发
- 通过前后端分离的架构设计，可以支持全场景业务的快速开发

场景	前端	后端
PC：Web	CabloyJS 前端	CabloyJS 后端
PC：Exe	CabloyJS 前端 + Electron	CabloyJS 后端
Mobile：IOS	CabloyJS 前端 + Cordova	CabloyJS 后端
Mobile：Android	CabloyJS 前端 + Cordova	CabloyJS 后端
微信公众号	CabloyJS 前端 + 微信 API	CabloyJS 后端
企业微信	CabloyJS 前端 + 企业微信 API	CabloyJS 后端
钉钉	CabloyJS 前端 + 钉钉 API	CabloyJS 后端
Slack	CabloyJS 前端 + Slack API	CabloyJS 后端
小程序：微信、支付宝等	Uni-app + CabloyJS 前端 SDK	CabloyJS 后端

后端：由于完整的前后端分离设计，只需开发一套 CabloyJS 后端代码即可
前端：所有可基于 H5 的场景，只需开发一套 CabloyJS 前端代码即可
小程序：提供 CabloyJS 前端 SDK 让 Uni-app 可以轻松对接 CabloyJS 后端代码

低代码平台辨析

拖拽式低代码平台
- 大多数业务表单不仅仅是一些字段的简单组合和增删改查，不同的业务都有自己独特的业务诉求，往往需要前端界面的定制和后端逻辑的定制。拖拽式低代码平台，对于业务人员而言没有足够的工具进行深入定制，对于研发人员而言也没有足够的机制深入开发
- 许多拖拽式低代码平台认识到了这一点，所以针对不同的业务场景提供官方预配置的套装解决方案，这同样也把业务人员和研发人员置于不上不下的尴尬境地，成为食之无味弃之可惜的鸡肋平台
编码式低代码平台
- CabloyJS 提供了大量基础工具和组件，使研发人员可以快速创建业务表单和审批流程（比拖拽式还要快），达到开箱即用的效果，同时又可以进行深入的定制开发
- 此外，编码式低代码平台有利于版本变更管理，便于排查问题和持续升级维护
业务运营场景
- 其实，对于业务和运营场景而言，普适化的表单引擎并不是刚需，而是要根据具体的垂直场景提供可灵活定制的工具。比如，CabloyJS 提供的 CMS 内容管理和渲染引擎，可以满足大多数业务运营场景的诉求

谁会用这款 Node.js 全栈框架？

>>>>> 0. 场景画像

小王准备创业，需要开发一款多租户的 SAAS 业务系统，想请小明帮忙，希望能用有限的预算让系统尽快落地，以便尽早验证商业模型，从而控制创业的风险

小明原本在公司里做开发，由于公司有完整的技术团队做支撑，做项目还是比较顺利。但是，当小明独立面对这样一个需求时，发现原本在公司使用的技术栈用不上了

这时候，小明就希望能找到一个全栈业务开发框架，内置各种功能特性，既开箱即用，又方便二次开发、灵活定制。在此基础上进行业务的快速开发，从而能保质保量的为朋友创业助一把力

>>>>> 1. 外包接单

痛点：

客户希望项目按质如期完工、价格低、风险小；服务商希望毛利高、投入少、进度快、客户满意。如何实现二者的平衡呢？

如果接到项目，从零开始代码开发，就会放大客户与服务商之间的矛盾，增大项目的实施风险。因此，一款高质、高效、灵活的全栈框架，可以让外包接单之路走得更顺一些，更远一些

优点：

高效灵活：CabloyJS 历时 5 年精心打造的 Node.js 全栈框架，内置大量特性功能，开箱即用，同时又具有强大的可扩展性，便于定制开发
二次机会：CabloyJS 完善的基础建设，不仅让开发效率更高，而且可以引导和培育客户的日常操控体验，从而衍生出更多的业务需求和合作机会

>>>>> 2. 初创企业

诉求：

在创业成本高企、竞争越发激烈的今天，初创企业往往希望在尽短的时间、以尽少的成本，研发出最小可用产品（MVP），从而尽早发布测试、收集反馈、迭代优化

优点：

尽快落地：CabloyJS 采用模块化体系，支持全场景开发，确保 MVP 产品尽快落地
保值(纵向深入)：CabloyJS 从底层内置分布式设计，并且内置工作流引擎等核心特性。当系统起量之后可以无缝支持集群部署，并在 MVP 产品的基础上继续深入开发更核心的业务，从而达到保值的效果
增值(横向拓展)：CabloyJS 提供了模块市场，可以通过模块市场直接选购与自身业务需求相匹配的模块，以低成本快速实现业务需求，从而达到增值的效果

CabloyJS 可以开发什么系统

可以开发多租户SAAS业务系统
可以开发前后端分离的后台业务管理系统，如 OA、CRM、ERP、电商，等等
可以开发JAMStack架构的CMS内容管理系统，支持 SEO 优化，如博客、技术文档、社区、知识店铺，等等
既可以先开发后台业务管理系统，再延伸开发CMS内容管理系统；也可以反过来，先开发CMS内容管理系统，再延伸开发后台业务管理系统
可以通过Cordova开发各类 App 应用，支持 IOS、Android
可以通过Electron开发桌面应用
可以开发微信公众号、企业微信、钉钉，等第三方平台的应用，解决信息孤岛的问题
可以为Uniapp小程序开发后端 API 接口

CabloyJS 开发的正式系统

网站类型	网站链接
后台管理系统（PC 布局）	https://admin.cabloy.com
后台管理系统（Mobile 布局）

博客	https://zhennann.com
技术文档（英文）	https://cabloy.com/index.html
技术文档（中文）	https://cabloy.com/zh-cn/index.html
社区（英文）	https://community.cabloy.com/index.html
社区（中文）	https://community.cabloy.com/zh-cn/index.html
课程（英文）	https://course.cabloy.com/index.html
课程（中文）	https://course.cabloy.com/zh-cn/index.html
Cabloy 商店（英文）	https://store.cabloy.com/index.html
Cabloy 商店（中文）	https://store.cabloy.com/zh-cn/index.html

CabloyJS 的研发历程

CabloyJS 从 2016 年启动开发，主要历经两个研发阶段：

1. 第一阶段：EggBornJS

EggBornJS 关注的核心就是模块化体系与模块隔离，并以此实现一套完整的全栈开发框架

比如模块egg-born-front是框架前端的核心模块，模块egg-born-backend是框架后端的核心模块，模块egg-born是框架的命令行工具，用于创建项目骨架

2. 第二阶段：CabloyJS

信念

凡是可以用 JavaScript 来写的应用，最终都会用 JavaScript 来写 | Atwood 定律

相信，Javascript 的深度探索者都会被这句名言激发，共同努力，为 Javascript 生态添砖加瓦，构建更繁荣的应用生态

CabloyJS 正是对这一名言的探索之作。欢迎您也加入 CabloyJS 的社区生态，一起促进 Javascript 的繁荣与应用

名称的由来

1. EggBorn

2. Cabloy

License

MIT

历时 5 个月，6000+ 肝到 8000+，CabloyJS 4.12 震撼发布，及新版教程尝鲜

zhennann — Mon, 29 Nov 2021 23:23:37 +0800

引言

凡是可以用 JavaScript 来写的应用，最终都会用 JavaScript 来写 | Atwood 定律

如果您想感受与众不同的 NodeJS 全栈开发体验，一定要试试自带工作流引擎的 CabloyJS 全栈开源框架。为了提升业务层面的开发效率和开发体验，CabloyJS 在前端和后端均提供了大量实用的工具和组件

CabloyJS 4.12

CabloyJS 从4.11升级到4.12，历时 5 个月，Github 提交数从6000+一路肝到8000+，这次的功能更新绝对是诚意满满，一次爽到爆

新增特性
- 数据：增加 simple 模式
- 默认的业务数据都具有生命周期，即三个阶段：草稿、正式、历史。草稿到正式之间还可以加入审批流
- 新增的simple模式，就是可以简化业务数据的生命周期，只保留正式版本，从而满足一些简单业务数据的管理
- 脏标记机制：所有 Form 表单均支持脏标记机制。当有字段值变动时，Form 表单标题就会有醒目提示，并且当关闭当前表单页面时，也会提示用户表单数据没有保存
- 测试：增加新的测试模块test-note
- 演示数据列表的布局切换：列表/卡片/表格
- 演示数据条目的布局切换：信息/正文 (Markdown)
- 演示如何增加便签部件，从而可以在仪表板中直接编辑和查看便签数据
- 测试：test-party 模块
- 演示如何增加简单聊天部件，从而可以在仪表板中进行直接的聊天互动
- 工作流引擎：
- 增加转办
- 增加代办
- 工作流引擎：
- 增加行为机制：从而实现与 activiti 中边界事件所对应的应用场景
  - 一个节点可以附加多个行为
  - 行为可以指定专属的边，从而进行节点的迁移
- 增加一个具体的行为实现: 超时处理
  - 可以指定某个审批节点的超时行为，一旦超时就跳转到指定的流程节点
- 工作流引擎：
- 增加网关节点，包括：
  - 排他网关
  - 并行网关
  - 包含网关
- 数据字典：
- 支持版本控制
- 支持对字典单独授权
- 支持多级树形字典
- 内置：美国城市区划、中国城市区划
- 通用的后端逻辑处理
- 通用的前端渲染组件
增强
- Markdown：实现了一个所见即所得的Markdown富文本编辑器，绝对好用，一定要体验一下
- JSON：重构了带格式化的JSON编辑器

文档与教程：

伴随着 CabloyJS 4.12 新版功能的推出，还全新制作了一套教程。为了体现 CabloyJS低代码的开箱即用和专业代码的灵活定制，教程也由浅到深相应的分为几个部分：

演示站点

通过这套教程，可以让我们更快的了解 CabloyJS 的开发风格，以及可以用来做哪些事情。欢迎大家尝鲜、拍砖

也可以在阅读教程的同时，直接浏览 CabloyJS 的演示站点，增加更直观的感性认知

演示站点：https://test.cabloy.com/

为了体验与众不同的pc=mobile+pad自适应布局风格，一定要分别用PC和Mobile单独体验演示站点。此言不虚，请您品鉴！！！

演示站点的二维码：

CabloyJS：一款自带工作流引擎的 NodeJS 全栈框架，接单快手、创业神器

zhennann — Sun, 20 Jun 2021 10:12:58 +0800

为了让独立开发、外包接单这条路走得更顺一些，更远一些，我打磨了一款开源的 Node.js 全栈开发框架，用时 5 年、6000+ Commits、30 万 + 代码。希望能与独立开发同仁找机会一起合作，一起创造价值

CabloyJS 是什么

CabloyJS 是一款自带工作流引擎的 Node.js 全栈框架, 接单快手、创业神器, 基于 koa + egg + vue + framework7 + mysql

在线演示

场景	链接/二维码
PC 端	https://test.cabloy.com/
Mobile 端

谁会用这款 Node.js 全栈框架？

>>>>> 0. 场景画像

>>>>> 1. 外包接单

痛点：

客户希望项目按质如期完工、价格低、风险小；服务商希望毛利高、投入少、进度快、客户满意。如何实现二者的平衡呢？

优点：

高效灵活：CabloyJS 历时 5 年精心打造的 Node.js 全栈框架，内置大量特性功能，开箱即用，同时又具有强大的可扩展性，便于定制开发
二次机会：CabloyJS 完善的基础建设，不仅让开发效率更高，而且可以引导和培育客户的日常操控体验，从而衍生出更多的业务需求和合作机会

>>>>> 2. 初创企业

诉求：

优点：

尽快落地：CabloyJS 采用模块化体系，支持全场景开发，确保 MVP 产品尽快落地
保值：CabloyJS 从底层内置分布式设计，并且内置工作流引擎等核心特性。当系统起量之后可以无缝支持集群部署，并在 MVP 产品的基础上继续深入开发更核心的业务，从而达到保值的效果
增值：CabloyJS 提供了模块市场，可以通过模块市场直接选购与自身业务需求相匹配的模块，以低成本快速实现业务需求，从而达到增值的效果

CabloyJS 的商业模式

开源免费：CabloyJS 全栈框架，开源免费，并提供大量文档、测试模块、视频课程等资源
模块市场：CabloyJS 提供了模块市场。研发同仁可以在实际开发过程中不断沉淀通用的模块，发布到模块市场，与平台共享收益。从而成为外包接单之外的睡后收入，共同打造一个由线性生长向指数生长的通道
二级分销：模块市场导入二级分销的玩法，汇聚更多社会渠道资源，带动模块的销售

CabloyJS 先期制作了一套视频课程，导入了相同的二级分销的玩法，欢迎品鉴

相关链接：

关于二级分销

CabloyJS 的四大亮点

>>>>> 亮点 1：自适应布局：`pc = mobile + pad`

背景说明

对于前端开发而言，有一个很现实的问题：如何同时进行 pc 端和 mobile 端的开发？

传统的做法一般而言有两个：

1）采用css自适应媒体查询

由于原生 mobile 端的布局和 pc 端的布局是不同的。css自适应媒体查询只是让 pc 端的页面在 mobile 端可用，但达不到原生mobile端的效果

比如，许多使用bootstrap实现的博客；再比如，市面上绝大多数后台管理系统模版。往往优先处理 pc 端的显示效果，然后采用css自适应媒体查询来适配 mobile 端，从而在 mobile 端仅仅达到能看的程度，但绝对不好用

2）采用两套代码

由于采用css自适应媒体查询有很大的局限性，很多项目采用两套代码来分别处理pc端和mobile端的布局显示。这样虽然解决了问题，但是同样的业务逻辑需要做两套代码，成本、时间、精力都得翻倍

解决之道：pc = mobile + pad自适应布局

CabloyJS 首创pc = mobile + pad的自适应布局机制：只需要一套代码，mobile端达到原生效果，同时将mobile端的操控体验和开发模式无缝带入pc端

效果演示：进入演示网站https://test.cabloy.com/，然后调整窗口尺寸分别体验 pc 端和 mobile 端的效果

>>>>> 亮点 2：模块化开发体系与模块隔离

模块化体系：CabloyJS 采用模块思维规划系统架构，以业务功能为单位，将与业务功能相关的前端组件与后端逻辑组织为一个业务模块，有利于业务功能的内聚与重用，从而便于沉淀通用的模块，然后发布到模块市场
模块隔离：模块的页面、数据、逻辑、路由、配置等元素均进行了命名空间隔离处理，避免模块之间的变量污染与冲突
全局模块与局部模块：CabloyJS 内置了大量全局模块，提供工作流引擎、用户管理、角色管理、权限管理、菜单管理、参数设置管理、表单验证、登录机制，等等诸多特性。具体的业务开发则在局部模块中进行，架构清晰、层次分明，从而轻松应对业务规模的持续增长

>>>>> 亮点 3：前后端分离，全场景开发

通过前后端分离的架构设计，可以支持全场景业务的快速开发

场景	前端	后端
PC：Web	CabloyJS 前端	CabloyJS 后端
PC：Exe	CabloyJS 前端 + Electron	CabloyJS 后端
Mobile：IOS	CabloyJS 前端 + Cordova	CabloyJS 后端
Mobile：Android	CabloyJS 前端 + Cordova	CabloyJS 后端
微信公众号	CabloyJS 前端 + 微信 API	CabloyJS 后端
企业微信	CabloyJS 前端 + 企业微信 API	CabloyJS 后端
钉钉	CabloyJS 前端 + 钉钉 API	CabloyJS 后端
Slack	CabloyJS 前端 + Slack API	CabloyJS 后端
小程序：微信、支付宝等	Uni-app + CabloyJS 前端 SDK	CabloyJS 后端

后端：由于完整的前后端分离设计，只需开发一套 CabloyJS 后端代码即可
前端：所有可基于 H5 的场景，只需开发一套 CabloyJS 前端代码即可
小程序：提供 CabloyJS 前端 SDK 让 Uni-app 可以轻松对接 CabloyJS 后端代码

>>>>> 亮点 4：内置 NodeJS 工作流引擎

众所周知，NodeJS 作为后端开发语言和运行环境，支持高并发、开发效率高，有口皆碑，但是大多用于数据CRUD管理、中间层聚合和中间层代理等工具场景，很少深入到业务领域的核心。有许多采用 NodeJS 开发的最小可用产品（MVP）最终会另起炉灶重构，这是原因之一

究其根源，NodeJS 作为业务开发平台，还缺少许多核心的基础构件，NodeJS工作流引擎便是其一。CabloyJS 4.0 重点开发了 NodeJS 工作流引擎，并作为内置的基础核心模块（同样是开源、免费），近一步拓展了 NodeJS 在后端的应用场景，为深入研发各类商业业务逻辑，提供了基础支撑

CabloyJS 的研发历程

CabloyJS 从 2016 年启动开发，主要历经两个研发阶段：

1. 第一阶段：EggBornJS

EggBornJS 关注的核心就是模块化体系与模块隔离，并以此实现一套完整的全栈开发框架

比如模块egg-born-front是框架前端的核心模块，模块egg-born-backend是框架后端的核心模块，模块egg-born是框架的命令行工具，用于创建项目骨架

这也是为什么所有业务模块都是以egg-born-module-为命名前缀的原因

2. 第二阶段：CabloyJS

有了 EggBornJS，从此可复用的不仅仅是组件，还有业务模块

有了 CabloyJS，您就可以快速开发各类业务应用

CabloyJS 架构图与技术栈

CabloyJS 并不盲目重新造轮子，而是采用业界成熟的开源框架和组件，经过有机组合、再次创新，补充业务层面的基建特性，从而具备了丰富的功能特性，又保持了强大的可扩展性

1. 第一层：NodeJS

基于 NodeJS，从而使得前后端均可以采用 Javascript 语言进行全栈开发，从而显著提升开发效率

2. 第二层：VueJS、KoaJS

3. 第三层：Framework7、EggJS

前端：采用 Framework7 作为主体的 UI 组件库，同时根据业务需要搭配其他 UI 组件库，如 AntD Vue 的表格组件、AntV X6 工作流绘制组件、ChartJS 图表组件，等等
后端：采用 EggJS 作为底层框架，从而沿用了 EggJS 成熟的基础建设和丰富的插件生态

4. 第四层：egg-born-front、egg-born-backend

egg-born-front：是前端的核心模块，主要进行了以下几方面的工作：

模块前端隔离：对模块前端的页面、数据、逻辑、路由、配置等元素进行了命名空间隔离处理，避免模块之间的变量污染与冲突
模块加载机制：只需给模块名称增加一个sync后缀，即可实现模块的同步加载和异步加载，参见：加载机制
pc=mobile+pad 自适应布局：对 Framework7 进行了改造，只需要一套代码，mobile端达到原生效果，同时将mobile端的操控体验和开发模式无缝带入pc端，参见自适应布局：pc = mobile + pad
组件环境对象：向 Vue 组件实例注入了大量环境对象，方便开发，参见：Component

egg-born-backend：是后端的核心模块，主要进行了以下几方面的工作：

模块化开发体系：EggJS 原有的目录结构并不适合模块化的开发风格。但是 EggJS 提供了强大的扩展机制，允许提供自定义的 Loader 加载器。通过开发自定义的 Loader 加载器，实现了以业务模块为单元的目录结构。每个业务模块可以定义与自身业务相关的资源，如：Routes、Controllers、Services、Models、Middlewares、Config、i18n语言资源，等等。而且这些元素可以编译打包成一个 js 文件，同时也可以进行丑化，从而保护商业代码。由于这种模块化的开发体系，也方便把编译打包的模块直接发布到NPM仓库或者模块市场，与社区分享，参见：模块编译与发布
模块后端隔离：以自定义的 Loader 加载器为基础，对模块后端的Routes、Controllers、Services、Models、Config等元素进行了命名空间隔离处理，避免模块之间的变量污染与冲突
Bean 容器与 AOP 编程：基于原生 JS（Vanilla JS）实现了更轻量、更灵活的 Bean 容器，并可以通过 AOP 机制进行扩展，参见：Bean
原生分布式架构：EggJS 原有的Worker + Agent进程模型，对于单机而言非常便利。但是面对多机集群，特别是基于docker的集群部署而言，Agent进程就失去了用武之地。更重要的是，如果一开始基于Agent进程进行开发，后续很难平滑的过渡到分布式场景。因此，egg-born-backend采用Redis，从框架底层就开始原生分布式的架构设计，并衍生出了Broadcast、Queue、Schedule、Startup等一系列分布式的开发组件，方便我们从一开始就进行分布式的开发。因此当系统起量后，可以轻松做集群扩展，参见：Broadcast, Queue, Schedule, Startup

5. 第五层：EggBornJS

egg-born-front和egg-born-backend，再加上一些周边工具，共同构成了 EggBornJS，也就是 CabloyJS 研发历程的第一阶段

6. 第六层：CabloyJS

CabloyJS 在 EggBornJS 的基础上，研发了一套核心全局模块，实现了一系列业务支撑特性，并将这些特性进行有机的组合，形成完整而灵活的上层生态架构，从而支持具体的业务开发进程

7. 第七层：Project（项目）

实际的项目由全局模块和局部模块构成

全局模块：CabloyJS 内置的核心模块、来自NPM仓库或者模块市场的第三方模块，统称为全局模块，一般安装在node_modules目录
局部模块：项目实际的开发工作一般在局部模块中展开。局部模块位于项目目录内，参见：新建模块

信念

凡是可以用 JavaScript 来写的应用，最终都会用 JavaScript 来写 | Atwood 定律

相信，Javascript 的深度探索者都会被这句名言激发，共同努力，为 Javascript 生态添砖加瓦，构建更繁荣的应用生态

CabloyJS 正是对这一名言的探索之作。欢迎您也加入 CabloyJS 的社区生态，一起促进 Javascript 的繁荣与应用

名称的由来

1. EggBorn

2. Cabloy

预览

白色主题

暗色主题

风信子主题

灿烂主题

显示侧边栏

移动端风格

License

MIT

zhennann (健哥)

一文讲透 CabloyJS 全栈框架的来龙去脉

本文受众

CabloyJS 是什么

技术栈

在线演示

引言

CabloyJS 解决了哪些现实痛点问题？

1. 中后台管理系统如何更优雅的支持移动端？

2. NodeJS 领域没有好用的工作流引擎！

3. 拖拽式低代码平台已经成为鸡肋方案！

CabloyJS 亮点介绍

1. 功能三大亮点

2. 架构三大亮点

CabloyJS 可以开发什么系统

CabloyJS 的研发历程

1. 第一阶段：EggBornJS

2. 第二阶段：CabloyJS

信念

名称的由来

1. EggBorn

2. Cabloy

License

在一个项目中同时实现 “后台管理系统” 和 “前台应用”

微信一起点菜

截图

后台商家管理系统

前台点菜应用

CabloyJS 4.22 重磅推出弹出式页面交互风格

升级说明

意义

预览

1. PC 端（展开式）

2. PC 端（弹出式）

3. Mobile 端

演示站点

相关链接

CabloyJS 的商业模式采用免费 + 增值模式，欢迎赐教

Cabloy 商业模式

1. 免费、开源

2. 增值、周边

相关链接

CabloyJS：一款 NodeJS 全栈开源框架，接单快手，创业神器

CabloyJS 是什么

开发 CabloyJS 的初心

1. 功能三大亮点

2. 架构三大亮点

低代码平台辨析

谁会用这款 Node.js 全栈框架？

>>>>> 0. 场景画像

>>>>> 1. 外包接单

>>>>> 2. 初创企业

CabloyJS 可以开发什么系统

CabloyJS 开发的正式系统

CabloyJS 的研发历程

1. 第一阶段：EggBornJS

2. 第二阶段：CabloyJS

信念

名称的由来

1. EggBorn

2. Cabloy

License

历时 5 个月，6000+ 肝到 8000+，CabloyJS 4.12 震撼发布，及新版教程尝鲜

引言

CabloyJS 4.12

文档与教程：

演示站点

CabloyJS：一款自带工作流引擎的 NodeJS 全栈框架，接单快手、创业神器

CabloyJS 是什么

在线演示

谁会用这款 Node.js 全栈框架？

>>>>> 0. 场景画像

>>>>> 1. 外包接单

>>>>> 2. 初创企业

CabloyJS 的商业模式

CabloyJS 的四大亮点

>>>>> 亮点 1：自适应布局：pc = mobile + pad

>>>>> 亮点 2：模块化开发体系与模块隔离

>>>>> 亮点 3：前后端分离，全场景开发

>>>>> 亮点 4：内置 NodeJS 工作流引擎

>>>>> 亮点 1：自适应布局：`pc = mobile + pad`