https://github.com/mss-boot-io/mss-boot-admin
A front-end and back-end separation authority management system based on Gin, React, Ant Design v5, Umi v4, and mss-boot. Initialized with an environment variable, it supports multiple configuration sources, simplifies database setup, and eases service startup. Features include multi-tenancy, roles, users, menus, internationalization, system config
https://github.com/mss-boot-io/mss-boot-admin
admin ant-design ant-design-pro antd go go-admin mss-boot mss-boot-admin
Last synced: 5 months ago
JSON representation
A front-end and back-end separation authority management system based on Gin, React, Ant Design v5, Umi v4, and mss-boot. Initialized with an environment variable, it supports multiple configuration sources, simplifies database setup, and eases service startup. Features include multi-tenancy, roles, users, menus, internationalization, system config
- Host: GitHub
- URL: https://github.com/mss-boot-io/mss-boot-admin
- Owner: mss-boot-io
- License: mit
- Created: 2023-05-01T11:39:10.000Z (about 2 years ago)
- Default Branch: main
- Last Pushed: 2024-10-29T08:36:58.000Z (7 months ago)
- Last Synced: 2024-10-29T09:47:22.539Z (7 months ago)
- Topics: admin, ant-design, ant-design-pro, antd, go, go-admin, mss-boot, mss-boot-admin
- Language: Go
- Homepage: https://docs.mss-boot-io.top
- Size: 717 KB
- Stars: 45
- Watchers: 2
- Forks: 10
- Open Issues: 12
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# mss-boot-admin
[](https://github.com/mss-boot-io/mss-boot-admin)
[](https://github.com/mss-boot-io/mss-boot-admin/releases)
[](https://github.com/mss-boot-io/mss-boot-admin)
English | [简体中文](./README.zh-CN.md)
## Introduction
> A front-end and back-end separation authority management system based on Gin, React, Ant Design v5, Umi v4, and mss-boot. Initialized with an environment variable, it supports multiple configuration sources, simplifies database setup, and eases service startup.
> Features include multi-tenancy, roles, users, menus, internationalization, system configuration, permissions, virtual models, notifications, and dictionaries.
[Beta Environment](https://admin-beta.mss-boot-io.top)
[Swagger](https://mss-boot-io.github.io/mss-boot-admin/swagger.json)
## Tutorial
[Online documentation](https://docs.mss-boot-io.top)
[Video tutorial](https://space.bilibili.com/597294782/channel/seriesdetail?sid=3881026)
## Project address
[Backend project](https://github.com/mss-boot-io/mss-boot-admin)
[Front-end project](https://github.com/mss-boot-io/mss-boot-admin-antd)
## 🎬 Experience environment
[Experience address](https://admin-beta.mss-boot-io.top)
> Account: admin Password: 123456
## ✨ Features
- Support internationalization
- Standard Restful API development specifications
- RBAC permission management based on Casbin
- Database storage based on Gorm
- Middleware development based on Gin
- Swagger document generation based on Gin
- Support oauth2.0 third-party login
- Support swagger document generation
- Support multiple configuration sources (local files, embed, object storage s3, etc., databases supported by gorm, mongodb)
- Support virtual model (dynamic configuration supports front-end and back-end functions)
- Support database migration
- Support microservice code generation
## 📦 Built-in functions
- User management: Users are system operators, and this function mainly completes the configuration of system users.
- Role management: Role menu permission allocation, set role data range permission division by organization.
- Menu management: Configure system menus, operation permissions, button permission identifiers, etc.
- Option management: dynamically configure enumerations.
- Model management: Manage virtual models.
- System configuration: Manage the configuration of various environments.
- Notice announcement: user notification message.
- Task management: Manage scheduled tasks, including execution logs.
- Internationalization management: Manage internationalization resources.
- Microservice code generation: Generate microservice code based on templates.
## 📦 Preparation
- Install golang1.21+
- Install mysql8.0+
- Install nodejs18.16.0+
## 📦 Quick start
### 1. Download the project
```shell
# Download the backend project
git clone https://github.com/mss-boot-io/mss-boot-admin.git
# Download the front-end project
git clone https://github.com/mss-boot-io/mss-boot-admin-antd.git
```
### 2. Migrate the database
```shell
# Enter the backend project
cd mss-boot-admin
# Configure database connection information (can be modified according to actual situation)
export DB_DSN="root:123456@tcp(127.0.0.1:3306)/mss-boot-admin-local?charset=utf8mb4&parseTime=True&loc=Local"
# Migrate the database
go run main.go migrate
```
### 3. Generate API interface information
```shell
# Generate API interface information
go run main.go server -a
```
### 4. Start the backend service
```shell
# Start the backend service
go run main.go server
```
### 5. Start the front-end service
```shell
# Enter the front-end project
cd mss-boot-admin-antd
# Install dependencies
npm install
# Start the front-end service
npm run start
```
## 📨 Interaction
mss-boot-io
telegram🔥🔥🔥
WeChat
WeChat MP🔥🔥🔥
bilibili🔥🔥🔥
## 💎 Contributors
## JetBrains open source certificate support
The `mss-boot-io` project has always been developed in the GoLand integrated development environment under JetBrains, based on the **free JetBrains Open Source license(s)** genuine free license. I would like to express my gratitude.
## 🤝 Special thanks
1. [ant-design](https://github.com/ant-design/ant-design)
2. [ant-design-pro](https://github.com/ant-design/ant-design-pro)
3. [umi](https://umijs.org)
4. [gin](https://github.com/gin-gonic/gin)
5. [casbin](https://github.com/casbin/casbin)
6. [gorm](https://github.com/jinzhu/gorm)
7. [gin-swagger](https://github.com/swaggo/gin-swagger)
8. [jwt-go](https://github.com/dgrijalva/jwt-go)
9. [oauth2](https://pkg.go.dev/golang.org/x/oauth2)
## 🤟 Sponsor Us
If you think this project helped you, you can buy a glass of juice for the author to show encouragement 🍹
## 🔑 License
[MIT](https://github.com/mss-boot-io/mss-boot-admin/blob/main/LICENSE)
Copyright (c) 2024 mss-boot-io