重庆云穹科技数字化，海外独立建站，网站建设，商城，小程序商城，小程序开发，商城开发，GoData，godata，中小企业ERP，MES，WMS，制作公司，云穹科技数字化，云穹科技数字化GoData，云穹科技数字化godata

GoData系统介绍

GoData是一个免费的、高效、且灵活的数字化设计系统

主要技术：Golang、Vue3、arco design vue、tailwindcss等等。

系统UI适配兼容了电脑端、手机、平板设备。

我们仅保留了底部的产品标识。

使用场景：快速搭建管理系统、GM游戏后台、进销存、电商后台、开放API授权、官网、物联网平台、等等

动态表单设计器：表单拖拽设计，刷新即生效；
BI报表设计器：BI(商业智能)、支持多数据源；
支持 Javascript 和 Golang 双动态脚本来支撑自身个性化需要；
开放API：将API接口授权，可开放给其他应用调用接口数据；
支持单层审批，支持复杂审批流触发到第三方；
在线手写VUE代码，实时生效；
打印设计；
完善的权限功能；
企业私有化部署(二进制极简)，目前支持Windows、Linux、MacOS、国产信创系统；
内置官网搭建；
完善的开发文档；
视频教程，准备中；

环境准备

推荐安装Mysql8（兼容性最好，其他数据库暂没测试）：https://dev.mysql.com/downloads/mysql/
下载云穹GoData服务程序，启动文件是goo

下载安装

到Gitee下载：https://gitee.com/yhm_my/godata

目录结构：
根据自身的系统选择对应的文件夹包，与自身系统无关的文件夹包下载后可以删除，没有影响。
其中windows64是windows系统的包，linux64是linux系统的包，macos是苹果系统包。
里面的goo是服务启动文件，config是系统的配置文件，www是官网的代码文件。

YAML配置说明

配置在系统启动时生效，其中Port、数据库配置项修改后需要重启服务生效，其他的配置修改后，不需要重启即可实时生效。

这里只说明几个需要重点关注的配置字段，其他字段请查看配置文件中的注释。配置文件在 conf 目录下。

boot.yaml中的Profile配置用来指定应用启动时加载对应的的文件，
dev表示启动时加载app-dev.yaml文件
prod表示启动时加载app-prod.yaml文件
boot.yaml中的DevelopeMode表示开发模式，十分重要！在生产环境中一定要填false！
true是开发模式，同时app-*.yaml文件中Gorm.InitData也填true，那么每次重启系统，数据都会被清空重置！请慎重！
false不是开发模式
数据库配置在app-*.yaml中
**重点**：1、系统第一次启动时，必须初始化系统内部数据；2、或者需要重置系统内部数据时；请设置下述3项配置为true：
设置config/boot.yaml中的DevelopeMode为true
设置config/app-?.yaml中的Gorm.AutoMigrate为true、Gorm.InitData为true

之后，不是第一启动，或者不需要重置系统内部数据的时候：
**生产环境中**：第一次启动后，将上述3项配置全部设置为false
**开发环境中**：config/app-?.yaml中的Gorm.InitData为false

角色管理

系统采用的RBAC权限模型，用户-角色-资源(菜单、按钮、接口)。用户、或openapi用户绑定了角色，就拥有对应的资源权限。

Id为1的是超级用户，超级用户仅此一个。并且拥有所有的权限。

角色没有层级关系，用户拥有的权限是其所有角色的并集。

比如：用户A拥有角色B和角色C，B角色有b1和b2权限，C角色有b1和c1权限。那么用户A就有b1、b2、c1权限。

使用建议：单个角色不应给太多权限，合理细分角色，使不同角色拥有对应的权限。再给用户绑定对应的角色就能更灵活控制权限。

接口管理

接口包括：服务端API、前端按钮、go脚本自定义API逻辑

服务端API：包含系统内部API、和表单设计新的API

前端按钮：可以用于控制前端按钮权限，js脚本中用，比如：havaAuth('POST~/api/r1/r2')，返回true表示有按钮权限

go脚本自定义API逻辑：点击启用Go脚本，点击脚本示例复制示例代码，用来自定义API逻辑

接口可以设置日志开启，开启后该api的每一个请求都会记录日志到菜单：系统 -> 请求日志中

使用场景：使用go脚本来自定义逻辑，然后把这个接口绑定到角色上，通过开放api开放数据接口给其他应用调用系统数据

