{"id":22955322,"url":"https://github.com/mss-boot-io/mss-boot-admin","last_synced_at":"2025-08-13T02:32:43.110Z","repository":{"id":176219829,"uuid":"634856289","full_name":"mss-boot-io/mss-boot-admin","owner":"mss-boot-io","description":"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","archived":false,"fork":false,"pushed_at":"2024-10-29T08:36:58.000Z","size":734,"stargazers_count":45,"open_issues_count":12,"forks_count":10,"subscribers_count":2,"default_branch":"main","last_synced_at":"2024-10-29T09:47:22.539Z","etag":null,"topics":["admin","ant-design","ant-design-pro","antd","go","go-admin","mss-boot","mss-boot-admin"],"latest_commit_sha":null,"homepage":"https://docs.mss-boot-io.top","language":"Go","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":"mit","status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/mss-boot-io.png","metadata":{"files":{"readme":"README.md","changelog":null,"contributing":null,"funding":null,"license":"LICENSE","code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2023-05-01T11:39:10.000Z","updated_at":"2024-10-29T08:25:52.000Z","dependencies_parsed_at":"2023-12-08T11:28:56.927Z","dependency_job_id":"f1b429de-3abd-47cd-8c19-d18a81a36a6b","html_url":"https://github.com/mss-boot-io/mss-boot-admin","commit_stats":null,"previous_names":["mss-boot-io/mss-boot-admin-api","mss-boot-io/mss-boot-admin"],"tags_count":18,"template":false,"template_full_name":null,"repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mss-boot-io%2Fmss-boot-admin","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mss-boot-io%2Fmss-boot-admin/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mss-boot-io%2Fmss-boot-admin/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/mss-boot-io%2Fmss-boot-admin/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/mss-boot-io","download_url":"https://codeload.github.com/mss-boot-io/mss-boot-admin/tar.gz/refs/heads/main","host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":229726932,"owners_count":18114839,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["admin","ant-design","ant-design-pro","antd","go","go-admin","mss-boot","mss-boot-admin"],"created_at":"2024-12-14T16:28:59.851Z","updated_at":"2024-12-14T16:29:00.595Z","avatar_url":"https://github.com/mss-boot-io.png","language":"Go","funding_links":[],"categories":[],"sub_categories":[],"readme":"# mss-boot-admin\n\n[![Build Status](https://github.com/mss-boot-io/mss-boot-admin/workflows/CI/badge.svg)](https://github.com/mss-boot-io/mss-boot-admin)\n[![Release](https://img.shields.io/github/v/release/mss-boot-io/mss-boot-admin.svg?style=flat-square)](https://github.com/mss-boot-io/mss-boot-admin/releases)\n[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/mss-boot-io/mss-boot-admin)\n\nEnglish | [简体中文](./README.zh-CN.md)\n\n## Introduction\n\u003e 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. \n\u003e Features include multi-tenancy, roles, users, menus, internationalization, system configuration, permissions, virtual models, notifications, and dictionaries.\n\n[Beta Environment](https://admin-beta.mss-boot-io.top)\n\n[Swagger](https://mss-boot-io.github.io/mss-boot-admin/swagger.json)\n\n## Tutorial\n[Online documentation](https://docs.mss-boot-io.top)\n[Video tutorial](https://space.bilibili.com/597294782/channel/seriesdetail?sid=3881026)\n\n## Project address\n[Backend project](https://github.com/mss-boot-io/mss-boot-admin)\n[Front-end project](https://github.com/mss-boot-io/mss-boot-admin-antd)\n\n## 🎬 Experience environment\n[Experience address](https://admin-beta.mss-boot-io.top)\n\u003e Account: admin Password: 123456\n\n## ✨ Features\n- Support internationalization\n- Standard Restful API development specifications\n- RBAC permission management based on Casbin\n- Database storage based on Gorm\n- Middleware development based on Gin\n- Swagger document generation based on Gin\n- Support oauth2.0 third-party login\n- Support swagger document generation\n- Support multiple configuration sources (local files, embed, object storage s3, etc., databases supported by gorm, mongodb)\n- Support virtual model (dynamic configuration supports front-end and back-end functions)\n- Support database migration\n- Support microservice code generation\n\n## 📦 Built-in functions\n- User management: Users are system operators, and this function mainly completes the configuration of system users.\n- Role management: Role menu permission allocation, set role data range permission division by organization.\n- Menu management: Configure system menus, operation permissions, button permission identifiers, etc.\n- Option management: dynamically configure enumerations.\n- Model management: Manage virtual models.\n- System configuration: Manage the configuration of various environments.\n- Notice announcement: user notification message.\n- Task management: Manage scheduled tasks, including execution logs.\n- Internationalization management: Manage internationalization resources.\n- Microservice code generation: Generate microservice code based on templates.\n\n## 📦 Preparation\n- Install golang1.21+\n- Install mysql8.0+\n- Install nodejs18.16.0+\n\n## 📦 Quick start\n### 1. Download the project\n```shell\n# Download the backend project\ngit clone https://github.com/mss-boot-io/mss-boot-admin.git\n# Download the front-end project\ngit clone https://github.com/mss-boot-io/mss-boot-admin-antd.git\n```\n\n### 2. Migrate the database\n```shell\n# Enter the backend project\ncd mss-boot-admin\n# Configure database connection information (can be modified according to actual situation)\nexport DB_DSN=\"root:123456@tcp(127.0.0.1:3306)/mss-boot-admin-local?charset=utf8mb4\u0026parseTime=True\u0026loc=Local\"\n# Migrate the database\ngo run main.go migrate\n```\n\n### 3. Generate API interface information\n```shell\n# Generate API interface information\ngo run main.go server -a\n```\n\n### 4. Start the backend service\n```shell\n# Start the backend service\ngo run main.go server\n```\n\n### 5. Start the front-end service\n```shell\n# Enter the front-end project\ncd mss-boot-admin-antd\n# Install dependencies\nnpm install\n# Start the front-end service\nnpm run start\n```\n\n## 📨 Interaction\n\u003ctable\u003e\n   \u003ctr\u003e\n    \u003ctd\u003e\u003ca href=\"https://t.me/+318z6NULrw81N2E1\" target=\"_blank\"\u003e\u003cimg src=\"https://th.bing.com/th/id/OIP.lYN2s7Dv1a4pLAVUaXMCVgAAAA?rs=1\u0026pid=ImgDetMain\" width=\"180px\"\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://mss-boot-io.github.io/.github/images/wechat.jpg\" width=\"180px\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://mss-boot-io.github.io/.github/images/wechat-mp.jpg\" width=\"180px\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003cimg src=\"https://mss-boot-io.github.io/.github/images/qq-group.jpg\" width=\"200px\"\u003e\u003c/td\u003e\n    \u003ctd\u003e\u003ca href=\"https://space.bilibili.com/597294782/channel/seriesdetail?sid=3881026\u0026ctype=0\"\u003emss-boot-io\u003c/a\u003e\u003c/td\u003e\n  \u003c/tr\u003e\n  \u003ctr\u003e\n    \u003ctd\u003etelegram🔥🔥🔥\u003c/td\u003e\n    \u003ctd\u003eWeChat\u003c/td\u003e\n    \u003ctd\u003eWeChat MP🔥🔥🔥\u003c/td\u003e\n    \u003ctd\u003e\u003ca target=\"_blank\" href=\"https://shang.qq.com/wpa/qunwpa?idkey=0f2bf59f5f2edec6a4550c364242c0641f870aa328e468c4ee4b7dbfb392627b\"\u003e\u003cimg border=\"0\" src=\"https://pub.idqqimg.com/wpa/images/group.png\" alt=\"mss-boot技术交流群\" title=\"mss-boot技术交流群\"\u003e\u003c/a\u003e\u003c/td\u003e\n    \u003ctd\u003ebilibili🔥🔥🔥\u003c/td\u003e\n  \u003c/tr\u003e\n\u003c/table\u003e\n\n## 💎 Contributors\n\n\u003cspan style=\"margin: 0 5px;\" \u003e\u003ca href=\"https://github.com/lwnmengjing\" \u003e\u003cimg src=\"https://images.weserv.nl/?url=avatars.githubusercontent.com/u/12806223?s=64\u0026v=4\u0026w=60\u0026fit=cover\u0026mask=circle\u0026maxage=7d\" /\u003e\u003c/a\u003e\u003c/span\u003e\n\u003cspan style=\"margin: 0 5px;\" \u003e\u003ca href=\"https://github.com/wangde7\" \u003e\u003cimg src=\"https://images.weserv.nl/?url=avatars.githubusercontent.com/u/56955959?s=64\u0026v=4\u0026w=60\u0026fit=cover\u0026mask=circle\u0026maxage=7d\" /\u003e\u003c/a\u003e\u003c/span\u003e\n\u003cspan style=\"margin: 0 5px;\" \u003e\u003ca href=\"https://github.com/mss-boot\" \u003e\u003cimg src=\"https://images.weserv.nl/?url=avatars.githubusercontent.com/u/109259065?s=64\u0026v=4\u0026w=60\u0026fit=cover\u0026mask=circle\u0026maxage=7d\" /\u003e\u003c/a\u003e\u003c/span\u003e\n\u003cspan style=\"margin: 0 5px;\" \u003e\u003ca href=\"https://github.com/wxip\" \u003e\u003cimg src=\"https://images.weserv.nl/?url=avatars.githubusercontent.com/u/25923931?s=64\u0026v=4\u0026w=60\u0026fit=cover\u0026mask=circle\u0026maxage=7d\" /\u003e\u003c/a\u003e\u003c/span\u003e\n\n## JetBrains open source certificate support\n\nThe `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.\n\n\u003ca href=\"https://www.jetbrains.com/?from=kubeadm-ha\" target=\"_blank\"\u003e\u003cimg src=\"https://raw.githubusercontent.com/panjf2000/illustrations/master/jetbrains/jetbrains-variant-4.png\" width=\"250\" align=\"middle\"/\u003e\u003c/a\u003e\n\n## 🤝 Special thanks\n\n1. [ant-design](https://github.com/ant-design/ant-design)\n2. [ant-design-pro](https://github.com/ant-design/ant-design-pro)\n3. [umi](https://umijs.org)\n4. [gin](https://github.com/gin-gonic/gin)\n5. [casbin](https://github.com/casbin/casbin)\n6. [gorm](https://github.com/jinzhu/gorm)\n7. [gin-swagger](https://github.com/swaggo/gin-swagger)\n8. [jwt-go](https://github.com/dgrijalva/jwt-go)\n9. [oauth2](https://pkg.go.dev/golang.org/x/oauth2)\n\n## 🤟 Sponsor Us\n\nIf you think this project helped you, you can buy a glass of juice for the author to show encouragement 🍹\n\n\u003cimg class=\"no-margin\" src=\"https://mss-boot-io.github.io/.github/images/sponsor-us.jpg\"  height=\"400px\"  alt=\"Sponsor Us\"\u003e\n\n## 🔑 License\n\n[MIT](https://github.com/mss-boot-io/mss-boot-admin/blob/main/LICENSE)\n\nCopyright (c) 2024 mss-boot-io","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmss-boot-io%2Fmss-boot-admin","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Fmss-boot-io%2Fmss-boot-admin","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Fmss-boot-io%2Fmss-boot-admin/lists"}