Oinone是一个企业级产品化引擎，专注于为企业在项目型、行业产品和标品的三个发展阶段提供极具成本效益的解决方案，帮助企业高效应对核心技术挑战，打造自有得研发平台。 建议大家以下方流程深度体验Oinone的各种能力、了解熟悉Oinone的设计理念、解题思路；同时我们也在微信群提供1V1的解答；有解决不了的问题随时联系对应的支持人员； 部署所需资料包 提示：安装启动具体操作查看“快速启动”。其它版本也可，建议使用以上版本。 入门学习路径 这是整个学习的过程：注意：此图的每一步都可在下面的目录中找到，大家跟随操作即可(有文档有视频)！ 快速启动 环境准备须知(部署前必看) * 无代码启动 常见问题 * 无代码启动常见问题 后端启动常见问题 入门培训视频 整体概念(点击此处观看) 视频简介: 平台整体介绍、核心理念、研发方式、要解决的问题 观看对象: 建议都看 后端(点击此处观看) 视频简介: 如何开始、与原有开发方式有什么差异？元数据是什么？前后端如何协作？0-1开发一个新场景，解答疑惑 观看对象: 后端，对Java有基础的了解 前端(点击此处观看) 视频简介: 前端要做什么？怎么做到不用联调？写的代码怎么沉淀、复用？与后端如何协作？每种场景都有一个示例，有最基本的概念讲解 观看对象: 前端，对Vue有基础的了解 无代码(点击此处观看) 视频简介: 无代码有什么定位？在开发、测试、生产阶段能做什么？对研发有什么帮助？无代码基础使用入门讲解 观看对象: 建议都看 按教程还原业务场景(文档) 后端 前端 按教程还原业务场景(视频) 后端 前端

1、执行yum-config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo出现问题： 报错： Could not fetch/save url https://download.docker.com/linux/centos/docker-ce.repo to file /etc/yum.repos.d/docker-ce.repo: [Errno 14] curl#35 – "TCP connection reset by peer 解决方案： # 把docker-ce镜像源设置到阿里云 yum-config-manager –add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo 2、如果重新运行startup.sh失败,可能是docker前面已经启过了还在运行。 解决方案： docker stop designer-allinone docker rm designer-allinone sh startup.sh 3、启动无代码失败 报错： 依赖包版本不匹配 pamirs-business-api已安装版本:[5.1.24],启动中包含的版本:[5.1.12] pamirs-data-audit-api已安装版本:[5.1.24],启动中包含的版本:[5.1.12] pamirs-sys-setting-core已安装版本:[5.1.24],启动中包含的版本:[5.1.12] ······ 解决方案：修改 startup.sh 中的版本修改docker pull 命令中的版本（注意：具体版本号查看https://doc.oinone.top/xin-ren-ru-men/18758.html中） 4、执行vi startup.sh出错，可能是没有修改这个文件的权限，执行chmod 777 startup.sh即可授权

1.1.1空工程准备准备工作 1.1.2建应用– 声明编码常量、名称常量– 加注解– 重写packagePrefix方法 1.1.3建完应用改配置 1.1.4建模型– 继承基类– 声明编码常量– 加注解详细文档：https://doc.oinone.top/oio4/9232.html 1.1.5建简单字段– java方式写字段– 加注解 1.1.6配菜单秒懂：定义菜单名称+绑定模型 1.1.7常用注解必填/唯一/搜索条件/隐藏/表单分列/上传图片/只读/提示 1.1.8数据字典(枚举)穷举详细文档：https://doc.oinone.top/oio4/9237.html 1.1.9序列化&多值详细文档：https://doc.oinone.top/oio4/9238.html 1.1.10建立一对多关系 1.1.11建立多对一关系 1.1.12建立多对多关系 1.1.13写方法action写了action,界面上有按钮（相当于springboot的Controller层） 1.1.14写方法Function写Function,界面上没有按钮（相当于springboot的Service层） 1.1.15继承多态详细文档：https://doc.oinone.top/oio4/9246.html 1.1.16扩展点– 自定义扩展点– 平台默认的扩展点详细文档：https://doc.oinone.top/oio4/9248.html 1.1.17拦截器详细文档：https://doc.oinone.top/oio4/9247.html

