# whitewolf260501-hash/-minesafe_web_hibrida architecture

> Architecture diagram of the GitHub repository whitewolf260501-hash/-minesafe_web_hibrida, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-19). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/whitewolf260501-hash/-minesafe_web_hibrida
- Repository: https://github.com/whitewolf260501-hash/-minesafe_web_hibrida

## Overview

MineSafe IoT is a web platform for environmental monitoring and safety management in Chilean small mines. Users reach a public landing page or sign in; an active, authorized Firebase session opens the operational panel, where telemetry is monitored, alerts are handled, and organizations, sites, crews, devices, and users are managed. The graph preserves the README’s documented emergency, reporting, and administration capabilities. Edges reflect excerpted calls, indexed imports, or README statements; several UI implementations were not sampled, so their internal wiring is left unspecified.

Main entry points: [`src/services/firebase.ts`](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/firebase.ts) (Firebase Services), [`src/App.tsx`](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/App.tsx) (Operations Panel), [`src/RootApp.tsx`](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/RootApp.tsx) (Route and Session), [`src/components/AlertsView.tsx`](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/AlertsView.tsx) (Alert Handling)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_access["Access and Shell"]
  node_landing["Public Landing<br/>[PublicLanding.tsx]"]
  node_login["Private Login<br/>[LoginView.tsx]"]
  node_shell["Route and Session<br/>[RootApp.tsx]"]
  node_panel["Operations Panel<br/>[App.tsx]"]
end

subgraph group_operations["Monitoring Operations"]
  node_dashboard["Dashboard<br/>[DashboardView.tsx]"]
  node_monitoring["Live Monitoring<br/>[MonitoringView.tsx]"]
  node_history["Historical Reports"]
  node_telemetry["Telemetry Collector"]
end

subgraph group_safety["Alerts and Response"]
  node_alertengine["Threshold Engine<br/>[alertEngine.ts]"]
  node_alerts["Alert Handling<br/>[AlertsView.tsx]"]
  node_resolution["Alert Resolution"]
  node_emergency["Emergency Controls<br/>[EmergencyModal.tsx]"]
end

subgraph group_management["Mine Administration"]
  node_sectors["Mining Sectors"]
  node_devices["Device Registry"]
  node_companies["Organization Management"]
  node_crews["Crew Management"]
  node_users["User Management"]
  node_admin["Platform Administration"]
end

subgraph group_platform["Services and Data"]
  node_firebase["Firebase Services<br/>[firebase.ts]"]
  node_rtdb[("Realtime Database")]
  node_storage[("Firebase Storage")]
  node_sound["Audio Alerts<br/>[audioAlert.ts]"]
end

node_visitor(("Visitor / Operator"))
node_esp32(("ESP32 Nodes"))

node_visitor -->|"opens"| node_landing
node_visitor -->|"signs in"| node_login
node_landing -.->|"renders route"| node_shell
node_login -.->|"returns session"| node_shell
node_shell -->|"checks session"| node_firebase
node_shell -->|"mounts panel"| node_panel
node_panel -->|"renders"| node_dashboard
node_panel -->|"renders"| node_monitoring
node_panel -->|"renders"| node_alerts
node_panel -->|"renders"| node_history
node_panel -->|"renders"| node_sectors
node_panel -->|"renders"| node_devices
node_panel -->|"renders"| node_users
node_panel -->|"renders"| node_admin
node_esp32 -->|"writes telemetry"| node_rtdb
node_firebase -->|"reads and writes"| node_rtdb
node_firebase -->|"stores evidence"| node_storage
node_rtdb -.->|"supplies readings"| node_telemetry
node_dashboard -->|"loads data"| node_firebase
node_monitoring -->|"subscribes to data"| node_firebase
node_panel -->|"refreshes devices"| node_firebase
node_panel -->|"acknowledges alerts"| node_firebase
node_panel -->|"resolves alerts"| node_firebase
node_alertengine -.->|"persists events"| node_firebase
node_alertengine -.->|"plays alarms"| node_sound
node_alerts -->|"loads alert data"| node_firebase
node_alerts -->|"opens resolution"| node_resolution
node_emergency -.->|"sends commands"| node_firebase
node_companies -->|"assigns devices"| node_devices
node_companies -->|"saves crews"| node_firebase
node_admin -->|"saves configuration"| node_firebase
node_history -.->|"loads history"| node_firebase
node_crews -.->|"manages crew data"| node_firebase
node_users -.->|"manages accounts"| node_firebase
node_sectors -.->|"manages sectors"| node_firebase