开放API

开放API主要是给其他客户端、应用系统等等开放指定接口来获取数据

开放API提交后会生成token，通过token来访问api

token有过期时间：0或不填表示永不过期；大于一表示会过期，过期后这个token访问接口会得到401的状态码

token的用法：支持两种方式，选择任意一种即可

用法1：将token放到请求头header里面，其中{key:value}长这样：Authorization:Bearer ${token}
用法2：将token放到URL的参数里面，长这样：https://domain?token=${token}

通过绑定角色，来控制token访问接口的细粒度权限

使用场景：需要对外、或给其他系统调用数据时

表单设计器

表单设计是系统的核心，用于CURD增删改查，拖拽设计所见即所得。支持单表、一对多、多对多（需要用到脚本）关系。

生成的表单，默认自适应，默认支持子表单的数据检验

支持：表单设计导出到json文件、导入json，任意迁移设计。

表单设计后提交时会生成数据库表（有开关可以不生成），设计字段时请不要使用下面的系统内置字段（默认会添加）：

id：主键 uint64
uid：用户ID uint64
coden：单据编号 string
status：单据状态 int8
create_at：创建时间 time
update_at：更新时间 time
deleted_at：删除时间（暂未启用，当前是永久删除） *time

表单功能介绍

点击左侧组件，即可添加到布局区域
布局区域中的每一个字段都可以拖拽位置
右边是当前选中字段的设置项

表单项属性

表单项 form-item，对应表单的UI和交互效果
表单字段对应着数据库字段，建议用下划线命名，形如：address_name
主要包含了表单项属性(form-item)、组件属性(props)、数据校验插槽(slots)、交互事件(events)、数据库字段设置（多数情况下用默认的就行）。
这里会讲到几个组件的特殊设置：下拉选择 & 下拉树选择文件上传子表单选择用户
配置项其他字段的意思，请参考arco的文档配置，跳转查看

下拉选择 & 下拉树选择

下拉选择就是一对一关系
目前这两个组件不支持multiple多选
组件属性有两项必填：1、doctypeTableName需要填数据库表名，2、fieldNames.label（下拉树是fieldNames.title）要填写显示的字段
事件处理中，事件yqRefresh方法中的字段需要替换成表单字段（一般是下划线的英文名）
数据库字段设置，使用默认就可以
其他属性设置参考arco文档跳转查看

文件上传

组件属性multiple=true支持多文件上传，数据库字段会设置成json类型。如果数据库不支持，这里就不能设置成true，比如sqlserver应该是不支持的
事件处理，事件yqUpload中的字段必须替换成表单字段（一般是下划线的英文名）
事件处理，组件属性multiple=true并且showRemoveButton=true时，事件yqRemoved中的字段必须替换成表单字段（一般是下划线的英文名）
文件选择后，会自动上传

子表单

添加子表单就是一对多关系
第一步，先创建子表单，保存时选中：表单全局配置 -> 数据库表设置 -> 子表单
第二步，选中子表单组件，在事件处理中下拉选择子表关联，选择上一步创建的表，会默认添加子表的字段
提示：关联的子表单不会包含：虚拟字段、子表被隐藏的字段、信息展示组件（二维码除外）。
子表单的字段不能包含key，因为key字段会被后端忽略，不会保存到数据库。

选择用户

选择用户也是一对一关系
组件属性中fieldsStr可以设置额外的显示字段，用逗号分割
如果在下拉选择中需要添加按钮，设置组件属性的showAdd=true
当表单字段修改后，事件yqRefresh中的字段也需要替换成修改后的表单字段（一般是下划线的英文名）。

自定义表单代码

点击：表单设计管理 -> 表单代码
其中默认生成是设计保存后自动生成的代码，这里不能被修改
自定义表单代码，复制默认生成的全部代码，点击左侧新增，左侧输入名称备注，再粘贴全部代码，再保存，最后点击应用表单代码，刷新即生效
应用场景：手写VUE代码，更个性化的设计表单

钩子hooks

点击：表单设计管理 -> 钩子hooks
hooks里面是go脚本，这个脚本是在数据库事物中执行的，如果发生错误，整个事务会回滚。执行的时机是在CURD之前执行
钩子hooks保存后就生效
应用场景：1、数据行的权限过滤，比如某用户只能看某些数据；2、触发三方api；等等

表单全局设置

