Nessuna descrizione

pixel 617ddb372d 规范化px		3 anni fa
.github	127a6b161e Update FUNDING.yml	4 anni fa
docs	70414b725e Modify readme.	4 anni fa
server	b5ee1ce3ed 统一样式调整	3 anni fa
web	617ddb372d 规范化px	3 anni fa
.gitattributes	75dff71227 显示语言修改	5 anni fa
.gitignore	c009d684f7 Revert "新增网页侧边栏颜色配置，新增网页主题色配置"	3 anni fa
CODE_OF_CONDUCT.md	e9cf6e164d Create CODE_OF_CONDUCT.md	5 anni fa
CONTRIBUTING.md	e22f378411 Create CONTRIBUTING.md	4 anni fa
LICENSE	22da7dd0c0 Update LICENSE	4 anni fa
README-en.md	fb6233918d Update README-en.md	4 anni fa
README.md	c009d684f7 Revert "新增网页侧边栏颜色配置，新增网页主题色配置"	3 anni fa
docker-compose.yaml	97167e332b update: docker-compose 优化	3 anni fa
package-lock.json	290fe31669 整合gin-vue-admin前端框架引入组合，减少main.js代码	3 anni fa
package.json	290fe31669 整合gin-vue-admin前端框架引入组合，减少main.js代码	3 anni fa

English | 简体中文

Project Guidelines

Online Documentation : https://www.gin-vue-admin.com/

Development Steps (Contributor: LLemonGreen And Fann)

Web UI Framework：element-ui
Server Framework：gin

1. Basic Introduction

1.1 Project Introduction

Online Demo

username：admin

password：123456

Gin-vue-admin is a full-stack (frontend and backend separation) framework designed for management system. It integrates multiple functions, such as JWT authentication, dynamic routing, dynamic menu, casbin authentication, form generator, code generator, etc. So that you can focus more time on your business Requirements.

Hi! Thank you for choosing gin-vue-admin.

Gin-vue-admin is a full-stack (frontend and backend separation) framework for developers, designers and product managers.

We are excited that you are interested in contributing to gin-vue-admin. Before submitting your contribution though, please make sure to take a moment and read through the following guidelines.

1.2 Contributing Guide

1.2.1 Issue Guidelines

Issues are exclusively for bug reports, feature requests and design-related topics. Other questions may be closed directly. If any questions come up when you are using Element, please hit Gitter for help.
Before submitting an issue, please check if similar problems have already been issued.

1.2.2 Pull Request Guidelines

Fork this repository to your own account. Do not create branches here.
Commit info should be formatted as [File Name]: Info about commit. (e.g. README.md: Fix xxx bug)
Make sure PRs are created to develop branch instead of master branch.
If your PR fixes a bug, please provide a description about the related bug.
Merging a PR takes two maintainers: one approves the changes after reviewing, and then the other reviews and merges.

1.3 Version list

master: 2.0 code, for prod
develop: 2.0 dev code, for test
gin-vue-admin_v2_dev (v2.0 GormV1 Stable branch)
gva_gormv2_dev (v2.0 GormV2 Development branch)

2. Getting started

- node version > v8.6.0
- golang version >= v1.14
- IDE recommendation: Goland
- We recommend you to apply for your own cloud service in QINIU. Replace the public key, private key, warehouse name and default url address with your own, so as not to mess up the test database.

Use docker-compose to experience this project
Installation docker-compose Official document
# Install on Linux
# 1.1 Run this command to download the current stable version of Docker Compose
sudo curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# 1.2 Apply executable permissions to binary files
sudo chmod +x /usr/local/bin/docker-compose 
# Use Python's pip installation
pip3 install docker-compose -i https://pypi.tuna.tsinghua.edu.cn/simple
Use Docker Desktop

Windows: https://hub.docker.com/editions/community/docker-ce-desktop-windows

Mac: https://hub.docker.com/editions/community/docker-ce-desktop-mac/
Use git to clone this project
git clone https://github.com/flipped-aurora/gin-vue-admin.git
Use docker-compose up to start the startup project with one click
# Use docker-compose to start four containers
docker-compose up
# If you modify some configuration options, you can use this command to repackage the image
docker-compose up --build
# Use docker-compose to start in the background
docker-compose up -d
Web project preview http://127.0.0.1:8000

swagger APIs http://127.0.0.1:8888/swagger/index.html
If the internal ip of the server's 177.7.0.12 container is occupied, the place to be modified is

Replace 177.7.0.12 on line 39 of docker-compose.yaml with the ip you want

