# jeetdange2/netra-x architecture

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

- Interactive diagram: https://gitdiagram.com/jeetdange2/netra-x
- Repository: https://github.com/jeetdange2/netra-x

## Overview

Netra.X is a browser-based mine-rescue rover command dashboard. The main workflow is to enter the command view, monitor simulated rover and mine conditions, inspect camera/map and survivor information, assess routes, then operate or stop the rover while tracking alerts and logs. MissionContext is the shared state and simulation layer. The excerpts show the app composition, provider, map delegation, and selected state/audio use; other panel-to-state links are shown as unverified where only the source index indicates a reference.

Main entry points: [`src/App.jsx`](https://github.com/jeetdange2/netra-x/blob/main/src/App.jsx) (Dashboard app), [`src/context/MissionContext.jsx`](https://github.com/jeetdange2/netra-x/blob/main/src/context/MissionContext.jsx) (Mission state), [`src/components/dashboard/CameraPanel.jsx`](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/CameraPanel.jsx) (Camera and vision), [`src/components/dashboard/MineMap.jsx`](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MineMap.jsx) (Mine map)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shell["Command interface"]
  node_app["Dashboard app<br/>[App.jsx]"]
  node_navigation["Tab navigation<br/>[Sidebar.jsx]"]
  node_statusbar["Mission status bar<br/>[TopStatusBar.jsx]"]
  node_architecture["Architecture viewer"]
end

subgraph group_mission["Mission simulation"]
  node_missionstate["Mission state<br/>[MissionContext.jsx]"]
  node_rovercards["Rover status"]
  node_environment["Environment readings"]
end

subgraph group_sensing["Sensing and mapping"]
  node_camera["Camera and vision<br/>[CameraPanel.jsx]"]
  node_map["Mine map<br/>[MineMap.jsx]"]
  node_map3d["3D SLAM view<br/>[MineMap3D.jsx]"]
  node_survivor["Survivor panel<br/>[SurvivorPanel.jsx]"]
end

subgraph group_response["Planning and response"]
  node_risk["Risk planner<br/>[RiskPlanner.jsx]"]
  node_controls["Rover controls<br/>[RoverControls.jsx]"]
  node_alerts["Alerts panel<br/>[AlertsPanel.jsx]"]
  node_logs["Mission log<br/>[MissionLog.jsx]"]
  node_audio["Audio alerts<br/>[audioAlert.js]"]
end

node_operator(("Mine operator"))

node_operator -->|"selects view"| node_navigation
node_operator -.->|"operates rover"| node_controls
node_app -->|"provides mission"| node_missionstate
node_app -->|"renders"| node_statusbar
node_app -->|"renders"| node_navigation
node_app -->|"renders"| node_rovercards
node_app -->|"renders"| node_camera
node_app -->|"renders"| node_map
node_app -->|"renders"| node_survivor
node_app -->|"renders"| node_risk
node_app -->|"renders"| node_controls
node_app -->|"renders"| node_environment
node_app -->|"renders"| node_alerts
node_app -->|"renders"| node_logs
node_app -->|"renders"| node_architecture
node_map -->|"delegates 3D view"| node_map3d
node_navigation -->|"reads and updates"| node_missionstate
node_camera -->|"plays feedback"| node_audio
node_rovercards -.->|"uses mission data"| node_missionstate
node_environment -.->|"uses mission data"| node_missionstate
node_camera -.->|"uses mission data"| node_missionstate
node_map -.->|"uses mission data"| node_missionstate
node_map3d -.->|"uses mission data"| node_missionstate
node_survivor -.->|"uses mission data"| node_missionstate
node_risk -.->|"uses mission data"| node_missionstate
node_controls -.->|"uses mission data"| node_missionstate
node_alerts -.->|"uses mission data"| node_missionstate
node_logs -.->|"uses mission data"| node_missionstate

click node_app "https://github.com/jeetdange2/netra-x/blob/main/src/App.jsx"
click node_navigation "https://github.com/jeetdange2/netra-x/blob/main/src/components/layout/Sidebar.jsx"
click node_statusbar "https://github.com/jeetdange2/netra-x/blob/main/src/components/layout/TopStatusBar.jsx"
click node_missionstate "https://github.com/jeetdange2/netra-x/blob/main/src/context/MissionContext.jsx"
click node_rovercards "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/RoverStatusCards.jsx"
click node_environment "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/EnvironmentalPanel.jsx"
click node_camera "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/CameraPanel.jsx"
click node_map "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MineMap.jsx"
click node_map3d "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MineMap3D.jsx"
click node_survivor "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/SurvivorPanel.jsx"
click node_risk "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/RiskPlanner.jsx"
click node_controls "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/RoverControls.jsx"
click node_alerts "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/AlertsPanel.jsx"
click node_logs "https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MissionLog.jsx"
click node_audio "https://github.com/jeetdange2/netra-x/blob/main/src/utils/audioAlert.js"
click node_architecture "https://github.com/jeetdange2/netra-x/blob/main/src/components/docs/ArchitectureViewer.jsx"

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_navigation,node_statusbar,node_architecture toneBlue
class node_missionstate,node_rovercards,node_environment toneAmber
class node_camera,node_map,node_map3d,node_survivor toneMint
class node_risk,node_controls,node_alerts,node_logs,node_audio toneRose
class node_operator toneIndigo
```

## Components

### Command interface

- [Dashboard app](https://github.com/jeetdange2/netra-x/blob/main/src/App.jsx): `src/App.jsx`
- [Tab navigation](https://github.com/jeetdange2/netra-x/blob/main/src/components/layout/Sidebar.jsx): `src/components/layout/Sidebar.jsx`
- [Mission status bar](https://github.com/jeetdange2/netra-x/blob/main/src/components/layout/TopStatusBar.jsx): `src/components/layout/TopStatusBar.jsx`
- [Architecture viewer](https://github.com/jeetdange2/netra-x/blob/main/src/components/docs/ArchitectureViewer.jsx): `src/components/docs/ArchitectureViewer.jsx`

### Mission simulation

- [Mission state](https://github.com/jeetdange2/netra-x/blob/main/src/context/MissionContext.jsx): `src/context/MissionContext.jsx`
- [Rover status](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/RoverStatusCards.jsx): `src/components/dashboard/RoverStatusCards.jsx`
- [Environment readings](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/EnvironmentalPanel.jsx): `src/components/dashboard/EnvironmentalPanel.jsx`

### Sensing and mapping

- [Camera and vision](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/CameraPanel.jsx): `src/components/dashboard/CameraPanel.jsx`
- [Mine map](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MineMap.jsx): `src/components/dashboard/MineMap.jsx`
- [3D SLAM view](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MineMap3D.jsx): `src/components/dashboard/MineMap3D.jsx`
- [Survivor panel](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/SurvivorPanel.jsx): `src/components/dashboard/SurvivorPanel.jsx`

### Planning and response

- [Risk planner](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/RiskPlanner.jsx): `src/components/dashboard/RiskPlanner.jsx`
- [Rover controls](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/RoverControls.jsx): `src/components/dashboard/RoverControls.jsx`
- [Alerts panel](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/AlertsPanel.jsx): `src/components/dashboard/AlertsPanel.jsx`
- [Mission log](https://github.com/jeetdange2/netra-x/blob/main/src/components/dashboard/MissionLog.jsx): `src/components/dashboard/MissionLog.jsx`
- [Audio alerts](https://github.com/jeetdange2/netra-x/blob/main/src/utils/audioAlert.js): `src/utils/audioAlert.js`

### Other components

- **Mine operator**

## Connections

- Mine operator → Tab navigation: selects view (evidence: `src/components/layout/Sidebar.jsx`)
- Mine operator → Rover controls: operates rover
- Dashboard app → Mission state: provides mission (evidence: `src/App.jsx`)
- Dashboard app → Mission status bar: renders (evidence: `src/App.jsx`)
- Dashboard app → Tab navigation: renders (evidence: `src/App.jsx`)
- Dashboard app → Rover status: renders (evidence: `src/App.jsx`)
- Dashboard app → Camera and vision: renders (evidence: `src/App.jsx`)
- Dashboard app → Mine map: renders (evidence: `src/App.jsx`)
- Dashboard app → Survivor panel: renders (evidence: `src/App.jsx`)
- Dashboard app → Risk planner: renders (evidence: `src/App.jsx`)
- Dashboard app → Rover controls: renders (evidence: `src/App.jsx`)
- Dashboard app → Environment readings: renders (evidence: `src/App.jsx`)
- Dashboard app → Alerts panel: renders (evidence: `src/App.jsx`)
- Dashboard app → Mission log: renders (evidence: `src/App.jsx`)
- Dashboard app → Architecture viewer: renders (evidence: `src/App.jsx`)
- Mine map → 3D SLAM view: delegates 3D view (evidence: `src/components/dashboard/MineMap.jsx`)
- Tab navigation → Mission state: reads and updates (evidence: `src/components/layout/Sidebar.jsx`)
- Camera and vision → Audio alerts: plays feedback (evidence: `src/components/dashboard/CameraPanel.jsx`)
- Rover status → Mission state: uses mission data (evidence: `src/components/dashboard/RoverStatusCards.jsx`)
- Environment readings → Mission state: uses mission data (evidence: `src/components/dashboard/EnvironmentalPanel.jsx`)
- Camera and vision → Mission state: uses mission data (evidence: `src/components/dashboard/CameraPanel.jsx`)
- Mine map → Mission state: uses mission data (evidence: `src/components/dashboard/MineMap.jsx`)
- 3D SLAM view → Mission state: uses mission data (evidence: `src/components/dashboard/MineMap3D.jsx`)
- Survivor panel → Mission state: uses mission data (evidence: `src/components/dashboard/SurvivorPanel.jsx`)
- Risk planner → Mission state: uses mission data (evidence: `src/components/dashboard/RiskPlanner.jsx`)
- Rover controls → Mission state: uses mission data (evidence: `src/components/dashboard/RoverControls.jsx`)
- Alerts panel → Mission state: uses mission data (evidence: `src/components/dashboard/AlertsPanel.jsx`)
- Mission log → Mission state: uses mission data (evidence: `src/components/dashboard/MissionLog.jsx`)
