# ovvenkatesan/gods-eye-view architecture

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

- Interactive diagram: https://gitdiagram.com/ovvenkatesan/gods-eye-view
- Repository: https://github.com/ovvenkatesan/gods-eye-view

## Overview

God’s Eye View is a browser-based, Cesium-powered globe for exploring public real-world signals. The main workflow starts the globe, loads independently managed data layers, renders their overlays, and lets users navigate or track entities; voice commands and annotations provide alternate ways to query and mark that world. Other documented capabilities include cockpit tracking, detection and military HUDs, sensor styles, scene tours, global context, and share links. Edges are limited to relationships shown in the README or source-index references and excerpts; several substantial features have directory-level paths because their implementation was not sampled.

Main entry points: [`src/main.js`](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/main.js) (App startup), [`src/overlays/worldOverlay.js`](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/overlays/worldOverlay.js) (Overlay system), [`src/data/manager.js`](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/manager.js) (Layer manager), [`src/voice/gevActions.js`](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/voice/gevActions.js) (Voice actions)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Globe Experience"]
  node_entry["App startup<br/>[main.js]"]
  node_map["Map stack"]
  node_layers["Layer manager<br/>[manager.js]"]
end

subgraph group_feeds["World Data"]
  node_flights["Aircraft feeds<br/>[flights.js]"]
  node_ships["Ship feeds<br/>[aisLiveVessels.js]"]
  node_space["Space tracks<br/>[satellites.js]"]
  node_cameras["Public cameras<br/>[cctv.js]"]
  node_otherfeeds["Other live layers"]
end

subgraph group_render["Visualization"]
  node_overlay["Overlay system<br/>[worldOverlay.js]"]
  node_overlaydraw["Overlay drawing"]
  node_detection["Detection overlay<br/>[detection.js]"]
  node_governor["Render governor<br/>[renderGovernor.js]"]
end

subgraph group_interaction["Control &amp; Analysis"]
  node_voice["Voice control<br/>[gevRealtime.js]"]
  node_actions["Voice actions<br/>[gevActions.js]"]
  node_analyst["Data query engine<br/>[analystEngine.js]"]
  node_annotations["Voice annotations"]
  node_resolver["Annotation resolver"]
  node_context["Global context"]
  node_cockpit["Cockpit tracking"]
end

subgraph group_extras["Capture &amp; Styling"]
  node_director["Scene director<br/>[director.js]"]
  node_styles["Sensor styles"]
  node_share["Share links<br/>[sharelink.js]"]
end

node_user(("Explorer"))

node_user -->|"opens"| node_entry
node_entry -->|"configures"| node_map
node_entry -->|"initializes"| node_layers
node_entry -->|"creates"| node_director
node_entry -->|"initializes"| node_annotations
node_layers -->|"notifies"| node_detection
node_entry -->|"registers"| node_flights
node_entry -->|"registers"| node_ships
node_entry -->|"registers"| node_space
node_entry -->|"registers"| node_cameras
node_entry -->|"registers"| node_otherfeeds
node_flights -.->|"draws via"| node_overlay
node_ships -.->|"draws via"| node_overlay
node_space -->|"draws via"| node_overlay
node_cameras -->|"draws via"| node_overlay
node_overlay -->|"delegates drawing"| node_overlaydraw
node_detection -->|"uses overlays"| node_overlay
node_layers -->|"requests renders"| node_governor
node_user -->|"speaks"| node_voice
node_voice -->|"dispatches"| node_actions
node_actions -->|"queries"| node_analyst
node_actions -->|"resolves regions"| node_resolver
node_user -->|"stages context"| node_context
node_user -->|"tracks target"| node_cockpit
node_user -->|"captures tour"| node_director
node_user -->|"chooses sensor look"| node_styles
node_user -->|"shares view"| node_share

