Simple Admin

English | 中文

Introduction

Simple Admin is a powerful microservice framework for basic management. It is based on go-zero and supports several advanced features. It can help you to develop a microservice back-end management core in a short time.

Gorm version here

Feature

• State of The Art Development：Use latest back-end technology development such as ent, go-zero, casbin
• Fully support go-swagger: Write comment in api file and generate swagger doc easily
• Error handling: Handle error messages via one module
• International：support different languages show in the front-end via put locale path in the message
• Service Discover: use k8s endpoints to do service discovery and load-balance
• Authority Manage authority via Casbin, based on RBAC
• Other builtin concurrency control, adaptive circuit breaker, adaptive load shedding, auto-trigger, auto recover

Current Progress

• Login and Register
• Menu Management
• Role Management
• Role Authority
• User Management
• Operation log
• Service discovery
• Dictionary management
• Oauth management
• Fully support K8s
• Service Monitor
• Log collecting
• JWT blacklist
• Job Schedule
• Message queue
• Ent
• Backend CRUD generation
• Frontend CRUD code generation

The use of consul for service registration discovery in the early stage of the project is mainly to adapt to low-configuration servers. In the near future, the deployment process of K8s will be mainly optimized, and the project will mainly use K8s for deployment in the future.

Preview

Online preview

Online Preview Account: admin Password: simple-admin

Read Only, cannot register and modify

More

Documentation

Document

or running locally

cd docs
docsify serve .

• go-zero Document
• ant-design-vue Document

Preparation

• Golang and git - Project development environment
• Ent - Ent
• Mysql - Familiar with mysql database
• GORM - Familiar with GORM apis
• Casbin - Familiar with Casbin apis
• Go-swagger - Go-swagger document generation

Install and use

• Get the project code

git clone https://github.com/suyuan32/simple-admin-core.git

• Installation dependencies

cd simple-admin-core/

go mod tidy

• Edit api/etc/core.yaml rpc/etc/core.yaml

• Run

# run core api
cd api 
go run core.go -f etc/core.yaml

# run core rpc
cd rpc
go run core.go -f etc/core.yaml

• Build

go build -o core core.go

Change Log

CHANGELOG

Project

• Simple-Admin-ui
• Simple-Admin

How to contribute

You are very welcome to join！Raise an issue Or submit a Pull Request。

Pull Request:

1. Fork code!
2. Create your own branch: git checkout -b feat/xxxx
3. Submit your changes: git commit -am 'feat(function): add xxxxx'
4. Push your branch: git push origin feat/xxxx
5. submitpull request

Git Contribution submission specification

• reference vue specification (Angular)

  • feat Add new features
  • fix Fix the problem/BUG
  • style The code style is related and does not affect the running result
  • perf Optimization/performance improvement
  • refactor Refactor
  • revert Undo edit
  • test Test related
  • docs Documentation/notes
  • chore Dependency update/scaffolding configuration modification etc.
  • workflow Workflow improvements
  • ci Continuous integration
  • types Type definition file changes
  • wip In development

Community

Discard

Stars

Maintainer

@Ryan Su

License

MIT © Ryan-2022