# lorydoor/simexams architecture

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

- Interactive diagram: https://gitdiagram.com/lorydoor/simexams
- Repository: https://github.com/lorydoor/simexams

## Overview

SimExams pairs a SalaRegia sender with a SalaSimulazione receiver. The workflow is to choose a report, optionally schedule its transmission, transfer it over TCP (or loopback), save it at the receiving end, and display it in a file-type viewer. The graph also includes sender settings and receiver reset handling. README capabilities and sampled call sites support the main flow; some implementation details, including library helpers and text/PDF viewers, were not sampled, so their connections are omitted or documented only where README evidence applies.

Main entry points: [`SalaRegia/Model/Riga.cs`](https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/Riga.cs) (Send controls), [`SalaRegia/MainWindow.xaml.cs`](https://github.com/lorydoor/simexams/blob/master/SalaRegia/MainWindow.xaml.cs) (Report selection), [`SalaSimulazione/MainWindow.xaml.cs`](https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/MainWindow.xaml.cs) (Incoming report list), [`SalaRegia/Model/InvioDati.cs`](https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/InvioDati.cs) (TCP file sender)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_sender["SalaRegia sender"]
  node_sender_ui["Report selection<br/>[MainWindow.xaml.cs]"]
  node_send_rows["Send controls<br/>[Riga.cs]"]
  node_delay["Send delay"]
  node_settings["Network settings"]
end

subgraph group_transport["TCP transfer"]
  node_send_data["TCP file sender<br/>[InvioDati.cs]"]
  node_network(("Local network"))
  node_receive_data["TCP file receiver<br/>[RicezioneDati.cs]"]
end

subgraph group_receiver["SalaSimulazione receiver"]
  node_receiver_ui["Incoming report list<br/>[MainWindow.xaml.cs]"]
  node_receive_rows["Report display rows<br/>[Riga.cs]"]
  node_viewers["File viewers"]
end

subgraph group_support["Shared UI support"]
  node_sender_library["Sender configuration<br/>[Libreria.cs]"]
  node_receiver_library["Receiver configuration<br/>[Libreria.cs]"]
end

node_operator(("Control-room operator"))

node_operator -->|"selects reports"| node_sender_ui
node_sender_ui -->|"creates rows"| node_send_rows
node_operator -->|"requests send"| node_send_rows
node_send_rows -->|"opens delay"| node_delay
node_send_rows -->|"invokes send"| node_send_data
node_sender_ui -->|"sends reset"| node_send_data
node_operator -->|"sets destination"| node_settings
node_send_data -->|"transmits TCP"| node_network
node_network -->|"delivers TCP"| node_receive_data
node_receive_data -->|"records received files"| node_receiver_ui
node_receiver_ui -->|"accepts incoming data"| node_receive_data
node_receiver_ui -->|"creates display rows"| node_receive_rows
node_operator -->|"opens report"| node_receive_rows
node_receive_rows -->|"opens by type"| node_viewers

click node_sender_ui "https://github.com/lorydoor/simexams/blob/master/SalaRegia/MainWindow.xaml.cs"
click node_send_rows "https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/Riga.cs"
click node_delay "https://github.com/lorydoor/simexams/blob/master/SalaRegia/View/InserisciTempo.xaml.cs"
click node_settings "https://github.com/lorydoor/simexams/blob/master/SalaRegia/View/Impostazioni.xaml.cs"
click node_send_data "https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/InvioDati.cs"
click node_receive_data "https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/Model/RicezioneDati.cs"
click node_receiver_ui "https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/MainWindow.xaml.cs"
click node_receive_rows "https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/Model/Riga.cs"
click node_viewers "https://github.com/lorydoor/simexams/tree/master/SalaSimulazione/View"
click node_sender_library "https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/Libreria.cs"
click node_receiver_library "https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/Model/Libreria.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_sender_ui,node_send_rows,node_delay,node_settings toneBlue
class node_send_data,node_network,node_receive_data toneAmber
class node_receiver_ui,node_receive_rows,node_viewers toneMint
class node_sender_library,node_receiver_library toneRose
class node_operator toneIndigo
```

## Components

### SalaRegia sender

- [Report selection](https://github.com/lorydoor/simexams/blob/master/SalaRegia/MainWindow.xaml.cs): `SalaRegia/MainWindow.xaml.cs`
- [Send controls](https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/Riga.cs): `SalaRegia/Model/Riga.cs`
- [Send delay](https://github.com/lorydoor/simexams/blob/master/SalaRegia/View/InserisciTempo.xaml.cs): `SalaRegia/View/InserisciTempo.xaml.cs`
- [Network settings](https://github.com/lorydoor/simexams/blob/master/SalaRegia/View/Impostazioni.xaml.cs): `SalaRegia/View/Impostazioni.xaml.cs`

### TCP transfer

- [TCP file sender](https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/InvioDati.cs): `SalaRegia/Model/InvioDati.cs`
- **Local network**
- [TCP file receiver](https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/Model/RicezioneDati.cs): `SalaSimulazione/Model/RicezioneDati.cs`

### SalaSimulazione receiver

- [Incoming report list](https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/MainWindow.xaml.cs): `SalaSimulazione/MainWindow.xaml.cs`
- [Report display rows](https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/Model/Riga.cs): `SalaSimulazione/Model/Riga.cs`
- [File viewers](https://github.com/lorydoor/simexams/tree/master/SalaSimulazione/View): `SalaSimulazione/View`

### Shared UI support

- [Sender configuration](https://github.com/lorydoor/simexams/blob/master/SalaRegia/Model/Libreria.cs): `SalaRegia/Model/Libreria.cs`
- [Receiver configuration](https://github.com/lorydoor/simexams/blob/master/SalaSimulazione/Model/Libreria.cs): `SalaSimulazione/Model/Libreria.cs`

### Other components

- **Control-room operator**

## Connections

- Control-room operator → Report selection: selects reports (evidence: `README.md`)
- Report selection → Send controls: creates rows (evidence: `SalaRegia/MainWindow.xaml.cs`)
- Control-room operator → Send controls: requests send (evidence: `README.md`)
- Send controls → Send delay: opens delay (evidence: `SalaRegia/Model/Riga.cs`)
- Send controls → TCP file sender: invokes send (evidence: `SalaRegia/Model/Riga.cs`)
- Report selection → TCP file sender: sends reset (evidence: `SalaRegia/MainWindow.xaml.cs`)
- Control-room operator → Network settings: sets destination (evidence: `SalaRegia/View/Impostazioni.xaml.cs`)
- TCP file sender → Local network: transmits TCP (evidence: `SalaRegia/Model/InvioDati.cs`)
- Local network → TCP file receiver: delivers TCP (evidence: `SalaSimulazione/Model/RicezioneDati.cs`)
- TCP file receiver → Incoming report list: records received files (evidence: `SalaSimulazione/MainWindow.xaml.cs`)
- Incoming report list → TCP file receiver: accepts incoming data (evidence: `SalaSimulazione/MainWindow.xaml.cs`)
- Incoming report list → Report display rows: creates display rows (evidence: `SalaSimulazione/MainWindow.xaml.cs`)
- Control-room operator → Report display rows: opens report (evidence: `README.md`)
- Report display rows → File viewers: opens by type (evidence: `SalaSimulazione/Model/Riga.cs`)