1、Windows启动如出现以下报错，直接点击 JAR manifest 即可 2、出现“未经许可授权模块无法访问" 报错： 原因： 有可能是因为jdk版本低于1.8_221版本。 解决方式： (1) 可以重装jdk，选择安装包里面提供的 (2) 低于1.8_221版本的需要覆盖掉jce， 原因:https://www.cnblogs.com/jinloooong/p/10619353.htmljce可以在这里下载， https://doc.oinone.top/install/backendinstall/13760.html 如果以上解决方式仍无效，请联系数式员工。 3、出现“境信息检查不通过，请根据以上提示信息进行修改" 报错： 原因： 新版本加了环境检验，同base库同Redis下中间件和版本不一致导致的校验失败 查看具体原因： 在看到报错信息后，日志向前翻(即看更早的日志)会看到错误的环境信息 ，有打印出具体的环境不一致的信息 解决方式： 需要保持同环境下的版本、中间件配置等一致 4、出现“创建数据库错误" 报错： 原因： 可能是因为开了防火墙，导致连接不上数据库 解决方式： 关闭防火墙：systemctl stop firewalld 或者放开对应的端口 5、出现“公共环境开启了元数据保护模式" Caused by: java.lang.UnsupportedOperationException: 公共环境开启了元数据保护模式，本地开发环境需配置 [pamirs.distribution.session.ownSign] at pro.shushi.pamirs.boot.standard.service.MetadataProtectedChecker.unsupportedLocalOperation(MetadataProtectedChecker.java:70) at pro.shushi.pamirs.boot.standard.service.MetadataProtectedChecker.process(MetadataProtectedChecker.java:63) at pro.shushi.pamirs.boot.common.spi.service.boot.DefaultBootModuleLifecycleBegin.run(DefaultBootModuleLifecycleBegin.java:35) at pro.shushi.pamirs.boot.common.process.PamirsBootMainProcessor.lambda$installOrLoad$2(PamirsBootMainProcessor.java:89) at pro.shushi.pamirs.boot.common.spi.api.boot.BootModuleLifecycleAroundApi.run(BootModuleLifecycleAroundApi.java:30) at pro.shushi.pamirs.boot.common.process.PamirsBootMainProcessor.installOrLoad(PamirsBootMainProcessor.java:66) at pro.shushi.pamirs.boot.common.initial.PamirsBootMainInitial.installOrLoad(PamirsBootMainInitial.java:119) at java.util.concurrent.CompletableFuture$AsyncRun.run$$$capture(CompletableFuture.java:1640) at java.util.concurrent.CompletableFuture$AsyncRun.run(CompletableFuture.java) at java.util.concurrent.CompletableFuture$AsyncRun.exec(CompletableFuture.java:1632) at java.util.concurrent.ForkJoinTask.doExec$$$capture(ForkJoinTask.java:289) at java.util.concurrent.ForkJoinTask.doExec(ForkJoinTask.java) at java.util.concurrent.ForkJoinPool$WorkQueue.runTask(ForkJoinPool.java:1056) at java.util.concurrent.ForkJoinPool.runWorker(ForkJoinPool.java:1692) at java.util.concurrent.ForkJoinWorkerThread.run(ForkJoinWorkerThread.java:175) 原因： 共环境下元数据保护机制正常的保护提示，防止元数据被意外修改 解决方式： (1) 测试环境启动或体验阶段，可在启动配置增加【程序实参 (Program arguments)】-PmetaProtected=pamirs 后再进行启动。 (2) 多人协调场景参考 https://doc.oinone.top/oinone-faq/18544.html

