# mounishwarans2/deep-ocean-acoustic-network architecture

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

- Interactive diagram: https://gitdiagram.com/mounishwarans2/deep-ocean-acoustic-network
- Repository: https://github.com/mounishwarans2/deep-ocean-acoustic-network

## Overview

This is a React ocean-monitoring and underwater-network dashboard, presented partly as a simulated digital twin and partly as an architecture concept. The main workflow routes users into the dashboard, builds simulated device/network telemetry, and exposes it through monitoring pages and menus. Separate branches cover an AI assistant, ocean observations, exploration views, and a 3D prototype. Some capabilities are visible in the file tree or documented UI data but their runtime wiring was not sampled, so those connections are omitted rather than inferred.

Main entry points: [`src/pages/Dashboard.tsx`](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/Dashboard.tsx) (Dashboard), [`src/components/menu/MenuContentView.tsx`](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/MenuContentView.tsx) (Menu Views), [`src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx`](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx) (Ocean Assistant), [`src/hooks/useSimulation.ts`](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/hooks/useSimulation.ts) (Simulation State)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application"]
  node_routes["App Routes<br/>[App.tsx]"]
  node_dashboard["Dashboard<br/>[Dashboard.tsx]"]
  node_settings["Dashboard Settings"]
  node_menu["Menu Views"]
  node_menu_data["Menu Content Data<br/>[menuContent.ts]"]
  node_assistant["Ocean Assistant"]
  node_ai_context["AI Context<br/>[aiContext.ts]"]
  node_ai_responses["Assistant Responses"]
end

subgraph group_monitor["Monitoring Simulation"]
  node_simulation["Simulation State<br/>[useSimulation.ts]"]
  node_network["Network Nodes<br/>[nodes.ts]"]
  node_telemetry["Telemetry Metrics<br/>[telemetry.ts]"]
  node_topology["Network Topology"]
  node_analytics["Data Analytics<br/>[DataAnalytics.tsx]"]
end

subgraph group_explore["Exploration and Data"]
  node_explore_portal["Explore Portal<br/>[ExplorePortal.tsx]"]
  node_device_explorer["Device Explorer<br/>[DeviceExplorer.tsx]"]
  node_acoustics["Acoustic Exploration"]
  node_ocean_data["NOAA Observation Provider<br/>[noaaWodService.ts]"]
  node_storage_view["Storage Architecture View"]
  node_pipeline_view["Pipeline Architecture View"]
end

subgraph group_prototype["3D Prototype"]
  node_about_device["Device Information Page<br/>[AboutDevice.tsx]"]
  node_viewer["Prototype Viewer"]
  node_model["Prototype Model<br/>[PrototypeModel.tsx]"]
  node_particles["Underwater Particles"]
  node_marine_manager["Marine Life Manager"]
  node_fish_school["Fish School<br/>[FishSchool.tsx]"]
end

node_user(("User"))

node_user -->|"opens app"| node_routes
node_routes -->|"routes to"| node_dashboard
node_dashboard -->|"reads state"| node_simulation
node_dashboard -->|"reads settings"| node_settings
node_dashboard -->|"renders"| node_menu
node_menu -->|"reads content"| node_menu_data
node_simulation -->|"generates nodes"| node_network
node_simulation -->|"computes metrics"| node_telemetry
node_dashboard -->|"renders"| node_assistant
node_assistant -->|"uses context"| node_ai_context
node_assistant -->|"uses responses"| node_ai_responses
node_assistant -->|"reads simulation"| node_simulation
node_menu -->|"renders view"| node_explore_portal
node_menu -->|"renders view"| node_device_explorer
node_menu -->|"renders view"| node_acoustics
node_storage_view -->|"reads observations"| node_ocean_data
node_about_device -->|"renders"| node_viewer
node_viewer -->|"renders"| node_model
node_viewer -->|"renders"| node_particles
node_marine_manager -->|"renders"| node_fish_school

