# antito-yanac/sara architecture

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

- Interactive diagram: https://gitdiagram.com/antito-yanac/sara
- Repository: https://github.com/antito-yanac/sara

## Overview

SARA/Keraunos combines weather surveillance and emergency response. The documented flow loads a live zone map, receives and displays weather alerts, and lets users submit SOS reports with location and contact details for response. The graph also includes administration, push notifications, PWA support, and responder-facing SOS modules. Relationships are limited to calls or dependencies shown in excerpts and the source index, or capabilities explicitly documented in the README; unsampled modules are not treated as inspected.

Main entry points: [`js/firebase-app.js`](https://github.com/antito-yanac/sara/blob/main/js/firebase-app.js) (Firebase services), [`js/app.js`](https://github.com/antito-yanac/sara/blob/main/js/app.js) (Surveillance app), [`js/boton-panico.js`](https://github.com/antito-yanac/sara/blob/main/js/boton-panico.js) (Panic reporting), [`js/notifications.js`](https://github.com/antito-yanac/sara/blob/main/js/notifications.js) (Push notifications)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_weather["Weather surveillance"]
  node_weather_config["Monitor configuration<br/>[config.js]"]
  node_weather_monitor["Weather monitor<br/>[monitor.js]"]
  node_status_sync["Weather status sync<br/>[estado-cliente.js]"]
  node_map["Live zone map<br/>[map.js]"]
  node_alerts["Alert display<br/>[alertas.js]"]
  node_app["Surveillance app<br/>[app.js]"]
end

subgraph group_sos["SOS and response"]
  node_panic_ui["SOS interface<br/>[sos-ui.js]"]
  node_panic["Panic reporting<br/>[boton-panico.js]"]
  node_user_registration["User registration"]
  node_offline_queue["Offline SOS queue<br/>[cola-offline.js]"]
  node_responder_app["Rescuer app<br/>[rescatista-app.js]"]
  node_ambulance_app["Ambulance app<br/>[ambulancia-app.js]"]
  node_sos_panel["SOS operations panel<br/>[panel.js]"]
  node_sos_unit["SOS response unit<br/>[unidad.js]"]
end

subgraph group_admin["Administration"]
  node_admin_panel["Alert administration<br/>[admin-panel.js]"]
  node_manual_admin["Manual alert mode<br/>[adminkeraunos.js]"]
end

subgraph group_platform["Firebase and PWA"]
  node_firebase["Firebase services<br/>[firebase-app.js]"]
  node_firestore[("Cloud Firestore")]
  node_push["Push notifications<br/>[notifications.js]"]
  node_pwa["PWA installation<br/>[pwa-install.js]"]
  node_sw["Messaging service worker"]
  node_sos_firebase["SOS Firebase initializer<br/>[firebase-init.js]"]
end

node_user(("User"))
node_admin_actor(("Administrator"))
node_weather_source(("Keraunos weather source"))

node_user -->|"opens surveillance"| node_app
node_app -->|"creates map"| node_map
node_app -->|"starts status sync"| node_status_sync
node_status_sync -->|"updates alerts"| node_alerts
node_alerts -->|"illuminates zones"| node_map
node_weather_source -.->|"supplies weather data"| node_weather_monitor
node_weather_config -->|"configures monitor"| node_weather_monitor
node_admin_actor -->|"issues manual alerts"| node_manual_admin
node_manual_admin -.->|"publishes alerts"| node_firestore
node_user -->|"requests SOS"| node_panic_ui
node_panic_ui -->|"invokes panic flow"| node_panic
node_panic -->|"uses registration"| node_user_registration
node_panic -->|"uses offline queue"| node_offline_queue
node_panic -->|"records SOS"| node_firestore
node_user_registration -->|"reads and writes profiles"| node_firestore
node_responder_app -->|"uses Firebase"| node_firebase
node_ambulance_app -->|"uses Firebase"| node_firebase
node_sos_panel -->|"uses initializer"| node_sos_firebase
node_sos_unit -->|"uses initializer"| node_sos_firebase
node_admin_actor -->|"manages alerts"| node_admin_panel
node_admin_panel -->|"uses Firebase"| node_firebase
node_app -->|"initializes push"| node_push
node_push -->|"gets Firebase app"| node_firebase
node_push -->|"registers worker"| node_sw
node_firebase -->|"initializes database"| node_firestore
node_user -.->|"installs application"| node_pwa
node_sos_firebase -->|"initializes database"| node_firestore

click node_weather_config "https://github.com/antito-yanac/sara/blob/main/config.js"
click node_weather_monitor "https://github.com/antito-yanac/sara/blob/main/monitor.js"
click node_status_sync "https://github.com/antito-yanac/sara/blob/main/js/estado-cliente.js"
click node_map "https://github.com/antito-yanac/sara/blob/main/js/map.js"
click node_alerts "https://github.com/antito-yanac/sara/blob/main/js/alertas.js"
click node_app "https://github.com/antito-yanac/sara/blob/main/js/app.js"
click node_panic_ui "https://github.com/antito-yanac/sara/blob/main/js/sos-ui.js"
click node_panic "https://github.com/antito-yanac/sara/blob/main/js/boton-panico.js"
click node_user_registration "https://github.com/antito-yanac/sara/blob/main/js/registro-usuario.js"
click node_offline_queue "https://github.com/antito-yanac/sara/blob/main/js/cola-offline.js"
click node_responder_app "https://github.com/antito-yanac/sara/blob/main/js/rescatista-app.js"
click node_ambulance_app "https://github.com/antito-yanac/sara/blob/main/js/ambulancia-app.js"
click node_sos_panel "https://github.com/antito-yanac/sara/blob/main/sos/panel/panel.js"
click node_sos_unit "https://github.com/antito-yanac/sara/blob/main/sos/unidad/unidad.js"
click node_admin_panel "https://github.com/antito-yanac/sara/blob/main/js/admin-panel.js"
click node_manual_admin "https://github.com/antito-yanac/sara/blob/main/js/adminkeraunos.js"
click node_firebase "https://github.com/antito-yanac/sara/blob/main/js/firebase-app.js"
click node_push "https://github.com/antito-yanac/sara/blob/main/js/notifications.js"
click node_pwa "https://github.com/antito-yanac/sara/blob/main/js/pwa-install.js"
click node_sw "https://github.com/antito-yanac/sara/blob/main/firebase-messaging-sw.js"
click node_sos_firebase "https://github.com/antito-yanac/sara/blob/main/sos/shared/firebase-init.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_weather_config,node_weather_monitor,node_status_sync,node_map,node_alerts,node_app,node_user toneBlue
class node_panic_ui,node_panic,node_user_registration,node_offline_queue,node_responder_app,node_ambulance_app,node_sos_panel,node_sos_unit toneAmber
class node_admin_panel,node_manual_admin toneMint
class node_firebase,node_firestore,node_push,node_pwa,node_sw,node_sos_firebase toneRose
class node_admin_actor,node_weather_source toneIndigo
```

## Components

### Weather surveillance

- [Monitor configuration](https://github.com/antito-yanac/sara/blob/main/config.js): `config.js`
- [Weather monitor](https://github.com/antito-yanac/sara/blob/main/monitor.js): `monitor.js`
- [Weather status sync](https://github.com/antito-yanac/sara/blob/main/js/estado-cliente.js): `js/estado-cliente.js`
- [Live zone map](https://github.com/antito-yanac/sara/blob/main/js/map.js): `js/map.js`
- [Alert display](https://github.com/antito-yanac/sara/blob/main/js/alertas.js): `js/alertas.js`
- [Surveillance app](https://github.com/antito-yanac/sara/blob/main/js/app.js): `js/app.js`

### SOS and response

- [SOS interface](https://github.com/antito-yanac/sara/blob/main/js/sos-ui.js): `js/sos-ui.js`
- [Panic reporting](https://github.com/antito-yanac/sara/blob/main/js/boton-panico.js): `js/boton-panico.js`
- [User registration](https://github.com/antito-yanac/sara/blob/main/js/registro-usuario.js): `js/registro-usuario.js`
- [Offline SOS queue](https://github.com/antito-yanac/sara/blob/main/js/cola-offline.js): `js/cola-offline.js`
- [Rescuer app](https://github.com/antito-yanac/sara/blob/main/js/rescatista-app.js): `js/rescatista-app.js`
- [Ambulance app](https://github.com/antito-yanac/sara/blob/main/js/ambulancia-app.js): `js/ambulancia-app.js`
- [SOS operations panel](https://github.com/antito-yanac/sara/blob/main/sos/panel/panel.js): `sos/panel/panel.js`
- [SOS response unit](https://github.com/antito-yanac/sara/blob/main/sos/unidad/unidad.js): `sos/unidad/unidad.js`

### Administration

- [Alert administration](https://github.com/antito-yanac/sara/blob/main/js/admin-panel.js): `js/admin-panel.js`
- [Manual alert mode](https://github.com/antito-yanac/sara/blob/main/js/adminkeraunos.js): `js/adminkeraunos.js`

### Firebase and PWA

- [Firebase services](https://github.com/antito-yanac/sara/blob/main/js/firebase-app.js): `js/firebase-app.js`
- **Cloud Firestore**
- [Push notifications](https://github.com/antito-yanac/sara/blob/main/js/notifications.js): `js/notifications.js`
- [PWA installation](https://github.com/antito-yanac/sara/blob/main/js/pwa-install.js): `js/pwa-install.js`
- [Messaging service worker](https://github.com/antito-yanac/sara/blob/main/firebase-messaging-sw.js): `firebase-messaging-sw.js`
- [SOS Firebase initializer](https://github.com/antito-yanac/sara/blob/main/sos/shared/firebase-init.js): `sos/shared/firebase-init.js`

### Other components

- **User**
- **Administrator**
- **Keraunos weather source**

## Connections

- User → Surveillance app: opens surveillance (evidence: `README.md`)
- Surveillance app → Live zone map: creates map (evidence: `js/app.js`)
- Surveillance app → Weather status sync: starts status sync (evidence: `js/app.js`)
- Weather status sync → Alert display: updates alerts (evidence: `js/estado-cliente.js`)
- Alert display → Live zone map: illuminates zones (evidence: `js/alertas.js`)
- Keraunos weather source → Weather monitor: supplies weather data
- Monitor configuration → Weather monitor: configures monitor (evidence: `monitor.js`)
- Administrator → Manual alert mode: issues manual alerts (evidence: `README.md`)
- Manual alert mode → Cloud Firestore: publishes alerts
- User → SOS interface: requests SOS (evidence: `README.md`)
- SOS interface → Panic reporting: invokes panic flow (evidence: `js/sos-ui.js`)
- Panic reporting → User registration: uses registration (evidence: `js/boton-panico.js`)
- Panic reporting → Offline SOS queue: uses offline queue (evidence: `js/boton-panico.js`)
- Panic reporting → Cloud Firestore: records SOS (evidence: `README.md`)
- User registration → Cloud Firestore: reads and writes profiles (evidence: `js/registro-usuario.js`)
- Rescuer app → Firebase services: uses Firebase (evidence: `js/rescatista-app.js`)
- Ambulance app → Firebase services: uses Firebase (evidence: `js/ambulancia-app.js`)
- SOS operations panel → SOS Firebase initializer: uses initializer (evidence: `sos/panel/panel.js`)
- SOS response unit → SOS Firebase initializer: uses initializer (evidence: `sos/unidad/unidad.js`)
- Administrator → Alert administration: manages alerts (evidence: `README.md`)
- Alert administration → Firebase services: uses Firebase (evidence: `js/admin-panel.js`)
- Surveillance app → Push notifications: initializes push (evidence: `js/app.js`)
- Push notifications → Firebase services: gets Firebase app (evidence: `js/notifications.js`)
- Push notifications → Messaging service worker: registers worker (evidence: `js/notifications.js`)
- Firebase services → Cloud Firestore: initializes database (evidence: `js/firebase-app.js`)
- User → PWA installation: installs application
- SOS Firebase initializer → Cloud Firestore: initializes database (evidence: `sos/shared/firebase-init.js`)
