# manjushree27-v/suraksha-setu architecture

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

- Interactive diagram: https://gitdiagram.com/manjushree27-v/suraksha-setu
- Repository: https://github.com/manjushree27-v/suraksha-setu

## Overview

Suraksha Setu is a React prototype dashboard for underground coal-mine subsidence monitoring. Operators use its dashboard to inspect synthetic sensor conditions, select nodes and view their map and history, review risk/anomaly and panel health, and acknowledge incidents or simulate risk states. The frontend currently uses controlled sample data rather than live telemetry; the README describes hardware, backend, database and AI integrations as future work. Relationships shown are limited to imports and rendering calls evidenced in excerpts or the source index.

Main entry points: [`src/pages/Dashboard.jsx`](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx) (Monitoring dashboard), [`src/App.jsx`](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/App.jsx) (App entry), [`src/components/MineMap.jsx`](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/components/MineMap.jsx) (Mine deformation map), [`src/components/SensorChart.jsx`](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/components/SensorChart.jsx) (Sensor trend chart)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_ui["Dashboard UI"]
  node_app["App entry<br/>[App.jsx]"]
  node_dashboard["Monitoring dashboard<br/>[Dashboard.jsx]"]
  node_alerts["Alerts and acknowledgement<br/>[Dashboard.jsx]"]
  node_risk["Risk and simulation controls<br/>[Dashboard.jsx]"]
  node_health["Node and panel health<br/>[Dashboard.jsx]"]
end

subgraph group_monitor["Monitoring Views"]
  node_map["Mine deformation map<br/>[MineMap.jsx]"]
  node_chart["Sensor trend chart<br/>[SensorChart.jsx]"]
end

subgraph group_data["Prototype Data"]
  node_nodes["Synthetic node readings<br/>[mockNodes.js]"]
  node_history["Historical readings<br/>[historicalData.js]"]
end

node_operator(("Mine operator"))

node_operator -->|"opens dashboard"| node_app
node_app -->|"renders"| node_dashboard
node_dashboard -->|"reads sample nodes"| node_nodes
node_dashboard -->|"reads trends"| node_history
node_dashboard -->|"renders map"| node_map
node_dashboard -->|"renders trends"| node_chart
node_dashboard -->|"displays incidents"| node_alerts
node_dashboard -->|"controls simulation"| node_risk
node_dashboard -->|"shows health"| node_health
node_operator -->|"selects and acknowledges"| node_dashboard

click node_app "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/App.jsx"
click node_dashboard "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx"
click node_map "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/components/MineMap.jsx"
click node_chart "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/components/SensorChart.jsx"
click node_nodes "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/data/mockNodes.js"
click node_history "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/data/historicalData.js"
click node_alerts "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx"
click node_risk "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx"
click node_health "https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.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_dashboard,node_alerts,node_risk,node_health toneBlue
class node_map,node_chart toneAmber
class node_nodes,node_history toneMint
class node_operator toneIndigo
```

## Components

### Dashboard UI

- [App entry](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/App.jsx): `src/App.jsx`
- [Monitoring dashboard](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Alerts and acknowledgement](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Risk and simulation controls](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`
- [Node and panel health](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/pages/Dashboard.jsx): `src/pages/Dashboard.jsx`

### Monitoring Views

- [Mine deformation map](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/components/MineMap.jsx): `src/components/MineMap.jsx`
- [Sensor trend chart](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/components/SensorChart.jsx): `src/components/SensorChart.jsx`

### Prototype Data

- [Synthetic node readings](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/data/mockNodes.js): `src/data/mockNodes.js`
- [Historical readings](https://github.com/manjushree27-v/suraksha-setu/blob/main/src/data/historicalData.js): `src/data/historicalData.js`

### Other components

- **Mine operator**

## Connections

- Mine operator → App entry: opens dashboard (evidence: `README.md`)
- App entry → Monitoring dashboard: renders (evidence: `src/App.jsx`)
- Monitoring dashboard → Synthetic node readings: reads sample nodes (evidence: `src/pages/Dashboard.jsx`)
- Monitoring dashboard → Historical readings: reads trends (evidence: `src/pages/Dashboard.jsx`)
- Monitoring dashboard → Mine deformation map: renders map (evidence: `src/pages/Dashboard.jsx`)
- Monitoring dashboard → Sensor trend chart: renders trends (evidence: `src/pages/Dashboard.jsx`)
- Monitoring dashboard → Alerts and acknowledgement: displays incidents (evidence: `src/pages/Dashboard.jsx`)
- Monitoring dashboard → Risk and simulation controls: controls simulation (evidence: `src/pages/Dashboard.jsx`)
- Monitoring dashboard → Node and panel health: shows health (evidence: `src/pages/Dashboard.jsx`)
- Mine operator → Monitoring dashboard: selects and acknowledges (evidence: `src/pages/Dashboard.jsx`)
