110 lines
3.0 KiB
Markdown
110 lines
3.0 KiB
Markdown
## 总览
|
||
fastbee-view是基于GoView二次开发的低代码可视化平台，图表或页面元素封装为基础组件，无需编写代码即可完成业务需求，项目已经获得GoView的商用授权。
|
||
|
||
技术栈为：Vue3 + TypeScript4 + Vite2 + NaiveUI + ECharts5 + Axios + Pinia2 + PlopJS
|
||
|
||
使用流程：新建项目-->可以点击上方编辑名称-->尽情发挥拖拉拽编辑页面-->保存(60s自动保存/手动保存)-->预览-->发布（生成地址）
|
||
|
||
注： 建议使用pnpm下载依赖和打包，npm有时候会有部分依赖下载不成功到时打包失败。
|
||
|
||
|
||
## 项目运行和部署
|
||
#### 1.修改根目录的 `.env.development` 文件，配置后端接口地址
|
||
```
|
||
# 后端接口地址
|
||
VITE_DEV_PATH = 'http://localhost:8080'
|
||
```
|
||
|
||
#### 2.修改完成后，开始安装依赖，建议使用 pnpm，比较快
|
||
|
||
```shell
|
||
# 安装 pnpm
|
||
npm install -g pnpm
|
||
```
|
||
|
||
```shell
|
||
# 安装项目依赖
|
||
|
||
# pnpm（建议使用nrm切换到淘宝源 https://registry.npmmirror.com/）
|
||
pnpm install
|
||
|
||
# npm
|
||
npm install
|
||
|
||
# yarn
|
||
yarn install
|
||
```
|
||
|
||
#### 3.启动项目
|
||
```shell
|
||
#pnpm
|
||
pnpm dev
|
||
|
||
# npm
|
||
npm run dev
|
||
|
||
#yarn
|
||
yarn dev
|
||
|
||
#Makefile
|
||
make dev
|
||
```
|
||
|
||
#### 4.编译
|
||
```shell
|
||
#pnpm
|
||
pnpm run build
|
||
|
||
# npm
|
||
npm run build
|
||
|
||
#yarn
|
||
yarn run build
|
||
|
||
#Makefile
|
||
make dist
|
||
```
|
||
|
||
#### 5.部署：
|
||
Nginx配置文件中添加location ，切记不要用重复的匹配关键词，编译的文件上传到 `/var/data/nginx/view/` 目录下
|
||
```shell
|
||
location ^~/view/ {
|
||
alias /var/data/nginx/view/;
|
||
index index.html;
|
||
try_files $uri $uri/ /index.html last;
|
||
}
|
||
```
|
||
|
||
部署完访问地址： https://[域名]/view/ ，也可以通过在系统中添加外链菜单
|
||
```
|
||
# 参考外链地址：
|
||
https://iot.fastbee.cn/view/#/project/items
|
||
```
|
||
|
||
## 相关文档
|
||
* [GoView官网文档](https://www.mtruning.club/guide/start/)
|
||
* [FastBee仓库](https://code.wumei.live/)
|
||
|
||
## 二次开发说明
|
||
* 登陆、退出、获取用户信息适配物美后台统一接口，拦截器调整
|
||
* 修改上传文件功能：原项目是上传到minio服务(oss),现在直接融合到wumei-smart项目中，一个大屏固定一张预览图
|
||
* 大屏业务数据字段微调，对应后台代码基础代码微调
|
||
* 所有的接口地址位置：`src\api\path\*`
|
||
* 系统登陆相关 `system.api` ===> 对应物美系统的接口
|
||
* 项目相关：`project.api` ===> `com.ruoyi.iot.controller.GoviewProjectController`
|
||
* 项目使用接口列表如下：
|
||
```ts
|
||
项目列表 GET /goview/project/list
|
||
新增项目 POST /goview/project
|
||
保存项目内容 POST /goview/project/save/data
|
||
修改项目基础信息/修改发布状态 PUT /goview/project/
|
||
删除项目 DELETE /goview/project/{ids}
|
||
上传文件接口 /goview/project/upload
|
||
获取项目 GET /goview/project/getData 此接口涉及到预览，所以前后端白名单放行
|
||
```
|
||
|
||
## 更新记录
|
||
* 2022-12-22 更新到go-view基础版本2.1.3
|
||
* 2023-05-30 更新到go-view基础版本2.2.3 [PS:版本依赖更新较大，建议删除依赖并且重新intsall项目]
|
||
* 2023-12-28 更新到go-view基础版本2.2.7 [PS:有新依赖，建议删除依赖并且重新intsall项目]
|