# rajadurga-16/netra-networked_environment_terrain_radar_awareness architecture

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

- Interactive diagram: https://gitdiagram.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness
- Repository: https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness

## Overview

NETRA is a mine-vehicle awareness prototype: Vehicle A supplies physical sensor/GPS data, while Vehicle B is simulated; backend risk analysis informs a browser dashboard with map, event, and multilingual voice alerts. The graph combines the README’s system description with the available dashboard source. Backend, hardware, and template implementations are not present in the supplied tree, so their paths are left null and those relationships are cited to the README.

Main entry points: [`dashboard/static/js/dashboard.js`](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/dashboard.js) (Dashboard UI), [`dashboard/templates/index.html`](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/templates/index.html) (Dashboard Page), [`dashboard/static/js/map.js`](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/map.js) (Digital Mine Map), [`dashboard/static/js/voice.js`](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/voice.js) (Voice Guidance)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_vehicle["Vehicles"]
  node_vehicle_a["Vehicle A"]
  node_local_avoid["Local Avoidance"]
  node_vehicle_b["Vehicle B Simulator"]
end

subgraph group_backend["Risk Backend"]
  node_serial["Serial Gateway"]
  node_collision["Collision Engine"]
  node_geofence["Geofence Engine"]
  node_risk["Risk Engine"]
  node_safety_override["Drive Safety Override"]
end

subgraph group_dashboard["Browser Dashboard"]
  node_dashboard["Dashboard UI<br/>[dashboard.js]"]
  node_map["Digital Mine Map<br/>[map.js]"]
  node_voice["Voice Guidance<br/>[voice.js]"]
  node_dashboard_template["Dashboard Page<br/>[index.html]"]
  node_styles["Dashboard Styling<br/>[style.css]"]
end

subgraph group_records["Risk History"]
  node_event_logger["Event Logger"]
  node_sqlite[("SQLite Event Store")]
end

node_operator(("Operator"))

node_vehicle_a -->|"sends sensor data"| node_serial
node_serial -->|"sends drive commands"| node_vehicle_a
node_vehicle_a -->|"senses obstacles"| node_local_avoid
node_vehicle_b -->|"supplies simulated state"| node_collision
node_collision -->|"provides conflict metrics"| node_risk
node_geofence -->|"provides zone severity"| node_risk
node_serial -->|"provides vehicle state"| node_risk
node_risk -->|"gates driving"| node_safety_override
node_safety_override -->|"forwards permitted commands"| node_serial
node_risk -->|"records risk events"| node_event_logger
node_event_logger -->|"persists events"| node_sqlite
node_operator -->|"views alerts"| node_dashboard
node_dashboard -->|"polls state"| node_serial
node_dashboard -->|"sets simulation mode"| node_vehicle_b
node_dashboard -->|"requests drive state"| node_safety_override
node_dashboard -->|"renders state"| node_map
node_dashboard -->|"updates guidance"| node_voice
node_dashboard_template -.->|"hosts interface"| node_dashboard
node_dashboard_template -.->|"uses styles"| node_styles
node_dashboard -->|"displays recent events"| node_event_logger
node_dashboard -->|"displays risk zones"| node_geofence

click node_dashboard "https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/dashboard.js"
click node_map "https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/map.js"
click node_voice "https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/voice.js"
click node_dashboard_template "https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/templates/index.html"
click node_styles "https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/css/style.css"

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_vehicle_a,node_local_avoid,node_vehicle_b toneBlue
class node_serial,node_collision,node_geofence,node_risk,node_safety_override toneAmber
class node_dashboard,node_map,node_voice,node_dashboard_template,node_styles toneMint
class node_event_logger,node_sqlite toneRose
class node_operator toneIndigo
```

## Components

### Vehicles

- **Vehicle A**
- **Local Avoidance**
- **Vehicle B Simulator**

### Risk Backend

- **Serial Gateway**
- **Collision Engine**
- **Geofence Engine**
- **Risk Engine**
- **Drive Safety Override**

### Browser Dashboard

- [Dashboard UI](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/dashboard.js): `dashboard/static/js/dashboard.js`
- [Digital Mine Map](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/map.js): `dashboard/static/js/map.js`
- [Voice Guidance](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/js/voice.js): `dashboard/static/js/voice.js`
- [Dashboard Page](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/templates/index.html): `dashboard/templates/index.html`
- [Dashboard Styling](https://github.com/rajadurga-16/netra-networked_environment_terrain_radar_awareness/blob/main/dashboard/static/css/style.css): `dashboard/static/css/style.css`

### Risk History

- **Event Logger**
- **SQLite Event Store**

### Other components

- **Operator**

## Connections

- Vehicle A → Serial Gateway: sends sensor data (evidence: `README.md`)
- Serial Gateway → Vehicle A: sends drive commands (evidence: `README.md`)
- Vehicle A → Local Avoidance: senses obstacles (evidence: `README.md`)
- Vehicle B Simulator → Collision Engine: supplies simulated state (evidence: `README.md`)
- Collision Engine → Risk Engine: provides conflict metrics (evidence: `README.md`)
- Geofence Engine → Risk Engine: provides zone severity (evidence: `README.md`)
- Serial Gateway → Risk Engine: provides vehicle state (evidence: `README.md`)
- Risk Engine → Drive Safety Override: gates driving (evidence: `README.md`)
- Drive Safety Override → Serial Gateway: forwards permitted commands (evidence: `README.md`)
- Risk Engine → Event Logger: records risk events (evidence: `README.md`)
- Event Logger → SQLite Event Store: persists events (evidence: `README.md`)
- Operator → Dashboard UI: views alerts (evidence: `README.md`)
- Dashboard UI → Serial Gateway: polls state (evidence: `dashboard/static/js/dashboard.js`)
- Dashboard UI → Vehicle B Simulator: sets simulation mode (evidence: `dashboard/static/js/dashboard.js`)
- Dashboard UI → Drive Safety Override: requests drive state (evidence: `dashboard/static/js/dashboard.js`)
- Dashboard UI → Digital Mine Map: renders state (evidence: `dashboard/static/js/dashboard.js`)
- Dashboard UI → Voice Guidance: updates guidance (evidence: `dashboard/static/js/dashboard.js`)
- Dashboard Page → Dashboard UI: hosts interface
- Dashboard Page → Dashboard Styling: uses styles
- Dashboard UI → Event Logger: displays recent events (evidence: `README.md`)
- Dashboard UI → Geofence Engine: displays risk zones (evidence: `README.md`)
