Skip to content

Commit

Permalink
Merge pull request #25 from nicelizhi/dev
Browse files Browse the repository at this point in the history
many update
  • Loading branch information
xxl4 authored Nov 3, 2023
2 parents 1fa17cb + 95fac6c commit 2ed6444
Show file tree
Hide file tree
Showing 5 changed files with 108 additions and 15 deletions.
1 change: 1 addition & 0 deletions .github/workflows/build.yml
Original file line number Diff line number Diff line change
Expand Up @@ -5,6 +5,7 @@ on:
branches: [ main ]
paths-ignore:
- .github/**
- docs/**
pull_request:
branches: [ main ]

Expand Down
90 changes: 89 additions & 1 deletion README.md
Original file line number Diff line number Diff line change
@@ -1 +1,89 @@
# easy-admin

# easy-admin
[![Build Status](https://github.com/nicelizhi/easy-admin/workflows/Build/badge.svg)](https://github.com/nicelizhi/easy-admin)
[![Release](https://img.shields.io/github/release/nicelizhi/easy-admin.svg?style=flat-square)](https://github.com/nicelizhi/easy-admin/releases)
[![License](https://img.shields.io/github/license/nicelizhi/easy-admin
)](https://github.com/nicelizhi/easy-admin)


The front-end and back-end separation authority management system based on Gin + Vue is extremely simple to initialize the system. You only need to modify the database connection in the configuration file. The system supports multi-instruction operations. Migration instructions can make it easier to initialize database information. Service instructions It's easy to start the api service.

## ✨ Feature

- Follow RESTful API design specifications

- Based on the GIN WEB API framework, it provides rich middleware support (user authentication, cross-domain, access log, tracking ID, etc.)

- RBAC access control model based on Casbin

- JWT authentication

- Support Swagger documents (based on swaggo)

- Database storage based on GORM, which can expand multiple types of databases

- Simple model mapping of configuration files to quickly get the desired configuration

- Code generation tool

- Multi-command mode

- Multi Language

- TimeZone Support

- TODO: unit test


## 🎁 Internal

1. User management: The user is the system operator, this function mainly completes the system user configuration.
2. Department management: configure the system organization (company, department, group), and display the tree structure to support data permissions.
3. Position management: configure the positions of system users.
4. Menu management: configure the system menu, operation authority, button authority identification, interface authority, etc.
5. Role management: Role menu permission assignment and role setting are divided into data scope permissions by organization.
6. Dictionary management: Maintain some relatively fixed data frequently used in the system.
7. Parameter management: dynamically configure common parameters for the system.
8. Operation log: system normal operation log record and query; system abnormal information log record and query.
9. Login log: The system login log record query contains login exceptions.
1. Interface documentation: Automatically generate related api interface documents according to the business code.
1. Code generation: According to the data table structure, generate the corresponding addition, deletion, modification, and check corresponding business, and the whole process of visual operation, so that the basic business can be implemented with zero code.
1. Form construction: Customize the page style, drag and drop to realize the page layout.
1. Service monitoring: View the basic information of some servers.
1. Content management: demo function, including classification management and content management. You can refer to the easy to use quick start.

# Api Document Generate

```
swag init --parseDependency --parseDepth=6 --instanceName admin -o ./docs/admin
```

# Online wagger Document

```
http://localhost:8000/swagger/admin/index.html
```

# Install

[Docker Install](https://nicelizhi.github.io/easy-admin/guide/install/docker)

[Docker Composer Install](https://nicelizhi.github.io/easy-admin/guide/install/docker-composer)

[K8s Install](https://nicelizhi.github.io/easy-admin/guide/install/k8s)

[Binary Install](https://nicelizhi.github.io/easy-admin/guide/install/binary)


# Configure

[Configure Docs](https://nicelizhi.github.io/easy-admin/guide/configure/)

# Document
[https://nicelizhi.github.io/easy-admin/](https://nicelizhi.github.io/easy-admin/)

# Issue
[https://github.com/nicelizhi/easy-admin/issues](https://github.com/nicelizhi/easy-admin/issues)

# Discussions
[https://github.com/nicelizhi/easy-admin/discussions](https://github.com/nicelizhi/easy-admin/discussions)
17 changes: 9 additions & 8 deletions docs/guide/install/docker-composer.md
Original file line number Diff line number Diff line change
Expand Up @@ -15,7 +15,7 @@ version: '3.8'
services:
easy-admin:
container_name: easy-admin
image: registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:latest
image: registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:1.0.0
privileged: true
restart: always
ports:
Expand Down Expand Up @@ -52,7 +52,7 @@ version: '3.8'
services:
easy-admin:
container_name: easy-admin
image: registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:latest
image: registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:1.0.0
privileged: true
restart: always
ports:
Expand All @@ -73,10 +73,10 @@ services:
restart: always
environment:
- POSTGRES_USER=root
- POSTGRES_PASSWORD=GoAdmin
- APP_DB_USER=GoAdmin
- APP_DB_PASS=GoAdmin
- APP_DB_NAME=GoAdmin
- POSTGRES_PASSWORD=easyadmin
- APP_DB_USER=easyadmin
- APP_DB_PASS=easyadmin
- APP_DB_NAME=easyadmin
volumes:
- ./db:/docker-entrypoint-initdb.d/
expod:
Expand All @@ -93,13 +93,14 @@ networks:

> You need have setting.yml file in ./config dir
```
docker run --name api-admin -p 8000:8000 -v ./config:/easy-admin/config/ -d registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:latest
docker-compose up -d // start
docker-compose down // down
```

### 4、Test it

```
docker exec -it api-admin bash
docker exec -it easy-admin bash
netstat -an | grep 8000
```

Expand Down
9 changes: 6 additions & 3 deletions docs/guide/install/docker.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,7 +6,7 @@
> tip: [how to install docker](https://nicelizhi.github.io/easy-admin/guide/install/installdocker)
```
docker pull registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:latest
docker pull registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:1.0.0
```
> view docker images
```
Expand All @@ -21,16 +21,19 @@ docker images

> You need have setting.yml file in ./config dir
```
docker run --name api-admin -p 8000:8000 -v ./config:/easy-admin/config/ -d registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:latest
docker run --name easy-admin -p 8000:8000 -v ./config:/config/ -d registry.ap-southeast-1.aliyuncs.com/kuops/easy-admin:1.0.0
```

### 4、Test it

```
docker exec -it api-admin bash
docker exec -it easy-admin bash
netstat -an | grep 8000
```

### 5、FAQ


### Issue Submit
https://github.com/nicelizhi/easy-admin/issues

6 changes: 3 additions & 3 deletions docs/index.md
Original file line number Diff line number Diff line change
Expand Up @@ -2,9 +2,9 @@
# easy-admin
[![Build Status](https://github.com/nicelizhi/easy-admin/workflows/Build/badge.svg)](https://github.com/nicelizhi/easy-admin)
[![Release](https://img.shields.io/github/release/nicelizhi/easy-admin.svg?style=flat-square)](https://github.com/nicelizhi/easy-admin/releases)
[![License](https://img.shields.io/github/license/mashape/apistatus.svg)](https://github.com/nicelizhi/easy-admin)
[![License](https://img.shields.io/github/license/nicelizhi/easy-admin
)](https://github.com/nicelizhi/easy-admin)

English | [简体中文](https://github.com/nicelizhi/easy-admin/blob/main/README.Zh-cn.md)

The front-end and back-end separation authority management system based on Gin + Vue is extremely simple to initialize the system. You only need to modify the database connection in the configuration file. The system supports multi-instruction operations. Migration instructions can make it easier to initialize database information. Service instructions It's easy to start the api service.

Expand Down Expand Up @@ -58,7 +58,7 @@ The front-end and back-end separation authority management system based on Gin +
swag init --parseDependency --parseDepth=6 --instanceName admin -o ./docs/admin
```

# Online swag Document
# Online wagger Document

```
http://localhost:8000/swagger/admin/index.html
Expand Down

0 comments on commit 2ed6444

Please sign in to comment.