# flipped-aurora/gin-vue-admin architecture

> Architecture diagram of the GitHub repository flipped-aurora/gin-vue-admin, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-09). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/flipped-aurora/gin-vue-admin
- Repository: https://github.com/flipped-aurora/gin-vue-admin

## Overview

Gin-vue-admin is a full-stack administration platform: users work in a Vue interface, which calls Gin APIs for administration and code-generation tasks. The backend initializes configuration and storage, registers routes and middleware, and serves requests through API and service layers. Major documented capabilities include JWT/Casbin access control, dynamic menus, uploads, and code generation; the tree also includes plugins and MCP tooling. Some subsystem links are documented capabilities rather than inspected calls, so those edges are dashed with no evidence path.

Main entry points: [`server/api/v1/system`](https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/api/v1/system) (Admin APIs), [`server/initialize/router.go`](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/initialize/router.go) (Route registry), [`server/service/system`](https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/service/system) (Admin services), [`web/src/App.vue`](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/App.vue) (Vue application)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web interface"]
  node_webapp["Vue application<br/>[App.vue]"]
  node_webcore["Frontend setup<br/>[gin-vue-admin.js]"]
  node_webrouter["Dynamic routing<br/>[router.js]"]
  node_webviews["Admin views<br/>[index.vue]"]
  node_webauto["Code tools UI<br/>[index.vue]"]
  node_webapi["API clients<br/>[autoCode.js]"]
end

subgraph group_backend["Backend runtime"]
  node_servermain["Server startup<br/>[main.go]"]
  node_servercore["HTTP runtime<br/>[server.go]"]
  node_routes["Route registry<br/>[router.go]"]
  node_middleware["Auth middleware<br/>[jwt.go]"]
  node_database[("SQL storage<br/>[gorm.go]")]
end

subgraph group_admin["Administration"]
  node_adminapi["Admin APIs"]
  node_adminservice["Admin services"]
  node_adminmodels["Domain models"]
end

subgraph group_automation["Automation tools"]
  node_codegen["Code generation"]
  node_llm["LLM integration<br/>[auto_code_llm.go]"]
  node_mcp["MCP service<br/>[server.go]"]
  node_standalone["MCP manager"]
end

subgraph group_extensions["Plugins and integrations"]
  node_plugins["Plugin system<br/>[register.go]"]
  node_email["Email plugin<br/>[main.go]"]
  node_upload["File uploads<br/>[upload.go]"]
end

node_user(("Administrator"))
node_external(("Upstream LLM"))

node_user -->|"uses"| node_webapp
node_webapp -->|"hosts setup"| node_webcore
node_webapp -.->|"renders routes"| node_webrouter
node_webrouter -.->|"loads views"| node_webviews
node_webviews -.->|"requests data"| node_webapi
node_webauto -.->|"requests code"| node_webapi
node_webapi -.->|"calls REST APIs"| node_adminapi
node_servermain -->|"starts server"| node_servercore
node_servermain -->|"initializes storage"| node_database
node_servercore -->|"builds routes"| node_routes
node_servercore -->|"resolves service"| node_mcp
node_routes -->|"applies auth"| node_middleware
node_routes -.->|"registers endpoints"| node_adminapi
node_adminapi -->|"calls services"| node_adminservice
node_adminservice -->|"uses models"| node_adminmodels
node_adminapi -->|"refreshes policy"| node_adminservice
node_adminservice -.->|"persists data"| node_database
node_webauto -.->|"configures generation"| node_codegen
node_codegen -.->|"uses generation service"| node_llm
node_llm -->|"posts prompts"| node_external
node_standalone -->|"starts process"| node_mcp
node_routes -->|"installs plugins"| node_plugins
node_plugins -.->|"registers extension"| node_email
node_adminapi -.->|"supports uploads"| node_upload