点击：顶部工具栏最左侧按钮 -> 表单全局设置
里面主要是表单的全局设置，每个字段也有解释
表单会绑定到菜单，需要填写菜单信息

BI设计器

BI设计用于生成报表，支持多数据源、多数据集、丰富的图表、多维透视表等等。

BI功能至少需要数据源，在数据源的基础之上提供数据集
拖拽设计，支持交互脚本

支持：BI设计导出到json文件、导入json，任意迁移设计。

数据源

默认是支持 mysql、mariadb、postgresql、sqlserver，但除了mysql和mariadb其他数据库还没测试过
支持添加多个数据源，测试链接
数据源在服务器使用过一次后会缓存，在go脚本中可以使用tools.GetCacheDB(数据源id)拿到数据源连接

数据集

数据集是BI报表唯一的数据来源
添加数据集时，需要指定数据源
数据集支持的方式，目前支持前3个：
1. sql脚本，只能返回一个数组的数据结果，当然也支持存储过程
2. go脚本，更灵活的数据集结果
3. 静态json数据
4. 实时数据（暂时未支持），以后会考虑websocke、sse、或中间件推送

BI组件设置

BI组件设置包含3个部分：

选择对应的数据集
图表、统计表、arco组件配置项
交互事件

上述部分的使用方法在系统中有说明、和示例代码

BI全局设置

如果设置为仪表盘，登录系统时的首页就会显示该报表
BI报表会绑定到菜单，需要填写菜单信息
BI报表的标题、和备注，会渲染到报表内容的顶部

打印设计

系统提供了2中打印设计，1、pdkmake用js脚本来设计查看文档；2、标签打印（基于开源hiprint）

表单设计后会默认生成一个pdfmake打印脚本

打印设计用于：表单设计 -> 表单全局设置 -> 表单UI设置 -> 默认打印，中绑定

Vue代码菜单

个性化更高的设计菜单内容

支持完整的vue3语法，对代码效果实时预览

设置

主要是系统的一些跟业务功能无关的功能集合

文件管理

包括系统所有的文件：图片、文件、视频、音频、pdf等等。

表单设计中的上传组件，上传的文件都在这里

系统设置

将系统的信息替换成自己的，包括系统的图片，系统的标题，水印，上传文件大小，登录页口号，等等能在这里随意更换。

数字认证：去除底部产品标识的使用码

服务器状态

包括服务器的资源状态：cpu、磁盘占用、系统信息

请求日志

接口管理中，指定的接口开启了日志记录，全部都在这里能查询到

生产环境部署

推荐用ubuntu的64位系统，部署生产环境。

支持部署成HTTPS服务，而且部署很简单，请查看下述步骤。而部署成HTTP就更简单了，直接启动。两者只能选择其中一种方式部署。

首先：修改config/boot.yaml中的Profile为prod，同时修改app-prod.yaml中的Port（注意：用HTTPS时必须为80端口）。

不使用SSL证书，部署成HTTP服务
只需要修改config/boot.yaml中的Profile为prod，同时修改app-prod.yaml中的Port，启动goo。访问地址：
数字化后台：http://你的IP:端口号/admin
官网：http://你的IP:端口号

生成SSL证书，部署成HTTPS服务，必须按下述5步的顺序操作：
1. 首先：你的云服务器必须开放入网规则：端口80、443必须打开。
2. 下载lego客户端
```
wget https://github.com/go-acme/lego/releases/download/v4.22.2/lego_v4.22.2_linux_amd64.tar.gz
```
3. 解压客户端
```
tar -xvf lego_v4.22.2_linux_amd64.tar.gz lego
```
4. 再生成SSL证书
  注意：必须将email替换成自己的，domains换成自己的域名。
```
./lego  --email="example@163.com" --domains="cqyunq.com,www.cqyunq.com" --path="./cert.com" --http --http.webroot "/" run
```
5. 最后，在app-prod.yaml中设置SslEnable为true开启ssl，启动goo成功后，https就可以了。访问地址：
  数字化后台：https://你的域名/admin
  官网：https://你的域名

Linux中的启动服务、停止服务命令：
启动服务：

启动前，先赋予goo执行权限：
```
chmod +x ./goo
```
在后台启动goo服务：
```
nohup ./goo &
```

停止服务：

先查询goo的ID：
```
ps -aux|grep goo
```
用上述查询的ID，停止goo服务：
```
kill -9 ID
```