# eshin087/gcdatlas architecture

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

- Interactive diagram: https://gitdiagram.com/eshin087/gcdatlas
- Repository: https://github.com/eshin087/gcdatlas

## Overview

gcdatlas is a browser-based, WebGL2 atlas that renders the real universe as ASCII. A visitor explores destinations and uses controls or tours to move through the atlas; the renderer presents the view, with dedicated object modules supplying celestial scenes. The README also documents live Earth and satellite data, SpaceX launches and weather, tours, sky viewing, the Halo, and music. The source excerpts do not show the main browser modules’ call graph, so those connections are omitted; documented capabilities and explicit API helper calls are retained.

Main entry points: [`src/09-render.js`](https://github.com/eshin087/gcdatlas/blob/main/src/09-render.js) (ASCII renderer), [`api/sats.js`](https://github.com/eshin087/gcdatlas/blob/main/api/sats.js) (Satellite feed), [`src/07h-halo.js`](https://github.com/eshin087/gcdatlas/blob/main/src/07h-halo.js) (Halo cruiser), [`src/objects/s3-spacex.js`](https://github.com/eshin087/gcdatlas/blob/main/src/objects/s3-spacex.js) (Launch scenes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_explore["Atlas and exploration"]
  node_core["Runtime core<br/>[02-core.js]"]
  node_universe["World model<br/>[04-world.js]"]
  node_catalogdata[("Atlas data<br/>[05-data.js]")]
  node_renderer["ASCII renderer<br/>[09-render.js]"]
  node_camera["Camera controls<br/>[08-camera.js]"]
  node_tours["Guided tours<br/>[08t-tours.js]"]
  node_features["Atlas features<br/>[09f-features.js]"]
  node_sky["Your sky<br/>[09g-sky.js]"]
end

subgraph group_simulation["Scenes and simulation"]
  node_solar["Solar scenes<br/>[o00-sun.js]"]
  node_earth["Live Earth<br/>[e1-earth-live.js]"]
  node_galaxies["Galaxy scenes<br/>[06g-galaxies.js]"]
  node_nebulae["Nebula scenes<br/>[p1-nebulae.js]"]
  node_blackholes["Black-hole scenes<br/>[p4-blackholes.js]"]
end

subgraph group_experience["Interactive experiences"]
  node_halo["Halo cruiser<br/>[07h-halo.js]"]
  node_drone["Pip drone<br/>[07i-drone.js]"]
  node_scan["Halo scan<br/>[07j-scan.js]"]
  node_launchscene["Launch scenes<br/>[s3-spacex.js]"]
  node_launchdirector["Launch director<br/>[s4-spacex-run.js]"]
  node_music["Browser music<br/>[07m-music.js]"]
end

subgraph group_services["Live data services"]
  node_launchapi["Launch feed<br/>[launches.js]"]
  node_weatherapi["Pad weather<br/>[weather.js]"]
  node_satsapi["Satellite feed<br/>[sats.js]"]
  node_guard["Cached API guard<br/>[guard.js]"]
  node_orbits["Orbit compaction<br/>[orbits.js]"]
end

node_visitor(("Visitor"))
node_launchsource(("Launch Library"))
node_meteosource(("Open-Meteo"))
node_celestrak(("CelesTrak"))

node_visitor -.->|"explores"| node_core
node_visitor -->|"starts tours"| node_tours
node_visitor -->|"views sky"| node_sky
node_visitor -->|"uses features"| node_features
node_core -.->|"renders views"| node_renderer
node_universe -.->|"uses data"| node_catalogdata
node_renderer -.->|"draws scenes"| node_solar
node_renderer -.->|"draws Earth"| node_earth
node_renderer -.->|"draws scenes"| node_galaxies
node_renderer -.->|"draws scenes"| node_nebulae
node_renderer -.->|"draws scenes"| node_blackholes
node_visitor -->|"rides along"| node_halo
node_halo -.->|"deploys"| node_drone
node_halo -.->|"offers scan"| node_scan
node_visitor -->|"selects rocket"| node_launchscene
node_launchscene -->|"starts flights"| node_launchdirector
node_launchdirector -->|"gets launches"| node_launchapi
node_launchscene -->|"uses weather"| node_weatherapi
node_visitor -->|"plays music"| node_music
node_launchapi -->|"fetches feed"| node_launchsource
node_weatherapi -->|"fetches forecast"| node_meteosource
node_satsapi -->|"fetches records"| node_celestrak
node_satsapi -->|"compacts records"| node_orbits
node_launchapi -->|"uses cache"| node_guard
node_weatherapi -->|"uses cache"| node_guard
node_satsapi -->|"uses cache"| node_guard

click node_core "https://github.com/eshin087/gcdatlas/blob/main/src/02-core.js"
click node_universe "https://github.com/eshin087/gcdatlas/blob/main/src/04-world.js"
click node_catalogdata "https://github.com/eshin087/gcdatlas/blob/main/src/05-data.js"
click node_renderer "https://github.com/eshin087/gcdatlas/blob/main/src/09-render.js"
click node_camera "https://github.com/eshin087/gcdatlas/blob/main/src/08-camera.js"
click node_tours "https://github.com/eshin087/gcdatlas/blob/main/src/08t-tours.js"
click node_features "https://github.com/eshin087/gcdatlas/blob/main/src/09f-features.js"
click node_sky "https://github.com/eshin087/gcdatlas/blob/main/src/09g-sky.js"
click node_solar "https://github.com/eshin087/gcdatlas/blob/main/src/o00-sun.js"
click node_earth "https://github.com/eshin087/gcdatlas/blob/main/src/objects/e1-earth-live.js"
click node_galaxies "https://github.com/eshin087/gcdatlas/blob/main/src/06g-galaxies.js"
click node_nebulae "https://github.com/eshin087/gcdatlas/blob/main/src/objects/p1-nebulae.js"
click node_blackholes "https://github.com/eshin087/gcdatlas/blob/main/src/objects/p4-blackholes.js"
click node_halo "https://github.com/eshin087/gcdatlas/blob/main/src/07h-halo.js"
click node_drone "https://github.com/eshin087/gcdatlas/blob/main/src/07i-drone.js"
click node_scan "https://github.com/eshin087/gcdatlas/blob/main/src/07j-scan.js"
click node_launchscene "https://github.com/eshin087/gcdatlas/blob/main/src/objects/s3-spacex.js"
click node_launchdirector "https://github.com/eshin087/gcdatlas/blob/main/src/objects/s4-spacex-run.js"
click node_music "https://github.com/eshin087/gcdatlas/blob/main/src/07m-music.js"
click node_launchapi "https://github.com/eshin087/gcdatlas/blob/main/api/launches.js"
click node_weatherapi "https://github.com/eshin087/gcdatlas/blob/main/api/weather.js"
click node_satsapi "https://github.com/eshin087/gcdatlas/blob/main/api/sats.js"
click node_guard "https://github.com/eshin087/gcdatlas/blob/main/api/_lib/guard.js"
click node_orbits "https://github.com/eshin087/gcdatlas/blob/main/api/_lib/orbits.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_core,node_universe,node_catalogdata,node_renderer,node_camera,node_tours,node_features,node_sky toneBlue
class node_solar,node_earth,node_galaxies,node_nebulae,node_blackholes toneAmber
class node_halo,node_drone,node_scan,node_launchscene,node_launchdirector,node_music toneMint
class node_launchapi,node_weatherapi,node_satsapi,node_guard,node_orbits toneRose
class node_visitor,node_launchsource,node_meteosource,node_celestrak toneIndigo
```

## Components

### Atlas and exploration

- [Runtime core](https://github.com/eshin087/gcdatlas/blob/main/src/02-core.js): `src/02-core.js`
- [World model](https://github.com/eshin087/gcdatlas/blob/main/src/04-world.js): `src/04-world.js`
- [Atlas data](https://github.com/eshin087/gcdatlas/blob/main/src/05-data.js): `src/05-data.js`
- [ASCII renderer](https://github.com/eshin087/gcdatlas/blob/main/src/09-render.js): `src/09-render.js`
- [Camera controls](https://github.com/eshin087/gcdatlas/blob/main/src/08-camera.js): `src/08-camera.js`
- [Guided tours](https://github.com/eshin087/gcdatlas/blob/main/src/08t-tours.js): `src/08t-tours.js`
- [Atlas features](https://github.com/eshin087/gcdatlas/blob/main/src/09f-features.js): `src/09f-features.js`
- [Your sky](https://github.com/eshin087/gcdatlas/blob/main/src/09g-sky.js): `src/09g-sky.js`

### Scenes and simulation

- [Solar scenes](https://github.com/eshin087/gcdatlas/blob/main/src/o00-sun.js): `src/o00-sun.js`
- [Live Earth](https://github.com/eshin087/gcdatlas/blob/main/src/objects/e1-earth-live.js): `src/objects/e1-earth-live.js`
- [Galaxy scenes](https://github.com/eshin087/gcdatlas/blob/main/src/06g-galaxies.js): `src/06g-galaxies.js`
- [Nebula scenes](https://github.com/eshin087/gcdatlas/blob/main/src/objects/p1-nebulae.js): `src/objects/p1-nebulae.js`
- [Black-hole scenes](https://github.com/eshin087/gcdatlas/blob/main/src/objects/p4-blackholes.js): `src/objects/p4-blackholes.js`

### Interactive experiences

- [Halo cruiser](https://github.com/eshin087/gcdatlas/blob/main/src/07h-halo.js): `src/07h-halo.js`
- [Pip drone](https://github.com/eshin087/gcdatlas/blob/main/src/07i-drone.js): `src/07i-drone.js`
- [Halo scan](https://github.com/eshin087/gcdatlas/blob/main/src/07j-scan.js): `src/07j-scan.js`
- [Launch scenes](https://github.com/eshin087/gcdatlas/blob/main/src/objects/s3-spacex.js): `src/objects/s3-spacex.js`
- [Launch director](https://github.com/eshin087/gcdatlas/blob/main/src/objects/s4-spacex-run.js): `src/objects/s4-spacex-run.js`
- [Browser music](https://github.com/eshin087/gcdatlas/blob/main/src/07m-music.js): `src/07m-music.js`

### Live data services

- [Launch feed](https://github.com/eshin087/gcdatlas/blob/main/api/launches.js): `api/launches.js`
- [Pad weather](https://github.com/eshin087/gcdatlas/blob/main/api/weather.js): `api/weather.js`
- [Satellite feed](https://github.com/eshin087/gcdatlas/blob/main/api/sats.js): `api/sats.js`
- [Cached API guard](https://github.com/eshin087/gcdatlas/blob/main/api/_lib/guard.js): `api/_lib/guard.js`
- [Orbit compaction](https://github.com/eshin087/gcdatlas/blob/main/api/_lib/orbits.js): `api/_lib/orbits.js`

### Other components

- **Visitor**
- **Launch Library**
- **Open-Meteo**
- **CelesTrak**

## Connections

- Visitor → Runtime core: explores
- Visitor → Guided tours: starts tours
- Visitor → Your sky: views sky
- Visitor → Atlas features: uses features
- Runtime core → ASCII renderer: renders views
- World model → Atlas data: uses data
- ASCII renderer → Solar scenes: draws scenes
- ASCII renderer → Live Earth: draws Earth
- ASCII renderer → Galaxy scenes: draws scenes
- ASCII renderer → Nebula scenes: draws scenes
- ASCII renderer → Black-hole scenes: draws scenes
- Visitor → Halo cruiser: rides along
- Halo cruiser → Pip drone: deploys
- Halo cruiser → Halo scan: offers scan
- Visitor → Launch scenes: selects rocket
- Launch scenes → Launch director: starts flights (evidence: `src/objects/s3-spacex.js`)
- Launch director → Launch feed: gets launches
- Launch scenes → Pad weather: uses weather
- Visitor → Browser music: plays music
- Launch feed → Launch Library: fetches feed (evidence: `api/launches.js`)
- Pad weather → Open-Meteo: fetches forecast (evidence: `api/weather.js`)
- Satellite feed → CelesTrak: fetches records (evidence: `api/sats.js`)
- Satellite feed → Orbit compaction: compacts records (evidence: `api/sats.js`)
- Launch feed → Cached API guard: uses cache (evidence: `api/launches.js`)
- Pad weather → Cached API guard: uses cache (evidence: `api/weather.js`)
- Satellite feed → Cached API guard: uses cache (evidence: `api/sats.js`)