click node_entry "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/main.js"
click node_map "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/mapStackController.js"
click node_layers "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/manager.js"
click node_flights "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/flights.js"
click node_ships "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/aisLiveVessels.js"
click node_space "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/satellites.js"
click node_cameras "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/cctv.js"
click node_otherfeeds "https://github.com/ovvenkatesan/gods-eye-view/tree/main/src/data"
click node_overlay "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/overlays/worldOverlay.js"
click node_overlaydraw "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/overlays/worldOverlayDraw.js"
click node_detection "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/detection.js"
click node_governor "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/renderGovernor.js"
click node_voice "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/voice/gevRealtime.js"
click node_actions "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/voice/gevActions.js"
click node_analyst "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/analystEngine.js"
click node_annotations "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/annotations/annotationEngine.js"
click node_resolver "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/annotations/annotationResolver.js"
click node_context "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/contextModePolicy.js"
click node_cockpit "https://github.com/ovvenkatesan/gods-eye-view/tree/main/src/data"
click node_director "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/scenes/director.js"
click node_styles "https://github.com/ovvenkatesan/gods-eye-view/tree/main/src/styles"
click node_share "https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/sharelink.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_entry,node_map,node_layers toneBlue
class node_flights,node_ships,node_space,node_cameras,node_otherfeeds toneAmber
class node_overlay,node_overlaydraw,node_detection,node_governor toneMint
class node_voice,node_actions,node_analyst,node_annotations,node_resolver,node_context,node_cockpit toneRose
class node_director,node_styles,node_share,node_user toneIndigo
```

## Components

### Globe Experience

- [App startup](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/main.js): `src/main.js`
- [Map stack](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/mapStackController.js): `src/mapStackController.js`
- [Layer manager](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/manager.js): `src/data/manager.js`

### World Data

- [Aircraft feeds](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/flights.js): `src/data/flights.js`
- [Ship feeds](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/aisLiveVessels.js): `src/data/aisLiveVessels.js`
- [Space tracks](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/satellites.js): `src/data/satellites.js`
- [Public cameras](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/cctv.js): `src/data/cctv.js`
- [Other live layers](https://github.com/ovvenkatesan/gods-eye-view/tree/main/src/data): `src/data`

### Visualization

- [Overlay system](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/overlays/worldOverlay.js): `src/overlays/worldOverlay.js`
- [Overlay drawing](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/overlays/worldOverlayDraw.js): `src/overlays/worldOverlayDraw.js`
- [Detection overlay](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/detection.js): `src/data/detection.js`
- [Render governor](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/renderGovernor.js): `src/renderGovernor.js`

### Control & Analysis

- [Voice control](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/voice/gevRealtime.js): `src/voice/gevRealtime.js`
- [Voice actions](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/voice/gevActions.js): `src/voice/gevActions.js`
- [Data query engine](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/data/analystEngine.js): `src/data/analystEngine.js`
- [Voice annotations](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/annotations/annotationEngine.js): `src/annotations/annotationEngine.js`
- [Annotation resolver](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/annotations/annotationResolver.js): `src/annotations/annotationResolver.js`
- [Global context](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/contextModePolicy.js): `src/contextModePolicy.js`
- [Cockpit tracking](https://github.com/ovvenkatesan/gods-eye-view/tree/main/src/data): `src/data`

### Capture & Styling

- [Scene director](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/scenes/director.js): `src/scenes/director.js`
- [Sensor styles](https://github.com/ovvenkatesan/gods-eye-view/tree/main/src/styles): `src/styles`
- [Share links](https://github.com/ovvenkatesan/gods-eye-view/blob/main/src/sharelink.js): `src/sharelink.js`

### Other components

- **Explorer**

## Connections

- Explorer → App startup: opens (evidence: `README.md`)
- App startup → Map stack: configures (evidence: `src/main.js`)
- App startup → Layer manager: initializes (evidence: `src/main.js`)
- App startup → Scene director: creates (evidence: `src/main.js`)
- App startup → Voice annotations: initializes (evidence: `src/main.js`)
- Layer manager → Detection overlay: notifies (evidence: `src/data/manager.js`)
- App startup → Aircraft feeds: registers (evidence: `src/main.js`)
- App startup → Ship feeds: registers (evidence: `src/main.js`)
- App startup → Space tracks: registers (evidence: `src/main.js`)
- App startup → Public cameras: registers (evidence: `src/main.js`)
- App startup → Other live layers: registers (evidence: `src/main.js`)
- Aircraft feeds → Overlay system: draws via
- Ship feeds → Overlay system: draws via
- Space tracks → Overlay system: draws via (evidence: `src/data/satellites.js`)
- Public cameras → Overlay system: draws via (evidence: `src/data/cctv.js`)
- Overlay system → Overlay drawing: delegates drawing (evidence: `src/overlays/worldOverlay.js`)
- Detection overlay → Overlay system: uses overlays (evidence: `src/data/detection.js`)
- Layer manager → Render governor: requests renders (evidence: `src/data/manager.js`)
- Explorer → Voice control: speaks (evidence: `README.md`)
- Voice control → Voice actions: dispatches (evidence: `src/voice/gevRealtime.js`)
- Voice actions → Data query engine: queries (evidence: `src/voice/gevActions.js`)
- Voice actions → Annotation resolver: resolves regions (evidence: `src/voice/gevActions.js`)
- Explorer → Global context: stages context (evidence: `README.md`)
- Explorer → Cockpit tracking: tracks target (evidence: `README.md`)
- Explorer → Scene director: captures tour (evidence: `README.md`)
- Explorer → Sensor styles: chooses sensor look (evidence: `README.md`)
- Explorer → Share links: shares view (evidence: `README.md`)