click node_webapp "https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/App.vue"
click node_webcore "https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/core/gin-vue-admin.js"
click node_webrouter "https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/pinia/modules/router.js"
click node_webviews "https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/view/superAdmin/index.vue"
click node_webauto "https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/view/systemTools/autoCode/index.vue"
click node_webapi "https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/api/autoCode.js"
click node_servermain "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/main.go"
click node_servercore "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/core/server.go"
click node_routes "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/initialize/router.go"
click node_middleware "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/middleware/jwt.go"
click node_database "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/initialize/gorm.go"
click node_adminapi "https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/api/v1/system"
click node_adminservice "https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/service/system"
click node_adminmodels "https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/model/system"
click node_codegen "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/service/system/auto_code_template.go"
click node_llm "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/service/system/auto_code_llm.go"
click node_mcp "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/mcp/server.go"
click node_standalone "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/mcp/standalone_manager.go"
click node_plugins "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/plugin/register.go"
click node_email "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/plugin/email/main.go"
click node_upload "https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/utils/upload/upload.go"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_webapp,node_webcore,node_webrouter,node_webviews,node_webauto,node_webapi toneBlue
class node_servermain,node_servercore,node_routes,node_middleware,node_database toneAmber
class node_adminapi,node_adminservice,node_adminmodels toneMint
class node_codegen,node_llm,node_mcp,node_standalone toneRose
class node_plugins,node_email,node_upload,node_user,node_external toneIndigo
```

## Components

### Web interface

- [Vue application](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/App.vue): `web/src/App.vue`
- [Frontend setup](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/core/gin-vue-admin.js): `web/src/core/gin-vue-admin.js`
- [Dynamic routing](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/pinia/modules/router.js): `web/src/pinia/modules/router.js`
- [Admin views](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/view/superAdmin/index.vue): `web/src/view/superAdmin/index.vue`
- [Code tools UI](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/view/systemTools/autoCode/index.vue): `web/src/view/systemTools/autoCode/index.vue`
- [API clients](https://github.com/flipped-aurora/gin-vue-admin/blob/main/web/src/api/autoCode.js): `web/src/api/autoCode.js`

### Backend runtime

- [Server startup](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/main.go): `server/main.go`
- [HTTP runtime](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/core/server.go): `server/core/server.go`
- [Route registry](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/initialize/router.go): `server/initialize/router.go`
- [Auth middleware](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/middleware/jwt.go): `server/middleware/jwt.go`
- [SQL storage](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/initialize/gorm.go): `server/initialize/gorm.go`

### Administration

- [Admin APIs](https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/api/v1/system): `server/api/v1/system`
- [Admin services](https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/service/system): `server/service/system`
- [Domain models](https://github.com/flipped-aurora/gin-vue-admin/tree/main/server/model/system): `server/model/system`

### Automation tools

- [Code generation](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/service/system/auto_code_template.go): `server/service/system/auto_code_template.go`
- [LLM integration](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/service/system/auto_code_llm.go): `server/service/system/auto_code_llm.go`
- [MCP service](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/mcp/server.go): `server/mcp/server.go`
- [MCP manager](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/mcp/standalone_manager.go): `server/mcp/standalone_manager.go`

### Plugins and integrations

- [Plugin system](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/plugin/register.go): `server/plugin/register.go`
- [Email plugin](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/plugin/email/main.go): `server/plugin/email/main.go`
- [File uploads](https://github.com/flipped-aurora/gin-vue-admin/blob/main/server/utils/upload/upload.go): `server/utils/upload/upload.go`

### Other components

- **Administrator**
- **Upstream LLM**

## Connections

- Administrator → Vue application: uses (evidence: `README.md`)
- Vue application → Frontend setup: hosts setup (evidence: `web/src/main.js`)
- Vue application → Dynamic routing: renders routes
- Dynamic routing → Admin views: loads views
- Admin views → API clients: requests data
- Code tools UI → API clients: requests code
- API clients → Admin APIs: calls REST APIs (evidence: `README.md`)
- Server startup → HTTP runtime: starts server (evidence: `server/main.go`)
- Server startup → SQL storage: initializes storage (evidence: `server/main.go`)
- HTTP runtime → Route registry: builds routes (evidence: `server/core/server.go`)
- HTTP runtime → MCP service: resolves service (evidence: `server/core/server.go`)
- Route registry → Auth middleware: applies auth (evidence: `server/initialize/router.go`)
- Route registry → Admin APIs: registers endpoints
- Admin APIs → Admin services: calls services (evidence: `server/api/v1/system/sys_authority.go`)
- Admin services → Domain models: uses models (evidence: `server/service/system/sys_authority.go`)
- Admin APIs → Admin services: refreshes policy (evidence: `server/api/v1/system/sys_authority.go`)
- Admin services → SQL storage: persists data
- Code tools UI → Code generation: configures generation
- Code generation → LLM integration: uses generation service
- LLM integration → Upstream LLM: posts prompts (evidence: `server/service/system/auto_code_llm.go`)
- MCP manager → MCP service: starts process (evidence: `server/mcp/standalone_manager.go`)
- Route registry → Plugin system: installs plugins (evidence: `server/initialize/router.go`)
- Plugin system → Email plugin: registers extension
- Admin APIs → File uploads: supports uploads (evidence: `README.md`)
