gin-vue-admin是一個(gè)基于gin+vue搭建的后臺(tái)管理系統(tǒng)框架，集成jwt鑒權(quán)，權(quán)限管理，動(dòng)態(tài)路由，分頁封裝，多點(diǎn)登錄攔截，資源權(quán)限，上傳下載，代碼生成器，表單生成器，通用工作流等基礎(chǔ)功能。

主要功能

1、權(quán)限管理：基于jwt和casbin實(shí)現(xiàn)的權(quán)限管理。

2、文件上傳下載：實(shí)現(xiàn)基于七牛云, 阿里云, 騰訊云 的文件上傳操作(請(qǐng)開發(fā)自己去各個(gè)平臺(tái)的申請(qǐng)對(duì)應(yīng) token 或者對(duì)應(yīng)key)。

3、分頁封裝：前端使用 mixins 封裝分頁，分頁方法調(diào)用 mixins 即可。

4、用戶管理：系統(tǒng)管理員分配用戶角色和角色權(quán)限。

5、角色管理：創(chuàng)建權(quán)限控制的主要對(duì)象，可以給角色分配不同api權(quán)限和菜單權(quán)限。

6、菜單管理：實(shí)現(xiàn)用戶動(dòng)態(tài)菜單配置，實(shí)現(xiàn)不同角色不同菜單。

7、api管理：不同用戶可調(diào)用的api接口的權(quán)限不同。

8、配置管理：配置文件可前臺(tái)修改(在線體驗(yàn)站點(diǎn)不開放此功能)。

9、條件搜索：增加條件搜索示例。

10、restful示例：可以參考用戶管理模塊中的示例API。

前端文件參考: web/src/view/superAdmin/api/api.vue

后臺(tái)文件參考: server/router/sys_api.go

11、多點(diǎn)登錄限制：需要在config.yaml中把system中的use-multipoint修改為true(需要自行配置Redis和Config中的Redis參數(shù)，測(cè)試階段，有bug請(qǐng)及時(shí)反饋)。

12、分片長(zhǎng)傳：提供文件分片上傳和大文件分片上傳功能示例。

13、表單生成器：表單生成器借助 @form-generator 。

14、代碼生成器：后臺(tái)基礎(chǔ)邏輯以及簡(jiǎn)單curd的代碼生成器。

技術(shù)選型

前端：用基于 Vue 的 Element 構(gòu)建基礎(chǔ)頁面。

后端：用 Gin 快速搭建基礎(chǔ)restful風(fēng)格API，Gin 是一個(gè)go語言編寫的Web框架。

數(shù)據(jù)庫(kù)：采用MySql > (5.7) 版本 數(shù)據(jù)庫(kù)引擎 InnoDB，使用 gorm 實(shí)現(xiàn)對(duì)數(shù)據(jù)庫(kù)的基本操作。

緩存：使用Redis實(shí)現(xiàn)記錄當(dāng)前活躍用戶的jwt令牌并實(shí)現(xiàn)多點(diǎn)登錄限制。

API文檔：使用Swagger構(gòu)建自動(dòng)化文檔。

配置文件：使用 fsnotify 和 viper 實(shí)現(xiàn)yaml格式的配置文件。

日志：使用 zap 實(shí)現(xiàn)日志記錄。

使用說明

- node版本 > v16.8.3

- golang版本 >= v1.16

- IDE推薦：Goland

server項(xiàng)目

使用 Goland 等編輯工具，打開server目錄，不可以打開 gin-vue-admin 根目錄

 # 克隆項(xiàng)目
git clone https://github.com/flipped-aurora/gin-vue-admin.git
# 進(jìn)入server文件夾
cd server

# 使用 go mod 并安裝go依賴包
go generate

# 編譯
go build -o server main.go (windows編譯命令為go build -o server.exe main.go )

# 運(yùn)行二進(jìn)制
./server (windows運(yùn)行命令為 server.exe)

 web項(xiàng)目

# 進(jìn)入web文件夾
cd web

# 安裝依賴
npm install

# 啟動(dòng)web項(xiàng)目
npm run serve

系統(tǒng)架構(gòu)圖

前端詳細(xì)設(shè)計(jì)圖

目錄結(jié)構(gòu)

