# moh1122/osiris architecture

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

## Overview

OSIRIS is a real-time OSINT dashboard: users inspect global intelligence layers on a map, open feeds and panels for detail, and use RECON searches and tools for targeted investigations. The principal flow is map interaction to client panels, then API routes that aggregate or normalize upstream data. Distinct branches cover aviation, CCTV, geospatial events, cyber/OSINT, markets, space, and AI briefings. The README documents capabilities not fully represented by sampled source; those branches are included, but unsampled internal call paths are omitted or marked unverified.

Main entry points: [`src/components/OsirisMap.tsx`](https://github.com/moh1122/osiris/blob/master/src/components/OsirisMap.tsx) (Interactive Map), [`src/lib/stealthFetch.ts`](https://github.com/moh1122/osiris/blob/master/src/lib/stealthFetch.ts) (Upstream Fetch), [`src/app/api/cctv/route.ts`](https://github.com/moh1122/osiris/blob/master/src/app/api/cctv/route.ts) (Global CCTV), [`src/components/OsintPanel.tsx`](https://github.com/moh1122/osiris/blob/master/src/components/OsintPanel.tsx) (RECON Panel)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Map and Panels"]
  node_dashboard["OSIRIS Dashboard<br/>[page.tsx]"]
  node_map["Interactive Map<br/>[OsirisMap.tsx]"]
  node_cctvui["Camera Previews<br/>[CctvPreviews.tsx]"]
  node_reconui["RECON Panel<br/>[OsintPanel.tsx]"]
end

subgraph group_feeds["Live Intelligence Feeds"]
  node_aviation["Flight Tracking<br/>[route.ts]"]
  node_flightpath["Flight Routes<br/>[route.ts]"]
  node_cctv["Global CCTV<br/>[route.ts]"]
  node_cctvproviders["Regional Camera Sources"]
  node_conflicts["Conflict Monitoring<br/>[route.ts]"]
  node_events["Global Event Layers"]
  node_broadcast["Live News<br/>[route.ts]"]
  node_maritime["Maritime Tracking<br/>[route.ts]"]
  node_space["Satellite Tracking<br/>[route.ts]"]
  node_weather["Weather and Space<br/>[route.ts]"]
end

subgraph group_recon["RECON and Analysis"]
  node_reconroutes["OSINT and Scanner APIs"]
  node_crypto["Crypto Intelligence<br/>[chainIntel.ts]"]
  node_ai["AI Intelligence"]
  node_sdk["Fusion SDK<br/>[PolybolosClient.ts]"]
end

subgraph group_platform["Shared Runtime"]
  node_cache["Source Cache<br/>[sourceCache.ts]"]
  node_fetch["Upstream Fetch<br/>[stealthFetch.ts]"]
  node_airports["Airport Data<br/>[airports.ts]"]
  node_camerahelpers["Camera Rendering Helpers<br/>[camera-preview.ts]"]
end

node_operator(("Analyst"))
node_lattice["Lattice Provider"]
node_datasources(("External Data Sources"))

node_operator -->|"opens"| node_dashboard
node_dashboard -.->|"presents"| node_map
node_map -.->|"loads layers"| node_aviation
node_map -.->|"loads cameras"| node_cctv
node_cctv -->|"dispatches"| node_cctvproviders
node_cctv -->|"caches indexes"| node_cache
node_cctv -->|"fetches upstream"| node_fetch
node_cctvui -->|"renders media"| node_camerahelpers
node_map -.->|"requests routes"| node_flightpath
node_flightpath -->|"resolves airports"| node_airports
node_flightpath -->|"queries sources"| node_fetch
node_aviation -->|"queries feeds"| node_fetch
node_map -.->|"loads zones"| node_conflicts
node_map -.->|"loads layers"| node_events
node_map -.->|"opens broadcasts"| node_broadcast
node_map -.->|"loads vessels"| node_maritime
node_map -.->|"loads satellites"| node_space
node_space -->|"fetches TLEs"| node_fetch
node_space -.->|"queries"| node_datasources
node_map -.->|"loads conditions"| node_weather
node_reconui -.->|"submits lookups"| node_reconroutes
node_reconui -.->|"requests tracing"| node_crypto
node_reconui -.->|"requests analysis"| node_ai
node_ai -.->|"uses AI service"| node_datasources
node_sdk -->|"connects optionally"| node_lattice
node_sdk -.->|"subscribes to OSIRIS"| node_datasources
node_conflicts -->|"fetches live data"| node_fetch
node_weather -.->|"fetches data"| node_fetch
node_aviation -.->|"queries feeds"| node_datasources
node_reconroutes -.->|"queries intelligence"| node_datasources

click node_dashboard "https://github.com/moh1122/osiris/blob/master/src/app/page.tsx"
click node_map "https://github.com/moh1122/osiris/blob/master/src/components/OsirisMap.tsx"
click node_cctvui "https://github.com/moh1122/osiris/blob/master/src/components/CctvPreviews.tsx"
click node_reconui "https://github.com/moh1122/osiris/blob/master/src/components/OsintPanel.tsx"
click node_aviation "https://github.com/moh1122/osiris/blob/master/src/app/api/flights/route.ts"
click node_flightpath "https://github.com/moh1122/osiris/blob/master/src/app/api/flight-route/route.ts"
click node_cctv "https://github.com/moh1122/osiris/blob/master/src/app/api/cctv/route.ts"
click node_cctvproviders "https://github.com/moh1122/osiris/tree/master/src/app/api/cctv"
click node_conflicts "https://github.com/moh1122/osiris/blob/master/src/app/api/conflicts/route.ts"
click node_events "https://github.com/moh1122/osiris/tree/master/src/app/api"
click node_broadcast "https://github.com/moh1122/osiris/blob/master/src/app/api/live-news/route.ts"
click node_maritime "https://github.com/moh1122/osiris/blob/master/src/app/api/maritime/route.ts"
click node_space "https://github.com/moh1122/osiris/blob/master/src/app/api/satellites/route.ts"
click node_weather "https://github.com/moh1122/osiris/blob/master/src/app/api/weather/route.ts"
click node_reconroutes "https://github.com/moh1122/osiris/tree/master/src/app/api/osint"
click node_crypto "https://github.com/moh1122/osiris/blob/master/src/lib/chainIntel.ts"
click node_ai "https://github.com/moh1122/osiris/tree/master/src/app/api/ai"
click node_sdk "https://github.com/moh1122/osiris/blob/master/src/lib/sdk/PolybolosClient.ts"
click node_cache "https://github.com/moh1122/osiris/blob/master/src/lib/sourceCache.ts"
click node_fetch "https://github.com/moh1122/osiris/blob/master/src/lib/stealthFetch.ts"
click node_airports "https://github.com/moh1122/osiris/blob/master/src/lib/airports.ts"
click node_camerahelpers "https://github.com/moh1122/osiris/blob/master/src/lib/camera-preview.ts"

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_dashboard,node_map,node_cctvui,node_reconui toneBlue
class node_aviation,node_flightpath,node_cctv,node_cctvproviders,node_conflicts,node_events,node_broadcast,node_maritime,node_space,node_weather toneAmber
class node_reconroutes,node_crypto,node_ai,node_sdk toneMint
class node_cache,node_fetch,node_airports,node_camerahelpers toneRose
class node_operator,node_lattice,node_datasources toneIndigo
```

## Components

### Map and Panels

- [OSIRIS Dashboard](https://github.com/moh1122/osiris/blob/master/src/app/page.tsx): `src/app/page.tsx`
- [Interactive Map](https://github.com/moh1122/osiris/blob/master/src/components/OsirisMap.tsx): `src/components/OsirisMap.tsx`
- [Camera Previews](https://github.com/moh1122/osiris/blob/master/src/components/CctvPreviews.tsx): `src/components/CctvPreviews.tsx`
- [RECON Panel](https://github.com/moh1122/osiris/blob/master/src/components/OsintPanel.tsx): `src/components/OsintPanel.tsx`

### Live Intelligence Feeds

- [Flight Tracking](https://github.com/moh1122/osiris/blob/master/src/app/api/flights/route.ts): `src/app/api/flights/route.ts`
- [Flight Routes](https://github.com/moh1122/osiris/blob/master/src/app/api/flight-route/route.ts): `src/app/api/flight-route/route.ts`
- [Global CCTV](https://github.com/moh1122/osiris/blob/master/src/app/api/cctv/route.ts): `src/app/api/cctv/route.ts`
- [Regional Camera Sources](https://github.com/moh1122/osiris/tree/master/src/app/api/cctv): `src/app/api/cctv`
- [Conflict Monitoring](https://github.com/moh1122/osiris/blob/master/src/app/api/conflicts/route.ts): `src/app/api/conflicts/route.ts`
- [Global Event Layers](https://github.com/moh1122/osiris/tree/master/src/app/api): `src/app/api`
- [Live News](https://github.com/moh1122/osiris/blob/master/src/app/api/live-news/route.ts): `src/app/api/live-news/route.ts`
- [Maritime Tracking](https://github.com/moh1122/osiris/blob/master/src/app/api/maritime/route.ts): `src/app/api/maritime/route.ts`
- [Satellite Tracking](https://github.com/moh1122/osiris/blob/master/src/app/api/satellites/route.ts): `src/app/api/satellites/route.ts`
- [Weather and Space](https://github.com/moh1122/osiris/blob/master/src/app/api/weather/route.ts): `src/app/api/weather/route.ts`

### RECON and Analysis

- [OSINT and Scanner APIs](https://github.com/moh1122/osiris/tree/master/src/app/api/osint): `src/app/api/osint`
- [Crypto Intelligence](https://github.com/moh1122/osiris/blob/master/src/lib/chainIntel.ts): `src/lib/chainIntel.ts`
- [AI Intelligence](https://github.com/moh1122/osiris/tree/master/src/app/api/ai): `src/app/api/ai`
- [Fusion SDK](https://github.com/moh1122/osiris/blob/master/src/lib/sdk/PolybolosClient.ts): `src/lib/sdk/PolybolosClient.ts`

### Shared Runtime

- [Source Cache](https://github.com/moh1122/osiris/blob/master/src/lib/sourceCache.ts): `src/lib/sourceCache.ts`
- [Upstream Fetch](https://github.com/moh1122/osiris/blob/master/src/lib/stealthFetch.ts): `src/lib/stealthFetch.ts`
- [Airport Data](https://github.com/moh1122/osiris/blob/master/src/lib/airports.ts): `src/lib/airports.ts`
- [Camera Rendering Helpers](https://github.com/moh1122/osiris/blob/master/src/lib/camera-preview.ts): `src/lib/camera-preview.ts`

### Other components

- **Analyst**
- **Lattice Provider**
- **External Data Sources**

## Connections

- Analyst → OSIRIS Dashboard: opens (evidence: `README.md`)
- OSIRIS Dashboard → Interactive Map: presents
- Interactive Map → Flight Tracking: loads layers
- Interactive Map → Global CCTV: loads cameras
- Global CCTV → Regional Camera Sources: dispatches (evidence: `src/app/api/cctv/route.ts`)
- Global CCTV → Source Cache: caches indexes (evidence: `src/app/api/cctv/route.ts`)
- Global CCTV → Upstream Fetch: fetches upstream (evidence: `src/app/api/cctv/route.ts`)
- Camera Previews → Camera Rendering Helpers: renders media (evidence: `src/components/CctvPreviews.tsx`)
- Interactive Map → Flight Routes: requests routes
- Flight Routes → Airport Data: resolves airports (evidence: `src/app/api/flight-route/route.ts`)
- Flight Routes → Upstream Fetch: queries sources (evidence: `src/app/api/flight-route/route.ts`)
- Flight Tracking → Upstream Fetch: queries feeds (evidence: `src/app/api/flights/route.ts`)
- Interactive Map → Conflict Monitoring: loads zones
- Interactive Map → Global Event Layers: loads layers
- Interactive Map → Live News: opens broadcasts
- Interactive Map → Maritime Tracking: loads vessels
- Interactive Map → Satellite Tracking: loads satellites
- Satellite Tracking → Upstream Fetch: fetches TLEs (evidence: `src/app/api/satellites/route.ts`)
- Satellite Tracking → External Data Sources: queries
- Interactive Map → Weather and Space: loads conditions
- RECON Panel → OSINT and Scanner APIs: submits lookups
- RECON Panel → Crypto Intelligence: requests tracing
- RECON Panel → AI Intelligence: requests analysis
- AI Intelligence → External Data Sources: uses AI service
- Fusion SDK → Lattice Provider: connects optionally (evidence: `src/lib/sdk/PolybolosClient.ts`)
- Fusion SDK → External Data Sources: subscribes to OSIRIS
- Conflict Monitoring → Upstream Fetch: fetches live data (evidence: `src/app/api/conflicts/route.ts`)
- Weather and Space → Upstream Fetch: fetches data (evidence: `src/app/api/weather/route.ts`)
- Flight Tracking → External Data Sources: queries feeds
- OSINT and Scanner APIs → External Data Sources: queries intelligence