Replace 177.7.0.12 in line 20 of .docker-compose/nginx/conf.d/my.conf with the ip you want
docker-compose uses a custom docker network
networks:
  network:
    ipam:
      driver: default
      config:
        - subnet: '177.7.0.0/16' 
Subnet address, the default gateway is 177.7.0.1 (docker-compose V2 needs to write, V3 does not need),For specific information, see the official document

The default network name is gin-vue-admin_network, and the default is bridge mode

If the subnet is modified, the ipv4_address of each service needs to be modified, and the ip of the server on line 20 of .docker-compose/nginx/conf.d/my.conf also needs to be modified
Use docker-compose to deploy this project need attention

For mysql database, please use a local database installed on the server disk.

Avoid using mysql in the docker container, there may be write problems, io is lower than the host machine, docker's persistence mechanism problem

init.sql is for docker-compose ==experience this project==, prohibit the use of init.sql to initialize project data, Database initializationPlease use this method

Use init.sql to initialize all problems, please bear it yourself, and have nothing to do with this project

When deploying using docker-compose of this project,Please modify the nginx configuration, mysql configuration, networks configuration, redis configuration corresponding to docker-compose.yaml, and make changes as needed.

2.1 Web

```bash

clone the project

git clone https://github.com/piexlmax/gin-vue-admin.git

enter the project directory

cd web

install dependency

npm install

develop

npm run serve


### 2.2 Server

bash

using go.mod

install go modules

go list (go mod tidy)

build the server

go build


> Zap log library usage guide && configuration guide

The configuration of the Zap log library selects zap under [config.yaml](./server/config.yaml)

yaml

zap logger configuration

zap: level: 'debug' format: 'console' prefix: '[GIN-VUE-ADMIN]' director: 'log' link_name: 'latest_log' show_line: true encode_level: 'LowercaseColorLevelEncoder' stacktrace_key: 'stacktrace' log_in_console: true


| Configuration Name | Type Of Configuration | Description                                                  |
| ------------------ | --------------------- | ------------------------------------------------------------ |
| level              | string                | For a detailed description of the level mode, please see the official [zap documentation](https://pkg.go.dev/go.uber.org/zap?tab=doc#pkg-constants) <br />info: info mode, stack information without errors, only output information<br />debug: debug mode, stack details with errors<br />warn:warn mode<br />error: error mode, stack details with error<br />dpanic: dpanic mode<br />panic: panic mode<br />fatal: fatal mode<br /> |
| format             | string                | console: Output log in console format<br />json: json format output log |
| prefix             | string                | Log prefix                                                   |
| director           | string                | The folder to store the log can be modified, no need to create it manually |
| link_name          | string                | [A soft connection file](https://baike.baidu.com/item/%E8%BD%AF%E9%93%BE%E6%8E%A5) of link_name will be generated in the server directory, and the link is the latest log file of the director configuration item |
| show_line          | bool                  | Display the line number, the default is true, it is not recommended to modify |
| encode_level       | string                | LowercaseLevelEncoder: lowercase<br /> LowercaseColorLevelEncoder: lowercase with color<br />CapitalLevelEncoder: uppercase<br />CapitalColorLevelEncoder: uppercase with color |
| stacktrace_key     | string                | The name of the stack, that is, the key of josn when outputting the log in json format |
| log_in_console     | bool                  | Whether to output to the console, the default is true        |

- Development environment || Debug environment configuration recommendations
    - `level:debug`
    - `format:console`
    - `encode_level:LowercaseColorLevelEncoder`或者`encode_leve:CapitalColorLevelEncoder`
- Deployment environment configuration recommendations
    - `level:error`
    - `format:json` 
    - `encode_level: LowercaseLevelEncoder `或者 `encode_level:CapitalLevelEncoder`
    - `log_in_console: false` 
- <font color=red>Suggestions are only suggestions, you can proceed according to your own needs, and suggestions are for reference only</font>

### 2.3 API docs auto-generation using swagger

#### 2.3.1 install swagger 

##### (1) Using VPN or outside mainland China
````
go get -u github.com/swaggo/swag/cmd/swag
````

##### (2) In mainland China

In mainland China, access to go.org/x is prohibited，we recommend [goproxy.io](https://goproxy.io/zh/)

````bash
If you are using Go version 1.13 and above (recommended)
# Enable Go Modules function
go env -w GO111MODULE=on 
# Configure GOPROXY environment variables
go env -w GOPROXY=https://goproxy.io,direct
If you are using Go version 1.12 and below
go env -w GO111MODULE=on
go env -w GOPROXY=https://goproxy.io

# Use the following command to download swag
go get -u github.com/swaggo/swag/cmd/swag
````

#### 2.3.2 API docs generation

````
cd server
swag init
````
After executing the above command，`docs` will show in `server/`，then open your browser, jump into `http://localhost:8888/swagger/index.html` to see the swagger APIs.


