# saadtoury-personal/hagracorp architecture

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

- Interactive diagram: https://gitdiagram.com/saadtoury-personal/hagracorp
- Repository: https://github.com/saadtoury-personal/hagracorp

## Overview

LunarNav helps mission planners compare lunar south-pole sites and dates using Sun illumination, Earth visibility, terrain horizons, and mission-window analyses. The principal workflow is selecting a site and time, obtaining API results computed from ephemeris and terrain data, and viewing comparisons or timelines. The graph also includes custom-point analysis, lunar imagery/phase, precomputed products, and scientific validation. The frontend’s detailed interactions are not shown in the excerpts, so its API connection is left unverified; validation-script relationships are limited to those visible in the source index or excerpts.

Main entry points: [`LunarNav/LunarNav.Core/Analysis.cs`](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Analysis.cs) (Mission Analysis), [`LunarNav/LunarNav.Api/Program.cs`](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Program.cs) (API Routes), [`LunarNav/LunarNav.Api/AppData.cs`](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/AppData.cs) (Data Access), [`LunarNav/LunarNav.Api/Tools.cs`](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Tools.cs) (Precompute)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["User Interface"]
  node_web["Web Client<br/>[LunarNav.Web]"]
  node_globe["3D Assets"]
end

subgraph group_api["API Services"]
  node_routes["API Routes<br/>[Program.cs]"]
  node_appdata["Data Access<br/>[AppData.cs]"]
  node_moon["Moon Service<br/>[MoonService.cs]"]
  node_precompute["Precompute<br/>[Tools.cs]"]
  node_api_validation["API Validation<br/>[Validation.cs]"]
end

subgraph group_science["Lunar Analysis"]
  node_analysis["Mission Analysis<br/>[Analysis.cs]"]
  node_ephemeris["Ephemeris<br/>[Ephemeris.cs]"]
  node_geometry["Sky Geometry<br/>[Geometry.cs]"]
  node_terrain["Terrain Horizons<br/>[Terrain.cs]"]
  node_models["Domain Models<br/>[Models.cs]"]
end

subgraph group_data["Mission Data"]
  node_datafiles["Precomputed Data<br/>[data]"]
end

subgraph group_validation["Scientific Validation"]
  node_validation_ours["Local Recalculation<br/>[ours.py]"]
  node_validation_pgda["PGDA Comparison<br/>[pgda.py]"]
end

node_planner(("Mission Planner"))

node_planner -->|"uses"| node_web
node_web -.->|"requests results"| node_routes
node_web -.->|"may display"| node_globe
node_routes -->|"reads site data"| node_appdata
node_routes -->|"runs analyses"| node_analysis
node_routes -->|"uses moon service"| node_moon
node_routes -->|"dispatches validation"| node_api_validation
node_routes -->|"dispatches precompute"| node_precompute
node_appdata -->|"reads data"| node_datafiles
node_appdata -->|"loads ephemeris"| node_ephemeris
node_appdata -->|"loads DEM"| node_terrain
node_appdata -->|"loads DEM"| node_precompute
node_precompute -->|"computes horizons"| node_terrain
node_precompute -->|"builds heatmaps"| node_analysis
node_analysis -->|"samples positions"| node_ephemeris
node_analysis -->|"uses sky geometry"| node_geometry
node_analysis -->|"uses horizon masks"| node_terrain
node_ephemeris -->|"uses geometry"| node_geometry
node_terrain -->|"uses vectors"| node_geometry
node_moon -->|"computes local phase"| node_analysis
node_moon -->|"samples local position"| node_ephemeris
node_validation_pgda -->|"imports"| node_validation_ours
node_validation_ours -->|"reads precomputed data"| node_datafiles
node_api_validation -->|"runs product analysis"| node_analysis

