为了让独立开发、外包接单这条路走得更顺一些，更远一些，我打磨了一款开源的 Node.js 全栈开发框架，用时 5 年、6000+ Commits、30 万 + 代码。希望能与独立开发同仁找机会一起合作，一起创造价值
CabloyJS是什么
CabloyJS是一款自带工作流引擎的Node.js全栈框架, 接单快手、创业神器, 基于koa + egg + vue + framework7 + mysql
在线演示
| 场景 | 链接/二维码 |
|---|---|
| PC端 | https://test.cabloy.com/ |
| Mobile端 |  |
谁会用这款Node.js全栈框架？
>>>>> 0. 场景画像
小王准备创业，需要开发一款多租户的SAAS业务系统，想请小明帮忙，希望能用有限的预算让系统尽快落地，以便尽早验证商业模型，从而控制创业的风险
小明原本在公司里做开发，由于公司有完整的技术团队做支撑，做项目还是比较顺利。但是，当小明独立面对这样一个需求时，发现原本在公司使用的技术栈用不上了
这时候，小明就希望能找到一个全栈业务开发框架，内置各种功能特性，既开箱即用，又方便二次开发、灵活定制。在此基础上进行业务的快速开发，从而能保质保量的为朋友创业助一把力
>>>>> 1. 外包接单
痛点：
客户希望项目按质如期完工、价格低、风险小；服务商希望毛利高、投入少、进度快、客户满意。如何实现二者的平衡呢？
如果接到项目，从零开始代码开发，就会放大客户与服务商之间的矛盾，增大项目的实施风险。因此，一款高质、高效、灵活的全栈框架，可以让外包接单之路走得更顺一些，更远一些
优点：
-
高效灵活：CabloyJS历时5年精心打造的Node.js全栈框架，内置大量特性功能，开箱即用，同时又具有强大的可扩展性，便于定制开发 -
二次机会：CabloyJS完善的基础建设，不仅让开发效率更高，而且可以引导和培育客户的日常操控体验，从而衍生出更多的业务需求和合作机会
>>>>> 2. 初创企业
诉求：
在创业成本高企、竞争越发激烈的今天，初创企业往往希望在尽短的时间、以尽少的成本，研发出最小可用产品（MVP），从而尽早发布测试、收集反馈、迭代优化
优点：
-
尽快落地：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在EggBornJS的基础上，提供了一套核心业务模块，从而实现了一系列业务支撑特性，并将这些特性进行有机的组合，形成完整而灵活的上层生态架构，从而支持具体的业务开发进程
有了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
这个名称的由来比较简单，因为有了Egg(后端框架)，所以就有了EggBorn。有一部动画片叫《天书奇谭》，里面的萌主就叫“蛋生”，我很喜欢看（不小心暴露了年龄😅）
2. Cabloy
Cabloy来自蓝精灵的魔法咒语，拼对了Cabloy这个单词就会有神奇的效果。同样，CabloyJS是有关化学的魔法，基于模块的组合与生化反应，您将实现您想要的任何东西
预览
- 白色主题
- 暗色主题
- 风信子主题
- 灿烂主题
- 显示侧边栏
- 移动端风格
License
MIT
