## 介绍
### 项目地址 : gitee: https://gitee.com/kevn/gsadmin/tree/master
### 项目地址 : github:https://github.com/sonhineboy/gsadmin
<div align=center>
<img src="https://kevn.gitee.io/gsadmindoc/img/gslogo.png" width=20%><br/>
<div style="padding: 20px 0"><a href="https://kevn.gitee.io/gsadmindoc">文档</a> | <a href="https://gsadmin.suiyidian.cn/">演示</a></div>
<a href='https://gitee.com/kevn/gsadmin' target="_blank">
<img src='https://gitee.com/kevn/gsadmin/badge/star.svg?theme=dark' alt='star' style="vertical-align: middle">
</a>
<a href='https://github.com/sonhineboy/gsadmin' target="_blank">
<img src='https://img.shields.io/github/stars/sonhineboy/gsadmin.svg?logo=GitHub' alt='star' style="vertical-align: middle">
</a>
<a href='https://gin-gonic.com/' target="_blank">
<img src='https://img.shields.io/badge/go-gin-blue?logo=go' alt='star' style="vertical-align: middle">
</a>
<a href='https://lolicode.gitee.io/scui-doc/' target="_blank">
<img src='https://img.shields.io/badge/vue-scui-yellow' alt='star' style="vertical-align: middle">
</a>
</div>
GS Admin=gin+scui 它是golang 开发的一个企业级后台。遵循MIT开源协议。前端框架是scui,SCUI基于 Vue3、elementPlus 持续性的提供独家组件和丰富的业务模板帮助你快速搭建企业级中后台前端任务。后端框架是gin,Gin是一个golang的微框架,封装比较优雅,具有快速灵活,容错方便等特点。内置了权限管理、用户管理等基础模块儿,还支持了事件服务,方便业务解耦。后续会根据用户的反馈更新内容!
## 项目特性
- 开箱即用的权限控制系统,基于角色用户控制,简洁灵活,控制用户权限更简洁、方便。
- SCUI基于 Vue3、elementPlus 持续性的提供独家组件和丰富的业务模板帮助你快速搭建企业级中后台前端任务。
- 项目目录分层清晰, 项目模式结构清晰, 包名语义化, 让你更加容易理解目录结构, 读懂代码更加方便!
- 开箱即用,本项目包含了基本的用户管理、权限管理、菜单管理等基础模块,让您专注自己的业务逻辑。
- 系统内置事件服务,让您更专注业务主线,事件监听者处理额外业务,系统解耦更方便。
- 服务端基于Gin框架开发,Gin是一个golang的微框架,封装比较优雅,具有快速灵活,容错方便等特
## 快速开始
<b>一共分三步</b>:
1、 拉代码
2、 部署后端服务
3、 部署前端代码
```go
#第一步
git clone https://gitee.com/kevn/gsadmin.git
#第二步
#服务端
cd {项目目录}/service && go mod tidy
#配置配置文件,config.yaml
#初始化数据 {项目目录}/service/databases/*.sql 执行里面的sql
go run main.go
#第三步
#web端
cd {项目目录}/web/scui && npm install
# 启动项目(开发模式)
npm run serve
```
> 演示账号密码:test/123456
> 注意:goland 的环境必须配置好,数据不要忘记初始化
## 加入贡献
GS Admin 是一个开源项目,一个开源项目的发展离不开开源社区的力量支持,如果您希望参与 GS Admin 的开发,可以先从 [issues](https://gitee.com/kevn/gsadmin/issues) 开始,通常来说会有以下的一些步骤:
- 1.关注 [issues](https://gitee.com/kevn/gsadmin/issues) 的动态,评论回复帮助提出疑问的用户;
- 2.根据 [issues](https://gitee.com/kevn/gsadmin/issues) 的内容,找寻根据自己当前对项目的了解程度,去修复力所能及的 BUG 或实现功能,并以 Pull Request 的形式提交至 [kevn/gsadmin](https://gitee.com/kevn/gsadmin) 仓库;
- 3.关注自己提交 Pull Request 的进度和状态,以推动您的 Pull Request 尽快合入主仓库;
- 4.对其他人提交的 Pull Request 进行 Code Review,并给出您的建议和看法。
- 5.坚持并持续进行上述步骤。