开源软件名称：

开源软件地址：

开源软件介绍：

GinSkeleton-Admin (后端部分)

在线演示地址: GinSkeleton-Admin

系统说明

1.本部分为后端接口部分,基于 GinSkeleton(v1.5.xx) 开发.
2.前端界面部分,基于 Iview(v4.6.1)开发, 界面系统仓库地址 .
3.本系统已经集成的功能模块是一个企业级系统必备的基础、通用功能模块，请勿删除.
4.如发现基础功能有问题，请及时向官方反馈，提交 Issue | PR，由官方统一更新、升级, 基础模块前后端已经做了目录分类,后续可直接更新相关文件夹.
5.Admin 系统只支持 mysql（5.x-8.x 测试100% 通过）, 其他数据库目前暂未适配.
6.admin 系统后台菜单目前只支持 2 级,暂不支持 3 级，主要是因为权限模块做树形化权限继承、对接 Casbin 同样以树形继承关系对接,存在比较复杂的逻辑，如果菜单层级太多，当底层节点的上下级关系变化太大时，会产生更加复杂的权限继承关系重新设置,最终会导致系统基础功能不稳定，3 级树形菜单将在下一个大版本增加，短期不会有 3 级菜单.

前言

1.使用本系统之前请了解GinSkeleton 主线版本的主要功能, 主线版本仓库地址 .

Admin系统已经集成的基础功能模块介绍

1.系统菜单：

1.1 后台设置的菜单+绑定的按钮(例如：增、删、改、查), 凡是没有设置为禁用状态，都对应前端的一个视图(页面地址)+界面按钮.
1.2 系统菜单 可以在 权限分配 多次分配给组织机构(公司、部门、岗位)节点,凡是挂接在特定岗位底下的用户，都会继承已分配的视图+按钮元素.
1.3 系统菜单 新增界面默认会有四个按钮,分别是 增、删、改、查, 每个按钮都对应一个后端接口地址，当该菜单被分配给组织机构节点时,按钮对应的接口地址会自动绑定到 casbin 模块对应的表,如果一开始菜单没有设置正确相关按钮、接口地址，请修改按钮对应的地址，重新分配权限即可.

2.用户管理：

管理用户账号、登录 token 认证。

3.组织机构：

企业以集团、分公司、部门、岗位等，按照层级划分(树形划分),所形成的垂直管理体系.

4.岗位成员：

用于将用户配置在组织机构树设置的岗位, 使用户与组织机构建立关联关系, 在 权限分配 菜单为特定组织机构分配权限后，该用户则自动垂直继承权限.

5.权限分配：

5.1 权限可以分配给岗位、也可以分配给部门、甚至可以分配给公司,岗位会继承他的上一级部门的权限，部门会继续继承他的上一级公司的权限，而同一个岗位底下的用户则拥有该岗位以及继承后的所有权限.
5.2 一般来说分配权限时，优先考虑分配给岗位，一个部门共同的权限分配给他们的上级部门，这样部门底下的所有岗位就会集成公共权限.

本系统超级管理员所在岗位：

6.权限分析：

由于我们以继承方式做权限的分配与管控，那么当用户的权限来源比较多的时候，无法很快定位权限来源, 此时你可以通过权限分析来定位它的来源.

7.按钮设置：

每一个按钮都一个名称和英文代码,按钮的英文代码是后端统一规定，前端开发时向后端获取,后端才能精准控制按钮权限.此外，每个按钮点击时都对应一个后端接口请求,本质上前端的按钮 ≈ 后端的api接口

运行 Admin 系统接口服务

//1.还原数据库：    //1.1 请将备份文件复制到桌面，相关路径：./database/db_ginskeleton.7z, 请解压后使用 sqlyog 等 mysql 客户端进行快速还原.      //1.2 如果需要修改数据库名称,打开以上文件开头部自行修改数据库名称即可.    //2.ginskeleton-admin 项目配置文件 config/gorm_v2.yml 配置数据库账号、密码、端口等：//3.使用 goland 打开本项目， cmd/web/main.go 文件通过鼠标右键 运行，或者 main 函数处显示的箭头启动即可

业务模块开发指南

1.我们通过1个实例带大家了解一个最基本的模块是如何进行开发、前后端对接起来的.
2.业务开发指南

版本更新日志

V1.0.34 (2022-03-22)

搭配的前端版本：>= V1.0.25

• 细节完善

• 1.gorm 相关的回调函数增强条件判断, 加强程序严谨性。
• 2.自带数据库文件更新, 给字段设置了默认值.

V1.0.33 (2022-02-27)

搭配的前端版本：>= V1.0.25

• 1.token 缓存到 redis 逻辑加强严谨性.

V1.0.32 (2022-02-10)

搭配的前端版本：>= V1.0.25

• bug 修复

• 1.大批量分配权限时会出现部分失败的情况。
• 2.老版本增量升级：app/model/users.go 139 行 对应的函数 OauthCheckTokenIsOk 覆盖老版本即可.

V1.0.31 (2022-02-05)

搭配的前端版本：>= V1.0.25

• bug 修复

• 1.大批量分配权限时会出现部分失败的情况，老版本 admin 升级最快捷方式：直接使用最新版本 app/model/auth/auth_menu_assign.go 文件覆盖同名文件即可.

• 更新

• 1.自带数据库文件更新, 为大批量操作的相关表字段创建索引，老版本 admin 系统可忽略，与上一条 bug 修复无依赖关系.

V1.0.29 (2022-01-25)

搭配的前端版本：>= V1.0.25

• 新增

