README.zh-CN.md

mss-boot-admin

English | 简体中文

简介

基于Gin + React + Atn Design v5 + Umi v4 + mss-boot 的前后端分离权限管理系统，系统初始化只需要一个环境变量即可启动系统， 系统支持多种配置源，迁移指令可以让初始化数据库信息更简单，服务指令可以很方便启动服务。

Beta环境

Swagger

教程

在线文档 视频教程

项目地址

后端项目 前端项目

🎬 体验环境

体验地址

账号：admin 密码：123456

✨ 特性

• 支持国际化
• 标准Restful API开发规范
• 基于Casbin的RBAC权限管理
• 基于Gorm的数据库存储
• 基于Gin的中间件开发
• 基于Gin的Swagger文档生成
• 支持oauth2.0第三方登录
• 支持swagger文档生成
• 支持多种配置源(本地文件、embed、对象存储s3等、gorm支持的数据库、mongodb)
• 虚拟模型支持(动态配置支持前后端功能)
• 支持数据库迁移
• 支持微服务代码生成

📦 内置功能

• 用户管理: 用户是系统操作者，该功能主要完成系统用户配置。
• 角色管理: 角色菜单权限分配、设置角色按机构进行数据范围权限划分。
• 菜单管理: 配置系统菜单，操作权限，按钮权限标识等。
• 选项管理: 动态配置枚举。
• 模型管理: 管理虚拟模型。
• 系统配置: 管理各种环境的配置。
• 通知公告: 用户通知消息。
• 任务管理: 管理定时任务，包括执行日志。
• 国际化管理: 管理国际化资源。
• 微服务代码生成: 根据模板生成微服务代码。

📦 准备工作

• 安装golang1.21+
• 安装mysql8.0+
• 安装nodejs18.16.0+

📦 快速开始

1. 下载项目

# 下载后端项目
git clone https://github.com/mss-boot-io/mss-boot-admin.git
# 下载前端项目
git clone https://github.com/mss-boot-io/mss-boot-admin-antd.git

2. 迁移数据库

# 进入后端项目
cd mss-boot-admin
# 配置数据库连接信息(可根据实际情况修改)
export DB_DSN="root:123456@tcp(127.0.0.1:3306)/mss-boot-admin-local?charset=utf8mb4&parseTime=True&loc=Local"
# 迁移数据库
go run main.go migrate

3. 生成API接口信息

# 生成api接口信息
go run main.go server -a

4. 启动后端服务

# 启动后端服务
go run main.go server

5. 启动前端服务

# 进入前端项目
cd mss-boot-admin-antd
# 安装依赖
npm install
# 启动前端服务
npm run start

📨 互动

				mss-boot-io
telegram🔥🔥🔥	微信	公众号🔥🔥🔥		哔哩哔哩🔥🔥🔥

💎 贡献者

JetBrains 开源证书支持

mss-boot-io 项目一直以来都是在 JetBrains 公司旗下的 GoLand 集成开发环境中进行开发，基于 free JetBrains Open Source license(s) 正版免费授权，在此表达我的谢意。

🤝 特别感谢

1. ant-design
2. ant-design-pro
3. umi
4. gin
5. casbin
6. gorm
7. gin-swagger
8. jwt-go
9. oauth2

🤟 打赏

如果你觉得这个项目帮助到了你，你可以帮作者买一杯果汁表示鼓励 🍹

🔑 License

MIT

Copyright (c) 2024 mss-boot-io