# bosa-cyber/gods-eye-view architecture

> Architecture diagram of the GitHub repository bosa-cyber/gods-eye-view, 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/bosa-cyber/gods-eye-view
- Repository: https://github.com/bosa-cyber/gods-eye-view

## Overview

God’s Eye View is a browser-based 3D globe for exploring public, real-world signals. The main workflow is to open the globe, choose a map and data layers, inspect or track live contacts, and use cockpit, voice, annotations, or scene tools to explore and share a view. The README documents these capabilities; sampled source shows application composition, map-source control, annotation resolution, and voice orchestration. Many layer internals and provider connections were not sampled, so the graph keeps those links broad or omits uncertain call relationships.

Main entry points: [`src/app/layers`](https://github.com/bosa-cyber/gods-eye-view/tree/main/src/app/layers) (Live Layers), [`src/standalone/application.js`](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/standalone/application.js) (App Composition), [`src/app/application.js`](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/app/application.js) (Application Core), [`src/maps/controller.js`](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/maps/controller.js) (Map Sources)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_runtime["Application Runtime"]
  node_application["App Composition<br/>[application.js]"]
  node_appcore["Application Core<br/>[application.js]"]
end

subgraph group_globe["Globe Experience"]
  node_globeview["3D Globe<br/>[viewer.js]"]
  node_maps["Map Sources<br/>[controller.js]"]
  node_render["Render Governor<br/>[renderGovernor.js]"]
  node_overlay["World Overlays<br/>[worldOverlay.js]"]
end

subgraph group_signals["Data Signals"]
  node_live["Live Layers"]
  node_transit["Transit Tracking<br/>[ingestion.js]"]
  node_cctv["Public Cameras<br/>[cctvCards.js]"]
  node_localdata["Local GeoJSON"]
end

subgraph group_interaction["Exploration Tools"]
  node_search["Place Search<br/>[index.js]"]
  node_cockpit["Cockpit Mode"]
  node_voice["Voice Agent"]
  node_analysis["Contact Analysis<br/>[analystEngine.js]"]
  node_annotations["Voice Whiteboard"]
  node_resolver["Boundary Resolver"]
  node_detection["Detection Overlay<br/>[detection.js]"]
  node_director["Scene Director<br/>[authoring.js]"]
  node_sharing["Share Links<br/>[bundle.js]"]
end

subgraph group_services["Provider Services"]
  node_providers["Data Providers"]
end

node_user(("Explorer"))

node_user -->|"opens"| node_application
node_application -->|"composes"| node_appcore
node_appcore -.->|"creates"| node_globeview
node_user -->|"chooses map"| node_maps
node_maps -->|"requests renders"| node_render
node_user -->|"selects layers"| node_live
node_live -.->|"loads signals"| node_providers
node_user -->|"tracks contact"| node_cockpit
node_user -->|"searches places"| node_search
node_user -->|"speaks commands"| node_voice
node_user -->|"speaks marks"| node_annotations
node_annotations -->|"resolves boundaries"| node_resolver
node_user -->|"asks questions"| node_analysis
node_user -->|"views detections"| node_detection
node_user -->|"records tours"| node_director
node_user -->|"shares view"| node_sharing
node_transit -->|"uses feed policy"| node_transit
node_user -->|"explores cameras"| node_cctv
node_user -->|"adds data"| node_localdata
node_live -.->|"renders signals"| node_overlay

click node_application "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/standalone/application.js"
click node_appcore "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/app/application.js"
click node_globeview "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/app/viewer.js"
click node_maps "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/maps/controller.js"
click node_render "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/renderGovernor.js"
click node_overlay "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/overlays/worldOverlay.js"
click node_live "https://github.com/bosa-cyber/gods-eye-view/tree/main/src/app/layers"
click node_transit "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/layers/transit/ingestion.js"
click node_cctv "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/cctvCards.js"
click node_localdata "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/localGeojsonCore.js"
click node_providers "https://github.com/bosa-cyber/gods-eye-view/tree/main/server/providers"
click node_search "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/search/index.js"
click node_cockpit "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/ui/cockpitController.js"
click node_voice "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/voice/realtimeController.js"
click node_analysis "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/analystEngine.js"
click node_annotations "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/annotations/annotationEngine.js"
click node_resolver "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/annotations/annotationResolver.js"
click node_detection "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/detection.js"
click node_director "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/director/authoring.js"
click node_sharing "https://github.com/bosa-cyber/gods-eye-view/blob/main/src/director/sharing/bundle.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_application,node_appcore toneBlue
class node_globeview,node_maps,node_render,node_overlay toneAmber
class node_live,node_transit,node_cctv,node_localdata toneMint
class node_search,node_cockpit,node_voice,node_analysis,node_annotations,node_resolver,node_detection,node_director,node_sharing toneRose
class node_providers,node_user toneIndigo
```

## Components

### Application Runtime

- [App Composition](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/standalone/application.js): `src/standalone/application.js`
- [Application Core](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/app/application.js): `src/app/application.js`

### Globe Experience

- [3D Globe](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/app/viewer.js): `src/app/viewer.js`
- [Map Sources](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/maps/controller.js): `src/maps/controller.js`
- [Render Governor](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/renderGovernor.js): `src/renderGovernor.js`
- [World Overlays](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/overlays/worldOverlay.js): `src/overlays/worldOverlay.js`

### Data Signals

- [Live Layers](https://github.com/bosa-cyber/gods-eye-view/tree/main/src/app/layers): `src/app/layers`
- [Transit Tracking](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/layers/transit/ingestion.js): `src/layers/transit/ingestion.js`
- [Public Cameras](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/cctvCards.js): `src/data/cctvCards.js`
- [Local GeoJSON](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/localGeojsonCore.js): `src/data/localGeojsonCore.js`

### Exploration Tools

- [Place Search](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/search/index.js): `src/search/index.js`
- [Cockpit Mode](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/ui/cockpitController.js): `src/ui/cockpitController.js`
- [Voice Agent](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/voice/realtimeController.js): `src/voice/realtimeController.js`
- [Contact Analysis](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/analystEngine.js): `src/data/analystEngine.js`
- [Voice Whiteboard](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/annotations/annotationEngine.js): `src/annotations/annotationEngine.js`
- [Boundary Resolver](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/annotations/annotationResolver.js): `src/annotations/annotationResolver.js`
- [Detection Overlay](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/data/detection.js): `src/data/detection.js`
- [Scene Director](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/director/authoring.js): `src/director/authoring.js`
- [Share Links](https://github.com/bosa-cyber/gods-eye-view/blob/main/src/director/sharing/bundle.js): `src/director/sharing/bundle.js`

### Provider Services

- [Data Providers](https://github.com/bosa-cyber/gods-eye-view/tree/main/server/providers): `server/providers`

### Other components

- **Explorer**

## Connections

- Explorer → App Composition: opens
- App Composition → Application Core: composes (evidence: `src/standalone/application.js`)
- Application Core → 3D Globe: creates
- Explorer → Map Sources: chooses map
- Map Sources → Render Governor: requests renders (evidence: `src/mapStackController.js`)
- Explorer → Live Layers: selects layers
- Live Layers → Data Providers: loads signals
- Explorer → Cockpit Mode: tracks contact
- Explorer → Place Search: searches places
- Explorer → Voice Agent: speaks commands
- Explorer → Voice Whiteboard: speaks marks
- Voice Whiteboard → Boundary Resolver: resolves boundaries (evidence: `src/annotations/annotationEngine.js`)
- Explorer → Contact Analysis: asks questions
- Explorer → Detection Overlay: views detections
- Explorer → Scene Director: records tours
- Explorer → Share Links: shares view
- Transit Tracking → Transit Tracking: uses feed policy (evidence: `src/layers/transit/ingestion.js`)
- Explorer → Public Cameras: explores cameras
- Explorer → Local GeoJSON: adds data
- Live Layers → World Overlays: renders signals
