# jorgehm28/alertaspirai architecture

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

- Interactive diagram: https://gitdiagram.com/jorgehm28/alertaspirai
- Repository: https://github.com/jorgehm28/alertaspirai

## Overview

Alertas Piraí is an early-warning system for flooding on the Río Piraí. Its workflow manages risk zones and communities, records or imports CAP alerts, prepares message versions for approval, and distributes approved alerts through public web, SMS, and manual channels. The React application provides public information and role-based management; the ASP.NET API exposes those workflows over REST, with application services and PostgreSQL/PostGIS persistence behind it. Edges rely on README statements and indexed or excerpted source; some subsystem wiring is not shown in the samples.

Main entry points: [`frontend/src/api.ts`](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/api.ts) (API client), [`frontend/src/App.tsx`](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/App.tsx) (React application), [`src/SistemaAlertas.Application/Abstracciones/IAppDbContext.cs`](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Abstracciones/IAppDbContext.cs) (Application data contract), [`src/SistemaAlertas.Api/Controllers/AvisosController.cs`](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/AvisosController.cs) (Alerts API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_app["React application<br/>[App.tsx]"]
  node_landing["Public landing<br/>[Landing.tsx]"]
  node_zoneui["Zone management<br/>[Zonas.tsx]"]
  node_communityui["Community management<br/>[Comunidades.tsx]"]
  node_alertui["Alert management<br/>[Avisos.tsx]"]
  node_messageui["Message review<br/>[Mensajes.tsx]"]
  node_userui["User management<br/>[Usuarios.tsx]"]
  node_api_client["API client<br/>[api.ts]"]
end

subgraph group_api["API access"]
  node_zoneapi["Zones API<br/>[ZonasController.cs]"]
  node_communityapi["Communities API"]
  node_alertapi["Alerts API"]
  node_authapi["Authentication API<br/>[AuthController.cs]"]
  node_usersapi["Users API"]
  node_publicapi["Public API"]
  node_versionsapi["Versions API"]
end

subgraph group_domain["Alert workflows"]
  node_zone_rules["Zone validation<br/>[Zona.cs]"]
  node_avisos["Alert records<br/>[Aviso.cs]"]
  node_cap_import["CAP import<br/>[Importacion]"]
  node_cap_builder["CAP builder"]
  node_version_service["Message versions"]
  node_version_entity["Version state<br/>[VersionMensaje.cs]"]
  node_users_service["User administration"]
  node_communities["Community contacts"]
end

subgraph group_delivery["Distribution"]
  node_diffusion["Alert distribution"]
  node_sms_queue["SMS queue worker"]
  node_sms_provider["SMS provider<br/>[TwilioEmisor.cs]"]
end

subgraph group_infra["Persistence and integrations"]
  node_db_interface["Application data contract<br/>[IAppDbContext.cs]"]
  node_db_context["EF data context"]
  node_database[("PostgreSQL + PostGIS")]
  node_geojson["GeoJSON converter"]
end

node_public(("Public visitor"))
node_operator(("Staff user"))

node_public -->|"views"| node_landing
node_operator -->|"uses"| node_app
node_app -->|"renders"| node_landing
node_app -->|"renders"| node_zoneui
node_app -->|"renders"| node_communityui
node_app -->|"renders"| node_alertui
node_app -->|"renders"| node_messageui
node_app -->|"renders"| node_userui
node_zoneui -.->|"uses"| node_api_client
node_communityui -.->|"uses"| node_api_client
node_alertui -.->|"uses"| node_api_client
node_messageui -.->|"uses"| node_api_client
node_userui -.->|"uses"| node_api_client
node_api_client -.->|"HTTP requests"| node_zoneapi
node_api_client -.->|"HTTP requests"| node_communityapi
node_api_client -.->|"HTTP requests"| node_alertapi
node_api_client -.->|"HTTP requests"| node_authapi
node_api_client -.->|"HTTP requests"| node_usersapi
node_api_client -.->|"HTTP requests"| node_versionsapi
node_zoneapi -->|"reads and writes"| node_db_interface
node_zoneapi -->|"converts geometry"| node_geojson
node_zoneapi -->|"validates area"| node_zone_rules
node_communityapi -->|"reads and writes"| node_db_interface
node_communityapi -->|"manages"| node_communities
node_alertapi -->|"reads and writes"| node_db_interface
node_alertapi -->|"manages"| node_avisos
node_alertapi -->|"imports CAP"| node_cap_import
node_alertapi -->|"builds CAP"| node_cap_builder
node_versionsapi -->|"delegates to"| node_version_service
node_versionsapi -->|"reads and writes"| node_db_interface
node_version_service -->|"reads and writes"| node_db_interface
node_version_service -->|"builds CAP"| node_cap_builder
node_version_service -->|"creates and reviews"| node_version_entity
node_usersapi -->|"delegates to"| node_users_service
node_users_service -->|"reads and writes"| node_db_interface
node_publicapi -->|"reads"| node_db_interface
node_publicapi -->|"converts geometry"| node_geojson
node_db_interface -->|"implemented by"| node_db_context
node_db_context -->|"persists entities"| node_database
node_diffusion -.->|"enqueues jobs"| node_sms_queue
node_sms_queue -.->|"sends SMS"| node_sms_provider
node_versionsapi -.->|"requests distribution"| node_diffusion

click node_app "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/App.tsx"
click node_landing "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Landing.tsx"
click node_zoneui "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Zonas.tsx"
click node_communityui "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Comunidades.tsx"
click node_alertui "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Avisos.tsx"
click node_messageui "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Mensajes.tsx"
click node_userui "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Usuarios.tsx"
click node_api_client "https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/api.ts"
click node_zoneapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/ZonasController.cs"
click node_communityapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/ComunidadesController.cs"
click node_alertapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/AvisosController.cs"
click node_authapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/AuthController.cs"
click node_usersapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/UsuariosController.cs"
click node_publicapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/PublicoController.cs"
click node_versionsapi "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/VersionesController.cs"
click node_zone_rules "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Domain/Zonas/Zona.cs"
click node_avisos "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Domain/Avisos/Aviso.cs"
click node_cap_import "https://github.com/jorgehm28/alertaspirai/tree/main/src/SistemaAlertas.Application/Avisos/Importacion"
click node_cap_builder "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Cap/MensajeCapBuilder.cs"
click node_version_service "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs"
click node_version_entity "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Domain/Mensajes/VersionMensaje.cs"
click node_users_service "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Usuarios/ServicioUsuarios.cs"
click node_communities "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/ComunidadesController.cs"
click node_diffusion "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Difusion/ServicioDifusion.cs"
click node_sms_queue "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Comun/ProcesadorColaSms.cs"
click node_sms_provider "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Infrastructure/Sms/TwilioEmisor.cs"
click node_db_interface "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Abstracciones/IAppDbContext.cs"
click node_db_context "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Infrastructure/Persistence/AlertasDbContext.cs"
click node_geojson "https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Infrastructure/Geo/ConversorGeoJson.cs"

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_app,node_landing,node_zoneui,node_communityui,node_alertui,node_messageui,node_userui,node_api_client,node_operator toneBlue
class node_zoneapi,node_communityapi,node_alertapi,node_authapi,node_usersapi,node_publicapi,node_versionsapi toneAmber
class node_zone_rules,node_avisos,node_cap_import,node_cap_builder,node_version_service,node_version_entity,node_users_service,node_communities toneMint
class node_diffusion,node_sms_queue,node_sms_provider toneRose
class node_db_interface,node_db_context,node_database,node_geojson,node_public toneIndigo
```

## Components

### Web application

- [React application](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/App.tsx): `frontend/src/App.tsx`
- [Public landing](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Landing.tsx): `frontend/src/paginas/Landing.tsx`
- [Zone management](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Zonas.tsx): `frontend/src/paginas/Zonas.tsx`
- [Community management](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Comunidades.tsx): `frontend/src/paginas/Comunidades.tsx`
- [Alert management](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Avisos.tsx): `frontend/src/paginas/Avisos.tsx`
- [Message review](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Mensajes.tsx): `frontend/src/paginas/Mensajes.tsx`
- [User management](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/paginas/Usuarios.tsx): `frontend/src/paginas/Usuarios.tsx`
- [API client](https://github.com/jorgehm28/alertaspirai/blob/main/frontend/src/api.ts): `frontend/src/api.ts`

### API access

- [Zones API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/ZonasController.cs): `src/SistemaAlertas.Api/Controllers/ZonasController.cs`
- [Communities API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/ComunidadesController.cs): `src/SistemaAlertas.Api/Controllers/ComunidadesController.cs`
- [Alerts API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/AvisosController.cs): `src/SistemaAlertas.Api/Controllers/AvisosController.cs`
- [Authentication API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/AuthController.cs): `src/SistemaAlertas.Api/Controllers/AuthController.cs`
- [Users API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/UsuariosController.cs): `src/SistemaAlertas.Api/Controllers/UsuariosController.cs`
- [Public API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/PublicoController.cs): `src/SistemaAlertas.Api/Controllers/PublicoController.cs`
- [Versions API](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/VersionesController.cs): `src/SistemaAlertas.Api/Controllers/VersionesController.cs`

### Alert workflows

- [Zone validation](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Domain/Zonas/Zona.cs): `src/SistemaAlertas.Domain/Zonas/Zona.cs`
- [Alert records](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Domain/Avisos/Aviso.cs): `src/SistemaAlertas.Domain/Avisos/Aviso.cs`
- [CAP import](https://github.com/jorgehm28/alertaspirai/tree/main/src/SistemaAlertas.Application/Avisos/Importacion): `src/SistemaAlertas.Application/Avisos/Importacion`
- [CAP builder](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Cap/MensajeCapBuilder.cs): `src/SistemaAlertas.Application/Cap/MensajeCapBuilder.cs`
- [Message versions](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs): `src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs`
- [Version state](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Domain/Mensajes/VersionMensaje.cs): `src/SistemaAlertas.Domain/Mensajes/VersionMensaje.cs`
- [User administration](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Usuarios/ServicioUsuarios.cs): `src/SistemaAlertas.Application/Usuarios/ServicioUsuarios.cs`
- [Community contacts](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Controllers/ComunidadesController.cs): `src/SistemaAlertas.Api/Controllers/ComunidadesController.cs`

### Distribution

- [Alert distribution](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Difusion/ServicioDifusion.cs): `src/SistemaAlertas.Application/Difusion/ServicioDifusion.cs`
- [SMS queue worker](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Api/Comun/ProcesadorColaSms.cs): `src/SistemaAlertas.Api/Comun/ProcesadorColaSms.cs`
- [SMS provider](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Infrastructure/Sms/TwilioEmisor.cs): `src/SistemaAlertas.Infrastructure/Sms/TwilioEmisor.cs`

### Persistence and integrations

- [Application data contract](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Application/Abstracciones/IAppDbContext.cs): `src/SistemaAlertas.Application/Abstracciones/IAppDbContext.cs`
- [EF data context](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Infrastructure/Persistence/AlertasDbContext.cs): `src/SistemaAlertas.Infrastructure/Persistence/AlertasDbContext.cs`
- **PostgreSQL + PostGIS**
- [GeoJSON converter](https://github.com/jorgehm28/alertaspirai/blob/main/src/SistemaAlertas.Infrastructure/Geo/ConversorGeoJson.cs): `src/SistemaAlertas.Infrastructure/Geo/ConversorGeoJson.cs`

### Other components

- **Public visitor**
- **Staff user**

## Connections

- Public visitor → Public landing: views (evidence: `README.md`)
- Staff user → React application: uses (evidence: `README.md`)
- React application → Public landing: renders (evidence: `frontend/src/App.tsx`)
- React application → Zone management: renders (evidence: `frontend/src/App.tsx`)
- React application → Community management: renders (evidence: `frontend/src/App.tsx`)
- React application → Alert management: renders (evidence: `frontend/src/App.tsx`)
- React application → Message review: renders (evidence: `frontend/src/App.tsx`)
- React application → User management: renders (evidence: `frontend/src/App.tsx`)
- Zone management → API client: uses
- Community management → API client: uses
- Alert management → API client: uses
- Message review → API client: uses (evidence: `frontend/src/paginas/Mensajes.tsx`)
- User management → API client: uses
- API client → Zones API: HTTP requests
- API client → Communities API: HTTP requests
- API client → Alerts API: HTTP requests
- API client → Authentication API: HTTP requests
- API client → Users API: HTTP requests
- API client → Versions API: HTTP requests
- Zones API → Application data contract: reads and writes (evidence: `src/SistemaAlertas.Api/Controllers/ZonasController.cs`)
- Zones API → GeoJSON converter: converts geometry (evidence: `src/SistemaAlertas.Api/Controllers/ZonasController.cs`)
- Zones API → Zone validation: validates area (evidence: `src/SistemaAlertas.Api/Controllers/ZonasController.cs`)
- Communities API → Application data contract: reads and writes (evidence: `src/SistemaAlertas.Api/Controllers/ComunidadesController.cs`)
- Communities API → Community contacts: manages (evidence: `src/SistemaAlertas.Api/Controllers/ComunidadesController.cs`)
- Alerts API → Application data contract: reads and writes (evidence: `src/SistemaAlertas.Api/Controllers/AvisosController.cs`)
- Alerts API → Alert records: manages (evidence: `src/SistemaAlertas.Api/Controllers/AvisosController.cs`)
- Alerts API → CAP import: imports CAP (evidence: `src/SistemaAlertas.Api/Controllers/AvisosController.cs`)
- Alerts API → CAP builder: builds CAP (evidence: `src/SistemaAlertas.Api/Controllers/AvisosController.cs`)
- Versions API → Message versions: delegates to (evidence: `src/SistemaAlertas.Api/Controllers/VersionesController.cs`)
- Versions API → Application data contract: reads and writes (evidence: `src/SistemaAlertas.Api/Controllers/VersionesController.cs`)
- Message versions → Application data contract: reads and writes (evidence: `src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs`)
- Message versions → CAP builder: builds CAP (evidence: `src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs`)
- Message versions → Version state: creates and reviews (evidence: `src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs`)
- Users API → User administration: delegates to
- User administration → Application data contract: reads and writes (evidence: `src/SistemaAlertas.Application/Usuarios/ServicioUsuarios.cs`)
- Public API → Application data contract: reads (evidence: `src/SistemaAlertas.Api/Controllers/PublicoController.cs`)
- Public API → GeoJSON converter: converts geometry (evidence: `src/SistemaAlertas.Api/Controllers/PublicoController.cs`)
- Application data contract → EF data context: implemented by (evidence: `src/SistemaAlertas.Infrastructure/Persistence/AlertasDbContext.cs`)
- EF data context → PostgreSQL + PostGIS: persists entities (evidence: `README.md`)
- Alert distribution → SMS queue worker: enqueues jobs
- SMS queue worker → SMS provider: sends SMS
- Versions API → Alert distribution: requests distribution