• 1.用户 token 缓存到 redis 功能,如果项目使用了 redis , 请直接在 config/config.yml 文件中设置 Token.IsCacheToRedis = 1
• 2.项目初始化时增加设置信任代理服务器ip列表，gin(v1.7.7)新增功能,详情参见相关配置项说明.
• 3.新增个人信息自主编辑功能，方便小权限账号编辑自己的账号密码.

• 更新

• 1.配置文件缓存时加锁,避免开发者频繁注册时,程序出现提示。
• 2.用户token鉴权时,如果开启了redis缓存功能，优先查询redis.
• 3.自带数据库文件更新，以便支持新增的个人信息编辑功能.
• 4.所有底层依赖包更新至最新版.

V1.0.28 (2022-02-27)

搭配的前端版本：>= V1.0.22

• 1.token 缓存到 redis 逻辑加强严谨性.

V1.0.27 (2021-12-20)

搭配的前端版本：>= V1.0.22

• 1.错误日志记录时同时记录调用链信息。
• 2.rabbitmq 消息队列增加消息延迟发送功能.
• 3.关于 rabbitmq 消息延迟使用请参考新版在线文档.

V1.0.26 (2021-11-28)

搭配的前端版本：>= V1.0.22

• 1.引入表单参数验证器全局翻译器,简化代码书写,提升开发效率.

V1.0.25 (2021-11-26)

搭配的前端版本：>= V1.0.22

• 1.将主线版本更新的内容合并至 admin-backend 版本.
• 2.详细更新日志参见主线版本(v1.5.29)的更新日志.

V1.0.24 (2021-10-24)

搭配的前端版本：>= V1.0.20

• 1.修复bug：添加系统菜单时，接口参数有空值时,会导致存储在数据库的个别字段为NULL.

V1.0.23 (2021-10-11)

搭配的前端版本：>= V1.0.14

• 1.更新token刷新接口逻辑，解决认证中间件被加载2次的小bug.

V1.0.22 (2021-09-13)

搭配的前端版本：>= V1.0.14

• 1.更新token刷新接口逻辑，支持在过期24小时内使用旧token换取新token.
• 2.验证码自定义验证逻辑部分完善代码严谨性.

V1.0.21 (2021-08-02)

搭配的前端版本：>= V1.0.14

• 1.升级项目依赖版本至最新版
• 2.修正一处单词拼写错误.

V1.0.20 (2021-07-09)

搭配的前端版本：>= V1.0.14

• 1.删除一处调试语句.

V1.0.19 (2021-06-29)

搭配的前端版本：>= V1.0.14

• 1.修正自带数据库(./database/db_ginskeleton_20210629.7z)——系统菜单表 tb_auth_system_menu 菜单排序字段 sort 为 string 的 bug, 导致菜单排序没有按照数字大小排序.
• 2.系统菜单表 tb_auth_system_menu , 菜单排序字段 sort 如果手动指定值，则父级值必须 > 子级菜单值，子级之间则没有任何限制.
• 3.本次 bug 也可以手动快速修复，自行修改已导入数据库表 tb_auth_system_menu 的 sort 字段类型为 int 即可.

V1.0.18 (2021-06-18)

搭配的前端版本：>= V1.0.14

• 1.修正常量定义处日期格式单词书写错误问题.
• 2.一个用户同时允许最大在线的token, 查询时优先按照 expires_at 倒序排列,便于不同系统间对接时,那种长久有效的token不会被"踢"下线.

V1.0.17 (2021-05-29)

搭配的前端版本：>= V1.0.14

• 1.账号密码使用验证码中间件代替原来的异步逻辑,避免异步验证验证码时用户使用postman请求接口时绕过了验证码校验机制.

V1.0.16 (2021-05-28)

搭配的前端版本：V1.0.13

• 1.针对小权限账号启动本项目时，涉及到文件上传，自动创建目录时，调整文件夹权限为 os.ModePerm.

V1.0.15 (2021-05-12)

• 1.修复数据查询时间格式化书写错误的bug,mysql日期时间格式化由 %Y-%m-%d %h:%i:%s 修复为 ：%Y-%m-%d %H:%i:%s ，由于 %h 小写导致了时间比实际滞后8小时.

V1.0.14 (2021-05-04)

• 1.cobra增加创建子目录的示例代码.

V1.0.12 (2021-04-26)

• 1.表单参数验证器独立为：api、web,进一步简化项目代码比较多时，程序的简洁性.
• 2.token生成时计算时间戳mysql调整为go函数计算,避免mysql函数 FROM_UNIXTIME 参数最大支持21亿的局限性.
• 3.ws删除了原有的部分业务代码,使程序保持最简洁性.
• 4.项目骨架依赖的核心包升级至最新版.

V1.0.11 (2021-04-16)

• 1.修复bug:在mysql8高版本系列，limit 后面的参数是浮点型查询不到数据。
• 2.更新自带数据库，修改oauth_token表的token字段长度为600.
• 3.更新sql结果树形化包版本，以便支持更多复杂的sql查询结果树形化.

V1.0.10 (2021-04-02)

• 1.系统菜单主表与子表数据接受方式以及后续的总体逻辑更新.

V1.0.01 (2021-03-27)

• Bug修复:
• 1.系统菜单添加按钮失败的错误.
  1.1 涉及到的文件：app/model/auth/auth_system_menu_button.go
  1.2 app/service/auth_system_menu/auth_organization_post_service.go
  2.快速升级、更新的办法：可直接使用官方仓库最新代码覆盖自带代码即可.

V1.0.00 (2021-03-20)

1.GinSkeleton-Admin 系统 v1.0.0 版本发布.