# spygil312/coalerta architecture

> Architecture diagram of the GitHub repository spygil312/coalerta, 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/spygil312/coalerta
- Repository: https://github.com/spygil312/coalerta

## Overview

CoAlerta is a community safety web app whose central workflow is reporting a geolocated incident, filtering and validating it by community, and dispatching assigned security personnel to respond. Separate role-based branches support account administration, community management, maps, incident history, and notifications. The README documents these capabilities and Firebase services; sampled JavaScript also shows direct Firestore reads, writes, and live queries. Many pages and modules were not sampled, so some documented subsystem links are shown at the product level rather than as inferred implementation calls.

Main entry points: [`js/coalerta-data.js`](https://github.com/spygil312/coalerta/blob/main/js/coalerta-data.js) (Incident data services), [`js/emergency-report.js`](https://github.com/spygil312/coalerta/blob/main/js/emergency-report.js) (Anonymous emergency report), [`js/login.js`](https://github.com/spygil312/coalerta/blob/main/js/login.js) (Sign-in), [`js/perfil.js`](https://github.com/spygil312/coalerta/blob/main/js/perfil.js) (Account profile)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_accounts["Accounts and roles"]
  node_registration["Registration<br/>[registro.js]"]
  node_sign_in["Sign-in<br/>[login.js]"]
  node_account_profile["Account profile<br/>[perfil.js]"]
  node_role_admin["Role and patrol admin<br/>[administracion.js]"]
end

subgraph group_response["Incident response"]
  node_anonymous_report["Anonymous emergency report"]
  node_community_report["Community alerts<br/>[alertas.js]"]
  node_coordinator_console["Coordinator console"]
  node_security_console["Security dispatch"]
  node_map["Incident map<br/>[mapa.js]"]
  node_history["Incident history<br/>[historial.js]"]
end

subgraph group_community["Community tools"]
  node_community_admin["Community management<br/>[comunidad.js]"]
  node_notifications["Notifications<br/>[notificaciones.js]"]
end

subgraph group_platform["Shared platform"]
  node_incident_data["Incident data services<br/>[coalerta-data.js]"]
  node_location["Location services<br/>[ubicacion.js]"]
  node_firebase_config["Firebase configuration<br/>[firebase-config.js]"]
  node_auth_service["Firebase Authentication"]
  node_firestore[("Cloud Firestore")]
  node_firestore_rules["Firestore access rules<br/>[firestore.rules]"]
end

node_visitor(("Visitor / neighbor"))
node_admin(("Administrator"))
node_coordinator(("Coordinator"))
node_security(("Security staff"))

node_visitor -->|"registers"| node_registration
node_visitor -->|"signs in"| node_sign_in
node_sign_in -->|"authenticates with"| node_auth_service
node_sign_in -->|"loads profile"| node_firestore
node_registration -->|"creates profile"| node_firestore
node_visitor -->|"reports emergency"| node_anonymous_report
node_anonymous_report -->|"uses anonymous auth"| node_auth_service
node_anonymous_report -->|"writes alert"| node_firestore
node_visitor -->|"reports incident"| node_community_report
node_community_report -.->|"uses alert data"| node_incident_data
node_incident_data -->|"queries and updates"| node_firestore
node_coordinator -->|"validates alerts"| node_coordinator_console
node_coordinator -->|"manages community"| node_community_admin
node_coordinator_console -.->|"uses shared data"| node_incident_data
node_admin -->|"manages roles"| node_role_admin
node_role_admin -->|"reads and assigns"| node_firestore
node_security -->|"responds to alerts"| node_security_console
node_security_console -->|"watches and dispatches"| node_firestore
node_visitor -->|"views incidents"| node_map
node_visitor -->|"reviews history"| node_history
node_visitor -->|"checks alerts"| node_notifications
node_map -.->|"uses shared data"| node_incident_data
node_history -->|"subscribes to incidents"| node_firestore
node_notifications -->|"reads alert state"| node_incident_data
node_account_profile -->|"updates account"| node_auth_service
node_account_profile -->|"updates profile"| node_firestore
node_firebase_config -->|"configures"| node_auth_service
node_firebase_config -->|"configures"| node_firestore
node_firestore_rules -->|"secures access"| node_firestore
node_anonymous_report -->|"gets GPS position"| node_location

click node_registration "https://github.com/spygil312/coalerta/blob/main/js/registro.js"
click node_sign_in "https://github.com/spygil312/coalerta/blob/main/js/login.js"
click node_account_profile "https://github.com/spygil312/coalerta/blob/main/js/perfil.js"
click node_role_admin "https://github.com/spygil312/coalerta/blob/main/js/administracion.js"
click node_anonymous_report "https://github.com/spygil312/coalerta/blob/main/js/emergency-report.js"
click node_community_report "https://github.com/spygil312/coalerta/blob/main/js/alertas.js"
click node_incident_data "https://github.com/spygil312/coalerta/blob/main/js/coalerta-data.js"
click node_coordinator_console "https://github.com/spygil312/coalerta/blob/main/js/coordinador_vecinal.js"
click node_security_console "https://github.com/spygil312/coalerta/blob/main/js/personal-seguridad.js"
click node_map "https://github.com/spygil312/coalerta/blob/main/js/mapa.js"
click node_history "https://github.com/spygil312/coalerta/blob/main/js/historial.js"
click node_community_admin "https://github.com/spygil312/coalerta/blob/main/js/comunidad.js"
click node_notifications "https://github.com/spygil312/coalerta/blob/main/js/notificaciones.js"
click node_location "https://github.com/spygil312/coalerta/blob/main/js/ubicacion.js"
click node_firebase_config "https://github.com/spygil312/coalerta/blob/main/js/firebase-config.js"
click node_firestore_rules "https://github.com/spygil312/coalerta/blob/main/firestore.rules"

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_registration,node_sign_in,node_account_profile,node_role_admin toneBlue
class node_anonymous_report,node_community_report,node_coordinator_console,node_security_console,node_map,node_history toneAmber
class node_community_admin,node_notifications toneMint
class node_incident_data,node_location,node_firebase_config,node_auth_service,node_firestore,node_firestore_rules toneRose
class node_visitor,node_admin,node_coordinator,node_security toneIndigo
```

## Components

### Accounts and roles

- [Registration](https://github.com/spygil312/coalerta/blob/main/js/registro.js): `js/registro.js`
- [Sign-in](https://github.com/spygil312/coalerta/blob/main/js/login.js): `js/login.js`
- [Account profile](https://github.com/spygil312/coalerta/blob/main/js/perfil.js): `js/perfil.js`
- [Role and patrol admin](https://github.com/spygil312/coalerta/blob/main/js/administracion.js): `js/administracion.js`

### Incident response

- [Anonymous emergency report](https://github.com/spygil312/coalerta/blob/main/js/emergency-report.js): `js/emergency-report.js`
- [Community alerts](https://github.com/spygil312/coalerta/blob/main/js/alertas.js): `js/alertas.js`
- [Coordinator console](https://github.com/spygil312/coalerta/blob/main/js/coordinador_vecinal.js): `js/coordinador_vecinal.js`
- [Security dispatch](https://github.com/spygil312/coalerta/blob/main/js/personal-seguridad.js): `js/personal-seguridad.js`
- [Incident map](https://github.com/spygil312/coalerta/blob/main/js/mapa.js): `js/mapa.js`
- [Incident history](https://github.com/spygil312/coalerta/blob/main/js/historial.js): `js/historial.js`

### Community tools

- [Community management](https://github.com/spygil312/coalerta/blob/main/js/comunidad.js): `js/comunidad.js`
- [Notifications](https://github.com/spygil312/coalerta/blob/main/js/notificaciones.js): `js/notificaciones.js`

### Shared platform

- [Incident data services](https://github.com/spygil312/coalerta/blob/main/js/coalerta-data.js): `js/coalerta-data.js`
- [Location services](https://github.com/spygil312/coalerta/blob/main/js/ubicacion.js): `js/ubicacion.js`
- [Firebase configuration](https://github.com/spygil312/coalerta/blob/main/js/firebase-config.js): `js/firebase-config.js`
- **Firebase Authentication**
- **Cloud Firestore**
- [Firestore access rules](https://github.com/spygil312/coalerta/blob/main/firestore.rules): `firestore.rules`

### Other components

- **Visitor / neighbor**
- **Administrator**
- **Coordinator**
- **Security staff**

## Connections

- Visitor / neighbor → Registration: registers (evidence: `README.md`)
- Visitor / neighbor → Sign-in: signs in (evidence: `README.md`)
- Sign-in → Firebase Authentication: authenticates with (evidence: `js/login.js`)
- Sign-in → Cloud Firestore: loads profile (evidence: `js/login.js`)
- Registration → Cloud Firestore: creates profile (evidence: `README.md`)
- Visitor / neighbor → Anonymous emergency report: reports emergency (evidence: `README.md`)
- Anonymous emergency report → Firebase Authentication: uses anonymous auth (evidence: `js/emergency-report.js`)
- Anonymous emergency report → Cloud Firestore: writes alert (evidence: `js/emergency-report.js`)
- Visitor / neighbor → Community alerts: reports incident (evidence: `README.md`)
- Community alerts → Incident data services: uses alert data
- Incident data services → Cloud Firestore: queries and updates (evidence: `js/coalerta-data.js`)
- Coordinator → Coordinator console: validates alerts (evidence: `README.md`)
- Coordinator → Community management: manages community (evidence: `README.md`)
- Coordinator console → Incident data services: uses shared data
- Administrator → Role and patrol admin: manages roles (evidence: `README.md`)
- Role and patrol admin → Cloud Firestore: reads and assigns (evidence: `js/administracion.js`)
- Security staff → Security dispatch: responds to alerts (evidence: `README.md`)
- Security dispatch → Cloud Firestore: watches and dispatches (evidence: `js/personal-seguridad.js`)
- Visitor / neighbor → Incident map: views incidents (evidence: `README.md`)
- Visitor / neighbor → Incident history: reviews history (evidence: `README.md`)
- Visitor / neighbor → Notifications: checks alerts (evidence: `README.md`)
- Incident map → Incident data services: uses shared data
- Incident history → Cloud Firestore: subscribes to incidents (evidence: `js/historial.js`)
- Notifications → Incident data services: reads alert state (evidence: `js/notificaciones.js`)
- Account profile → Firebase Authentication: updates account (evidence: `js/perfil.js`)
- Account profile → Cloud Firestore: updates profile (evidence: `js/perfil.js`)
- Firebase configuration → Firebase Authentication: configures (evidence: `js/firebase-config.js`)
- Firebase configuration → Cloud Firestore: configures (evidence: `js/firebase-config.js`)
- Firestore access rules → Cloud Firestore: secures access (evidence: `README.md`)
- Anonymous emergency report → Location services: gets GPS position (evidence: `js/emergency-report.js`)
