# snider967/vms-expanded-admin-dashboard architecture

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

- Interactive diagram: https://gitdiagram.com/snider967/vms-expanded-admin-dashboard
- Repository: https://github.com/snider967/vms-expanded-admin-dashboard

## Overview

This is a Jellyfin administrator dashboard plugin for diagnostics, activity and storage trends, import checks, and Discord notifications. The principal workflow is an administrator opening the dashboard, whose routes serve diagnostic controllers that gather probes and retained snapshots for display. Scheduled tasks separately scan diagnostics, refresh charts, report new media, and deliver health digests. The graph preserves documented integrations and stateful subsystems; some source is unsampled, so uncertain implementation links are omitted.

Main entry points: [`ScheduledDiagnostics.cs`](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ScheduledDiagnostics.cs) (Diagnostic and media tasks), [`DiagnosticsController.cs`](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DiagnosticsController.cs) (Diagnostics API), [`ArrQueue.cs`](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ArrQueue.cs) (Arr requests), [`DeskProbes.cs`](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskProbes.cs) (Diagnostic probes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard access"]
  node_dashboard["Dashboard page<br/>[desk.html]"]
  node_routes["Desk routes<br/>[DeskRoutes.cs]"]
  node_controller["Diagnostics API"]
  node_plugin["Plugin registration<br/>[Plugin.cs]"]
end

subgraph group_diagnostics["Diagnostics and trends"]
  node_probes["Diagnostic probes<br/>[DeskProbes.cs]"]
  node_snapshot["Dashboard snapshot"]
  node_arrhistory["Import history<br/>[ArrHistory.cs]"]
end

subgraph group_state["Settings and retained state"]
  node_settings[("Plugin settings<br/>[DeskSettings.cs]")]
  node_state[("Diagnostic state<br/>[DeskState.cs]")]
  node_incidents[("Incident history")]
end

subgraph group_tasks["Scheduled notifications"]
  node_registration["Task registration"]
  node_scheduled["Diagnostic and media tasks"]
  node_alerts["Health alert rules<br/>[HealthAlerts.cs]"]
  node_digest["Health digest task<br/>[HealthDigest.cs]"]
end

subgraph group_integrations["External integrations"]
  node_arrqueue["Arr requests<br/>[ArrQueue.cs]"]
  node_monitor["Uptime monitor<br/>[monitor.py]"]
end

node_admin(("Administrator"))
node_sonarr["Sonarr"]
node_radarr["Radarr"]
node_discord["Discord webhooks"]
node_jellyfin["Jellyfin server"]

node_admin -->|"opens"| node_dashboard
node_plugin -->|"registers"| node_dashboard
node_dashboard -->|"requests"| node_routes
node_routes -->|"routes to"| node_controller
node_controller -->|"runs"| node_probes
node_controller -->|"updates checks"| node_snapshot
node_controller -->|"reads and updates"| node_settings
node_controller -->|"reads history"| node_arrhistory
node_controller -->|"reads queues"| node_arrqueue
node_arrhistory -->|"requests pages"| node_arrqueue
node_arrqueue -->|"HTTP GET"| node_sonarr
node_arrqueue -->|"HTTP GET"| node_radarr
node_arrhistory -->|"samples library"| node_probes
node_probes -.->|"reads server data"| node_jellyfin
node_snapshot -->|"retains checks"| node_state
node_scheduled -->|"runs probes"| node_probes
node_scheduled -->|"refreshes charts"| node_snapshot
node_scheduled -->|"evaluates health"| node_alerts
node_scheduled -->|"records incidents"| node_incidents
node_scheduled -.->|"retains task state"| node_state
node_scheduled -.->|"sends alerts"| node_discord
node_digest -->|"reads and saves"| node_state
node_digest -->|"summarizes incidents"| node_incidents
node_digest -->|"delivers digest"| node_discord
node_registration -.->|"registers tasks"| node_scheduled
node_monitor -->|"checks health"| node_jellyfin
node_monitor -->|"sends outage alerts"| node_discord

click node_dashboard "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/Pages/desk.html"
click node_routes "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskRoutes.cs"
click node_controller "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DiagnosticsController.cs"
click node_plugin "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/Plugin.cs"
click node_probes "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskProbes.cs"
click node_snapshot "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DashboardSnapshot.cs"
click node_arrhistory "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ArrHistory.cs"
click node_arrqueue "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ArrQueue.cs"
click node_settings "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskSettings.cs"
click node_state "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskState.cs"
click node_incidents "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DiagnosticIncidents.cs"
click node_registration "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskTaskRegistration.cs"
click node_scheduled "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ScheduledDiagnostics.cs"
click node_alerts "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/HealthAlerts.cs"
click node_digest "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/HealthDigest.cs"
click node_monitor "https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/Scripts/monitor.py"

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_dashboard,node_routes,node_controller,node_plugin toneBlue
class node_probes,node_snapshot,node_arrhistory toneAmber
class node_settings,node_state,node_incidents,node_discord,node_jellyfin toneMint
class node_registration,node_scheduled,node_alerts,node_digest toneRose
class node_arrqueue,node_monitor,node_admin,node_sonarr,node_radarr toneIndigo
```

## Components

### Dashboard access

- [Dashboard page](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/Pages/desk.html): `Pages/desk.html`
- [Desk routes](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskRoutes.cs): `DeskRoutes.cs`
- [Diagnostics API](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DiagnosticsController.cs): `DiagnosticsController.cs`
- [Plugin registration](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/Plugin.cs): `Plugin.cs`

### Diagnostics and trends

- [Diagnostic probes](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskProbes.cs): `DeskProbes.cs`
- [Dashboard snapshot](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DashboardSnapshot.cs): `DashboardSnapshot.cs`
- [Import history](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ArrHistory.cs): `ArrHistory.cs`

### Settings and retained state

- [Plugin settings](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskSettings.cs): `DeskSettings.cs`
- [Diagnostic state](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskState.cs): `DeskState.cs`
- [Incident history](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DiagnosticIncidents.cs): `DiagnosticIncidents.cs`

### Scheduled notifications

- [Task registration](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/DeskTaskRegistration.cs): `DeskTaskRegistration.cs`
- [Diagnostic and media tasks](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ScheduledDiagnostics.cs): `ScheduledDiagnostics.cs`
- [Health alert rules](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/HealthAlerts.cs): `HealthAlerts.cs`
- [Health digest task](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/HealthDigest.cs): `HealthDigest.cs`

### External integrations

- [Arr requests](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/ArrQueue.cs): `ArrQueue.cs`
- [Uptime monitor](https://github.com/snider967/vms-expanded-admin-dashboard/blob/main/Scripts/monitor.py): `Scripts/monitor.py`

### Other components

- **Administrator**
- **Sonarr**
- **Radarr**
- **Discord webhooks**
- **Jellyfin server**

## Connections

- Administrator → Dashboard page: opens (evidence: `README.md`)
- Plugin registration → Dashboard page: registers (evidence: `Plugin.cs`)
- Dashboard page → Desk routes: requests (evidence: `README.md`)
- Desk routes → Diagnostics API: routes to (evidence: `DeskRoutes.cs`)
- Diagnostics API → Diagnostic probes: runs (evidence: `DiagnosticsController.cs`)
- Diagnostics API → Dashboard snapshot: updates checks (evidence: `DiagnosticsController.cs`)
- Diagnostics API → Plugin settings: reads and updates (evidence: `DiagnosticsController.cs`)
- Diagnostics API → Import history: reads history (evidence: `DiagnosticsController.cs`)
- Diagnostics API → Arr requests: reads queues (evidence: `DiagnosticsController.cs`)
- Import history → Arr requests: requests pages (evidence: `ArrHistory.cs`)
- Arr requests → Sonarr: HTTP GET (evidence: `ArrQueue.cs`)
- Arr requests → Radarr: HTTP GET (evidence: `ArrQueue.cs`)
- Import history → Diagnostic probes: samples library (evidence: `ArrHistory.cs`)
- Diagnostic probes → Jellyfin server: reads server data (evidence: `README.md`)
- Dashboard snapshot → Diagnostic state: retains checks (evidence: `DashboardSnapshot.cs`)
- Diagnostic and media tasks → Diagnostic probes: runs probes (evidence: `ScheduledDiagnostics.cs`)
- Diagnostic and media tasks → Dashboard snapshot: refreshes charts (evidence: `DashboardSnapshot.cs`)
- Diagnostic and media tasks → Health alert rules: evaluates health (evidence: `ScheduledDiagnostics.cs`)
- Diagnostic and media tasks → Incident history: records incidents (evidence: `ScheduledDiagnostics.cs`)
- Diagnostic and media tasks → Diagnostic state: retains task state (evidence: `README.md`)
- Diagnostic and media tasks → Discord webhooks: sends alerts (evidence: `README.md`)
- Health digest task → Diagnostic state: reads and saves (evidence: `HealthDigest.cs`)
- Health digest task → Incident history: summarizes incidents (evidence: `README.md`)
- Health digest task → Discord webhooks: delivers digest (evidence: `HealthDigest.cs`)
- Task registration → Diagnostic and media tasks: registers tasks
- Uptime monitor → Jellyfin server: checks health (evidence: `README.md`)
- Uptime monitor → Discord webhooks: sends outage alerts (evidence: `README.md`)
