# mounishwarans2/deepsealink-3d-simulation architecture

> Architecture diagram of the GitHub repository mounishwarans2/deepsealink-3d-simulation, 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/deepsealink-3d-simulation
- Repository: https://github.com/mounishwarans2/deepsealink-3d-simulation

## Overview

DeepSeaLink is a 3D underwater acoustic-communications digital-twin simulation. Users navigate the rendered ocean, inspect hardware nodes, and toggle marine life; the app composes the ocean scene and maintains selection and hover state. The scene combines terrain, seabed, water, network equipment, acoustic effects, and fauna, while device inspection presents node telemetry. The graph follows explicit App composition and sampled/source-index references. The README is only generic Vite-template guidance, so it does not document further product capabilities; unsampled modules are included only where the source index establishes their role or composition.

Main entry points: [`src/components/Ocean/OceanEnvironment.tsx`](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/OceanEnvironment.tsx) (Ocean scene), [`src/App.tsx`](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/App.tsx) (Application shell), [`src/components/MarineLife/MarineLifeManager.tsx`](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/MarineLifeManager.tsx) (Fauna manager), [`src/components/MarineLife/Crab.tsx`](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/Crab.tsx) (Crabs)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_app["Application and interaction"]
  node_app["Application shell<br/>[App.tsx]"]
  node_camera["Free camera"]
  node_hud["Depth display<br/>[CameraHUD.tsx]"]
  node_interaction["Device interaction"]
  node_inspector["Device inspector"]
end

subgraph group_scene["Ocean scene"]
  node_ocean["Ocean scene"]
  node_terrain["Coastal terrain<br/>[CoastalTerrain.tsx]"]
  node_vegetation["Coastal vegetation"]
  node_landdata["Land data receiver"]
  node_landserver["Land server area<br/>[LandServerArea.tsx]"]
  node_seabed["Seabed<br/>[Seabed.tsx]"]
  node_seabedshader["Seabed shader<br/>[seabedShader.ts]"]
  node_coral["Coral reef<br/>[CoralReef.tsx]"]
end

subgraph group_network["Communications network"]
  node_acoustic["Acoustic propagation"]
  node_hardware["Acoustic hardware"]
  node_mesh["Mesh topology"]
end

subgraph group_life["Marine life"]
  node_marine["Fauna manager"]
  node_fish["Fish schools<br/>[FishSchool.tsx]"]
  node_whales["Whales<br/>[Whale.tsx]"]
  node_crabs["Crabs<br/>[Crab.tsx]"]
  node_simulation["Fauna simulation"]
end

node_user(("User"))

node_user -->|"operates"| node_app
node_app -->|"mounts"| node_camera
node_app -->|"mounts"| node_hud
node_app -->|"renders"| node_ocean
node_app -->|"mounts"| node_interaction
node_app -->|"renders"| node_inspector
node_ocean -->|"renders"| node_terrain
node_ocean -->|"renders"| node_vegetation
node_ocean -->|"renders"| node_landdata
node_ocean -.->|"renders"| node_landserver
node_ocean -->|"renders"| node_seabed
node_seabed -->|"uses"| node_seabedshader
node_ocean -->|"renders"| node_coral
node_ocean -->|"renders"| node_acoustic
node_ocean -->|"renders"| node_hardware
node_ocean -->|"renders"| node_mesh
node_ocean -->|"renders"| node_marine
node_marine -->|"renders"| node_fish
node_marine -->|"renders"| node_whales
node_marine -->|"renders"| node_crabs
node_crabs -->|"uses"| node_simulation
node_crabs -->|"queries seabed"| node_terrain

