# GinAdmin
这个项目是以Gin框架为基础搭建的后台管理平台,虽然很多人都认为go是用来开发高性能服务端项目的,但是也难免有要做web管理端的需求,总不能再使用别的语言来开发吧。所以整合出了GinAdmin项目,请大家多提意见指正!
## GitHub
* https://github.com/gphper/ginadmin
## 依赖
* golang > 1.8
## 依赖
* Gin
* BootStrap
* LayUi
* WebUpload
## 使用文档
- [开始使用](#开始使用)
- [项目目录](#结构)
- [分页](#分页)
- [日志](#日志)
- [数据库](#数据库)
- [定时任务](#定时任务)
- [配置文件](#配置文件)
- [模板页面](#模板页面)
- [用户权限](#用户权限)
### <a name="开始使用">开始使用</a>
1. git 克隆地址
```
git clone https://github.com/gphper/ginadmin.git
```
2. 下载依赖包
```go
go mod download
```
3. 配置 `conf/config.ini`文件
```
[mysql]
username=root
password=123456
database=db_beego
host=127.0.0.1
port=3306
max_open_conn=50
max_idle_conn=20
[session]
session_name=gosession_id
[base]
port=:8091
```
### <a name="结构">项目目录</a>
```
|--api // Api接口控制器
|--comment // 封装的公共方法
|--conf // 配置文件
|--controllers // Admin控制器存在目录
|--logs // 日志存放目录
|--middleware //中间件
|--models //Gorm中的model类
|--router //自定义路由目录
|--statics //css js等静态文件目录
|--uploadfile //上传文件目录
|--views //视图模板目录
```
### <a name="分页">分页</a>
1. 使用 `comment/util.go` 里面的 `PageOperation` 进行分页
```go
adminDb := models.Db.Table("admin_users").Select("nickname","username").Where("uid != ?", 1)
adminUserData := comment.PageOperation(c, adminDb, 1, &adminUserList)
```
2. 在html中使用
```go
{{ .adminUserData.PageHtml }}
```
### <a name="日志">日志</a>
1. 自定义日志 在 `comment/loggers` 目录下新建logger
```
参考 userlog.go 文件
```
2. 调用自定义的的logger写日志
```go
loggers.UserLogger.Info("无法获取网址",
zap.String("url", "http://www.baidu.com"),
zap.Int("attempt", 3),
zap.Duration("backoff", time.Second),)
```
### <a name="数据库">数据库</a>
1. 数据库迁移,将定义好的model填充写到下面的 `AutoMigrate` 方法中
```go
Db.Set("gorm:table_options", "ENGINE=InnoDB").AutoMigrate(&AdminUsers{},&AdminGroup{})
```
2. 数据填充,将数据写入到 `models\default.go` 下面的 `FillData` 中
### <a name="定时任务">定时任务</a>
- 在 `comment/cron/cron.go` 添加定时执行任务
### <a name="配置文件">配置文件</a>
1. 现在 `conf/conf.go` 添加配置项的 struct 类型,例如
```go
type AppConf struct {
BaseConf `ini:"base"`
}
type BaseConf struct {
Port string `ini:"port"`
}
```
2. 在 `conf/conf.ini` 添加配置信息
```
[base]
port=:8091
```
3. 在代码中调用配置文件的信息
```go
conf.App.BaseConf.Port
```
### <a name="模板页面">模板页面</a>
- 所有的后台模板都写到 `views/template` 目录下面,并且分目录存储,调用时按照 `目录/模板名称` 的方式调用
### <a name="用户权限">用户权限</a>
- 菜单权限定义到 `comment/menu/menu.go` 文件下,定义完之后在用户组管理里面编辑权限
- 在控制器中可用从 `gin.context` 获取权限
```go
privs,_ := c.Get("userPrivs")
```
- template 中判断权限的函数 `judgeContainPriv` 定义在 `comment/template/default.go` 文件下
```go
"judgeContainPriv": func(privMap map[string]interface{},priv string)bool {
//判断权限是all的全通过
_,o :=privMap["all"]
if o {
return true
}
_,ok := privMap[priv]
return ok
},
```
第 1 条附言 ·
增加docker-compose支持
第 2 条附言 ·
增加了casbin权限管理,在分支查看
第 3 条附言 ·
添加命令行快捷键