Skip to content

Latest commit

 

History

History
148 lines (108 loc) · 5.37 KB

README.zh-CN.md

File metadata and controls

148 lines (108 loc) · 5.37 KB

mss-boot-admin-antd

Build Status Release License

English | 简体中文

简介

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

教程

在线文档 视频教程

项目地址

后端项目 前端项目

🎬 体验环境

体验地址

账号: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
微信 公众号🔥🔥🔥 mss-boot技术交流群 哔哩哔哩🔥🔥🔥

💎 贡献者

JetBrains 开源证书支持

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

🤝 特别感谢

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

🔑 License

MIT

Copyright (c) 2024 mss-boot-io