# rudra795/aurexo1 architecture

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

- Interactive diagram: https://gitdiagram.com/rudra795/aurexo1
- Repository: https://github.com/rudra795/aurexo1

## Overview

Aurexo is a map-first maritime intelligence platform: operators inspect live marine conditions, vessels, satellite layers, regions, and safe routes, or ask a conversational copilot to explain evidence. API handlers route requests into domain services and agent/LLM reasoning; deterministic geospatial checks and live feeds underpin safety and point intelligence. The README documents browser-direct NASA satellite tiles and major capabilities, but many page and service implementations were not sampled, so some documented links are cited to the README and uncertain wiring is omitted.

Main entry points: [`src/app`](https://github.com/rudra795/aurexo1/tree/main/src/app) (Marine workspace), [`src/lib/services/point-intelligence.service.ts`](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/point-intelligence.service.ts) (Point intelligence), [`src/lib/services/marine.service.ts`](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/marine.service.ts) (Marine observations), [`src/components/map`](https://github.com/rudra795/aurexo1/tree/main/src/components/map) (Map and layers)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Operator experience"]
  node_web["Marine workspace"]
  node_map["Map and layers"]
  node_copilot["Tactical copilot"]
  node_telemetry["Telemetry HUD"]
end

subgraph group_api["Application API"]
  node_api_query["Agent query API<br/>[route.ts]"]
  node_api_marine["Marine conditions API<br/>[route.ts]"]
  node_api_point["Point intelligence API<br/>[route.ts]"]
  node_api_regions["Regions API<br/>[route.ts]"]
  node_api_vessels["Vessels API<br/>[route.ts]"]
end

subgraph group_reasoning["Agent reasoning"]
  node_supervisor["Agent supervisor<br/>[supervisor.ts]"]
  node_agents["Collaborative agents"]
  node_llm["LLM dispatcher<br/>[provider.ts]"]
  node_model_discovery["Model discovery<br/>[model-discovery.ts]"]
  node_sessions["Conversation sessions<br/>[session.service.ts]"]
end

subgraph group_intelligence["Marine intelligence"]
  node_marine_service["Marine observations<br/>[marine.service.ts]"]
  node_point_service["Point intelligence"]
  node_regions["Region intelligence<br/>[region.service.ts]"]
  node_safety["Safety assessment<br/>[safety-engine.ts]"]
  node_boundaries["Boundary sentinel<br/>[boundaries.ts]"]
  node_routes["Passage corridors<br/>[routes.ts]"]
  node_vessels["Vessel tracking<br/>[vessel.service.ts]"]
  node_satellite["Satellite layers"]
end

subgraph group_integrations["Data integrations"]
  node_weather_provider["Open-Meteo feeds<br/>[open-meteo.ts]"]
  node_ais_provider["AIS stream adapter<br/>[ais-stream.ts]"]
  node_ais["AIS ingestion<br/>[ais-service.ts]"]
end

node_operator(("Maritime operator"))
node_nasa["NASA GIBS"]
node_llm_services["LLM providers"]

node_operator -->|"uses"| node_web
node_web -->|"presents"| node_map
node_web -->|"presents"| node_copilot
node_web -->|"presents"| node_telemetry
node_map -->|"streams tiles"| node_nasa
node_copilot -.->|"submits queries"| node_api_query
node_web -.->|"requests conditions"| node_api_marine
node_web -.->|"requests point data"| node_api_point
node_web -.->|"requests regions"| node_api_regions
node_web -.->|"requests vessels"| node_api_vessels
node_api_query -->|"invokes"| node_supervisor
node_api_query -->|"uses"| node_sessions
node_supervisor -->|"synthesizes with"| node_llm
node_supervisor -->|"delegates to"| node_agents
node_llm -->|"dispatches to"| node_llm_services
node_api_marine -->|"calls"| node_marine_service
node_api_point -->|"calls"| node_point_service
node_api_regions -->|"calls"| node_regions
node_api_vessels -->|"calls"| node_vessels
node_marine_service -->|"fetches observations"| node_weather_provider
node_point_service -->|"finds nearest region"| node_regions
node_point_service -->|"checks geofence"| node_boundaries
node_point_service -->|"retrieves conditions"| node_marine_service
node_point_service -->|"retrieves nearby vessels"| node_vessels
node_safety -->|"fetches conditions"| node_marine_service
node_safety -->|"checks geofence"| node_boundaries
node_routes -->|"checks waypoints"| node_boundaries
node_vessels -->|"fetches live vessels"| node_ais_provider
node_ais_provider -->|"uses ingestion service"| node_ais
node_map -->|"configures layers"| node_satellite
node_model_discovery -.->|"discovers models"| node_llm_services

click node_web "https://github.com/rudra795/aurexo1/tree/main/src/app"
click node_map "https://github.com/rudra795/aurexo1/tree/main/src/components/map"
click node_copilot "https://github.com/rudra795/aurexo1/tree/main/src/components/chat"
click node_telemetry "https://github.com/rudra795/aurexo1/tree/main/src/components/telemetry"
click node_api_query "https://github.com/rudra795/aurexo1/blob/main/src/app/api/agent/query/route.ts"
click node_api_marine "https://github.com/rudra795/aurexo1/blob/main/src/app/api/marine/conditions/route.ts"
click node_api_point "https://github.com/rudra795/aurexo1/blob/main/src/app/api/marine/point/route.ts"
click node_api_regions "https://github.com/rudra795/aurexo1/blob/main/src/app/api/regions/route.ts"
click node_api_vessels "https://github.com/rudra795/aurexo1/blob/main/src/app/api/vessels/route.ts"
click node_supervisor "https://github.com/rudra795/aurexo1/blob/main/src/lib/agents/supervisor.ts"
click node_agents "https://github.com/rudra795/aurexo1/tree/main/src/lib/agents"
click node_llm "https://github.com/rudra795/aurexo1/blob/main/src/lib/llm/provider.ts"
click node_model_discovery "https://github.com/rudra795/aurexo1/blob/main/src/lib/llm/model-discovery.ts"
click node_sessions "https://github.com/rudra795/aurexo1/blob/main/src/lib/services/session.service.ts"
click node_marine_service "https://github.com/rudra795/aurexo1/blob/main/src/lib/services/marine.service.ts"
click node_point_service "https://github.com/rudra795/aurexo1/blob/main/src/lib/services/point-intelligence.service.ts"
click node_regions "https://github.com/rudra795/aurexo1/blob/main/src/lib/services/region.service.ts"
click node_safety "https://github.com/rudra795/aurexo1/blob/main/src/lib/tools/safety-engine.ts"
click node_boundaries "https://github.com/rudra795/aurexo1/blob/main/src/lib/geo/boundaries.ts"
click node_routes "https://github.com/rudra795/aurexo1/blob/main/src/lib/geo/routes.ts"
click node_vessels "https://github.com/rudra795/aurexo1/blob/main/src/lib/services/vessel.service.ts"
click node_satellite "https://github.com/rudra795/aurexo1/blob/main/src/lib/tools/satellite-layers.ts"
click node_weather_provider "https://github.com/rudra795/aurexo1/blob/main/src/lib/providers/open-meteo.ts"
click node_ais_provider "https://github.com/rudra795/aurexo1/blob/main/src/lib/providers/ais-stream.ts"
click node_ais "https://github.com/rudra795/aurexo1/blob/main/src/lib/tools/ais-service.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_web,node_map,node_copilot,node_telemetry toneBlue
class node_api_query,node_api_marine,node_api_point,node_api_regions,node_api_vessels toneAmber
class node_supervisor,node_agents,node_llm,node_model_discovery,node_sessions toneMint
class node_marine_service,node_point_service,node_regions,node_safety,node_boundaries,node_routes,node_vessels,node_satellite toneRose
class node_weather_provider,node_ais_provider,node_ais,node_operator,node_nasa,node_llm_services toneIndigo
```

## Components

### Operator experience

- [Marine workspace](https://github.com/rudra795/aurexo1/tree/main/src/app): `src/app`
- [Map and layers](https://github.com/rudra795/aurexo1/tree/main/src/components/map): `src/components/map`
- [Tactical copilot](https://github.com/rudra795/aurexo1/tree/main/src/components/chat): `src/components/chat`
- [Telemetry HUD](https://github.com/rudra795/aurexo1/tree/main/src/components/telemetry): `src/components/telemetry`

### Application API

- [Agent query API](https://github.com/rudra795/aurexo1/blob/main/src/app/api/agent/query/route.ts): `src/app/api/agent/query/route.ts`
- [Marine conditions API](https://github.com/rudra795/aurexo1/blob/main/src/app/api/marine/conditions/route.ts): `src/app/api/marine/conditions/route.ts`
- [Point intelligence API](https://github.com/rudra795/aurexo1/blob/main/src/app/api/marine/point/route.ts): `src/app/api/marine/point/route.ts`
- [Regions API](https://github.com/rudra795/aurexo1/blob/main/src/app/api/regions/route.ts): `src/app/api/regions/route.ts`
- [Vessels API](https://github.com/rudra795/aurexo1/blob/main/src/app/api/vessels/route.ts): `src/app/api/vessels/route.ts`

### Agent reasoning

- [Agent supervisor](https://github.com/rudra795/aurexo1/blob/main/src/lib/agents/supervisor.ts): `src/lib/agents/supervisor.ts`
- [Collaborative agents](https://github.com/rudra795/aurexo1/tree/main/src/lib/agents): `src/lib/agents`
- [LLM dispatcher](https://github.com/rudra795/aurexo1/blob/main/src/lib/llm/provider.ts): `src/lib/llm/provider.ts`
- [Model discovery](https://github.com/rudra795/aurexo1/blob/main/src/lib/llm/model-discovery.ts): `src/lib/llm/model-discovery.ts`
- [Conversation sessions](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/session.service.ts): `src/lib/services/session.service.ts`

### Marine intelligence

- [Marine observations](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/marine.service.ts): `src/lib/services/marine.service.ts`
- [Point intelligence](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/point-intelligence.service.ts): `src/lib/services/point-intelligence.service.ts`
- [Region intelligence](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/region.service.ts): `src/lib/services/region.service.ts`
- [Safety assessment](https://github.com/rudra795/aurexo1/blob/main/src/lib/tools/safety-engine.ts): `src/lib/tools/safety-engine.ts`
- [Boundary sentinel](https://github.com/rudra795/aurexo1/blob/main/src/lib/geo/boundaries.ts): `src/lib/geo/boundaries.ts`
- [Passage corridors](https://github.com/rudra795/aurexo1/blob/main/src/lib/geo/routes.ts): `src/lib/geo/routes.ts`
- [Vessel tracking](https://github.com/rudra795/aurexo1/blob/main/src/lib/services/vessel.service.ts): `src/lib/services/vessel.service.ts`
- [Satellite layers](https://github.com/rudra795/aurexo1/blob/main/src/lib/tools/satellite-layers.ts): `src/lib/tools/satellite-layers.ts`

### Data integrations

- [Open-Meteo feeds](https://github.com/rudra795/aurexo1/blob/main/src/lib/providers/open-meteo.ts): `src/lib/providers/open-meteo.ts`
- [AIS stream adapter](https://github.com/rudra795/aurexo1/blob/main/src/lib/providers/ais-stream.ts): `src/lib/providers/ais-stream.ts`
- [AIS ingestion](https://github.com/rudra795/aurexo1/blob/main/src/lib/tools/ais-service.ts): `src/lib/tools/ais-service.ts`

### Other components

- **Maritime operator**
- **NASA GIBS**
- **LLM providers**

## Connections

- Maritime operator → Marine workspace: uses
- Marine workspace → Map and layers: presents
- Marine workspace → Tactical copilot: presents
- Marine workspace → Telemetry HUD: presents
- Map and layers → NASA GIBS: streams tiles
- Tactical copilot → Agent query API: submits queries
- Marine workspace → Marine conditions API: requests conditions
- Marine workspace → Point intelligence API: requests point data
- Marine workspace → Regions API: requests regions
- Marine workspace → Vessels API: requests vessels
- Agent query API → Agent supervisor: invokes (evidence: `src/app/api/agent/query/route.ts`)
- Agent query API → Conversation sessions: uses (evidence: `src/app/api/agent/query/route.ts`)
- Agent supervisor → LLM dispatcher: synthesizes with (evidence: `src/lib/agents/supervisor.ts`)
- Agent supervisor → Collaborative agents: delegates to (evidence: `src/lib/agents/supervisor.ts`)
- LLM dispatcher → LLM providers: dispatches to (evidence: `src/lib/llm/provider.ts`)
- Marine conditions API → Marine observations: calls (evidence: `src/app/api/marine/conditions/route.ts`)
- Point intelligence API → Point intelligence: calls (evidence: `src/app/api/marine/point/route.ts`)
- Regions API → Region intelligence: calls (evidence: `src/app/api/regions/route.ts`)
- Vessels API → Vessel tracking: calls (evidence: `src/app/api/vessels/route.ts`)
- Marine observations → Open-Meteo feeds: fetches observations (evidence: `src/lib/services/marine.service.ts`)
- Point intelligence → Region intelligence: finds nearest region (evidence: `src/lib/services/point-intelligence.service.ts`)
- Point intelligence → Boundary sentinel: checks geofence (evidence: `src/lib/services/point-intelligence.service.ts`)
- Point intelligence → Marine observations: retrieves conditions (evidence: `src/lib/services/point-intelligence.service.ts`)
- Point intelligence → Vessel tracking: retrieves nearby vessels (evidence: `src/lib/services/point-intelligence.service.ts`)
- Safety assessment → Marine observations: fetches conditions
- Safety assessment → Boundary sentinel: checks geofence (evidence: `src/lib/tools/safety-engine.ts`)
- Passage corridors → Boundary sentinel: checks waypoints (evidence: `src/lib/geo/routes.ts`)
- Vessel tracking → AIS stream adapter: fetches live vessels (evidence: `src/lib/services/vessel.service.ts`)
- AIS stream adapter → AIS ingestion: uses ingestion service (evidence: `src/lib/providers/ais-stream.ts`)
- Map and layers → Satellite layers: configures layers (evidence: `src/components/map/LayerController.tsx`)
- Model discovery → LLM providers: discovers models
