# kevin-neila/estelar-1-nasa-space-apps-challenge-2026 architecture

> Architecture diagram of the GitHub repository kevin-neila/estelar-1-nasa-space-apps-challenge-2026, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-17). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026
- Repository: https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026

## Overview

ArtemisForge is a lunar landing-site decision-support web application. Its main analysis workflow evaluates a site and date against Sun/Earth visibility and terrain horizons, then presents operational windows and comparisons. A separate rover-planning workflow combines terrain, shadow, slope, temperature, and communications constraints into a route and PDF dossier. The graph also preserves the globe explorer, educational mode, and methodology/reporting capabilities documented in the README. Some page implementations and runtime wiring were not sampled, so documented capabilities are included without inferring their internal call paths.

Main entry points: [`src/ui/sitePage.js`](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/sitePage.js) (Site Analysis), [`src/main.js`](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/main.js) (Pathfinder Controller), [`src/core/scenario.js`](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/scenario.js) (Scenario Engine), [`src/ui/comparePage.js`](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/comparePage.js) (Scenario Compare)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_analysis["Site Analysis"]
  node_site["Site Analysis<br/>[sitePage.js]"]
  node_site_es["Sitio Analysis<br/>[sitioPage.js]"]
  node_compare["Scenario Compare<br/>[comparePage.js]"]
  node_comparar["Comparar Scenarios<br/>[compararPage.js]"]
  node_charts["Sky Charts<br/>[skyCharts.js]"]
  node_site_report["Site Report PDF<br/>[reportPdf.js]"]
  node_shared_ui["Shared UI<br/>[common.js]"]
end

subgraph group_core["Mission Computation"]
  node_ephemeris["Lunar Ephemeris<br/>[ephemeris.js]"]
  node_geometry["Sky Geometry<br/>[geometry.js]"]
  node_scenario["Scenario Engine<br/>[scenario.js]"]
  node_site_adapter["Site Adapter<br/>[siteAdapter.js]"]
  node_i18n["Localization<br/>[i18n.js]"]
end

subgraph group_rover["Rover Pathfinder"]
  node_pathfinder["Route Optimizer<br/>[pathfinder.js]"]
  node_scene["3D Terrain Cockpit<br/>[lunarScene.js]"]
  node_main["Pathfinder Controller<br/>[main.js]"]
  node_pdf["Flight Dossier PDF<br/>[pdfExporter.js]"]
end

subgraph group_explore["Exploration and Learning"]
  node_globe["Moon Globe<br/>[globePage.js]"]
  node_learning["Educational Mode<br/>[learnPage.js]"]
  node_methodology["Methodology Page<br/>[acercaPage.js]"]
end

node_architect(("Mission Planner"))

node_architect -->|"analyzes sites"| node_site
node_architect -->|"compares scenarios"| node_compare
node_architect -->|"explores missions"| node_globe
node_architect -->|"learns concepts"| node_learning
node_architect -->|"plans rover route"| node_main
node_architect -->|"reviews methods"| node_methodology
node_site -->|"runs analysis"| node_scenario
node_site_es -->|"runs analysis"| node_scenario
node_compare -->|"evaluates scenarios"| node_scenario
node_comparar -->|"evaluates scenarios"| node_scenario
node_scenario -->|"builds metrics"| node_geometry
node_geometry -->|"samples positions"| node_ephemeris
node_site -->|"renders sky charts"| node_charts
node_compare -->|"renders sky charts"| node_charts
node_architect -->|"exports site report"| node_site_report
node_main -->|"adapts site data"| node_site_adapter
node_main -->|"computes shadow and route"| node_pathfinder
node_main -->|"updates terrain view"| node_scene
node_main -->|"exports dossier"| node_pdf
node_globe -->|"uses sky geometry"| node_geometry
node_site -->|"uses shared interface"| node_shared_ui
node_site -->|"localizes interface"| node_i18n
node_site_report -->|"gets language"| node_i18n