├── server
├── api (api層)
│ └── v1 (v1版本接口)
├── config (配置包)
├── core (核心文件)
├── docs (swagger文檔目錄)
├── global (全局對(duì)象)
├── initialize (初始化)
│ └── internal (初始化內(nèi)部函數(shù))
├── middleware (中間件層)
├── model (模型層)
│ ├── request (入?yún)⒔Y(jié)構(gòu)體)
│ └── response (出參結(jié)構(gòu)體)
├── packfile (靜態(tài)文件打包)
├── resource (靜態(tài)資源文件夾)
│ ├── excel (excel導(dǎo)入導(dǎo)出默認(rèn)路徑)
│ ├── page (表單生成器)
│ └── template (模板)
├── router (路由層)
├── service (service層)
├── source (source層)
└── utils (工具包)
├── timer (定時(shí)器接口封裝)
└── upload (oss接口封裝)

web
├── babel.config.js
├── Dockerfile
├── favicon.ico
├── index.html -- 主頁面
├── limit.js -- 助手代碼
├── package.json -- 包管理器代碼
├── src -- 源代碼
│ ├── api -- api 組
│ ├── App.vue -- 主頁面
│ ├── assets -- 靜態(tài)資源
│ ├── components -- 全局組件
│ ├── core -- gva 組件包
│ │ ├── config.js -- gva網(wǎng)站配置文件
│ │ ├── gin-vue-admin.js -- 注冊(cè)歡迎文件
│ │ └── global.js -- 統(tǒng)一導(dǎo)入文件
│ ├── directive -- v-auth 注冊(cè)文件
│ ├── main.js -- 主文件
│ ├── permission.js -- 路由中間件
│ ├── pinia -- pinia 狀態(tài)管理器，取代vuex
│ │ ├── index.js -- 入口文件
│ │ └── modules -- modules
│ │ ├── dictionary.js
│ │ ├── router.js
│ │ └── user.js
│ ├── router -- 路由聲明文件
│ │ └── index.js
│ ├── style -- 全局樣式
│ │ ├── base.scss
│ │ ├── basics.scss
│ │ ├── element_visiable.scss -- 此處可以全局覆蓋 element-plus 樣式
│ │ ├── iconfont.css -- 頂部幾個(gè)icon的樣式文件
│ │ ├── main.scss
│ │ ├── mobile.scss
│ │ └── newLogin.scss
│ ├── utils -- 方法包庫(kù)
│ │ ├── asyncRouter.js -- 動(dòng)態(tài)路由相關(guān)
│ │ ├── btnAuth.js -- 動(dòng)態(tài)權(quán)限按鈕相關(guān)
│ │ ├── bus.js -- 全局mitt聲明文件
│ │ ├── date.js -- 日期相關(guān)
│ │ ├── dictionary.js -- 獲取字典方法
│ │ ├── downloadImg.js -- 下載圖片方法
│ │ ├── format.js -- 格式整理相關(guān)
│ │ ├── image.js -- 圖片相關(guān)方法
│ │ ├── page.js -- 設(shè)置頁面標(biāo)題
│ │ ├── request.js -- 請(qǐng)求
│ │ └── stringFun.js -- 字符串文件
| ├── view -- 主要view代碼
| | ├── about -- 關(guān)于我們
| | ├── dashboard -- 面板
| | ├── error -- 錯(cuò)誤
| | ├── example --上傳案例
| | ├── iconList -- icon列表
| | ├── init -- 初始化數(shù)據(jù)
| | | ├── index -- 新版本
| | | ├── init -- 舊版本
| | ├── layout -- layout約束頁面
| | | ├── aside
| | | ├── bottomInfo -- bottomInfo
| | | ├── screenfull -- 全屏設(shè)置
| | | ├── setting -- 系統(tǒng)設(shè)置
| | | └── index.vue -- base 約束
| | ├── login --登錄
| | ├── person --個(gè)人中心
| | ├── superAdmin -- 超級(jí)管理員操作
| | ├── system -- 系統(tǒng)檢測(cè)頁面
| | ├── systemTools -- 系統(tǒng)配置相關(guān)頁面
| | └── routerHolder.vue -- page 入口頁面
├── vite.config.js -- vite 配置文件
└── yarn.lock

更新日志

- 版本號(hào)2.8.2

- 增加mcp支持

- 增加優(yōu)雅關(guān)閉

- 清理框架中的引用錯(cuò)誤，減少用戶在正常開發(fā)時(shí)遭遇的循環(huán)引用。

- 增加MCP Tool 自動(dòng)化模板

- 增加MCP 調(diào)試工具

- 優(yōu)化初始化數(shù)據(jù)邏輯

- 自動(dòng)化模板搜索功能優(yōu)化，時(shí)間類型調(diào)整為timeRange工具。

?更新到最新版本，如需體驗(yàn)MCP功能需要自行配置菜單和API方可使用。