1 Star 0 Fork 54

飘渺 / GinSkeleton-Admin-Backend

加入 Gitee
与超过 1200万 开发者一起发现、参与优秀开源项目,私有仓库也完全免费 :)
免费加入
克隆/下载
README.md 4.62 KB
一键复制 编辑 原始数据 按行查看 历史
飘渺 提交于 2021-03-22 23:38 . 文档更新

GinSkeleton-Admin (后端部分)

预览图

在线演示地址: GinSkeleton-Admin

系统说明

1.本部分为后端接口部分,基于 GinSkeleton(v1.5.10) 开发.
2.前端界面部分,基于 Iview(v4.5.0)开发, 界面系统仓库地址 .
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.权限分配:

权限可以分配给岗位、也可以分配给部门、甚至可以分配给公司,岗位会继承他的上一级部门的权限,部门会继续继承他的上一级公司的权限,而同一个岗位底下的用户则拥有该岗位以及继承后的所有权限.
权限继承关系
本系统超级管理员所在岗位:
超级管理员

6.权限分析:

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

7.按钮设置:

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

运行 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.业务开发指南

版本更新日志

2021-03-20

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

Go
1
https://gitee.com/seedlings_2020/gin-skeleton-admin-backend.git
git@gitee.com:seedlings_2020/gin-skeleton-admin-backend.git
seedlings_2020
gin-skeleton-admin-backend
GinSkeleton-Admin-Backend
master

搜索帮助