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

主要功能

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

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

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

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

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

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

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

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

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

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

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

后臺文件參考: server/router/sys_api.go

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

12、分片長傳：提供文件分片上傳和大文件分片上傳功能示例。

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

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

技術(shù)選型

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

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

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

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

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

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

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

使用說明

- node版本 > v16.8.3

- golang版本 >= v1.16

- IDE推薦：Goland

server項目

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

 # 克隆項目
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項目

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

# 安裝依賴
npm install

# 啟動web項目
npm run serve

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

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

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

├── server
├── api (api層)
│ └── v1 (v1版本接口)
├── config (配置包)
├── core (核心文件)
├── docs (swagger文檔目錄)
├── global (全局對象)
├── 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 (定時器接口封裝)
└── 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 -- 注冊歡迎文件
│ │ └── global.js -- 統(tǒng)一導(dǎo)入文件
│ ├── directive -- v-auth 注冊文件
│ ├── 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 -- 頂部幾個icon的樣式文件
│ │ ├── main.scss
│ │ ├── mobile.scss
│ │ └── newLogin.scss
│ ├── utils -- 方法包庫
│ │ ├── asyncRouter.js -- 動態(tài)路由相關(guān)
│ │ ├── btnAuth.js -- 動態(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 -- 請求
│ │ └── stringFun.js -- 字符串文件
| ├── view -- 主要view代碼
| | ├── about -- 關(guān)于我們
| | ├── dashboard -- 面板
| | ├── error -- 錯誤
| | ├── example --上傳案例
| | ├── iconList -- icon列表
| | ├── init -- 初始化數(shù)據(jù)
| | | ├── index -- 新版本
| | | ├── init -- 舊版本
| | ├── layout -- layout約束頁面
| | | ├── aside
| | | ├── bottomInfo -- bottomInfo
| | | ├── screenfull -- 全屏設(shè)置
| | | ├── setting -- 系統(tǒng)設(shè)置
| | | └── index.vue -- base 約束
| | ├── login --登錄
| | ├── person --個人中心
| | ├── superAdmin -- 超級管理員操作
| | ├── system -- 系統(tǒng)檢測頁面
| | ├── systemTools -- 系統(tǒng)配置相關(guān)頁面
| | └── routerHolder.vue -- page 入口頁面
├── vite.config.js -- vite 配置文件
└── yarn.lock

更新日志

- 版本號2.8.2

- 增加mcp支持

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

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

- 增加MCP Tool 自動化模板

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

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

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

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