|
|
@@ -1,102 +1,276 @@
|
|
|
-# go-admin-ui
|
|
|
+# go-admin
|
|
|
|
|
|
+ <img align="right" width="320" src="https://gitee.com/mydearzwj/image/raw/master/img/go-admin.svg">
|
|
|
|
|
|
- 
|
|
|
|
|
|
-## 简介
|
|
|
+[](https://github.com/go-admin-team/go-admin)
|
|
|
+[](https://github.com/go-admin-team/go-admin/releases)
|
|
|
+[](https://github.com/go-admin-team/go-admin)
|
|
|
|
|
|
-[goadmin-ui](https://github.com/wenjianzhang/go-admin-ui) 是一个后台基础模块的前端的实现，它基于 [vue-element-admin](https://panjiachen.github.io/vue-element-admin)实现。它实现了一套最基本的后台权限管理前端的基础模块。可以很快捷的开启自己的项目，不用考虑权限功能如何实现，操作页面如何设计，这里基本上已经满足了，希望能够为大家提供便利。
|
|
|
+English | [简体中文](https://github.com/go-admin-team/go-admin/blob/master/README.Zh-cn.md)
|
|
|
|
|
|
-- [在线预览](http://www.zhangwj.com/#/login)
|
|
|
+The front-end and back-end separation authority management system based on Gin + Vue + Element UI 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.
|
|
|
|
|
|
-- [后端项目](https://github.com/wenjianzhang/go-admin)
|
|
|
+[documentation](https://doc.go-admin.dev)
|
|
|
|
|
|
-- [前端项目](https://github.com/wenjianzhang/go-admin-ui)
|
|
|
+[Backend project](https://github.com/go-admin-team/go-admin)
|
|
|
|
|
|
+[Video tutorial](https://space.bilibili.com/565616721/channel/detail?cid=125737)
|
|
|
|
|
|
+## ✨ Feature
|
|
|
|
|
|
-## 功能
|
|
|
+- Follow RESTful API design specifications
|
|
|
|
|
|
-```
|
|
|
-- 登录
|
|
|
-- 退出
|
|
|
-
|
|
|
-- 首页
|
|
|
-- 系统管理
|
|
|
- - 用户管理
|
|
|
- - 菜单管理
|
|
|
- - 角色管理
|
|
|
- - 部门管理
|
|
|
- - 岗位管理
|
|
|
- - 字典管理
|
|
|
- - 参数设置
|
|
|
- - 日志管理
|
|
|
- - 登录日志
|
|
|
-
|
|
|
-- 基础信息
|
|
|
- - Excel
|
|
|
-
|
|
|
-- 系统工具
|
|
|
- - 系统接口
|
|
|
- - 日历
|
|
|
+- 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
|
|
|
+
|
|
|
+- Form builder
|
|
|
+
|
|
|
+- Multi-command mode
|
|
|
+
|
|
|
+- 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.
|
|
|
+
|
|
|
+## Ready to work
|
|
|
+
|
|
|
+You need to install locally [go] [gin] [node](http://nodejs.org/) 和 [git](https://git-scm.com/)
|
|
|
+
|
|
|
+At the same time, a series of tutorials including videos and documents are provided. How to complete the downloading to the proficient use, it is strongly recommended that you read these tutorials before you practice this project! ! !
|
|
|
+
|
|
|
+### Easily implement go-admin to write the first application-documentation tutorial
|
|
|
+
|
|
|
+[Step 1 - basic content introduction](http://doc.zhangwj.com/go-admin-site/guide/intro/tutorial01.html)
|
|
|
+
|
|
|
+[Step 2 - Practical application - writing database operations](http://doc.zhangwj.com/go-admin-site/guide/intro/tutorial02.html)
|
|
|
+
|
|
|
+### Teach you from getting started to giving up-video tutorial
|
|
|
|
|
|
+[How to start go-admin](https://www.bilibili.com/video/BV1z5411x7JG)
|
|
|
+
|
|
|
+[Easily implement business using build tools](https://www.bilibili.com/video/BV1Dg4y1i79D)
|
|
|
+
|
|
|
+[v1.1.0 version code generation tool-free your hands](https://www.bilibili.com/video/BV1N54y1i71P) [Advanced]
|
|
|
+
|
|
|
+[Explanation of multi-command startup mode and IDE configuration](https://www.bilibili.com/video/BV1Fg4y1q7ph)
|
|
|
+
|
|
|
+[Configuration instructions for go-admin menu](https://www.bilibili.com/video/BV1Wp4y1D715) [Must see]
|
|
|
+
|
|
|
+[How to configure menu information and interface information](https://www.bilibili.com/video/BV1zv411B7nG) [Must see]
|
|
|
+
|
|
|
+[go-admin permission configuration instructions](https://www.bilibili.com/video/BV1rt4y197d3) [Must see]
|
|
|
+
|
|
|
+[Instructions for use of go-admin data permissions](https://www.bilibili.com/video/BV1LK4y1s71e) [Must see]
|
|
|
+
|
|
|
+**If you have any questions, please read the above-mentioned usage documents and articles first. If you are not satisfied, welcome to issue and pr. Video tutorials and documents are being updated continuously.**
|
|
|
+
|
|
|
+## 📦 Local development
|
|
|
+
|
|
|
+### Development directory creation
|
|
|
+
|
|
|
+```bash
|
|
|
+
|
|
|
+# Create a development directory
|
|
|
+mkdir goadmin
|
|
|
+cd goadmin
|
|
|
```
|
|
|
|
|
|
-## 开发
|
|
|
+### Get the code
|
|
|
+
|
|
|
+> Important note: the two projects must be placed in the same folder;
|
|
|
|
|
|
```bash
|
|
|
-# 克隆项目
|
|
|
-git clone https://github.com/wenjianzhang/go-admin-ui.git
|
|
|
+# Get backend code
|
|
|
+git clone https://github.com/go-admin-team/go-admin.git
|
|
|
+
|
|
|
+# Get the front-end code
|
|
|
+git clone https://github.com/go-admin-team/go-admin-ui.git
|
|
|
|
|
|
-# 进入项目目录
|
|
|
-cd go-admin-ui
|
|
|
+```
|
|
|
|
|
|
-# 安装依赖
|
|
|
-npm install
|
|
|
+### Startup instructions
|
|
|
|
|
|
-# 建议不要直接使用 cnpm 安装依赖，会有各种诡异的 bug。可以通过如下操作解决 npm 下载速度慢的问题
|
|
|
-npm install --registry=https://registry.npm.taobao.org
|
|
|
+#### Server startup instructions
|
|
|
|
|
|
-# 启动服务
|
|
|
-npm run dev
|
|
|
+```bash
|
|
|
+# Enter the go-admin backend project
|
|
|
+cd ./go-admin
|
|
|
+
|
|
|
+# Compile the project
|
|
|
+go build
|
|
|
+
|
|
|
+# Change setting
|
|
|
+# File path go-admin/config/settings.yml
|
|
|
+vi ./config/setting.yml
|
|
|
+
|
|
|
+# 1. Modify the database information in the configuration file
|
|
|
+# Note: The corresponding configuration data under settings.database
|
|
|
+# 2. Confirm the log path
|
|
|
```
|
|
|
|
|
|
-浏览器访问 http://localhost:9527
|
|
|
+:::tip ⚠️Note that this problem will occur if CGO is not installed in the windows environment;
|
|
|
|
|
|
-## 发布
|
|
|
+```bash
|
|
|
+E:\go-admin>go build
|
|
|
+# github.com/mattn/go-sqlite3
|
|
|
+cgo: exec /missing-cc: exec: "/missing-cc": file does not exist
|
|
|
+```
|
|
|
+
|
|
|
+or
|
|
|
|
|
|
```bash
|
|
|
-# 构建测试环境
|
|
|
-npm run build:stage
|
|
|
+D:\Code\go-admin>go build
|
|
|
+# github.com/mattn/go-sqlite3
|
|
|
+cgo: exec gcc: exec: "gcc": executable file not found in %PATH%
|
|
|
+```
|
|
|
+
|
|
|
+[Solve the cgo problem and enter](https://doc.go-admin.dev/guide/other/faq.html#_5-cgo-exec-missing-cc-exec-missing-cc-file-does-not-exist)
|
|
|
+
|
|
|
+:::
|
|
|
+
|
|
|
+#### Initialize the database, and start the service
|
|
|
+
|
|
|
+``` bash
|
|
|
+# The first configuration needs to initialize the database resource information
|
|
|
+# Use under macOS or linux
|
|
|
+$ ./go-admin migrate -c=config/settings.dev.yml
|
|
|
+
|
|
|
+# ⚠️Note: Use under windows
|
|
|
+$ go-admin.exe migrate -c=config/settings.dev.yml
|
|
|
|
|
|
-# 构建生产环境
|
|
|
-npm run build:prod
|
|
|
+# Start the project, you can also use the IDE for debugging
|
|
|
+# Use under macOS or linux
|
|
|
+$ ./go-admin server -c config/settings.yml
|
|
|
+
|
|
|
+# ⚠️Note: Use under windows
|
|
|
+$ go-admin.exe server -c config/settings.yml
|
|
|
+```
|
|
|
+
|
|
|
+#### Use docker to compile and start
|
|
|
+
|
|
|
+```shell
|
|
|
+# Compile the image
|
|
|
+docker build -t go-admin .
|
|
|
+
|
|
|
+
|
|
|
+# Start the container, the first go-admin is the container name, and the second go-admin is the image name
|
|
|
+# -v Mapping configuration file Local path: container path
|
|
|
+docker run --name go-admin -p 8000:8000 -v /config/settings.yml:/config/settings.yml -d go-admin-server
|
|
|
```
|
|
|
|
|
|
-## 其它
|
|
|
+
|
|
|
+
|
|
|
+#### Generation Document
|
|
|
|
|
|
```bash
|
|
|
-# 预览发布环境效果
|
|
|
-npm run preview
|
|
|
+go generate
|
|
|
+```
|
|
|
|
|
|
-# 预览发布环境效果 + 静态资源分析
|
|
|
-npm run preview -- --report
|
|
|
+#### Cross compile
|
|
|
+```bash
|
|
|
+# windows
|
|
|
+env GOOS=windows GOARCH=amd64 go build main.go
|
|
|
|
|
|
-# 代码格式检查
|
|
|
-npm run lint
|
|
|
+# or
|
|
|
+# linux
|
|
|
+env GOOS=linux GOARCH=amd64 go build main.go
|
|
|
+```
|
|
|
+
|
|
|
+### UI interactive terminal startup instructions
|
|
|
|
|
|
-# 代码格式检查并自动修复
|
|
|
-npm run lint -- --fix
|
|
|
+```bash
|
|
|
+# Installation dependencies
|
|
|
+npm install # or cnpm install
|
|
|
+
|
|
|
+# Start service
|
|
|
+npm run dev
|
|
|
```
|
|
|
|
|
|
+## 🎬 Online Demo
|
|
|
+> admin / 123456
|
|
|
+
|
|
|
+演示地址：[http://www.go-admin.dev](http://www.go-admin.dev/#/login)
|
|
|
+
|
|
|
+
|
|
|
+## 📨 Interactive
|
|
|
+
|
|
|
+<table>
|
|
|
+ <tr>
|
|
|
+ <td><img src="https://raw.githubusercontent.com/wenjianzhang/image/master/img/wx.png" width="180px"></td>
|
|
|
+ <td><img src="https://raw.githubusercontent.com/wenjianzhang/image/master/img/qq2.png" width="200px"></td>
|
|
|
+ </tr>
|
|
|
+ <tr>
|
|
|
+ <td>Wechat</td>
|
|
|
+ <td><a target="_blank" href="https://shang.qq.com/wpa/qunwpa?idkey=0f2bf59f5f2edec6a4550c364242c0641f870aa328e468c4ee4b7dbfb392627b"><img border="0" src="https://pub.idqqimg.com/wpa/images/group.png" alt="go-admin技术交流乙号" title="go-admin技术交流乙号"></a></td>
|
|
|
+ </tr>
|
|
|
+</table>
|
|
|
+
|
|
|
+## 💎 Members
|
|
|
+
|
|
|
+<a href="https://github.com/wenjianzhang"> <img src="https://avatars.githubusercontent.com/u/3890175?s=460&u=20eac63daef81588fbac611da676b99859319251&v=4" width="80px"></a>
|
|
|
+<a href="https://github.com/lwnmengjing"> <img src="https://avatars.githubusercontent.com/u/12806223?s=400&u=a89272dce50100b77b4c0d5c81c718bf78ebb580&v=4" width="80px"></a>
|
|
|
+<a href="https://github.com/chengxiao"> <img src="https://avatars.githubusercontent.com/u/1379545?s=460&u=557da5503d0ac4a8628df6b4075b17853d5edcd9&v=4" width="80px"></a>
|
|
|
+<a href="https://github.com/bing127"> <img src="https://avatars.githubusercontent.com/u/31166183?s=460&u=c085bff88df10bb7676c8c0351ba9dcd031d1fb3&v=4" width="80px"></a>
|
|
|
+
|
|
|
+
|
|
|
+
|
|
|
+## JetBrains open source certificate support
|
|
|
+
|
|
|
+The `go-admin` 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.
|
|
|
+
|
|
|
+<a href="https://www.jetbrains.com/?from=kubeadm-ha" target="_blank"><img src="https://raw.githubusercontent.com/panjf2000/illustrations/master/jetbrains/jetbrains-variant-4.png" width="250" align="middle"/></a>
|
|
|
+
|
|
|
+
|
|
|
+## 🤝 Thanks
|
|
|
+1. [chengxiao](https://github.com/chengxiao)
|
|
|
+2. [gin](https://github.com/gin-gonic/gin)
|
|
|
+2. [casbin](https://github.com/casbin/casbin)
|
|
|
+2. [spf13/viper](https://github.com/spf13/viper)
|
|
|
+2. [gorm](https://github.com/jinzhu/gorm)
|
|
|
+2. [gin-swagger](https://github.com/swaggo/gin-swagger)
|
|
|
+2. [jwt-go](https://github.com/dgrijalva/jwt-go)
|
|
|
+2. [vue-element-admin](https://github.com/PanJiaChen/vue-element-admin)
|
|
|
+2. [ruoyi-vue](https://gitee.com/y_project/RuoYi-Vue)
|
|
|
+2. [form-generator](https://github.com/JakHuang/form-generator)
|
|
|
+
|
|
|
+## 🤟 Sponsor Us
|
|
|
|
|
|
-## 在线预览
|
|
|
+> If you think this project helped you, you can buy a glass of juice for the author to show encouragement :tropical_drink:
|
|
|
|
|
|
-[在线 Demo](http://www.zhangwj.com/#/login)
|
|
|
+<img class="no-margin" src="https://raw.githubusercontent.com/wenjianzhang/image/master/img/pay.png" height="200px" >
|
|
|
|
|
|
+## 🤝 Link
|
|
|
+[Go developer growth roadmap](http://www.golangroadmap.com/)
|
|
|
|
|
|
-## License
|
|
|
+## 🔑 License
|
|
|
|
|
|
-[MIT](https://github.com/wenjianzhang/go-admin-ui/blob/master/LICENSE)
|
|
|
+[MIT](https://github.com/go-admin-team/go-admin/blob/master/LICENSE.md)
|
|
|
|
|
|
-Copyright (c) 2020 wenjianzhang
|
|
|
+Copyright (c) 2020 wenjianzhang
|
zhangwenjian