# uvdesk/community-skeleton architecture

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

- Interactive diagram: https://gitdiagram.com/uvdesk/community-skeleton
- Repository: https://github.com/uvdesk/community-skeleton

## Overview

UVdesk Community is a Symfony-based helpdesk skeleton; the principal local workflow is first-run setup: an administrator configures the installation, database settings are checked and saved, and the system is prepared for helpdesk use. The README documents ticketing, mailbox ingestion, automation, support-center, API, and extension capabilities supplied by packages rather than implemented in the sampled local source. Those package-level branches are shown as external dependencies. Several runtime routes and service registrations were not sampled, so uncertain links are omitted.

Main entry points: [`src/Controller/ConfigureHelpdesk.php`](https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ConfigureHelpdesk.php) (Web Installer), [`public/index.php`](https://github.com/uvdesk/community-skeleton/blob/master/public/index.php) (HTTP Entry), [`src/Controller/BaseController.php`](https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/BaseController.php) (Home Dispatcher), [`src/Console/Wizard/ConfigureHelpdesk.php`](https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/ConfigureHelpdesk.php) (Console Setup)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_setup["Installation"]
  node_web_installer["Web Installer"]
  node_install_ui["Installer Interface<br/>[index.html.twig]"]
  node_wizard_script["Wizard Client<br/>[wizard.js]"]
  node_cli_setup["Console Setup"]
  node_env_update["Environment Update"]
  node_db_migrate["Database Migration"]
  node_user_create["Default User Setup<br/>[DefaultUser.php]"]
end

subgraph group_runtime["Application Runtime"]
  node_web["HTTP Entry<br/>[index.php]"]
  node_base["Home Dispatcher<br/>[BaseController.php]"]
  node_exception_handler["Exception Handler"]
end

subgraph group_helpdesk["Helpdesk Packages"]
  node_core["Core Framework"]
  node_automation["Automation"]
  node_mailbox["Mailbox Ingestion"]
  node_support_center["Support Center"]
  node_api["API Bundle"]
  node_extensions["Extension Framework"]
end

subgraph group_support["Support Services"]
  node_database[("Configured Database<br/>[doctrine.yaml]")]
  node_image_endpoint["Image Cache Endpoint"]
  node_image_cache["URL Image Cache"]
  node_image_manager["Remote Image Loader<br/>[ImageManager.php]"]
end

node_admin(("Administrator"))

node_admin -->|"requests helpdesk"| node_web
node_web -.->|"routes requests"| node_base
node_base -->|"forwards setup"| node_web_installer
node_base -.->|"redirects to portal"| node_support_center
node_base -.->|"redirects to helpdesk"| node_core
node_admin -->|"configures installation"| node_install_ui
node_install_ui -.->|"uses client script"| node_wizard_script
node_wizard_script -.->|"submits setup"| node_web_installer
node_web_installer -->|"checks connection"| node_database
node_web_installer -->|"updates credentials"| node_env_update
node_cli_setup -->|"runs command"| node_env_update
node_cli_setup -->|"creates admin"| node_user_create
node_cli_setup -->|"migrates schema"| node_database
node_db_migrate -->|"creates or migrates"| node_database
node_web_installer -->|"records setup"| node_cli_setup
node_core -.->|"supports workflows"| node_automation
node_mailbox -->|"converts email tickets"| node_core
node_support_center -->|"enables customer portal"| node_core
node_api -.->|"extends interfaces"| node_core
node_extensions -->|"extends packages"| node_core
node_web -.->|"serves image route"| node_image_endpoint
node_image_endpoint -->|"gets cached image"| node_image_cache
node_image_cache -->|"loads image"| node_image_manager
node_web -.->|"dispatches exceptions"| node_exception_handler

click node_web "https://github.com/uvdesk/community-skeleton/blob/master/public/index.php"
click node_base "https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/BaseController.php"
click node_web_installer "https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ConfigureHelpdesk.php"
click node_install_ui "https://github.com/uvdesk/community-skeleton/blob/master/templates/installation-wizard/index.html.twig"
click node_wizard_script "https://github.com/uvdesk/community-skeleton/blob/master/public/scripts/wizard.js"
click node_cli_setup "https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/ConfigureHelpdesk.php"
click node_env_update "https://github.com/uvdesk/community-skeleton/blob/master/src/Console/EnvironmentVariables.php"
click node_db_migrate "https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/MigrateDatabase.php"
click node_user_create "https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/DefaultUser.php"
click node_database "https://github.com/uvdesk/community-skeleton/blob/master/config/packages/doctrine.yaml"
click node_image_endpoint "https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ImageCache/ImageCacheController.php"
click node_image_cache "https://github.com/uvdesk/community-skeleton/blob/master/src/Service/UrlImageCacheService.php"
click node_image_manager "https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ImageCache/ImageManager.php"
click node_exception_handler "https://github.com/uvdesk/community-skeleton/blob/master/src/EventListener/ExceptionSubscriber.php"

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_web_installer,node_install_ui,node_wizard_script,node_cli_setup,node_env_update,node_db_migrate,node_user_create toneBlue
class node_web,node_base,node_exception_handler toneAmber
class node_core,node_automation,node_mailbox,node_support_center,node_api,node_extensions toneMint
class node_database,node_image_endpoint,node_image_cache,node_image_manager toneRose
class node_admin toneIndigo
```

## Components

### Installation

- [Web Installer](https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ConfigureHelpdesk.php): `src/Controller/ConfigureHelpdesk.php`
- [Installer Interface](https://github.com/uvdesk/community-skeleton/blob/master/templates/installation-wizard/index.html.twig): `templates/installation-wizard/index.html.twig`
- [Wizard Client](https://github.com/uvdesk/community-skeleton/blob/master/public/scripts/wizard.js): `public/scripts/wizard.js`
- [Console Setup](https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/ConfigureHelpdesk.php): `src/Console/Wizard/ConfigureHelpdesk.php`
- [Environment Update](https://github.com/uvdesk/community-skeleton/blob/master/src/Console/EnvironmentVariables.php): `src/Console/EnvironmentVariables.php`
- [Database Migration](https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/MigrateDatabase.php): `src/Console/Wizard/MigrateDatabase.php`
- [Default User Setup](https://github.com/uvdesk/community-skeleton/blob/master/src/Console/Wizard/DefaultUser.php): `src/Console/Wizard/DefaultUser.php`

### Application Runtime

- [HTTP Entry](https://github.com/uvdesk/community-skeleton/blob/master/public/index.php): `public/index.php`
- [Home Dispatcher](https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/BaseController.php): `src/Controller/BaseController.php`
- [Exception Handler](https://github.com/uvdesk/community-skeleton/blob/master/src/EventListener/ExceptionSubscriber.php): `src/EventListener/ExceptionSubscriber.php`

### Helpdesk Packages

- **Core Framework**
- **Automation**
- **Mailbox Ingestion**
- **Support Center**
- **API Bundle**
- **Extension Framework**

### Support Services

- [Configured Database](https://github.com/uvdesk/community-skeleton/blob/master/config/packages/doctrine.yaml): `config/packages/doctrine.yaml`
- [Image Cache Endpoint](https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ImageCache/ImageCacheController.php): `src/Controller/ImageCache/ImageCacheController.php`
- [URL Image Cache](https://github.com/uvdesk/community-skeleton/blob/master/src/Service/UrlImageCacheService.php): `src/Service/UrlImageCacheService.php`
- [Remote Image Loader](https://github.com/uvdesk/community-skeleton/blob/master/src/Controller/ImageCache/ImageManager.php): `src/Controller/ImageCache/ImageManager.php`

### Other components

- **Administrator**

## Connections

- Administrator → HTTP Entry: requests helpdesk (evidence: `README.md`)
- HTTP Entry → Home Dispatcher: routes requests
- Home Dispatcher → Web Installer: forwards setup (evidence: `src/Controller/BaseController.php`)
- Home Dispatcher → Support Center: redirects to portal
- Home Dispatcher → Core Framework: redirects to helpdesk
- Administrator → Installer Interface: configures installation (evidence: `README.md`)
- Installer Interface → Wizard Client: uses client script
- Wizard Client → Web Installer: submits setup
- Web Installer → Configured Database: checks connection (evidence: `src/Controller/ConfigureHelpdesk.php`)
- Web Installer → Environment Update: updates credentials (evidence: `src/Controller/ConfigureHelpdesk.php`)
- Console Setup → Environment Update: runs command (evidence: `src/Console/Wizard/ConfigureHelpdesk.php`)
- Console Setup → Default User Setup: creates admin (evidence: `src/Console/Wizard/ConfigureHelpdesk.php`)
- Console Setup → Configured Database: migrates schema (evidence: `src/Console/Wizard/ConfigureHelpdesk.php`)
- Database Migration → Configured Database: creates or migrates (evidence: `src/Console/Wizard/MigrateDatabase.php`)
- Web Installer → Console Setup: records setup (evidence: `src/Controller/ConfigureHelpdesk.php`)
- Core Framework → Automation: supports workflows (evidence: `README.md`)
- Mailbox Ingestion → Core Framework: converts email tickets (evidence: `README.md`)
- Support Center → Core Framework: enables customer portal (evidence: `README.md`)
- API Bundle → Core Framework: extends interfaces (evidence: `README.md`)
- Extension Framework → Core Framework: extends packages (evidence: `README.md`)
- HTTP Entry → Image Cache Endpoint: serves image route
- Image Cache Endpoint → URL Image Cache: gets cached image (evidence: `src/Controller/ImageCache/ImageCacheController.php`)
- URL Image Cache → Remote Image Loader: loads image (evidence: `src/Service/UrlImageCacheService.php`)
- HTTP Entry → Exception Handler: dispatches exceptions