click node_web "https://github.com/saadtoury-personal/hagracorp/tree/dev/LunarNav/LunarNav.Web"
click node_globe "https://github.com/saadtoury-personal/hagracorp/tree/dev/3Dobjets"
click node_routes "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Program.cs"
click node_appdata "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/AppData.cs"
click node_moon "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/MoonService.cs"
click node_precompute "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Tools.cs"
click node_api_validation "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Validation.cs"
click node_analysis "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Analysis.cs"
click node_ephemeris "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Ephemeris.cs"
click node_geometry "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Geometry.cs"
click node_terrain "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Terrain.cs"
click node_models "https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Models.cs"
click node_datafiles "https://github.com/saadtoury-personal/hagracorp/tree/dev/LunarNav/LunarNav.Web/wwwroot/data"
click node_validation_ours "https://github.com/saadtoury-personal/hagracorp/blob/dev/tools/validation/ours.py"
click node_validation_pgda "https://github.com/saadtoury-personal/hagracorp/blob/dev/tools/validation/pgda.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_web,node_globe toneBlue
class node_routes,node_appdata,node_moon,node_precompute,node_api_validation toneAmber
class node_analysis,node_ephemeris,node_geometry,node_terrain,node_models toneMint
class node_datafiles toneRose
class node_validation_ours,node_validation_pgda,node_planner toneIndigo
```

## Components

### User Interface

- [Web Client](https://github.com/saadtoury-personal/hagracorp/tree/dev/LunarNav/LunarNav.Web): `LunarNav/LunarNav.Web`
- [3D Assets](https://github.com/saadtoury-personal/hagracorp/tree/dev/3Dobjets): `3Dobjets`

### API Services

- [API Routes](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Program.cs): `LunarNav/LunarNav.Api/Program.cs`
- [Data Access](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/AppData.cs): `LunarNav/LunarNav.Api/AppData.cs`
- [Moon Service](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/MoonService.cs): `LunarNav/LunarNav.Api/MoonService.cs`
- [Precompute](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Tools.cs): `LunarNav/LunarNav.Api/Tools.cs`
- [API Validation](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Api/Validation.cs): `LunarNav/LunarNav.Api/Validation.cs`

### Lunar Analysis

- [Mission Analysis](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Analysis.cs): `LunarNav/LunarNav.Core/Analysis.cs`
- [Ephemeris](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Ephemeris.cs): `LunarNav/LunarNav.Core/Ephemeris.cs`
- [Sky Geometry](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Geometry.cs): `LunarNav/LunarNav.Core/Geometry.cs`
- [Terrain Horizons](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Terrain.cs): `LunarNav/LunarNav.Core/Terrain.cs`
- [Domain Models](https://github.com/saadtoury-personal/hagracorp/blob/dev/LunarNav/LunarNav.Core/Models.cs): `LunarNav/LunarNav.Core/Models.cs`

### Mission Data

- [Precomputed Data](https://github.com/saadtoury-personal/hagracorp/tree/dev/LunarNav/LunarNav.Web/wwwroot/data): `LunarNav/LunarNav.Web/wwwroot/data`

### Scientific Validation

- [Local Recalculation](https://github.com/saadtoury-personal/hagracorp/blob/dev/tools/validation/ours.py): `tools/validation/ours.py`
- [PGDA Comparison](https://github.com/saadtoury-personal/hagracorp/blob/dev/tools/validation/pgda.py): `tools/validation/pgda.py`

### Other components

- **Mission Planner**

## Connections

- Mission Planner → Web Client: uses (evidence: `README.md`)
- Web Client → API Routes: requests results
- Web Client → 3D Assets: may display
- API Routes → Data Access: reads site data (evidence: `LunarNav/LunarNav.Api/Program.cs`)
- API Routes → Mission Analysis: runs analyses (evidence: `LunarNav/LunarNav.Api/Program.cs`)
- API Routes → Moon Service: uses moon service (evidence: `LunarNav/LunarNav.Api/Program.cs`)
- API Routes → API Validation: dispatches validation (evidence: `LunarNav/LunarNav.Api/Program.cs`)
- API Routes → Precompute: dispatches precompute (evidence: `LunarNav/LunarNav.Api/Program.cs`)
- Data Access → Precomputed Data: reads data (evidence: `LunarNav/LunarNav.Api/AppData.cs`)
- Data Access → Ephemeris: loads ephemeris (evidence: `LunarNav/LunarNav.Api/AppData.cs`)
- Data Access → Terrain Horizons: loads DEM (evidence: `LunarNav/LunarNav.Api/AppData.cs`)
- Data Access → Precompute: loads DEM (evidence: `LunarNav/LunarNav.Api/AppData.cs`)
- Precompute → Terrain Horizons: computes horizons (evidence: `LunarNav/LunarNav.Api/Tools.cs`)
- Precompute → Mission Analysis: builds heatmaps (evidence: `LunarNav/LunarNav.Api/Tools.cs`)
- Mission Analysis → Ephemeris: samples positions (evidence: `LunarNav/LunarNav.Core/Analysis.cs`)
- Mission Analysis → Sky Geometry: uses sky geometry (evidence: `LunarNav/LunarNav.Core/Analysis.cs`)
- Mission Analysis → Terrain Horizons: uses horizon masks (evidence: `LunarNav/LunarNav.Core/Analysis.cs`)
- Ephemeris → Sky Geometry: uses geometry (evidence: `LunarNav/LunarNav.Core/Ephemeris.cs`)
- Terrain Horizons → Sky Geometry: uses vectors (evidence: `LunarNav/LunarNav.Core/Terrain.cs`)
- Moon Service → Mission Analysis: computes local phase (evidence: `LunarNav/LunarNav.Api/MoonService.cs`)
- Moon Service → Ephemeris: samples local position (evidence: `LunarNav/LunarNav.Api/MoonService.cs`)
- PGDA Comparison → Local Recalculation: imports (evidence: `tools/validation/pgda.py`)
- Local Recalculation → Precomputed Data: reads precomputed data (evidence: `tools/validation/ours.py`)
- API Validation → Mission Analysis: runs product analysis (evidence: `LunarNav/LunarNav.Api/Validation.cs`)
