# agavrile/lunar-navigator architecture

> Architecture diagram of the GitHub repository agavrile/lunar-navigator, 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/agavrile/lunar-navigator
- Repository: https://github.com/agavrile/lunar-navigator

## Overview

The product is a lunar south-pole landing-site analysis prototype. An operator adjusts a site, UTC epoch, and RF band in the React/Cesium console; the client requests analysis from the Crow API and displays telemetry and a lunar globe view, using a deterministic browser estimator if the live request fails. Backend analysis combines DEM terrain horizons, Sun/Earth ephemerides, and RF/relay evaluation. The README also describes overlays and a heuristic 30-day forecast. Relationships for those UI capabilities are documented, while finer internal UI decomposition is not visible in the sampled excerpts.

Main entry points: [`frontend/src/App.tsx`](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx) (Mission Console), [`backend/radio_comms.cpp`](https://github.com/agavrile/lunar-navigator/blob/main/backend/radio_comms.cpp) (Site Analysis), [`frontend/src/api.ts`](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/api.ts) (Analysis Client), [`backend/main.cpp`](https://github.com/agavrile/lunar-navigator/blob/main/backend/main.cpp) (Crow API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_console["Mission Console"]
  node_ui["Mission Console<br/>[App.tsx]"]
  node_globe["Cesium Globe<br/>[App.tsx]"]
  node_planning["Time Planning<br/>[App.tsx]"]
  node_overlays["Scene Overlays<br/>[App.tsx]"]
  node_client["Analysis Client<br/>[api.ts]"]
  node_offline["Offline Estimator<br/>[api.ts]"]
end

subgraph group_service["Analysis Service"]
  node_api["Crow API<br/>[main.cpp]"]
  node_engine["Site Analysis<br/>[radio_comms.cpp]"]
end

subgraph group_science["Analysis Models"]
  node_terrain["DEM Horizon<br/>[gdal_parser.cpp]"]
  node_ephemeris["Celestial Positions<br/>[jpl_ephemeris.cpp]"]
  node_rf["RF And Relay<br/>[radio_comms.cpp]"]
end

subgraph group_integrations["External Inputs"]
  node_dem[("Lunar DEM")]
  node_horizons["JPL Horizons"]
end

node_operator(("Mission Operator"))

node_operator -->|"sets mission inputs"| node_ui
node_ui -->|"renders"| node_globe
node_ui -->|"provides controls"| node_planning
node_ui -->|"renders"| node_overlays
node_ui -->|"requests analysis"| node_client
node_client -->|"posts analysis"| node_api
node_client -->|"falls back"| node_offline
node_api -->|"invokes"| node_engine
node_engine -->|"samples horizons"| node_terrain
node_engine -->|"gets positions"| node_ephemeris
node_engine -->|"evaluates links"| node_rf
node_terrain -->|"reads elevations"| node_dem
node_ephemeris -->|"queries"| node_horizons

click node_ui "https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx"
click node_globe "https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx"
click node_planning "https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx"
click node_overlays "https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx"
click node_client "https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/api.ts"
click node_offline "https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/api.ts"
click node_api "https://github.com/agavrile/lunar-navigator/blob/main/backend/main.cpp"
click node_engine "https://github.com/agavrile/lunar-navigator/blob/main/backend/radio_comms.cpp"
click node_terrain "https://github.com/agavrile/lunar-navigator/blob/main/backend/gdal_parser.cpp"
click node_ephemeris "https://github.com/agavrile/lunar-navigator/blob/main/backend/jpl_ephemeris.cpp"
click node_rf "https://github.com/agavrile/lunar-navigator/blob/main/backend/radio_comms.cpp"

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_ui,node_globe,node_planning,node_overlays,node_client,node_offline toneBlue
class node_api,node_engine toneAmber
class node_terrain,node_ephemeris,node_rf toneMint
class node_dem,node_horizons toneRose
class node_operator toneIndigo
```

## Components

### Mission Console

- [Mission Console](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Cesium Globe](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Time Planning](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Scene Overlays](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Analysis Client](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/api.ts): `frontend/src/api.ts`
- [Offline Estimator](https://github.com/agavrile/lunar-navigator/blob/main/frontend/src/api.ts): `frontend/src/api.ts`

### Analysis Service

- [Crow API](https://github.com/agavrile/lunar-navigator/blob/main/backend/main.cpp): `backend/main.cpp`
- [Site Analysis](https://github.com/agavrile/lunar-navigator/blob/main/backend/radio_comms.cpp): `backend/radio_comms.cpp`

### Analysis Models

- [DEM Horizon](https://github.com/agavrile/lunar-navigator/blob/main/backend/gdal_parser.cpp): `backend/gdal_parser.cpp`
- [Celestial Positions](https://github.com/agavrile/lunar-navigator/blob/main/backend/jpl_ephemeris.cpp): `backend/jpl_ephemeris.cpp`
- [RF And Relay](https://github.com/agavrile/lunar-navigator/blob/main/backend/radio_comms.cpp): `backend/radio_comms.cpp`

### External Inputs

- **Lunar DEM**
- **JPL Horizons**

### Other components

- **Mission Operator**

## Connections

- Mission Operator → Mission Console: sets mission inputs (evidence: `README.md`)
- Mission Console → Cesium Globe: renders (evidence: `README.md`)
- Mission Console → Time Planning: provides controls (evidence: `README.md`)
- Mission Console → Scene Overlays: renders (evidence: `README.md`)
- Mission Console → Analysis Client: requests analysis (evidence: `frontend/src/App.tsx`)
- Analysis Client → Crow API: posts analysis (evidence: `README.md`)
- Analysis Client → Offline Estimator: falls back (evidence: `frontend/src/api.ts`)
- Crow API → Site Analysis: invokes (evidence: `backend/main.cpp`)
- Site Analysis → DEM Horizon: samples horizons (evidence: `README.md`)
- Site Analysis → Celestial Positions: gets positions (evidence: `README.md`)
- Site Analysis → RF And Relay: evaluates links (evidence: `backend/radio_comms.cpp`)
- DEM Horizon → Lunar DEM: reads elevations (evidence: `README.md`)
- Celestial Positions → JPL Horizons: queries (evidence: `backend/jpl_ephemeris.cpp`)