注意： 部署/启动前端的过程中如果出现问题，请先在 常见问题 中寻找答案。如仍未解决，请及时在群里咨询。 视频教程(点此观看) 1. 需要安装的工具 Node.js (v20.16.0) VSCode 注意：以上工具需安装在本地开发电脑上，根据实际情况补充所需工具。 2. 安装 Node.js 检查是否已安装 在终端中输入以下命令： node -v 如果安装了，会出现版本号。建议使用 20.16.0 版本。 下载 Node.js 如果未安装，请选择以下任一方式下载： 官网下载： Node.js v20.16.0 下载好了之后，双击，开始安装： 一直点击 Next 直到 Install 完成安装。 验证安装 再次运行以下命令检查是否安装成功： node -v npm -v 出现版本号表示安装成功： 3. 安装 VSCode 如果已安装，请忽略此步骤。 下载 VSCode 选择以下任一方式下载： 官网下载：Visual Studio Code 安装完成后，打开 VSCode 并加载前端工程 SS_FRONT_MODULES。 配置项目 在 ss-boot 子工程中，打开 vue.config.js 文件，将 target 地址修改为后端开发地址： 4. 安装 Vue CLI 安装 在 VSCode 的终端中输入以下命令安装 Vue CLI (v5.0.8)： npm install -g @vue/cli@5.0.8 验证安装 检查安装是否成功： vue –version 安装成功将显示版本号。 5. 配置 npm 源 设置 npm 源为内部源 npm config set registry http://nexus.shushi.pro/repository/kunlun/ 登录 NPM 源 注意：用户名和密码在部署包的 xxx账号.md 文件中。 npm login –registry “http://nexus.shushi.pro/repository/kunlun/” npm info underscore 成功登录后，将出现相关信息： 6. 安装 pnpm 验证安装 在终端中输入以下命令安装 pnpm： npm install -g pnpm 验证安装 检查安装是否成功： pnpm -v 清理缓存 pnpm run clean 安装依赖包 pnpm i 注意：此过程可能较慢。 7. 启动项目 启动开发环境： pnpm run dev 启动成功后，您可以直接访问项目。

