简介
goadmin-ui 是一个后台基础模块的前端的实现，它基于 vue-element-admin实现。它实现了一套最基本的后台权限管理前端的基础模块。可以很快捷的开启自己的项目，不用考虑权限功能如何实现，操作页面如何设计，这里基本上已经满足了，希望能够为大家提供便利。
基于Gin + Vue + Element UI的前后端分离权限管理系统
系统初始化极度简单，只需要配置文件中，修改数据库连接，系统启动后会自动初始化数据库信息以及必须的基础数据
一 编写go-admin应用,第1步
让我们通过示例来学习。
通过这个教程，我们将带着你创建一个基本的文章管理程序。
它由两部分组成：
- 前端页面。
- 后端api服务。
我们假设你已经阅读了开始
二.开始项目
如果这是你第一次使用 go-admin 的话，你需要一些初始化设置。也就是说，你需要配置一个 go-admin 即一个项目实例需要的设置数据库或者也可以使用细目本身提供的sqlite3的体验数据库（部分功能不支持，如代码生成），目前推荐大家使用mysql数据库。
三.建议开发目录
├── project
│ ├── go-admin #后端go代码
│ ├── go-admin-ui #前端vue代码
四.修改配置
进入项目后台代码工作路径，
打开 /project/go-admin/config/settings.yml
修改配置#注释的地方：
database:
driver: mysql
source: root:123456@tcp(127.0.0.1:3306)/goadmindb?charset=utf8&parseTime=True&loc=Local&timeout=1000ms #数据配置 utf8改为utf8mb4 可以支持emoji表情
gen:
dbname: goadmindb #数据库名
frontpath: ../go-admin-ui/src #前端vue/js代码的生成路径 ..是指在go-admin同级目录的go-admin-ui里生成前端代码 参考上面一.建议开发目录
五.代码生成
1. 导入表
先在数据库里创建好自己的表信息
CREATE TABLE `hm_article` (
`article_id` int(10) unsigned NOT NULL AUTO_INCREMENT,
`article_sn` varchar(60) NOT NULL DEFAULT '' COMMENT '文章编号',
`navigate_id` int(10) unsigned NOT NULL COMMENT '栏目ID',
`title` varchar(200) NOT NULL COMMENT '标题',
`keywords` varchar(100) DEFAULT NULL COMMENT '标签',
`description` varchar(255) DEFAULT NULL COMMENT '摘要',
`image_url` varchar(200) DEFAULT NULL COMMENT '图片',
`video_url` varchar(200) DEFAULT NULL COMMENT '视频地址',
`content` text CHARACTER SET utf8mb4 COMMENT '内容',
`author` varchar(20) DEFAULT NULL COMMENT '文章作者',
`source` varchar(30) DEFAULT NULL COMMENT '文章来源',
`hits` int(10) unsigned DEFAULT '0' COMMENT '点击量',
`is_recommend` tinyint(1) unsigned DEFAULT '0' COMMENT '是否推荐 1:是 2:否',
`is_top` tinyint(4) unsigned DEFAULT '0' COMMENT '是否置顶 1:是 2:否',
`url` varchar(250) DEFAULT NULL COMMENT '文章链接',
`tags` varchar(255) DEFAULT NULL COMMENT '标签',
`comment_nums` int(11) NOT NULL DEFAULT '0' COMMENT '评论数量',
`status` tinyint(3) unsigned NOT NULL DEFAULT '1' COMMENT '1 正式发布 2 下架 3草稿',
`create_by` varchar(128) DEFAULT NULL,
`update_by` varchar(128) DEFAULT NULL,
`created_at` timestamp NULL DEFAULT NULL COMMENT '添加时间',
`updated_at` timestamp NULL DEFAULT NULL COMMENT '更新时间',
`deleted_at` timestamp NULL DEFAULT NULL,
PRIMARY KEY (`article_id`),
KEY `category_id` (`navigate_id`) USING BTREE,
KEY `hits` (`hits`) USING BTREE,
KEY `status` (`status`) USING BTREE
) ENGINE=InnoDB AUTO_INCREMENT=42 DEFAULT CHARSET=utf8 COMMENT='文章';
启动
go-admin，进入系统
打开以上程序画面，程序左侧有两个菜单，
系统工具-->代码生成-->导入
这里的导入是要将我们刚刚创建的表导入到系统中，这样我们就可以根据表来生成代码了。
2.编辑模板字段
确定后，表结构存储到了代码生成工具里，此时我们需要对导入数据进行编辑。
按需编辑选项，之后点击保存。
3. 生成代码和配置
注意
注意
注意
点击生成代码前,一定要在
四.修改配置里配置好前端的代码生成路径.
解释说明:
- 预览:可查看生成的代码
- 代码生成:生成不带权限的代码
- 代码生成[带权限]:生成带权限的代码
- 配置生成:菜单和api权限生成到db数据库里(注意:重复点击,会多次插入
sys_menu表里数据)
代码生成和代码生成[带权限]选择其一即可.
下面以代码生成[带权限]操作说明
注意
点击代码生成[带权限]后,会同时生成前端代码和后端代码到项目里,无须手动复制代码到项目
生成的文件
前端代码生成的文件:
/project/go-admin-ui/src/api/article.js
/project/go-admin-ui/srcsrc/views/article/index.vue
后端代码生成的文件:
/project/go-admin/apis/article/article.go
/project/go-admin/models/article.go
/project/go-admin/router/article.go
路由
路由里router.go里会自动插入文章的路由
/project/go-admin/router/router.go
// 无需认证的路由示例
func examplesNoCheckRoleRouter(r *gin.Engine) {
v1 := r.Group("/api/v1")
v1.GET("/nilcheckrole", nil)
// {{无需认证路由自动补充在此处请勿删除}}
}
// 需要认证的路由示例
func examplesCheckRoleRouter(r *gin.Engine, authMiddleware *jwtauth.GinJWTMiddleware) {
v1 := r.Group("/api/v1")
v1.GET("/checkrole", nil)
// {{认证路由自动补充在此处请勿删除}}
registerHmArticleRouter(v1, authMiddleware) #这里是新生成的文章路由代码
}
注意:
上面两处// {{认证路由自动补充在此处请勿删除}} 一定不可删除,这是插入路由的标识位
4.重启前后台服务
格式化前后台代码,重启前后台服务.
六.配置角色权限
进入角色管理->角色列表->修改
选择系统管理员，点击修改，勾选我们刚才添加的菜单以及api接口，保存。
刷新页面，刚刚授权的菜单就出来了。
七.操作内容管理
这个时候我们的内容管理已经添加完成了，里边已经具备了增删改查功能。
列表
新增
修改
删除
八.结束语
OK！，内容到这里已经介绍了开始第一个go-admin应用的全部过程，虽然图片居多，主要也是编码内容比较少，希望大家能够掌握，如在使用中遇到了什么问题都可以在qq群或者微信群中沟通交流！谢谢！
从哪里获得帮助：
如果你在阅读本教程的过程中有任何疑问，可以前往提交建议