Categorygithub.com/mss-boot-io/mss-boot-admin

modulepackage

0.4.8

Repository: https://github.com/mss-boot-io/mss-boot-admin.git

Documentation: pkg.go.dev

# README

mss-boot-admin

English | 简体中文

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

Swagger

Tutorial

Online documentation Video tutorial

Project address

Backend project Front-end project

🎬 Experience environment

Experience address

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

# 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

# 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

# Generate API interface information
go run main.go server -a

4. Start the backend service

# Start the backend service
go run main.go server

5. Start the front-end service

# 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.