How jorgehm28/alertaspirai works
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: api.ts API client · App.tsx React application · IAppDbContext.cs Application data contract · AvisosController.cs Alerts API
Components 32
Web application
- React application
frontend/src/App.tsx - Public landing
frontend/src/paginas/Landing.tsx - Zone management
frontend/src/paginas/Zonas.tsx - Community management
frontend/src/paginas/Comunidades.tsx - Alert management
frontend/src/paginas/Avisos.tsx - Message review
frontend/src/paginas/Mensajes.tsx - User management
frontend/src/paginas/Usuarios.tsx - API client
frontend/src/api.ts
API access
- Zones API
src/SistemaAlertas.Api/Controllers/ZonasController.cs - Communities API
src/SistemaAlertas.Api/Controllers/ComunidadesController.cs - Alerts API
src/SistemaAlertas.Api/Controllers/AvisosController.cs - Authentication API
src/SistemaAlertas.Api/Controllers/AuthController.cs - Users API
src/SistemaAlertas.Api/Controllers/UsuariosController.cs - Public API
src/SistemaAlertas.Api/Controllers/PublicoController.cs - Versions API
src/SistemaAlertas.Api/Controllers/VersionesController.cs
Alert workflows
- Zone validation
src/SistemaAlertas.Domain/Zonas/Zona.cs - Alert records
src/SistemaAlertas.Domain/Avisos/Aviso.cs - CAP import
src/SistemaAlertas.Application/Avisos/Importacion - CAP builder
src/SistemaAlertas.Application/Cap/MensajeCapBuilder.cs - Message versions
src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs - Version state
src/SistemaAlertas.Domain/Mensajes/VersionMensaje.cs - User administration
src/SistemaAlertas.Application/Usuarios/ServicioUsuarios.cs - Community contacts
src/SistemaAlertas.Api/Controllers/ComunidadesController.cs
Distribution
- Alert distribution
src/SistemaAlertas.Application/Difusion/ServicioDifusion.cs - SMS queue worker
src/SistemaAlertas.Api/Comun/ProcesadorColaSms.cs - SMS provider
src/SistemaAlertas.Infrastructure/Sms/TwilioEmisor.cs
Persistence and integrations
- Application data contract
src/SistemaAlertas.Application/Abstracciones/IAppDbContext.cs - EF data context
src/SistemaAlertas.Infrastructure/Persistence/AlertasDbContext.cs - PostgreSQL + PostGIS
- GeoJSON converter
src/SistemaAlertas.Infrastructure/Geo/ConversorGeoJson.cs
Other components
- Public visitor
- Staff user
Connections 42
- Public visitor → Public landing: views
README.md - Staff user → React application: uses
README.md - React application → Public landing: renders
frontend/src/App.tsx - React application → Zone management: renders
frontend/src/App.tsx - React application → Community management: renders
frontend/src/App.tsx - React application → Alert management: renders
frontend/src/App.tsx - React application → Message review: renders
frontend/src/App.tsx - React application → User management: renders
frontend/src/App.tsx - Zone management → API client: uses
- Community management → API client: uses
- Alert management → API client: uses
- Message review → API client: uses
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
src/SistemaAlertas.Api/Controllers/ZonasController.cs - Zones API → GeoJSON converter: converts geometry
src/SistemaAlertas.Api/Controllers/ZonasController.cs - Zones API → Zone validation: validates area
src/SistemaAlertas.Api/Controllers/ZonasController.cs - Communities API → Application data contract: reads and writes
src/SistemaAlertas.Api/Controllers/ComunidadesController.cs - Communities API → Community contacts: manages
src/SistemaAlertas.Api/Controllers/ComunidadesController.cs - Alerts API → Application data contract: reads and writes
src/SistemaAlertas.Api/Controllers/AvisosController.cs - Alerts API → Alert records: manages
src/SistemaAlertas.Api/Controllers/AvisosController.cs - Alerts API → CAP import: imports CAP
src/SistemaAlertas.Api/Controllers/AvisosController.cs - Alerts API → CAP builder: builds CAP
src/SistemaAlertas.Api/Controllers/AvisosController.cs - Versions API → Message versions: delegates to
src/SistemaAlertas.Api/Controllers/VersionesController.cs - Versions API → Application data contract: reads and writes
src/SistemaAlertas.Api/Controllers/VersionesController.cs - Message versions → Application data contract: reads and writes
src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs - Message versions → CAP builder: builds CAP
src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs - Message versions → Version state: creates and reviews
src/SistemaAlertas.Application/Mensajes/ServicioVersiones.cs - Users API → User administration: delegates to
- User administration → Application data contract: reads and writes
src/SistemaAlertas.Application/Usuarios/ServicioUsuarios.cs - Public API → Application data contract: reads
src/SistemaAlertas.Api/Controllers/PublicoController.cs - Public API → GeoJSON converter: converts geometry
src/SistemaAlertas.Api/Controllers/PublicoController.cs - Application data contract → EF data context: implemented by
src/SistemaAlertas.Infrastructure/Persistence/AlertasDbContext.cs - EF data context → PostgreSQL + PostGIS: persists entities
README.md - Alert distribution → SMS queue worker: enqueues jobs
- SMS queue worker → SMS provider: sends SMS
- Versions API → Alert distribution: requests distribution