# nop-chaos

**Repository Path**: xin-felix/nop-chaos

## Basic Information

- **Project Name**: nop-chaos
- **Description**: Nop平台是基于可逆计算原理从零开始构建的新一代低代码平台，它致力于克服低代码平台无法摆脱穷举法的困境，从理论层面有效的解决粗粒度软件复用的问题。nop-chaos是Nop平台的前端部分，基于Vue3.0、ant-design-vue、百度AMIS、logicflow、xspreadsheet等技术实现。
- **Primary Language**: TypeScript
- **License**: MIT
- **Default Branch**: master
- **Homepage**: https://www.zhihu.com/people/canonical-entropy
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 46
- **Created**: 2023-03-09
- **Last Updated**: 2023-03-09

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Nop Chaos (Nop Platform 2.0的前端部分)

#### 介绍

Nop Platform 2.0是基于可逆计算原理从零开始构建的新一代低代码平台，它致力于克服低代码平台无法摆脱穷举法的困境，从理论层面超越组件技术，有效的解决粗粒度软件复用的问题。nop-chaos是Nop平台的前端部分，基于Vue3.0、ant-design-vue、百度AMIS、logicflow、xspreadsheet等技术实现。

nop-chaos与[nop-entropy（Nop平台的后端部分）](https://gitee.com/canonical-entropy/nop-entropy)相结合，可以形成类似[百度爱速搭](https://aisuda.baidu.com/)的完整解决方案。nop-chaos是一个通用的前端低代码运行容器，它打包之后可以直接嵌入到后端的Java服务中。**在一般的业务开发中，只需要在Java端增加JSON文件和一些简单的js脚本库即可，并不需要重新编译打包nop-chaos项目**。

nop-chaos目前主要使用[百度AMIS框架](https://github.com/baidu/amis)来渲染后端返回的低代码页面，但是它的设计本身是通用的，大量操作都是在与框架无关的JSON结构层面完成，可以很容易的适配其他低代码引擎。后期考虑会增加对[阿里LowCodeEngine](https://github.com/alibaba/lowcode-engine)低代码引擎的适配。

#### 设计原理

[可逆计算：下一代软件构造理论](https://zhuanlan.zhihu.com/p/64004026)

[可逆计算的技术实现](https://zhuanlan.zhihu.com/p/163852896)

[从张量积看低代码平台的设计](https://zhuanlan.zhihu.com/p/531474176)

[低代码平台需要什么样的ORM引擎？](https://zhuanlan.zhihu.com/p/543252423)

[为什么百度AMIS是一个优秀的设计](https://zhuanlan.zhihu.com/p/599773955)

#### 软件架构

nop-chaos采用pnpm多模块管理，具有如下模块：

1. nop-site:  前端程序主框架以及对AMIS框架的集成。其中主框架是基于[jeecgboot-vue3](https://gitee.com/jeecg/jeecgboot-vue3)和[vben-admin](https://doc.vvbin.cn/guide/introduction)项目进行改造。nop-site对AMIS进行了一定的封装和增强，内部使用SystemJs来动态加载js模块（主要代码均在src/nop目录下）。

2. nop-server-tool: 在服务端通过rollup对js库进行转换打包的工具。它负责将ESM模块文件翻译为SystemJs模块标准的js文件。这一模块主要是嵌入在后端Java程序中执行。

3. nop-amis-editor: 对amis-editor的简单封装，可以嵌入在iframe中独立使用

4. 其他模块为目前正在考虑集成的相关技术，尚未包含实际内容

#### 安装与使用

- 如果没有安装 Node.js 16，下载地址：<https://nodejs.org>

```bash
# 验证
node -v
```

- 如果没有安装 pnpm 执行安装

```bash
npm i -g pnpm
# 验证
pnpm -v
```

- 获取代码

```bash
git clone https://gitee.com/canonical-entropy/nop-chaos.git
cd nop-chaos
```

注意：不要放到中文或带空格的目录下。

- 安装依赖

```bash
pnpm config set registry https://registry.npm.taobao.org
pnpm config set ENTRYCLI_CDNURL=https://cdn.npm.taobao.org/dist/sentry-cli
pnpm config set sentrycli_cdnurl=https://cdn.npm.taobao.org/dist/sentry-cli

pnpm install
```

- 开发调试

```bash
pnpm dev
```

初次执行速度会很慢，需要耐心等待

- 测试
  
  > 在浏览器中输入http://localhost:8100, 进入登录页，用户名nop, 密码123。

需要启动nop-entropy项目中的某个服务模块来提供给后端服务，例如nop-entropy/nop-demo/nop-quarkus-demo模块。

如果希望不依赖任何服务启动，可以修改packages/nop-site/.env.development文件中的VITE_USE_MOCK = true。在MOCK模式下会使用packages/nop-site/public/mock/pages目录下的JSON文件来模拟后端服务响应。

- 打包

```bash
pnpm build
```

打包完成后，会在各模块的根目录生成 dist 文件夹