# sagoo-admin-ui

业务管理系统前端

### 关于其他插件说明

组态项目代码仓库： sagoo-configuration
开源版本对应的组态代码分支是 master
企业版和专业版对应的组态代码分支是 v2

其他前端插件项目不分 v1 v2 都是一样的

### 依赖安装方式

用 yarn 安装依赖

1. 全局安装 yarn： npm i yarn -g ,如果是非 windows 环境需要加 sudo
2. 用 yarn 在项目中安装依赖： yarn i

### 环境变量配置

**.env**

为默认环境配置，不可修改，会导致使用异常。

**.env.development**

开发环境配置，启动 `npm run dev` 会启动开发环境，配置为链接本地的 `go` 环境的配置，可按需更改。

**.env.nginx**

线上 `nignx` 部署情况下的演示配置，可以复制到 `.env.development` 中进行按需修改使用。

**.env.golocal**

如需将打包后的静态文件放入到 `go` 服务中的 `public` 文件夹下使用，则需使用 `npm run build:golocal` 命令打包。

**config.js**

本地运行或打包都会根据 `env` 文件的配置，提前自动生成 `config.js` 配置文件，运行环境会在 `public` 目录下，打包之后会在生成的 `sagoo-iot` 目录下。可以通过手动修改这个 `config.js` 文件来修改前端运行时的服务端请求地址。通过修改配置来适应不同环境来避免调试时频繁打包。

```javascript
window.allEnv = {
	topo: {
		server: '/base-api/api/v1',
		imgServer: '/base-api',
	},
	screen: {
		server: '/base-api/api/v1',
		imgServer: '/base-api',
	},
	rule: {
		server: '/rule-api',
		iotServer: '/base-api/api/v1',
	},
	media: '/media',
}
```


### 关于前端 pligin 插件

前端插件的文件在 `public/plugin` 目录下，运行 `dev` 或 `build` 前会自动检查插件文件是否存在，不存在会自动拉取，拉取后会自动运行 `dev` 或 `build` 命令。

之后如果需要更新插件，可以运行 `npm run plugin:update` 命令进行更新，避免插件更新影响主程序。