# fs185085781/v9os architecture

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

- Interactive diagram: https://gitdiagram.com/fs185085781/v9os
- Repository: https://github.com/fs185085781/v9os

## Overview

V9OS is a Go/Vue backend management system with selectable desktop-style interfaces and a plugin-oriented backend. The user-facing path is browser → selected interface/login → desktop or admin panel → settings, app store, and management views; the Go server supplies HTTP routes and initializes runtime services. README-documented capabilities include generated CRUD, distributed plugins, configurable persistence and messaging, internationalization, and multiple themes. Relationships for unsampled subsystems are based on README statements; source excerpts confirm frontend shell selection and server initialization, but do not expose all route wiring.

Main entry points: [`api/internal/server/server.go`](https://github.com/fs185085781/v9os/blob/main/api/internal/server/server.go) (HTTP server), [`web/src/App.vue`](https://github.com/fs185085781/v9os/blob/main/web/src/App.vue) (Mode selector), [`web/src/components/backend/Layout.vue`](https://github.com/fs185085781/v9os/blob/main/web/src/components/backend/Layout.vue) (Backend UI), [`web/src/components/macos/App.vue`](https://github.com/fs185085781/v9os/blob/main/web/src/components/macos/App.vue) (macOS shell)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_frontend["Web interface"]
  node_webboot["Web bootstrap<br/>[main.js]"]
  node_appselect["Mode selector<br/>[App.vue]"]
  node_userstate["User state<br/>[user.js]"]
  node_backendui["Backend UI<br/>[Layout.vue]"]
  node_backendlogin["Backend login<br/>[Login.vue]"]
  node_desktopui["Desktop shells<br/>[Desktop.vue]"]
  node_macshell["macOS shell<br/>[App.vue]"]
  node_winshell["Windows shell<br/>[App.vue]"]
  node_deepinshell["Deepin shell<br/>[App.vue]"]
  node_pluginui["Plugin management UI<br/>[index.vue]"]
  node_settingsui["User settings UI"]
end

subgraph group_backend["Backend runtime"]
  node_console["Console entry<br/>[main.go]"]
  node_gui["GUI entry<br/>[main.go]"]
  node_server["HTTP server<br/>[server.go]"]
  node_controllers["API controllers"]
  node_auth["Authentication middleware<br/>[auth.go]"]
end

subgraph group_extensibility["Plugins and APIs"]
  node_pluginmgr["Plugin manager"]
  node_pluginapi["Shared plugin API<br/>[plugin.go]"]
end

subgraph group_services["Runtime services"]
  node_config["Configuration"]
  node_cache["Cache providers"]
  node_queue["Queue providers"]
  node_logger["Logging providers"]
end

subgraph group_data["Persistence"]
  node_database[("Database adapters")]
  node_models["Domain models"]
  node_store["File storage"]
end

node_browser(("User browser"))
node_externaldb[("External databases")]
node_redis[("Redis")]
node_rocketmq["RocketMQ"]

node_browser -->|"opens"| node_webboot
node_webboot -->|"mounts"| node_appselect
node_appselect -->|"selects mode"| node_macshell
node_appselect -->|"selects mode"| node_winshell
node_appselect -->|"selects mode"| node_deepinshell
node_appselect -->|"selects mode"| node_backendui
node_appselect -->|"reads settings"| node_userstate
node_macshell -->|"renders"| node_desktopui
node_macshell -.->|"uses login form"| node_backendlogin
node_winshell -.->|"uses login form"| node_backendlogin
node_deepinshell -.->|"uses login form"| node_backendlogin
node_desktopui -->|"reads preferences"| node_userstate
node_backendui -.->|"offers management"| node_pluginui
node_backendui -.->|"offers settings"| node_settingsui
node_console -.->|"starts runtime"| node_server
node_gui -->|"starts runtime"| node_server
node_server -->|"reads configuration"| node_config
node_server -->|"initializes"| node_cache
node_server -->|"initializes"| node_database
node_server -.->|"initializes"| node_queue
node_server -->|"registers manager"| node_pluginmgr
node_server -->|"routes requests"| node_controllers
node_server -->|"installs middleware"| node_auth
node_controllers -.->|"manages domain data"| node_models
node_pluginui -.->|"manages plugins"| node_controllers
node_pluginmgr -.->|"hosts extensions"| node_pluginapi
node_database -.->|"supports drivers"| node_externaldb
node_cache -.->|"optional backend"| node_redis
node_queue -.->|"optional backend"| node_rocketmq
node_server -->|"registers storage"| node_store
node_server -.->|"uses logging"| node_logger

click node_webboot "https://github.com/fs185085781/v9os/blob/main/web/src/main.js"
click node_appselect "https://github.com/fs185085781/v9os/blob/main/web/src/App.vue"
click node_userstate "https://github.com/fs185085781/v9os/blob/main/web/src/stores/user.js"
click node_backendui "https://github.com/fs185085781/v9os/blob/main/web/src/components/backend/Layout.vue"
click node_backendlogin "https://github.com/fs185085781/v9os/blob/main/web/src/components/backend/Login.vue"
click node_desktopui "https://github.com/fs185085781/v9os/blob/main/web/src/components/macos/Desktop.vue"
click node_macshell "https://github.com/fs185085781/v9os/blob/main/web/src/components/macos/App.vue"
click node_winshell "https://github.com/fs185085781/v9os/blob/main/web/src/components/win10/App.vue"
click node_deepinshell "https://github.com/fs185085781/v9os/blob/main/web/src/components/deepin/App.vue"
click node_pluginui "https://github.com/fs185085781/v9os/blob/main/web/src/components/common/views/plugin/plugin/index.vue"
click node_settingsui "https://github.com/fs185085781/v9os/blob/main/web/src/components/common/modules/settings/SystemSettingsPanel.vue"
click node_console "https://github.com/fs185085781/v9os/blob/main/api/cmd/console/main.go"
click node_gui "https://github.com/fs185085781/v9os/blob/main/api/cmd/gui/main.go"
click node_server "https://github.com/fs185085781/v9os/blob/main/api/internal/server/server.go"
click node_controllers "https://github.com/fs185085781/v9os/tree/main/api/internal/controller"
click node_auth "https://github.com/fs185085781/v9os/blob/main/api/internal/middleware/auth.go"
click node_pluginmgr "https://github.com/fs185085781/v9os/tree/main/api/internal/plugin/manager"
click node_pluginapi "https://github.com/fs185085781/v9os/blob/main/share/plugin/plugin.go"
click node_config "https://github.com/fs185085781/v9os/tree/main/api/internal/config"
click node_cache "https://github.com/fs185085781/v9os/tree/main/api/internal/cache"
click node_queue "https://github.com/fs185085781/v9os/tree/main/api/internal/queue"
click node_logger "https://github.com/fs185085781/v9os/tree/main/api/internal/logger"
click node_database "https://github.com/fs185085781/v9os/tree/main/api/internal/database"
click node_models "https://github.com/fs185085781/v9os/tree/main/api/internal/model"
click node_store "https://github.com/fs185085781/v9os/tree/main/api/internal/store"

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_webboot,node_appselect,node_userstate,node_backendui,node_backendlogin,node_desktopui,node_macshell,node_winshell,node_deepinshell,node_pluginui,node_settingsui,node_browser toneBlue
class node_console,node_gui,node_server,node_controllers,node_auth,node_externaldb,node_redis toneAmber
class node_pluginmgr,node_pluginapi toneMint
class node_config,node_cache,node_queue,node_logger toneRose
class node_database,node_models,node_store,node_rocketmq toneIndigo
```

## Components

### Web interface

- [Web bootstrap](https://github.com/fs185085781/v9os/blob/main/web/src/main.js): `web/src/main.js`
- [Mode selector](https://github.com/fs185085781/v9os/blob/main/web/src/App.vue): `web/src/App.vue`
- [User state](https://github.com/fs185085781/v9os/blob/main/web/src/stores/user.js): `web/src/stores/user.js`
- [Backend UI](https://github.com/fs185085781/v9os/blob/main/web/src/components/backend/Layout.vue): `web/src/components/backend/Layout.vue`
- [Backend login](https://github.com/fs185085781/v9os/blob/main/web/src/components/backend/Login.vue): `web/src/components/backend/Login.vue`
- [Desktop shells](https://github.com/fs185085781/v9os/blob/main/web/src/components/macos/Desktop.vue): `web/src/components/macos/Desktop.vue`
- [macOS shell](https://github.com/fs185085781/v9os/blob/main/web/src/components/macos/App.vue): `web/src/components/macos/App.vue`
- [Windows shell](https://github.com/fs185085781/v9os/blob/main/web/src/components/win10/App.vue): `web/src/components/win10/App.vue`
- [Deepin shell](https://github.com/fs185085781/v9os/blob/main/web/src/components/deepin/App.vue): `web/src/components/deepin/App.vue`
- [Plugin management UI](https://github.com/fs185085781/v9os/blob/main/web/src/components/common/views/plugin/plugin/index.vue): `web/src/components/common/views/plugin/plugin/index.vue`
- [User settings UI](https://github.com/fs185085781/v9os/blob/main/web/src/components/common/modules/settings/SystemSettingsPanel.vue): `web/src/components/common/modules/settings/SystemSettingsPanel.vue`

### Backend runtime

- [Console entry](https://github.com/fs185085781/v9os/blob/main/api/cmd/console/main.go): `api/cmd/console/main.go`
- [GUI entry](https://github.com/fs185085781/v9os/blob/main/api/cmd/gui/main.go): `api/cmd/gui/main.go`
- [HTTP server](https://github.com/fs185085781/v9os/blob/main/api/internal/server/server.go): `api/internal/server/server.go`
- [API controllers](https://github.com/fs185085781/v9os/tree/main/api/internal/controller): `api/internal/controller`
- [Authentication middleware](https://github.com/fs185085781/v9os/blob/main/api/internal/middleware/auth.go): `api/internal/middleware/auth.go`

### Plugins and APIs

- [Plugin manager](https://github.com/fs185085781/v9os/tree/main/api/internal/plugin/manager): `api/internal/plugin/manager`
- [Shared plugin API](https://github.com/fs185085781/v9os/blob/main/share/plugin/plugin.go): `share/plugin/plugin.go`

### Runtime services

- [Configuration](https://github.com/fs185085781/v9os/tree/main/api/internal/config): `api/internal/config`
- [Cache providers](https://github.com/fs185085781/v9os/tree/main/api/internal/cache): `api/internal/cache`
- [Queue providers](https://github.com/fs185085781/v9os/tree/main/api/internal/queue): `api/internal/queue`
- [Logging providers](https://github.com/fs185085781/v9os/tree/main/api/internal/logger): `api/internal/logger`

### Persistence

- [Database adapters](https://github.com/fs185085781/v9os/tree/main/api/internal/database): `api/internal/database`
- [Domain models](https://github.com/fs185085781/v9os/tree/main/api/internal/model): `api/internal/model`
- [File storage](https://github.com/fs185085781/v9os/tree/main/api/internal/store): `api/internal/store`

### Other components

- **User browser**
- **External databases**
- **Redis**
- **RocketMQ**

## Connections

- User browser → Web bootstrap: opens (evidence: `README.md`)
- Web bootstrap → Mode selector: mounts (evidence: `web/src/main.js`)
- Mode selector → macOS shell: selects mode (evidence: `web/src/App.vue`)
- Mode selector → Windows shell: selects mode (evidence: `web/src/App.vue`)
- Mode selector → Deepin shell: selects mode (evidence: `web/src/App.vue`)
- Mode selector → Backend UI: selects mode (evidence: `web/src/App.vue`)
- Mode selector → User state: reads settings (evidence: `web/src/App.vue`)
- macOS shell → Desktop shells: renders (evidence: `web/src/components/macos/App.vue`)
- macOS shell → Backend login: uses login form (evidence: `web/src/components/macos/App.vue`)
- Windows shell → Backend login: uses login form (evidence: `web/src/components/win10/App.vue`)
- Deepin shell → Backend login: uses login form (evidence: `web/src/components/deepin/App.vue`)
- Desktop shells → User state: reads preferences (evidence: `web/src/components/macos/Desktop.vue`)
- Backend UI → Plugin management UI: offers management (evidence: `README.md`)
- Backend UI → User settings UI: offers settings (evidence: `README.md`)
- Console entry → HTTP server: starts runtime (evidence: `README.md`)
- GUI entry → HTTP server: starts runtime
- HTTP server → Configuration: reads configuration (evidence: `api/internal/server/server.go`)
- HTTP server → Cache providers: initializes (evidence: `api/internal/server/server.go`)
- HTTP server → Database adapters: initializes (evidence: `api/internal/server/server.go`)
- HTTP server → Queue providers: initializes (evidence: `api/internal/server/server.go`)
- HTTP server → Plugin manager: registers manager (evidence: `api/internal/server/server.go`)
- HTTP server → API controllers: routes requests (evidence: `api/internal/server/server.go`)
- HTTP server → Authentication middleware: installs middleware (evidence: `api/internal/server/server.go`)
- API controllers → Domain models: manages domain data (evidence: `README.md`)
- Plugin management UI → API controllers: manages plugins (evidence: `README.md`)
- Plugin manager → Shared plugin API: hosts extensions (evidence: `README.md`)
- Database adapters → External databases: supports drivers (evidence: `README.md`)
- Cache providers → Redis: optional backend (evidence: `README.md`)
- Queue providers → RocketMQ: optional backend (evidence: `README.md`)
- HTTP server → File storage: registers storage (evidence: `api/internal/server/server.go`)
- HTTP server → Logging providers: uses logging (evidence: `README.md`)