## 3. Technical selection

- Frontend: using `Element-UI` based on vue，to code the page.
- Backend: using `Gin` to quickly build basic RESTful API. `Gin` is a web framework written in Go (Golang).
- DB: `MySql`(5.6.44)，using `gorm` to implement data manipulation, added support for SQLite databases.
- Cache: using `Redis` to implement the recording of the JWT token of the currently active user and implement the multi-login restriction.
- API: using Swagger to auto generate APIs docs。
- Config: using `fsnotify` and `viper` to implement `yaml` config file。
- Log: using `go-logging` record logs。

## 4. Project Architecture

### 4.1 Architecture Diagram

![Architecture diagram](http://qmplusimg.henrongyi.top/gva/gin-vue-admin.png)

### 4.2 Front-end Detailed Design Diagram (Contributor: <a href="https://github.com/baobeisuper">baobeisuper</a>)

![Front-end Detailed Design Diagram](http://qmplusimg.henrongyi.top/naotu.png)

### 4.3 Project Layout

├─server  	     （backend）
│  ├─api            （API entrance）
│  ├─config         （config file）
│  ├─core  	        （core code）
│  ├─docs  	        （swagger APIs docs）
│  ├─global         （global objet）
│  ├─initialiaze    （initialiazation）
│  ├─middleware     （middle ware）
│  ├─model          （model and services）
│  ├─resource       （resources, such as static pages, templates）
│  ├─router         （routers）
│  ├─service         (services)
│  └─utils	        （common utilities）
└─web            （frontend）
    ├─public        （deploy templates）
    └─src           （source code）
        ├─api       （frontend APIs）
        ├─assets	（static files）
        ├─components（components）
        ├─router	（frontend routers）
        ├─store     （vuex state management）
        ├─style     （common styles）
        ├─utils     （frontend common utilitie）
        └─view      （pages）


## 5. Features

- Authority management: Authority management based on `jwt` and `casbin`. 
- File upload & download: File upload operation based on Qiniu Cloud (In order to make it easier for everyone to test, I have provided various important tokens of my Qiniu test number, and I urge you not to make things a mess).
- Pagination Encapsulation：The frontend uses mixins to encapsulate paging, and the paging method can call mixins
- User management: The system administrator assigns user roles and role permissions.
- Role management: Create the main object of permission control, and then assign different API permissions and menu permissions to the role.
- Menu management: User dynamic menu configuration implementation, assigning different menus to different roles.
- API management: Different users can call different API permissions.
- Configuration management: The configuration file can be modified in the web page (the test environment does not provide this function).
- Rich text editor: Embed MarkDown editor function.
- Conditional search: Add an example of conditional search.
- Restful example: You can see sample APIs in user management module.

fontend code file: src\view\superAdmin\api\api.vue backend code file: model\dnModel\api.go ```

Multi-login restriction: Change userMultipoint to true in system in config.yaml (You need to configure redis and redis parameters yourself. During the test period, please report in time if there is a bug).
Upload file by chunk：Provides examples of file upload and large file upload by chunk.
Form Builder：With the help of @form-generator.
Code generator: Providing backend with basic logic and simple curd code generator.

6. To-do list

upload & export Excel
e-chart
workflow, task transfer function
frontend independent mode, mock

7. Knowledge base

7.1 Team blog

https://www.yuque.com/flipped-aurora

There are video courses about frontend framework in our blo. If you think the project is helpful to you, you can add my personal WeChat:shouzi_1994，your comments is welcomed。

7.2 Video courses

(1) Development environment course

Bilibili：https://www.bilibili.com/video/BV1Fg4y187Bw/

(2) Template course

Bilibili：https://www.bilibili.com/video/BV16K4y1r7BD/

（3）2.0 version introduction and development experience

Bilibili：https://www.bilibili.com/video/BV1aV411d7Gm#reply2831798461

(4) Golang basic course (coming soon)

https://space.bilibili.com/322210472/channel/detail?cid=108884

8. Contacts

8.1 Groups

QQ group: 622360840

| QQ group |d | :---: | | |

Wechat group: comment "加入gin-vue-admin交流群"

Wechat

About Us

9. Donate

If you find this project useful, you can buy author a glass of juice :tropical_drink: here

10. Commercial considerations

If you use this project for commercial purposes, please comply with the Apache2.0 agreement and retain the author's technical support statement.

README-en.md