click node_site "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/sitePage.js"
click node_site_es "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/sitioPage.js"
click node_compare "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/comparePage.js"
click node_comparar "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/compararPage.js"
click node_charts "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/skyCharts.js"
click node_ephemeris "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/ephemeris.js"
click node_geometry "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/geometry.js"
click node_scenario "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/scenario.js"
click node_site_adapter "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/siteAdapter.js"
click node_pathfinder "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/pathfinder.js"
click node_scene "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/lunarScene.js"
click node_main "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/main.js"
click node_pdf "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/pdfExporter.js"
click node_globe "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/globePage.js"
click node_learning "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/learnPage.js"
click node_methodology "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/acercaPage.js"
click node_site_report "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/reportPdf.js"
click node_shared_ui "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/common.js"
click node_i18n "https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/i18n.js"

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_site,node_site_es,node_compare,node_comparar,node_charts,node_site_report,node_shared_ui toneBlue
class node_ephemeris,node_geometry,node_scenario,node_site_adapter,node_i18n toneAmber
class node_pathfinder,node_scene,node_main,node_pdf toneMint
class node_globe,node_learning,node_methodology toneRose
class node_architect toneIndigo
```

## Components

### Site Analysis

- [Site Analysis](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/sitePage.js): `src/ui/sitePage.js`
- [Sitio Analysis](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/sitioPage.js): `src/ui/sitioPage.js`
- [Scenario Compare](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/comparePage.js): `src/ui/comparePage.js`
- [Comparar Scenarios](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/compararPage.js): `src/ui/compararPage.js`
- [Sky Charts](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/skyCharts.js): `src/ui/skyCharts.js`
- [Site Report PDF](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/reportPdf.js): `src/ui/reportPdf.js`
- [Shared UI](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/common.js): `src/ui/common.js`

### Mission Computation

- [Lunar Ephemeris](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/ephemeris.js): `src/core/ephemeris.js`
- [Sky Geometry](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/geometry.js): `src/core/geometry.js`
- [Scenario Engine](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/scenario.js): `src/core/scenario.js`
- [Site Adapter](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/core/siteAdapter.js): `src/core/siteAdapter.js`
- [Localization](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/i18n.js): `src/ui/i18n.js`

### Rover Pathfinder

- [Route Optimizer](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/pathfinder.js): `src/pathfinder.js`
- [3D Terrain Cockpit](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/lunarScene.js): `src/lunarScene.js`
- [Pathfinder Controller](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/main.js): `src/main.js`
- [Flight Dossier PDF](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/pdfExporter.js): `src/pdfExporter.js`

### Exploration and Learning

- [Moon Globe](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/globePage.js): `src/ui/globePage.js`
- [Educational Mode](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/learnPage.js): `src/ui/learnPage.js`
- [Methodology Page](https://github.com/kevin-neila/estelar-1-nasa-space-apps-challenge-2026/blob/main/src/ui/acercaPage.js): `src/ui/acercaPage.js`

### Other components

- **Mission Planner**

## Connections

- Mission Planner → Site Analysis: analyzes sites (evidence: `README.md`)
- Mission Planner → Scenario Compare: compares scenarios (evidence: `README.md`)
- Mission Planner → Moon Globe: explores missions (evidence: `README.md`)
- Mission Planner → Educational Mode: learns concepts (evidence: `README.md`)
- Mission Planner → Pathfinder Controller: plans rover route (evidence: `README.md`)
- Mission Planner → Methodology Page: reviews methods (evidence: `README.md`)
- Site Analysis → Scenario Engine: runs analysis (evidence: `src/ui/sitePage.js`)
- Sitio Analysis → Scenario Engine: runs analysis (evidence: `src/ui/sitioPage.js`)
- Scenario Compare → Scenario Engine: evaluates scenarios (evidence: `src/ui/comparePage.js`)
- Comparar Scenarios → Scenario Engine: evaluates scenarios (evidence: `src/ui/compararPage.js`)
- Scenario Engine → Sky Geometry: builds metrics (evidence: `src/core/scenario.js`)
- Sky Geometry → Lunar Ephemeris: samples positions (evidence: `src/core/geometry.js`)
- Site Analysis → Sky Charts: renders sky charts (evidence: `src/ui/sitePage.js`)
- Scenario Compare → Sky Charts: renders sky charts (evidence: `src/ui/comparePage.js`)
- Mission Planner → Site Report PDF: exports site report (evidence: `README.md`)
- Pathfinder Controller → Site Adapter: adapts site data (evidence: `src/main.js`)
- Pathfinder Controller → Route Optimizer: computes shadow and route (evidence: `src/main.js`)
- Pathfinder Controller → 3D Terrain Cockpit: updates terrain view (evidence: `src/main.js`)
- Pathfinder Controller → Flight Dossier PDF: exports dossier (evidence: `src/main.js`)
- Moon Globe → Sky Geometry: uses sky geometry (evidence: `src/ui/globePage.js`)
- Site Analysis → Shared UI: uses shared interface (evidence: `src/ui/sitePage.js`)
- Site Analysis → Localization: localizes interface
- Site Report PDF → Localization: gets language (evidence: `src/ui/reportPdf.js`)
