# 基于golang的后台管理脚手架gofast的使用步骤 {#基于golang的后台管理脚手架gofast的使用步骤}
本文讲述基于golang的后台管理脚手架gofast的使用步骤。推荐该脚手架,界面美观,用户体验好。该脚手架为前后端分离设计,分为2个工程,分别为后台api工程gfast(基于goframe开发)和前端页面工程gfast-ui(基于ruoyi开发)。
# 一. 部署前端工程gfast-ui {#一-部署前端工程gfast-ui}
# 1. 安装依赖 {#_1-安装依赖}
yarn
若出现错误
Syntax Error: Error: Node Sass version 5.0.0 is incompatible with ^4.0.0.
,则重装低版本node sass,步骤如下:
- npm uninstall node-sass
- npm install node-sass@4.12.0
# 2. 删除工程中的无用代码 {#_2-删除工程中的无用代码}
删除./src/views/index.vue顶部的广告信息
修改"gfast管理系统"关键字为自己的系统信息
# 3. 运行服务 {#_3-运行服务}
yarn dev
启动过程中若报错提示缺少依赖,则按提示安装依赖(如yarn add -D http-parser-js
)
# 二. 后台api工程gfast {#二-后台api工程gfast}
# 1. 初始化数据库 {#_1-初始化数据库}
create database gfast_open default CHARSET utf8 collate utf8_general_ci; use gfast_open;
source ./data/db.sql
# 2. 准备配置文件 {#_2-准备配置文件}
创建开发环境配置: cp -r ./config ./config_dev
# 3. 运行服务 {#_3-运行服务-2}
启动参数: --gf.gcfg.path=./config_dev/
# 三. 默认账号 {#三-默认账号}
前端服务和后台api服务都运行起来以后,访问页面http://localhost:1024
默认账号demo,密码123456, 该账号具有最高权限。
# 四. 代码生成 {#四-代码生成}
# 1. 创建数据库表 {#_1-创建数据库表}
有2种方式:
- 通过后台系统的
模型管理
模块提供的功能通过页面动态创建数据库表。 - 手动通过sql语句创建
# 2. 导入表 {#_2-导入表}
操作导航: 系统工具->代码生成->导入
# 3. 编辑 {#_3-编辑}
编辑导入的表信息, 需要按实际需要修改如下信息:
- 作者
字段信息
模块的插入
、编辑
、列表
、查询
、查询方式
、必填
、显示类型
、字典类型
测试发现,
必填
没有生效。
生成信息
模块的生成模块名
、生成业务名
、生成包路径
按需修改生成模块名
和生成业务名
生成包路径
实际上对应于gfast工程的go.mod文件的module gfast
中的gfast
,按需修改即可。
# 4. 生成代码 {#_4-生成代码}
点击生成代码
按钮,导出zip文件并解压
- 拷贝go目录下的代码到gfast工程根目录
如cp -r ./go/* /data/workspace/oupeng/sitePack/sitePackAdmin/gfast/
- 使用gf工具生成剩余文件
还需要通过gf工具生成_model.go和_entity.go文件,命令如gf gen model ./app/model/distributor -t distributor
在执行gf gen命令之前,需要确保工程的生成信息配置是正确的:
如:
moduleName = "distributor"
packageName = "gfast"
-
修正"生成的后台代码"的语法错误 自动生成的代码会有部分语法错误,如参数类型定义错误。需要手工修复下。
-
为
自动生成的代码
定义接口
接口定义代码并没有自动生成,需要手工补充。 -
重启后台服务
后台代码修改完成之后,需要重启服务,改动才会生效。
6.复制vue代码到gfast-ui工程的src目录下
命令如cp -r ./vue/* /data/workspace/oupeng/sitePack/sitePackAdmin/gfast-ui/src/
- 完成如上步骤后,生成代码的流程正式结束。
# 五. 权限 {#五-权限}
按提示添加菜单
为用户添加分配菜单权限
# 六. 官网 {#六-官网}
官网: http://doc.qjit.cn/docs/gfast/introduce