click node_landing "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/PublicLanding.tsx"
click node_login "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/LoginView.tsx"
click node_shell "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/RootApp.tsx"
click node_panel "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/App.tsx"
click node_dashboard "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/DashboardView.tsx"
click node_monitoring "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/MonitoringView.tsx"
click node_history "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/HistoricalReportsView.tsx"
click node_telemetry "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/telemetryCollector.ts"
click node_alertengine "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/alertEngine.ts"
click node_alerts "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/AlertsView.tsx"
click node_resolution "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/AlertResolutionModal.tsx"
click node_emergency "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/EmergencyModal.tsx"
click node_sectors "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/MiningSectorsView.tsx"
click node_devices "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/DeviceRegistryAndAssignmentPanel.tsx"
click node_companies "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/CompanyBulkManagementView.tsx"
click node_crews "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/CrewManagementSection.tsx"
click node_users "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/UsersManagementView.tsx"
click node_admin "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/SuperAdminControlView.tsx"
click node_firebase "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/firebase.ts"
click node_sound "https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/audioAlert.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_landing,node_login,node_shell,node_panel toneBlue
class node_dashboard,node_monitoring,node_history,node_telemetry toneAmber
class node_alertengine,node_alerts,node_resolution,node_emergency toneMint
class node_sectors,node_devices,node_companies,node_crews,node_users,node_admin toneRose
class node_firebase,node_rtdb,node_storage,node_sound,node_visitor,node_esp32 toneIndigo
```

## Components

### Access and Shell

- [Public Landing](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/PublicLanding.tsx): `src/components/PublicLanding.tsx`
- [Private Login](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/LoginView.tsx): `src/components/LoginView.tsx`
- [Route and Session](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/RootApp.tsx): `src/RootApp.tsx`
- [Operations Panel](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/App.tsx): `src/App.tsx`

### Monitoring Operations

- [Dashboard](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/DashboardView.tsx): `src/components/DashboardView.tsx`
- [Live Monitoring](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/MonitoringView.tsx): `src/components/MonitoringView.tsx`
- [Historical Reports](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/HistoricalReportsView.tsx): `src/components/HistoricalReportsView.tsx`
- [Telemetry Collector](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/telemetryCollector.ts): `src/services/telemetryCollector.ts`

### Alerts and Response

- [Threshold Engine](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/alertEngine.ts): `src/services/alertEngine.ts`
- [Alert Handling](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/AlertsView.tsx): `src/components/AlertsView.tsx`
- [Alert Resolution](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/AlertResolutionModal.tsx): `src/components/AlertResolutionModal.tsx`
- [Emergency Controls](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/EmergencyModal.tsx): `src/components/EmergencyModal.tsx`

### Mine Administration

- [Mining Sectors](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/MiningSectorsView.tsx): `src/components/MiningSectorsView.tsx`
- [Device Registry](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/DeviceRegistryAndAssignmentPanel.tsx): `src/components/DeviceRegistryAndAssignmentPanel.tsx`
- [Organization Management](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/CompanyBulkManagementView.tsx): `src/components/CompanyBulkManagementView.tsx`
- [Crew Management](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/CrewManagementSection.tsx): `src/components/CrewManagementSection.tsx`
- [User Management](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/UsersManagementView.tsx): `src/components/UsersManagementView.tsx`
- [Platform Administration](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/components/SuperAdminControlView.tsx): `src/components/SuperAdminControlView.tsx`

### Services and Data

- [Firebase Services](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/firebase.ts): `src/services/firebase.ts`
- **Realtime Database**
- **Firebase Storage**
- [Audio Alerts](https://github.com/whitewolf260501-hash/-minesafe_web_hibrida/blob/main/src/services/audioAlert.ts): `src/services/audioAlert.ts`

### Other components

- **Visitor / Operator**
- **ESP32 Nodes**

## Connections

- Visitor / Operator → Public Landing: opens
- Visitor / Operator → Private Login: signs in
- Public Landing → Route and Session: renders route (evidence: `src/RootApp.tsx`)
- Private Login → Route and Session: returns session (evidence: `src/RootApp.tsx`)
- Route and Session → Firebase Services: checks session (evidence: `src/RootApp.tsx`)
- Route and Session → Operations Panel: mounts panel (evidence: `src/RootApp.tsx`)
- Operations Panel → Dashboard: renders (evidence: `src/App.tsx`)
- Operations Panel → Live Monitoring: renders (evidence: `src/App.tsx`)
- Operations Panel → Alert Handling: renders (evidence: `src/App.tsx`)
- Operations Panel → Historical Reports: renders (evidence: `src/App.tsx`)
- Operations Panel → Mining Sectors: renders (evidence: `src/App.tsx`)
- Operations Panel → Device Registry: renders (evidence: `src/App.tsx`)
- Operations Panel → User Management: renders (evidence: `src/App.tsx`)
- Operations Panel → Platform Administration: renders (evidence: `src/App.tsx`)
- ESP32 Nodes → Realtime Database: writes telemetry
- Firebase Services → Realtime Database: reads and writes (evidence: `src/services/firebase.ts`)
- Firebase Services → Firebase Storage: stores evidence
- Realtime Database → Telemetry Collector: supplies readings
- Dashboard → Firebase Services: loads data (evidence: `src/components/DashboardView.tsx`)
- Live Monitoring → Firebase Services: subscribes to data (evidence: `src/components/MonitoringView.tsx`)
- Operations Panel → Firebase Services: refreshes devices (evidence: `src/App.tsx`)
- Operations Panel → Firebase Services: acknowledges alerts (evidence: `src/App.tsx`)
- Operations Panel → Firebase Services: resolves alerts (evidence: `src/App.tsx`)
- Threshold Engine → Firebase Services: persists events (evidence: `src/services/alertEngine.ts`)
- Threshold Engine → Audio Alerts: plays alarms (evidence: `src/services/alertEngine.ts`)
- Alert Handling → Firebase Services: loads alert data (evidence: `src/components/AlertsView.tsx`)
- Alert Handling → Alert Resolution: opens resolution (evidence: `src/components/AlertsView.tsx`)
- Emergency Controls → Firebase Services: sends commands
- Organization Management → Device Registry: assigns devices (evidence: `src/components/CompanyBulkManagementView.tsx`)
- Organization Management → Firebase Services: saves crews (evidence: `src/components/CompanyBulkManagementView.tsx`)
- Platform Administration → Firebase Services: saves configuration (evidence: `src/components/SuperAdminControlView.tsx`)
- Historical Reports → Firebase Services: loads history
- Crew Management → Firebase Services: manages crew data
- User Management → Firebase Services: manages accounts (evidence: `src/components/UsersManagementView.tsx`)
- Mining Sectors → Firebase Services: manages sectors (evidence: `src/components/MiningSectorsView.tsx`)
