# halseyspicy/geeker-admin architecture

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

- Interactive diagram: https://gitdiagram.com/halseyspicy/geeker-admin
- Repository: https://github.com/halseyspicy/geeker-admin

## Overview

Geeker-Admin is a Vue-based administrative dashboard framework. The principal workflow is a browser user signing in, passing route and permission checks, and entering a dynamically assembled administrative UI; pages can then use shared table and API facilities to display or update data. Other documented capabilities include configurable layouts and themes, internationalization, cached pages, button-level permissions, reusable components and directives, and data-visualization screens. Source excerpts establish the app entry, routing, API, and theme behavior; several feature links below reflect README descriptions because their implementation was not sampled.

Main entry points: [`src/routers/index.ts`](https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/index.ts) (Route guard), [`src/views`](https://github.com/halseyspicy/geeker-admin/tree/master/src/views) (Admin pages), [`src/main.ts`](https://github.com/halseyspicy/geeker-admin/blob/master/src/main.ts) (App bootstrap), [`src/App.vue`](https://github.com/halseyspicy/geeker-admin/blob/master/src/App.vue) (App shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["App runtime"]
  node_entry["App bootstrap<br/>[main.ts]"]
  node_root["App shell<br/>[App.vue]"]
  node_apiclient["HTTP client<br/>[index.ts]"]
end

subgraph group_access["Access control"]
  node_router["Route guard<br/>[index.ts]"]
  node_staticroutes["Static routes<br/>[staticRouter.ts]"]
  node_dynamicroutes["Dynamic routes<br/>[dynamicRouter.ts]"]
  node_auth["Menu permissions<br/>[auth.ts]"]
  node_user["User session<br/>[user.ts]"]
  node_login["Login screen<br/>[index.vue]"]
  node_loginform["Login API<br/>[login.ts]"]
end

subgraph group_interface["Admin interface"]
  node_layout["Layout selector<br/>[index.vue]"]
  node_layouts["Layout variants"]
  node_globalstate["Global preferences<br/>[global.ts]"]
  node_theme["Theme behavior<br/>[useTheme.ts]"]
  node_i18n["Language support<br/>[index.ts]"]
  node_pagecache["Page caching<br/>[keepAlive.ts]"]
end

subgraph group_capabilities["Product features"]
  node_protable["ProTable<br/>[index.vue]"]
  node_tablehook["Table state hook<br/>[useTable.ts]"]
  node_adminpages["Admin pages"]
  node_visualization["Data visualizations"]
  node_directives["Custom directives<br/>[index.ts]"]
  node_components["Reusable components"]
end

node_browser(("Browser user"))
node_backend["Mock API services"]

node_browser -->|"opens app"| node_entry
node_entry -->|"mounts"| node_root
node_root -->|"renders routes"| node_router
node_router -->|"registers"| node_staticroutes
node_router -->|"checks token"| node_user
node_router -->|"checks permissions"| node_auth
node_router -->|"initializes"| node_dynamicroutes
node_dynamicroutes -->|"loads menus"| node_auth
node_dynamicroutes -->|"clears invalid session"| node_user
node_staticroutes -->|"routes to"| node_login
node_auth -->|"requests permissions"| node_loginform
node_login -.->|"authenticates"| node_loginform
node_loginform -.->|"uses client"| node_apiclient
node_apiclient -->|"sends requests"| node_backend
node_router -->|"routes into"| node_layout
node_layout -->|"selects layout"| node_layouts
node_root -->|"reads preferences"| node_globalstate
node_root -->|"initializes theme"| node_theme
node_theme -->|"updates settings"| node_globalstate
node_entry -->|"registers language"| node_i18n
node_adminpages -->|"uses tables"| node_protable
node_protable -->|"uses table state"| node_tablehook
node_adminpages -.->|"loads data"| node_apiclient
node_adminpages -->|"includes screens"| node_visualization
node_entry -->|"registers directives"| node_directives
node_adminpages -->|"uses shared UI"| node_components
node_layouts -->|"supports cached pages"| node_pagecache

click node_entry "https://github.com/halseyspicy/geeker-admin/blob/master/src/main.ts"
click node_root "https://github.com/halseyspicy/geeker-admin/blob/master/src/App.vue"
click node_router "https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/index.ts"
click node_staticroutes "https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/modules/staticRouter.ts"
click node_dynamicroutes "https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/modules/dynamicRouter.ts"
click node_auth "https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/auth.ts"
click node_user "https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/user.ts"
click node_login "https://github.com/halseyspicy/geeker-admin/blob/master/src/views/login/index.vue"
click node_loginform "https://github.com/halseyspicy/geeker-admin/blob/master/src/api/modules/login.ts"
click node_layout "https://github.com/halseyspicy/geeker-admin/blob/master/src/layouts/index.vue"
click node_layouts "https://github.com/halseyspicy/geeker-admin/tree/master/src/layouts"
click node_globalstate "https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/global.ts"
click node_theme "https://github.com/halseyspicy/geeker-admin/blob/master/src/hooks/useTheme.ts"
click node_i18n "https://github.com/halseyspicy/geeker-admin/blob/master/src/languages/index.ts"
click node_apiclient "https://github.com/halseyspicy/geeker-admin/blob/master/src/api/index.ts"
click node_protable "https://github.com/halseyspicy/geeker-admin/blob/master/src/components/ProTable/index.vue"
click node_tablehook "https://github.com/halseyspicy/geeker-admin/blob/master/src/hooks/useTable.ts"
click node_adminpages "https://github.com/halseyspicy/geeker-admin/tree/master/src/views"
click node_visualization "https://github.com/halseyspicy/geeker-admin/tree/master/src/views/dataScreen"
click node_directives "https://github.com/halseyspicy/geeker-admin/blob/master/src/directives/index.ts"
click node_components "https://github.com/halseyspicy/geeker-admin/tree/master/src/components"
click node_pagecache "https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/keepAlive.ts"

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_entry,node_root,node_apiclient,node_browser toneBlue
class node_router,node_staticroutes,node_dynamicroutes,node_auth,node_user,node_login,node_loginform toneAmber
class node_layout,node_layouts,node_globalstate,node_theme,node_i18n,node_pagecache,node_backend toneMint
class node_protable,node_tablehook,node_adminpages,node_visualization,node_directives,node_components toneRose
```

## Components

### App runtime

- [App bootstrap](https://github.com/halseyspicy/geeker-admin/blob/master/src/main.ts): `src/main.ts`
- [App shell](https://github.com/halseyspicy/geeker-admin/blob/master/src/App.vue): `src/App.vue`
- [HTTP client](https://github.com/halseyspicy/geeker-admin/blob/master/src/api/index.ts): `src/api/index.ts`

### Access control

- [Route guard](https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/index.ts): `src/routers/index.ts`
- [Static routes](https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/modules/staticRouter.ts): `src/routers/modules/staticRouter.ts`
- [Dynamic routes](https://github.com/halseyspicy/geeker-admin/blob/master/src/routers/modules/dynamicRouter.ts): `src/routers/modules/dynamicRouter.ts`
- [Menu permissions](https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/auth.ts): `src/stores/modules/auth.ts`
- [User session](https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/user.ts): `src/stores/modules/user.ts`
- [Login screen](https://github.com/halseyspicy/geeker-admin/blob/master/src/views/login/index.vue): `src/views/login/index.vue`
- [Login API](https://github.com/halseyspicy/geeker-admin/blob/master/src/api/modules/login.ts): `src/api/modules/login.ts`

### Admin interface

- [Layout selector](https://github.com/halseyspicy/geeker-admin/blob/master/src/layouts/index.vue): `src/layouts/index.vue`
- [Layout variants](https://github.com/halseyspicy/geeker-admin/tree/master/src/layouts): `src/layouts`
- [Global preferences](https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/global.ts): `src/stores/modules/global.ts`
- [Theme behavior](https://github.com/halseyspicy/geeker-admin/blob/master/src/hooks/useTheme.ts): `src/hooks/useTheme.ts`
- [Language support](https://github.com/halseyspicy/geeker-admin/blob/master/src/languages/index.ts): `src/languages/index.ts`
- [Page caching](https://github.com/halseyspicy/geeker-admin/blob/master/src/stores/modules/keepAlive.ts): `src/stores/modules/keepAlive.ts`

### Product features

- [ProTable](https://github.com/halseyspicy/geeker-admin/blob/master/src/components/ProTable/index.vue): `src/components/ProTable/index.vue`
- [Table state hook](https://github.com/halseyspicy/geeker-admin/blob/master/src/hooks/useTable.ts): `src/hooks/useTable.ts`
- [Admin pages](https://github.com/halseyspicy/geeker-admin/tree/master/src/views): `src/views`
- [Data visualizations](https://github.com/halseyspicy/geeker-admin/tree/master/src/views/dataScreen): `src/views/dataScreen`
- [Custom directives](https://github.com/halseyspicy/geeker-admin/blob/master/src/directives/index.ts): `src/directives/index.ts`
- [Reusable components](https://github.com/halseyspicy/geeker-admin/tree/master/src/components): `src/components`

### Other components

- **Browser user**
- **Mock API services**

## Connections

- Browser user → App bootstrap: opens app (evidence: `README.md`)
- App bootstrap → App shell: mounts (evidence: `src/main.ts`)
- App shell → Route guard: renders routes (evidence: `src/App.vue`)
- Route guard → Static routes: registers (evidence: `src/routers/index.ts`)
- Route guard → User session: checks token (evidence: `src/routers/index.ts`)
- Route guard → Menu permissions: checks permissions (evidence: `src/routers/index.ts`)
- Route guard → Dynamic routes: initializes (evidence: `src/routers/index.ts`)
- Dynamic routes → Menu permissions: loads menus (evidence: `src/routers/modules/dynamicRouter.ts`)
- Dynamic routes → User session: clears invalid session (evidence: `src/routers/modules/dynamicRouter.ts`)
- Static routes → Login screen: routes to (evidence: `src/routers/modules/staticRouter.ts`)
- Menu permissions → Login API: requests permissions (evidence: `src/stores/modules/auth.ts`)
- Login screen → Login API: authenticates
- Login API → HTTP client: uses client
- HTTP client → Mock API services: sends requests (evidence: `README.md`)
- Route guard → Layout selector: routes into
- Layout selector → Layout variants: selects layout (evidence: `src/layouts/index.vue`)
- App shell → Global preferences: reads preferences (evidence: `src/App.vue`)
- App shell → Theme behavior: initializes theme (evidence: `src/App.vue`)
- Theme behavior → Global preferences: updates settings (evidence: `src/hooks/useTheme.ts`)
- App bootstrap → Language support: registers language (evidence: `src/main.ts`)
- Admin pages → ProTable: uses tables (evidence: `README.md`)
- ProTable → Table state hook: uses table state (evidence: `src/components/ProTable/index.vue`)
- Admin pages → HTTP client: loads data
- Admin pages → Data visualizations: includes screens (evidence: `src/views/dataScreen/index.vue`)
- App bootstrap → Custom directives: registers directives (evidence: `src/main.ts`)
- Admin pages → Reusable components: uses shared UI (evidence: `README.md`)
- Layout variants → Page caching: supports cached pages (evidence: `README.md`)
