# deskarria2-lab/volar architecture

> Architecture diagram of the GitHub repository deskarria2-lab/volar, 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/deskarria2-lab/volar
- Repository: https://github.com/deskarria2-lab/volar

## Overview

This is a desktop flight-planning and airspace-simulation application, with a reusable C# flight and persistence library, WinForms interfaces, and a console simulator. The main simulation workflow collects flight data, validates it, creates and moves flight plans, and supports conflict review; simulation history can be reconstructed and saved. The tree also shows a separate login/dashboard interface and SQLite-backed user services. Edges reflect the shown calls and references; some UI-to-library relationships are based on the indexed source references, not fully reproduced excerpts.

Main entry points: [`FlightLib/Gestion de Aviones/FlightPlan.cs`](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/FlightPlan.cs) (Flight plan), [`Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/01_Datos%20de%20Vuelo.cs) (Flight input), [`FlightLib/Base de Datos/FlightPlanHistory.cs`](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanHistory.cs) (Flight history), [`FlightLib/Gestion de Aviones/FlightPlanList.cs`](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/FlightPlanList.cs) (Plan collection)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Desktop interfaces"]
  node_flight_input["Flight input"]
  node_airspace["Airspace view"]
  node_conflict_view["Conflict view"]
  node_login["Login form<br/>[00_Login.cs]"]
  node_dashboard["Dashboard<br/>[01_Dashboard.cs]"]
  node_console_simulator["Console simulator<br/>[Program.cs]"]
end

subgraph group_flight["Flight simulation"]
  node_validation["Input validation<br/>[MethodChecker.cs]"]
  node_file_import["Flight file import<br/>[GesitonFicheros.cs]"]
  node_flight_plan["Flight plan<br/>[FlightPlan.cs]"]
  node_plan_list["Plan collection<br/>[FlightPlanList.cs]"]
  node_position["Position geometry<br/>[Position.cs]"]
  node_conflict_detector["Conflict detector"]
end

subgraph group_history["Simulation history"]
  node_history["Flight history"]
  node_history_data["Flight state data<br/>[FlightPlanData.cs]"]
end

subgraph group_storage["Persistence and accounts"]
  node_flight_repository["History repository"]
  node_database_connection["SQLite connection<br/>[DataBase.cs]"]
  node_sqlite_store[("SQLite database<br/>[userBD.db]")]
  node_auth_service["Email lookup<br/>[AuthService.cs]"]
  node_user_repository["User repository<br/>[UserRepository.cs]"]
  node_user_record["User record<br/>[User.cs]"]
end

node_operator(("Operator"))

node_operator -->|"enters flights"| node_flight_input
node_flight_input -->|"checks input"| node_validation
node_flight_input -->|"creates plans"| node_flight_plan
node_flight_input -->|"adds plans"| node_plan_list
node_flight_input -->|"loads flight file"| node_file_import
node_operator -->|"reviews airspace"| node_airspace
node_airspace -->|"accesses history"| node_flight_repository
node_airspace -->|"uses history"| node_history
node_airspace -->|"uses flight plans"| node_flight_plan
node_plan_list -->|"moves plans"| node_flight_plan
node_flight_plan -->|"uses positions"| node_position
node_conflict_view -->|"reads plans"| node_plan_list
node_operator -->|"signs in"| node_login
node_login -.->|"opens dashboard"| node_dashboard
node_auth_service -->|"checks email"| node_user_repository
node_user_repository -->|"queries users"| node_database_connection
node_user_repository -->|"maps user"| node_user_record
node_flight_repository -->|"executes SQL"| node_database_connection
node_flight_repository -->|"stores states"| node_history_data
node_database_connection -->|"opens database"| node_sqlite_store
node_history -->|"captures states"| node_history_data
node_history -->|"rebuilds plans"| node_plan_list
node_history -->|"captures flight data"| node_flight_plan
node_history -->|"captures coordinates"| node_position
node_console_simulator -->|"opens database"| node_database_connection
node_console_simulator -->|"creates collection"| node_plan_list
node_console_simulator -->|"creates flights"| node_flight_plan

click node_flight_input "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/01_Datos%20de%20Vuelo.cs"
click node_airspace "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs"
click node_conflict_view "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/07_FormConflictes.cs"
click node_login "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/GUI_VOLAR/Form/00_Login.cs"
click node_dashboard "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/GUI_VOLAR/Form/01_Dashboard.cs"
click node_validation "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/miscellaneous/MethodChecker.cs"
click node_file_import "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/miscellaneous/GesitonFicheros.cs"
click node_flight_plan "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/FlightPlan.cs"
click node_plan_list "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/FlightPlanList.cs"
click node_position "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/Position.cs"
click node_conflict_detector "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/DetectorConflicto.cs"
click node_history "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanHistory.cs"
click node_history_data "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanData.cs"
click node_flight_repository "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanRepository.cs"
click node_database_connection "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/DataBase.cs"
click node_sqlite_store "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/userBD.db"
click node_auth_service "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/AuthService.cs"
click node_user_repository "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/UserRepository.cs"
click node_user_record "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/User.cs"
click node_console_simulator "https://github.com/deskarria2-lab/volar/blob/Rama-Principal/SimulatorConsole/Program.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_flight_input,node_airspace,node_conflict_view,node_login,node_dashboard,node_console_simulator toneBlue
class node_validation,node_file_import,node_flight_plan,node_plan_list,node_position,node_conflict_detector toneAmber
class node_history,node_history_data toneMint
class node_flight_repository,node_database_connection,node_sqlite_store,node_auth_service,node_user_repository,node_user_record toneRose
class node_operator toneIndigo
```

## Components

### Desktop interfaces

- [Flight input](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/01_Datos%20de%20Vuelo.cs): `Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`
- [Airspace view](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs): `Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs`
- [Conflict view](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/Pruebas_GUI_Volar/Forms/07_FormConflictes.cs): `Pruebas_GUI_Volar/Forms/07_FormConflictes.cs`
- [Login form](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/GUI_VOLAR/Form/00_Login.cs): `GUI_VOLAR/Form/00_Login.cs`
- [Dashboard](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/GUI_VOLAR/Form/01_Dashboard.cs): `GUI_VOLAR/Form/01_Dashboard.cs`
- [Console simulator](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/SimulatorConsole/Program.cs): `SimulatorConsole/Program.cs`

### Flight simulation

- [Input validation](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/miscellaneous/MethodChecker.cs): `FlightLib/miscellaneous/MethodChecker.cs`
- [Flight file import](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/miscellaneous/GesitonFicheros.cs): `FlightLib/miscellaneous/GesitonFicheros.cs`
- [Flight plan](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/FlightPlan.cs): `FlightLib/Gestion de Aviones/FlightPlan.cs`
- [Plan collection](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/FlightPlanList.cs): `FlightLib/Gestion de Aviones/FlightPlanList.cs`
- [Position geometry](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/Position.cs): `FlightLib/Gestion de Aviones/Position.cs`
- [Conflict detector](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Gestion%20de%20Aviones/DetectorConflicto.cs): `FlightLib/Gestion de Aviones/DetectorConflicto.cs`

### Simulation history

- [Flight history](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanHistory.cs): `FlightLib/Base de Datos/FlightPlanHistory.cs`
- [Flight state data](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanData.cs): `FlightLib/Base de Datos/FlightPlanData.cs`

### Persistence and accounts

- [History repository](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/FlightPlanRepository.cs): `FlightLib/Base de Datos/FlightPlanRepository.cs`
- [SQLite connection](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/DataBase.cs): `FlightLib/Base de Datos/DataBase.cs`
- [SQLite database](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/userBD.db): `userBD.db`
- [Email lookup](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/AuthService.cs): `FlightLib/Base de Datos/AuthService.cs`
- [User repository](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/UserRepository.cs): `FlightLib/Base de Datos/UserRepository.cs`
- [User record](https://github.com/deskarria2-lab/volar/blob/Rama-Principal/FlightLib/Base%20de%20Datos/User.cs): `FlightLib/Base de Datos/User.cs`

### Other components

- **Operator**

## Connections

- Operator → Flight input: enters flights (evidence: `Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`)
- Flight input → Input validation: checks input (evidence: `Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`)
- Flight input → Flight plan: creates plans (evidence: `Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`)
- Flight input → Plan collection: adds plans (evidence: `Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`)
- Flight input → Flight file import: loads flight file (evidence: `Pruebas_GUI_Volar/Forms/01_Datos de Vuelo.cs`)
- Operator → Airspace view: reviews airspace (evidence: `Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs`)
- Airspace view → History repository: accesses history (evidence: `Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs`)
- Airspace view → Flight history: uses history (evidence: `Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs`)
- Airspace view → Flight plan: uses flight plans (evidence: `Pruebas_GUI_Volar/Forms/03_Espacio_Aereo.cs`)
- Plan collection → Flight plan: moves plans (evidence: `FlightLib/Gestion de Aviones/FlightPlanList.cs`)
- Flight plan → Position geometry: uses positions (evidence: `FlightLib/Gestion de Aviones/FlightPlan.cs`)
- Conflict view → Plan collection: reads plans (evidence: `Pruebas_GUI_Volar/Forms/07_FormConflictes.cs`)
- Operator → Login form: signs in (evidence: `GUI_VOLAR/Form/00_Login.cs`)
- Login form → Dashboard: opens dashboard
- Email lookup → User repository: checks email (evidence: `FlightLib/Base de Datos/AuthService.cs`)
- User repository → SQLite connection: queries users (evidence: `FlightLib/Base de Datos/UserRepository.cs`)
- User repository → User record: maps user (evidence: `FlightLib/Base de Datos/UserRepository.cs`)
- History repository → SQLite connection: executes SQL (evidence: `FlightLib/Base de Datos/FlightPlanRepository.cs`)
- History repository → Flight state data: stores states (evidence: `FlightLib/Base de Datos/FlightPlanRepository.cs`)
- SQLite connection → SQLite database: opens database (evidence: `FlightLib/Base de Datos/DataBase.cs`)
- Flight history → Flight state data: captures states (evidence: `FlightLib/Base de Datos/FlightPlanHistory.cs`)
- Flight history → Plan collection: rebuilds plans (evidence: `FlightLib/Base de Datos/FlightPlanHistory.cs`)
- Flight history → Flight plan: captures flight data (evidence: `FlightLib/Base de Datos/FlightPlanHistory.cs`)
- Flight history → Position geometry: captures coordinates (evidence: `FlightLib/Base de Datos/FlightPlanHistory.cs`)
- Console simulator → SQLite connection: opens database (evidence: `SimulatorConsole/Program.cs`)
- Console simulator → Plan collection: creates collection (evidence: `SimulatorConsole/Program.cs`)
- Console simulator → Flight plan: creates flights (evidence: `SimulatorConsole/Program.cs`)