注意： 部署/启动后端的过程中如果出现问题，请先在 常见问题 中寻找答案。如仍未解决，请及时在群里咨询。 视频教程(点此观看) 一、环境搭建 1. 需要安装的工具 JDK(1.8_221+) Maven IDEA 注意：以上工具需安装在本地开发电脑上，根据实际情况补充所需工具； 已安装请忽略。 2. 安装 JDK(JDK1.8_221+) 检查是否已安装 JDK 在终端中执行以下命令： java -version 如果安装了，会出现版本号。如果没有安装，请选择以下方式下载 JDK： 官网下载（建议下载 JDK 8, installer）：Oracle JDK下载 注意：JDK版本必须高于1.8_221+版本。若无法升级，低于这个版本需要覆盖JCE（覆盖JCE：https://www.cnblogs.com/jinloooong/p/10619353.html） 配置环境变量 打开 Windows 环境变量配置页： 此电脑 => 右键属性 => 系统高级设置 => 环境变量 在用户环境变量中新建变量为JAVA_HOME的项,值为JDK安装之后的路径 变量名：JAVA_HOME 变量值：JDK 安装路径 编辑变量为Path的项添加一个值%JAVA_HOME%\bin 在 PowerShell 或 CMD 中验证，输入java -version，输出类似信息为安装配置成功 3. 安装 Maven 检查是否已安装 Maven 在终端中执行： mvn -v 如果安装了，会出现版本号。如果未安装，请下载 Maven： 推荐安装： Maven 3.6.3 下载 下载后解压。 配置 Maven 私服 之前解压的数式提供的部署包中有两个settings.xml文件： 根据 Maven 版本选择对应的 settings.xml 文件： 3.6.x 及以下的版本使用 settings-3.6.3.xml 3.8.x 及以上的版本使用 settings-3.8.x.xml 具体步骤： 将对应的 settings-3.x.x.xml 复制到 Maven 安装目录的 conf 文件夹里面。 备份已有 settings.xml，将已经存在的settings.xml进行备份(即重命名)。 3.然后将 settings-3.x.x.xml 重命名为 settings.xml。 配置环境变量 在用户环境变量中新建变量为M2_HOME的项,值为Maven安装路径 变量名：M2_HOME 变量值：Maven 安装路径 编辑变量为Path的项添加一个值%M2_HOME%\bin 验证安装 在终端执行： mvn –version 出现下列信息，表示成功了： 如果仍然不成功，请检查环境变量配置。 4. 下载安装 IDEA IntelliJ IDEA Community Edition（社区版）即可，该版本免费且完全够用下载方式： 官网下载：IDEA下载链接 二、IDEA 配置 1. 下载 IDEA 插件 有2种方式： 【推荐】根据不同版本下载不同的idea插件 (联系Oinone获取) 插件下载地址：https://guide.oinone.top/zh-cn/DevManual/Tutorials/setup-guide.html#%E4%B8%89%E3%80%81%E5%90%8E%E7%AB%AF%E9%A2%9D%E5%A4%96%E5%B7%A5%E5%85%B7 1、打开 IDEA，依次点击菜单项 File => Settings => Plugins，找到下载的插件包。 2、找到自己前面下载的插件包: 3、idea插件包输入验证码 Oinone企业版需要激活idea插件，设计器版本可不用激活。 输入数式提供的验证码进行验证, 若激活失败(包括无提示)可数式支持人员询问 2. IDEA 配置（Maven 配置，Annotation 配置） 先打开数式提供的部署包中的后端工程 设置 Maven 的 settings.xml： Maven home path：设置为下载的 Maven 路径。 User settings file：设置为 Maven conf 目录下的 settings.xml。 配置 Java Compiler 为 -parameters。 配置 Annotation Processors，勾选 Enable annotation processing。 编译 Maven 拉取包，执行 mvn install，然后再 reload。 3. 项目启动（修改 yml 文件）…

注意： 启动无代码的过程中如果出现问题，请先在 常见问题 中寻找答案。如仍未解决，请及时在群里咨询。 视频教程(点此观看) docker安装从3分35秒开始 MySQL安装从6分30秒开始 部署无代码从21分50秒开始 一、进入服务器 ssh 用户名@服务器ip # 举例：ssh root@192.168.0.121 二、安装 Docker 1. 判断是否已安装 Docker docker -v 如果出现 Docker 版本号，说明已安装 Docker，如下图： 没有安装时显示如下图： 2. 安装并启动 Docker 已安装了 Docker：执行以下命令启动 Docker（未安装则忽略此步骤） # 启动 Docker systemctl start docker # 查看是否启动成功 docker -v 未安装 Docker 的情况：依次执行以下操作 # 删除原有版本 yum remove docker docker-client docker-client-latest docker-common docker-latest docker-latest-logrotate docker-logrotate docker-engine yum install -y yum-utils yum-config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo #提示 如果 docker 源异常，可以改用阿里云源: #yum-config-manager –add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin # 启动 Docker systemctl start docker # 查看是否启动成功 docker -v 3. 检查 Docker 是否启动成功 sudo systemctl status docker 出现如下图表示启动成功： 三、安装 MySQL 1. 判断是否已安装 MySQL mysql –version 如果出现 MySQL 版本号，说明已安装 MySQL。 没有安装会显示如下图： 2. 安装并启动 MySQL 查看服务器 glibc 版本 ldd –version 查看结果，如图： 下载 MySQL 压缩包 官网下载：MySQL 下载地址 在服务器上创建用户组和用户 # 添加用户组 groupadd mysql # 创建 MySQL 用户并添加到用户组 useradd -g mysql mysql 切换到mysql用户下 su mysql 上传mysql压缩包到服务器 # 注意：以下命令在新开的一个本地命令行执行，不进入服务器！ scp path/to/your/mysql-8.0.40-linux-glibc2.17-x86_64.tar.xz(替换成本地电脑mysql压缩包的实际地址) username@ip_address:/home/mysql(替换成想要上传在服务器上的具体地址) 已经将mysql压缩包上传到服务器的某个文件夹成功之后，进入服务器的该文件内查看压缩包是否已经存在，执行ls，如图： 上传成功后，在服务器上解压 tar -Jxvf mysql-8.0.40-linux-glibc2.17-x86_64.tar.xz # 解压 MySQL 压缩包 创建软链 ln -s path/to/your/mysql-8.0.40-linux-glibc2.17-x86_64 mysql # 创建软链 进入mysql目录 cd mysql 配置文件与目录创建 MySQL 服务启动项很多，一般不通过命令行输入，而是写在配置文件中，启动时指定配置文件即可。如果没有指定配置文件，则会去 /etc/my.cnf 等默认路径下找配置文件。这里直接指定自己创建的配置文件，把一切都掌握在自己手里。 vi my.cnf # 执行此命令，然后写入以下配置 [mysqld] basedir=/home/mysql/mysql (改成mysql具体路径) datadir=/home/mysql/mysql/data/ (改成data具体路径) socket=/tmp/mysql.sock character-set-server=UTF8MB4…

