# yukitsune/cpdlcplugin architecture

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

- Interactive diagram: https://gitdiagram.com/yukitsune/cpdlcplugin
- Repository: https://github.com/yukitsune/cpdlcplugin

## Overview

CPDLC Plugin adds controller-to-aircraft datalink messaging to vatSys through a relay server. The main workflow runs from a controller’s plugin interface over SignalR to the server hub, which dispatches commands and queries; the server manages dialogues and relays ACARS traffic to aircraft. The plugin also supports message history, setup, status labels, and connection management. The graph reflects documented capabilities and sampled call paths; several server subsystems are represented at directory level because their implementations were not sampled.

Main entry points: [`source/CPDLCServer/Handlers`](https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCServer/Handlers) (Command Handlers), [`source/CPDLCPlugin/Server/SignalRConnectionManager.cs`](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCPlugin/Server/SignalRConnectionManager.cs) (SignalR Client), [`source/CPDLCServer/Clients/ClientManager.cs`](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Clients/ClientManager.cs) (ACARS Client Manager), [`source/CPDLCServer/Clients/HoppieAcarsClient.cs`](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Clients/HoppieAcarsClient.cs) (Hoppie Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["vatSys Plugin"]
  node_plugin["Plugin Entry<br/>[Plugin.cs]"]
  node_windows["Plugin Windows"]
  node_viewmodels["Message Views"]
  node_connection["SignalR Client"]
  node_clientstate[("Client State")]
end

subgraph group_relay["Relay Server"]
  node_hub["Controller Hub<br/>[ControllerHub.cs]"]
  node_handlers["Command Handlers"]
  node_repositories[("Repositories")]
  node_monitor["Message Monitor"]
end

subgraph group_domain["Dialogue Domain"]
  node_dialogue["Dialogue State<br/>[Dialogue.cs]"]
  node_uplink["Uplink Messages<br/>[UplinkMessage.cs]"]
  node_downlink["Downlink Messages<br/>[DownlinkMessage.cs]"]
end

subgraph group_acars["ACARS Relay"]
  node_clientmanager["ACARS Client Manager<br/>[ClientManager.cs]"]
  node_hoppie["Hoppie Client"]
end

node_controller(("Controller"))
node_aircraft(("Aircraft Network"))
node_server(("CPDLC Server"))

node_controller -->|"uses"| node_plugin
node_plugin -.->|"opens"| node_windows
node_windows -.->|"uses"| node_viewmodels
node_plugin -->|"connects"| node_connection
node_connection -->|"invokes"| node_hub
node_hub -->|"dispatches"| node_handlers
node_handlers -.->|"accesses"| node_repositories
node_handlers -.->|"updates"| node_dialogue
node_dialogue -->|"contains"| node_uplink
node_dialogue -->|"contains"| node_downlink
node_monitor -->|"reads"| node_repositories
node_monitor -->|"checks"| node_dialogue
node_monitor -.->|"publishes changes"| node_handlers
node_server -.->|"hosts"| node_clientmanager
node_clientmanager -->|"creates"| node_hoppie
node_clientmanager -->|"reads downlinks"| node_hoppie
node_hoppie -.->|"sends ACARS"| node_aircraft
node_aircraft -.->|"returns messages"| node_hoppie
node_hoppie -->|"streams messages"| node_clientmanager
node_handlers -.->|"uses clients"| node_clientmanager
node_server -->|"relays CPDLC"| node_connection
node_viewmodels -.->|"sends requests"| node_connection
node_connection -.->|"updates"| node_clientstate

click node_plugin "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCPlugin/Plugin.cs"
click node_windows "https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCPlugin/Windows"
click node_viewmodels "https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCPlugin/ViewModels"
click node_connection "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCPlugin/Server/SignalRConnectionManager.cs"
click node_clientstate "https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCPlugin"
click node_hub "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Hubs/ControllerHub.cs"
click node_handlers "https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCServer/Handlers"
click node_repositories "https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCServer/Persistence"
click node_monitor "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Services/MessageMonitorService.cs"
click node_dialogue "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Model/Dialogue.cs"
click node_uplink "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Model/UplinkMessage.cs"
click node_downlink "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Model/DownlinkMessage.cs"
click node_clientmanager "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Clients/ClientManager.cs"
click node_hoppie "https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Clients/HoppieAcarsClient.cs"

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_plugin,node_windows,node_viewmodels,node_connection,node_clientstate toneBlue
class node_hub,node_handlers,node_repositories,node_monitor toneAmber
class node_dialogue,node_uplink,node_downlink,node_server toneMint
class node_clientmanager,node_hoppie toneRose
class node_controller,node_aircraft toneIndigo
```

## Components

### vatSys Plugin

- [Plugin Entry](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCPlugin/Plugin.cs): `source/CPDLCPlugin/Plugin.cs`
- [Plugin Windows](https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCPlugin/Windows): `source/CPDLCPlugin/Windows`
- [Message Views](https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCPlugin/ViewModels): `source/CPDLCPlugin/ViewModels`
- [SignalR Client](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCPlugin/Server/SignalRConnectionManager.cs): `source/CPDLCPlugin/Server/SignalRConnectionManager.cs`
- [Client State](https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCPlugin): `source/CPDLCPlugin`

### Relay Server

- [Controller Hub](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Hubs/ControllerHub.cs): `source/CPDLCServer/Hubs/ControllerHub.cs`
- [Command Handlers](https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCServer/Handlers): `source/CPDLCServer/Handlers`
- [Repositories](https://github.com/yukitsune/cpdlcplugin/tree/main/source/CPDLCServer/Persistence): `source/CPDLCServer/Persistence`
- [Message Monitor](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Services/MessageMonitorService.cs): `source/CPDLCServer/Services/MessageMonitorService.cs`

### Dialogue Domain

- [Dialogue State](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Model/Dialogue.cs): `source/CPDLCServer/Model/Dialogue.cs`
- [Uplink Messages](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Model/UplinkMessage.cs): `source/CPDLCServer/Model/UplinkMessage.cs`
- [Downlink Messages](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Model/DownlinkMessage.cs): `source/CPDLCServer/Model/DownlinkMessage.cs`

### ACARS Relay

- [ACARS Client Manager](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Clients/ClientManager.cs): `source/CPDLCServer/Clients/ClientManager.cs`
- [Hoppie Client](https://github.com/yukitsune/cpdlcplugin/blob/main/source/CPDLCServer/Clients/HoppieAcarsClient.cs): `source/CPDLCServer/Clients/HoppieAcarsClient.cs`

### Other components

- **Controller**
- **Aircraft Network**
- **CPDLC Server**

## Connections

- Controller → Plugin Entry: uses (evidence: `README.md`)
- Plugin Entry → Plugin Windows: opens (evidence: `source/CPDLCPlugin/Plugin.cs`)
- Plugin Windows → Message Views: uses
- Plugin Entry → SignalR Client: connects (evidence: `source/CPDLCPlugin/Server/SignalRConnectionManager.cs`)
- SignalR Client → Controller Hub: invokes (evidence: `source/CPDLCPlugin/Server/SignalRConnectionManager.cs`)
- Controller Hub → Command Handlers: dispatches (evidence: `source/CPDLCServer/Hubs/ControllerHub.cs`)
- Command Handlers → Repositories: accesses (evidence: `source/CPDLCServer/Handlers/ControllerConnectedNotificationHandler.cs`)
- Command Handlers → Dialogue State: updates
- Dialogue State → Uplink Messages: contains (evidence: `source/CPDLCServer/Model/Dialogue.cs`)
- Dialogue State → Downlink Messages: contains (evidence: `source/CPDLCServer/Model/Dialogue.cs`)
- Message Monitor → Repositories: reads (evidence: `source/CPDLCServer/Services/MessageMonitorService.cs`)
- Message Monitor → Dialogue State: checks (evidence: `source/CPDLCServer/Services/MessageMonitorService.cs`)
- Message Monitor → Command Handlers: publishes changes
- CPDLC Server → ACARS Client Manager: hosts
- ACARS Client Manager → Hoppie Client: creates (evidence: `source/CPDLCServer/Clients/ClientManager.cs`)
- ACARS Client Manager → Hoppie Client: reads downlinks (evidence: `source/CPDLCServer/Clients/ClientManager.cs`)
- Hoppie Client → Aircraft Network: sends ACARS
- Aircraft Network → Hoppie Client: returns messages
- Hoppie Client → ACARS Client Manager: streams messages (evidence: `source/CPDLCServer/Clients/ClientManager.cs`)
- Command Handlers → ACARS Client Manager: uses clients
- CPDLC Server → SignalR Client: relays CPDLC (evidence: `README.md`)
- Message Views → SignalR Client: sends requests
- SignalR Client → Client State: updates (evidence: `source/CPDLCPlugin/Server/SignalRConnectionManager.cs`)