click node_app "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/App.tsx"
click node_camera "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Camera/FreeCameraController.tsx"
click node_hud "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Camera/CameraHUD.tsx"
click node_interaction "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Interaction/DeviceInteraction.tsx"
click node_inspector "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Interaction/DeviceInspector.tsx"
click node_ocean "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/OceanEnvironment.tsx"
click node_terrain "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/CoastalTerrain.tsx"
click node_vegetation "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/CoastalVegetation.tsx"
click node_landdata "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/LandDataReceiver.tsx"
click node_landserver "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/LandServerArea.tsx"
click node_seabed "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/Seabed.tsx"
click node_seabedshader "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/shaders/seabedShader.ts"
click node_coral "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/CoralReef.tsx"
click node_acoustic "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Communication/AcousticPropagation.tsx"
click node_hardware "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Network/AcousticHardware.tsx"
click node_mesh "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Network/MeshTopologyNetwork.tsx"
click node_marine "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/MarineLifeManager.tsx"
click node_fish "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/FishSchool.tsx"
click node_whales "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/Whale.tsx"
click node_crabs "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/Crab.tsx"
click node_simulation "https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/marineLifeSimulation.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_app,node_camera,node_hud,node_interaction,node_inspector,node_user toneBlue
class node_ocean,node_terrain,node_vegetation,node_landdata,node_landserver,node_seabed,node_seabedshader,node_coral toneAmber
class node_acoustic,node_hardware,node_mesh toneMint
class node_marine,node_fish,node_whales,node_crabs,node_simulation toneRose
```

## Components

### Application and interaction

- [Application shell](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/App.tsx): `src/App.tsx`
- [Free camera](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Camera/FreeCameraController.tsx): `src/components/Camera/FreeCameraController.tsx`
- [Depth display](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Camera/CameraHUD.tsx): `src/components/Camera/CameraHUD.tsx`
- [Device interaction](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Interaction/DeviceInteraction.tsx): `src/components/Interaction/DeviceInteraction.tsx`
- [Device inspector](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Interaction/DeviceInspector.tsx): `src/components/Interaction/DeviceInspector.tsx`

### Ocean scene

- [Ocean scene](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/OceanEnvironment.tsx): `src/components/Ocean/OceanEnvironment.tsx`
- [Coastal terrain](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/CoastalTerrain.tsx): `src/components/Environment/CoastalTerrain.tsx`
- [Coastal vegetation](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/CoastalVegetation.tsx): `src/components/Environment/CoastalVegetation.tsx`
- [Land data receiver](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/LandDataReceiver.tsx): `src/components/Environment/LandDataReceiver.tsx`
- [Land server area](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Environment/LandServerArea.tsx): `src/components/Environment/LandServerArea.tsx`
- [Seabed](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/Seabed.tsx): `src/components/Ocean/Seabed.tsx`
- [Seabed shader](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/shaders/seabedShader.ts): `src/shaders/seabedShader.ts`
- [Coral reef](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Ocean/CoralReef.tsx): `src/components/Ocean/CoralReef.tsx`

### Communications network

- [Acoustic propagation](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Communication/AcousticPropagation.tsx): `src/components/Communication/AcousticPropagation.tsx`
- [Acoustic hardware](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Network/AcousticHardware.tsx): `src/components/Network/AcousticHardware.tsx`
- [Mesh topology](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/Network/MeshTopologyNetwork.tsx): `src/components/Network/MeshTopologyNetwork.tsx`

### Marine life

- [Fauna manager](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/MarineLifeManager.tsx): `src/components/MarineLife/MarineLifeManager.tsx`
- [Fish schools](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/FishSchool.tsx): `src/components/MarineLife/FishSchool.tsx`
- [Whales](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/Whale.tsx): `src/components/MarineLife/Whale.tsx`
- [Crabs](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/Crab.tsx): `src/components/MarineLife/Crab.tsx`
- [Fauna simulation](https://github.com/mounishwarans2/deepsealink-3d-simulation/blob/main/src/components/MarineLife/marineLifeSimulation.ts): `src/components/MarineLife/marineLifeSimulation.ts`

### Other components

- **User**

## Connections

- User → Application shell: operates
- Application shell → Free camera: mounts (evidence: `src/App.tsx`)
- Application shell → Depth display: mounts (evidence: `src/App.tsx`)
- Application shell → Ocean scene: renders (evidence: `src/App.tsx`)
- Application shell → Device interaction: mounts (evidence: `src/App.tsx`)
- Application shell → Device inspector: renders (evidence: `src/App.tsx`)
- Ocean scene → Coastal terrain: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Coastal vegetation: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Land data receiver: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Land server area: renders
- Ocean scene → Seabed: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Seabed → Seabed shader: uses (evidence: `src/components/Ocean/Seabed.tsx`)
- Ocean scene → Coral reef: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Acoustic propagation: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Acoustic hardware: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Mesh topology: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Ocean scene → Fauna manager: renders (evidence: `src/components/Ocean/OceanEnvironment.tsx`)
- Fauna manager → Fish schools: renders (evidence: `src/components/MarineLife/MarineLifeManager.tsx`)
- Fauna manager → Whales: renders (evidence: `src/components/MarineLife/MarineLifeManager.tsx`)
- Fauna manager → Crabs: renders (evidence: `src/components/MarineLife/MarineLifeManager.tsx`)
- Crabs → Fauna simulation: uses (evidence: `src/components/MarineLife/Crab.tsx`)
- Crabs → Coastal terrain: queries seabed (evidence: `src/components/MarineLife/Crab.tsx`)