本地开发：本地使用idea开发，编写业务代码；服务器：用来部署无代码设计器的，安装docker、mysql等；本教程模拟的 本地是windows、 服务器是Centos的操作系统 注意事项条件 需要准备一台4核16G的Linux服务器 操作系统推荐CentOS 7.9 64位(其他兼容操作系统也可以) 1、互通性 ● 本地开发ip   能否调通   服务器ip   在本地执行命令：ping 192.168.0.121(替换成服务器ip) ● 部署docker的宿主机ip 能否调通 本地开发ip   进入服务器执行命令：ping 192.168.0.60(替换成自己的本地ip) 注意：推荐双向能互通，如果不通的话从无代码端访问本地数据会出现调用服务错误。 2、确定服务器系统架构 查看当前系统架构: 使用 arch(推荐使用) 或者uname -a 命令 x86_64：表示支持 AMD64 架构。 aarch64：表示支持 ARM64 架构 Oinone所有镜像均使用docker manifest支持amd64和arm64架构！(如果有其他架构请先联系数式人员确定能否使用) 注意！以上条件必须先明确好，再进入后面的部署。

前端学习路径 后端学习路径

1. 安装docker 1.1 Linux内核系统（以CentOS7为例） 1.1.1 检查防火墙 查看防火墙是否开启 systemctl status firewalld 如防火墙处于开启状态 有2种处理方式，选择其中一种，开发环境如内网环境建议选择处理方案1 处理方案1:停止防火墙 systemctl stop firewalld 处理方案2:开放docker镜像内置中间件透出的端口 88：web访问端口 8099：后端Java服务端口 19876：rocketmq的namesrv端口： 6378：缓存redis的端口 3307：数据库mysql的端口 2182：zookeeper的端口 20880：dubbo的通信端口 10991：rocketmq的broker端口 查看防火墙已经开放的端口 firewall-cmd –list-ports 防火墙新增开放端口示例： firewall-cmd –permanent –zone=public –add-port=88/tcp 新增以后生效需要重新加载防火墙 systemctl reload firewalld 查看端口是否开放成功 firewall-cmd –list-ports 也可以从外部使用telnet命令检查端口是否开放成功，如telnet 192.168.0.121 3307 1.1.2 官方安装地址（docker如已安装请忽略）： https://docs.docker.com/engine/install/centos/ yum install -y yum-utils yum-config-manager –add-repo https://download.docker.com/linux/centos/docker-ce.repo 如果docker这个源异常可以用阿里云的源 #yum-config-manager –add-repo http://mirrors.aliyun.com/docker-ce/linux/centos/docker-ce.repo yum install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin #启动docker systemctl start docker #查看是否安装成功 docker -v 如果无法访问官网，参考阿里云安装Docker CE镜像https://developer.aliyun.com/mirror/docker-ce?spm=a2c6h.13651102.0.0.57e31b11lhSNtT 1.1.3 可使用一键安装脚本（docker如已安装请忽略） wget https://pamirs.oss-cn-hangzhou.aliyuncs.com/docker/quick-install.sh sh quick-install.sh 1.1.4 Docker部署常见问题 https://doc.oinone.top/install/20670.html 1.2 无公网环境Linux系统 需要根据指定的版本以及内核架构来生成对应docker以及镜像包 1.3 window环境 https://docs.docker.com/desktop/install/windows-install/ 2. 解压提供的部署.zip 部署.zip包含： settings-3.6.3.xml：拉取平台jar的maven仓库settings，对应maven版本3.6.x settings-3.8.x.xml：拉取平台jar的maven仓库settings，对应maven版本3.8.x oinone-op-ds-all-full：包含所有中间件及前后端工程，用于启动docker结构和脚本(需拷贝到服务器) oinone-op-ds-all-mini：仅包含前后端工程，用于启动docker结构和脚本(需拷贝到服务器) license：平台证书 docker-mvn-npm账号.md oinone-example：后端示例工程 ss-front-modules：前端示例工程 3. 对应版本的docker镜像拉取 镜像地址 镜像概述 harbor.oinone.top/oinone/oinone-designer-full-v5.1:5.1.16 包含所有中间件及前后端工程(v5.1:5.1.16为示例版本号,实际以Oinone发出来的为准) harbor.oinone.top/oinone/oinone-designer-mini-v5.1:5.1.16 仅包含前后端工程(v5.1:5.1.16为示例版本号,实际以Oinone发出来的为准) 注意：docker镜像拉取的账号密码在部署.zip里面(docker-mvn-npm账号.md) docker login –username=用户名 harbor.oinone.top docker pull harbor.oinone.top/oinone/xxx 4. 修改startup.sh/cmd文件 doker的结构包 oinone-op-ds-all-full 或oinone-op-ds-all-mini 上传到服务器上;下面的操作都是这该文件夹下进行 4.1 linux环境修改参数 在startup.sh文件中找到如下 configDir=$(pwd)version=版本号IP=192.168.0.121 修改对应的IP为docker宿主机IP 4.2 window环境修改参数 在startup.cmd文件中找到如下set configDir=%CD%set version=版本号set IP=192.168.0.121 修改对应的IP为docker宿主机IP 5. 修改mq/broker.conf 注意：使用oinone-op-ds-all-mini版本，无需进行该步操作（直接跳过）注意：使用oinone-op-ds-all-full版本，才需进行该步操作 修改其中brokerIP1的IP从192.168.0.121改成宿主机IP brokerClusterName = DefaultCluster namesrvAddr=127.0.0.1:9876 brokerIP1=192.168.0.121 brokerName = broker-a brokerId = 0 deleteWhen = 04 fileReservedTime = 48 …… 5. 修改config/application.yml 注意：使用oinone-op-ds-all-full版本，无需进行该步操作（直接跳过）注意：使用oinone-op-ds-all-mini版本，才需进行该步操作 修改中间件的配置(oinone-op-ds-all-full版本无需修改)，把中间件对应的IP、端口或密码，改成实际提供服务IP、端口或密码。包括： zookeeper mysql rocket-mq redis oss配置 7. 启动Docker 7.1 linux环境启动 在终端执行 sh startup.sh 7.2 window环境启动 用PowerShell 执行 .\startup.cmd 7.3 查看日志，检查是否启动成功 在logs目录下可看到日志文件，第一次启动时间会相对长一些，等看到日志文件中输出 启动耗时…