# ajaykumar25bev7072-hub/sih-minevision architecture

> Architecture diagram of the GitHub repository ajaykumar25bev7072-hub/sih-minevision, 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/ajaykumar25bev7072-hub/sih-minevision
- Repository: https://github.com/ajaykumar25bev7072-hub/sih-minevision

## Overview

MineBoard is a Flask-based mining-truck collision-avoidance simulation and monitoring dashboard. Its main workflow generates 50 steps of four-truck telemetry, evaluates sensor and hazard states, serves fleet or per-truck views and asynchronous telemetry, then updates the browser’s map, charts, table, and in-cab HUD. The graph preserves the documented scenario simulation and calibration API as well as the dashboard branches. Source excerpts establish the backend and client update calls; template-to-script wiring and some endpoint details are documented only at a high level.

Main entry points: [`app.py`](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/app.py) (Flask Routes), [`static/js/main.js`](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/main.js) (Live UI Updates), [`generate_data.py`](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/generate_data.py) (Scenario Generator), [`calibration.py`](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/calibration.py) (Risk Calibration)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_simulation["Simulation and Safety"]
  node_generator["Scenario Generator<br/>[generate_data.py]"]
  node_calibration["Risk Calibration<br/>[calibration.py]"]
  node_dataset["Telemetry Dataset<br/>[sample_data.json]"]
end

subgraph group_backend["Flask Service"]
  node_web_app["Flask Routes<br/>[app.py]"]
  node_telemetry["Session Telemetry API<br/>[app.py]"]
end

subgraph group_fleet_ui["Fleet Control Center"]
  node_fleet_page["Fleet Overview<br/>[index.html]"]
  node_client["Live UI Updates<br/>[main.js]"]
  node_charts["Risk and Trend Charts<br/>[charts.js]"]
  node_radar["Position Map<br/>[radar.js]"]
end

subgraph group_cab_ui["Driver HUD"]
  node_truck_page["Truck View<br/>[truck.html]"]
end

node_actor(("Fleet Operator"))

node_web_app -->|"loads"| node_dataset
node_web_app -->|"generates if missing"| node_generator
node_generator -->|"evaluates telemetry"| node_calibration
node_web_app -->|"serves matrix"| node_calibration
node_web_app -->|"renders"| node_fleet_page
node_web_app -->|"renders"| node_truck_page
node_web_app -->|"routes requests"| node_telemetry
node_actor -.->|"opens dashboard"| node_web_app
node_actor -.->|"advances or resets"| node_client
node_client -->|"fetches reset"| node_telemetry
node_client -->|"updates charts"| node_charts
node_client -->|"updates blips"| node_radar
node_telemetry -.->|"returns telemetry"| node_client

click node_generator "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/generate_data.py"
click node_calibration "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/calibration.py"
click node_dataset "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/data/sample_data.json"
click node_web_app "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/app.py"
click node_telemetry "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/app.py"
click node_fleet_page "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/templates/index.html"
click node_truck_page "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/templates/truck.html"
click node_client "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/main.js"
click node_charts "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/charts.js"
click node_radar "https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/radar.js"

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_generator,node_calibration,node_dataset toneBlue
class node_web_app,node_telemetry toneAmber
class node_fleet_page,node_client,node_charts,node_radar toneMint
class node_truck_page toneRose
class node_actor toneIndigo
```

## Components

### Simulation and Safety

- [Scenario Generator](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/generate_data.py): `generate_data.py`
- [Risk Calibration](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/calibration.py): `calibration.py`
- [Telemetry Dataset](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/data/sample_data.json): `data/sample_data.json`

### Flask Service

- [Flask Routes](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/app.py): `app.py`
- [Session Telemetry API](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/app.py): `app.py`

### Fleet Control Center

- [Fleet Overview](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/templates/index.html): `templates/index.html`
- [Live UI Updates](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/main.js): `static/js/main.js`
- [Risk and Trend Charts](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/charts.js): `static/js/charts.js`
- [Position Map](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/static/js/radar.js): `static/js/radar.js`

### Driver HUD

- [Truck View](https://github.com/ajaykumar25bev7072-hub/sih-minevision/blob/main/templates/truck.html): `templates/truck.html`

### Other components

- **Fleet Operator**

## Connections

- Flask Routes → Telemetry Dataset: loads (evidence: `app.py`)
- Flask Routes → Scenario Generator: generates if missing (evidence: `app.py`)
- Scenario Generator → Risk Calibration: evaluates telemetry (evidence: `generate_data.py`)
- Flask Routes → Risk Calibration: serves matrix (evidence: `app.py`)
- Flask Routes → Fleet Overview: renders (evidence: `app.py`)
- Flask Routes → Truck View: renders (evidence: `app.py`)
- Flask Routes → Session Telemetry API: routes requests (evidence: `app.py`)
- Fleet Operator → Flask Routes: opens dashboard (evidence: `README.md`)
- Fleet Operator → Live UI Updates: advances or resets (evidence: `README.md`)
- Live UI Updates → Session Telemetry API: fetches reset (evidence: `static/js/main.js`)
- Live UI Updates → Risk and Trend Charts: updates charts (evidence: `static/js/main.js`)
- Live UI Updates → Position Map: updates blips (evidence: `static/js/main.js`)
- Session Telemetry API → Live UI Updates: returns telemetry (evidence: `README.md`)