click node_routes "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/App.tsx"
click node_dashboard "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/Dashboard.tsx"
click node_settings "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/hooks/useDashboardSettings.tsx"
click node_menu "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/MenuContentView.tsx"
click node_menu_data "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/data/menuContent.ts"
click node_simulation "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/hooks/useSimulation.ts"
click node_network "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/simulation/nodes.ts"
click node_telemetry "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/simulation/telemetry.ts"
click node_topology "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/topology/NetworkTopology.tsx"
click node_analytics "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/DataAnalytics.tsx"
click node_assistant "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx"
click node_ai_context "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/services/aiContext.ts"
click node_ai_responses "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/services/assistantResponses.ts"
click node_explore_portal "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/explore/ExplorePortal.tsx"
click node_device_explorer "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/explore/DeviceExplorer.tsx"
click node_acoustics "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/explore/AcousticSignals.tsx"
click node_ocean_data "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/services/noaaWodService.ts"
click node_storage_view "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/data/CassandraStorageView.tsx"
click node_pipeline_view "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/data/DataPipelineView.tsx"
click node_about_device "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/AboutDevice.tsx"
click node_viewer "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/prototype3d/PrototypeViewer.tsx"
click node_model "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/prototype3d/PrototypeModel.tsx"
click node_particles "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/prototype3d/UnderwaterParticles.tsx"
click node_marine_manager "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/sim3d/components/MarineLife/MarineLifeManager.tsx"
click node_fish_school "https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/sim3d/components/MarineLife/FishSchool.tsx"

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_routes,node_dashboard,node_settings,node_menu,node_menu_data,node_assistant,node_ai_context,node_ai_responses,node_user toneBlue
class node_simulation,node_network,node_telemetry,node_topology,node_analytics toneAmber
class node_explore_portal,node_device_explorer,node_acoustics,node_ocean_data,node_storage_view,node_pipeline_view toneMint
class node_about_device,node_viewer,node_model,node_particles,node_marine_manager,node_fish_school toneRose
```

## Components

### Application

- [App Routes](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/App.tsx): `src/App.tsx`
- [Dashboard](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/Dashboard.tsx): `src/pages/Dashboard.tsx`
- [Dashboard Settings](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/hooks/useDashboardSettings.tsx): `src/hooks/useDashboardSettings.tsx`
- [Menu Views](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/MenuContentView.tsx): `src/components/menu/MenuContentView.tsx`
- [Menu Content Data](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/data/menuContent.ts): `src/data/menuContent.ts`
- [Ocean Assistant](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx): `src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx`
- [AI Context](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/services/aiContext.ts): `src/services/aiContext.ts`
- [Assistant Responses](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/services/assistantResponses.ts): `src/services/assistantResponses.ts`

### Monitoring Simulation

- [Simulation State](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/hooks/useSimulation.ts): `src/hooks/useSimulation.ts`
- [Network Nodes](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/simulation/nodes.ts): `src/simulation/nodes.ts`
- [Telemetry Metrics](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/simulation/telemetry.ts): `src/simulation/telemetry.ts`
- [Network Topology](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/topology/NetworkTopology.tsx): `src/components/topology/NetworkTopology.tsx`
- [Data Analytics](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/DataAnalytics.tsx): `src/pages/DataAnalytics.tsx`

### Exploration and Data

- [Explore Portal](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/explore/ExplorePortal.tsx): `src/components/explore/ExplorePortal.tsx`
- [Device Explorer](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/explore/DeviceExplorer.tsx): `src/components/explore/DeviceExplorer.tsx`
- [Acoustic Exploration](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/explore/AcousticSignals.tsx): `src/components/explore/AcousticSignals.tsx`
- [NOAA Observation Provider](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/services/noaaWodService.ts): `src/services/noaaWodService.ts`
- [Storage Architecture View](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/data/CassandraStorageView.tsx): `src/components/menu/data/CassandraStorageView.tsx`
- [Pipeline Architecture View](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/menu/data/DataPipelineView.tsx): `src/components/menu/data/DataPipelineView.tsx`

### 3D Prototype

- [Device Information Page](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/pages/AboutDevice.tsx): `src/pages/AboutDevice.tsx`
- [Prototype Viewer](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/prototype3d/PrototypeViewer.tsx): `src/components/prototype3d/PrototypeViewer.tsx`
- [Prototype Model](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/prototype3d/PrototypeModel.tsx): `src/components/prototype3d/PrototypeModel.tsx`
- [Underwater Particles](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/components/prototype3d/UnderwaterParticles.tsx): `src/components/prototype3d/UnderwaterParticles.tsx`
- [Marine Life Manager](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/sim3d/components/MarineLife/MarineLifeManager.tsx): `src/sim3d/components/MarineLife/MarineLifeManager.tsx`
- [Fish School](https://github.com/mounishwarans2/deep-ocean-acoustic-network/blob/main/src/sim3d/components/MarineLife/FishSchool.tsx): `src/sim3d/components/MarineLife/FishSchool.tsx`

### Other components

- **User**

## Connections

- User → App Routes: opens app (evidence: `src/App.tsx`)
- App Routes → Dashboard: routes to (evidence: `src/App.tsx`)
- Dashboard → Simulation State: reads state (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Dashboard Settings: reads settings (evidence: `src/pages/Dashboard.tsx`)
- Dashboard → Menu Views: renders (evidence: `src/pages/Dashboard.tsx`)
- Menu Views → Menu Content Data: reads content (evidence: `src/components/menu/MenuContentView.tsx`)
- Simulation State → Network Nodes: generates nodes (evidence: `src/hooks/useSimulation.ts`)
- Simulation State → Telemetry Metrics: computes metrics (evidence: `src/hooks/useSimulation.ts`)
- Dashboard → Ocean Assistant: renders (evidence: `src/pages/Dashboard.tsx`)
- Ocean Assistant → AI Context: uses context (evidence: `src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx`)
- Ocean Assistant → Assistant Responses: uses responses (evidence: `src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx`)
- Ocean Assistant → Simulation State: reads simulation (evidence: `src/components/OceanIntelligenceAssistant/OceanIntelligenceAssistant.tsx`)
- Menu Views → Explore Portal: renders view (evidence: `src/components/menu/MenuContentView.tsx`)
- Menu Views → Device Explorer: renders view (evidence: `src/components/menu/MenuContentView.tsx`)
- Menu Views → Acoustic Exploration: renders view (evidence: `src/components/menu/MenuContentView.tsx`)
- Storage Architecture View → NOAA Observation Provider: reads observations (evidence: `src/components/menu/data/CassandraStorageView.tsx`)
- Device Information Page → Prototype Viewer: renders (evidence: `src/pages/AboutDevice.tsx`)
- Prototype Viewer → Prototype Model: renders (evidence: `src/components/prototype3d/PrototypeViewer.tsx`)
- Prototype Viewer → Underwater Particles: renders (evidence: `src/components/prototype3d/PrototypeViewer.tsx`)
- Marine Life Manager → Fish School: renders (evidence: `src/sim3d/components/MarineLife/MarineLifeManager.tsx`)
