How diazperillaj/sistema-monitoreo works
Alarma hogar es un sistema de monitoreo doméstico: usuarios consultan casas, estado, alarmas e historial, y envían comandos desde la web; centrales ESP32 reportan por MQTT y el backend distribuye actualizaciones por WebSocket. El backend también ofrece autenticación, membresía, configuración, invitaciones y notificaciones. Se muestran las principales etapas y límites del sistema. Las conexiones entre frontend y API, y entre firmware y broker, siguen la documentación; varias relaciones internas de módulos no muestreados se omiten para evitar inferir llamadas.
Main entry points: procesador.py Procesador de eventos · consultas.ts Consultas API · db.py PostgreSQL · mqtt_ingesta.py Ingesta MQTT
Components 21
Aplicación web
- Interfaz y rutas
frontend/src/main.tsx - Vistas del hogar
frontend/src/vistas - Cliente HTTP
frontend/src/api/cliente.ts - Consultas API
frontend/src/api/consultas.ts - Estado en vivo
frontend/src/tiempo-real/useCasaEnVivo.ts - Seguimiento comandos
frontend/src/tiempo-real/useComandoEnCurso.ts
API y dominio
- Aplicación FastAPI
backend/app/main.py - Autenticación y sesiones
backend/app/api/auth.py - Sesiones y permisos
backend/app/services/auth.py - Casas y operaciones
backend/app/api
Tiempo real y avisos
- Procesador de eventos
backend/app/services/procesador.py - Ingesta MQTT
backend/app/services/mqtt_ingesta.py - Conexión MQTT
backend/app/services/mqtt_cliente.py - Distribución WebSocket
backend/app/services/ws_hub.py - Avisos y Web Push
backend/app/services/notificador.py
Persistencia
- PostgreSQL
backend/app/db.py - Modelos de dominio
backend/app/models.py
Dispositivos
- Central de puerta
firmware/gateway_puerta/app_web.h - Nodos ESP32
firmware/nodo_bano/nodo_espnow.h
Other components
- Usuario
- Broker MQTT
Connections 21
- Usuario → Interfaz y rutas: usa
README.md - Interfaz y rutas → Vistas del hogar: navega
frontend/src/main.tsx - Vistas del hogar → Consultas API: consulta
- Consultas API → Cliente HTTP: ejecuta solicitudes
frontend/src/api/consultas.ts - Cliente HTTP → Aplicación FastAPI: llama API
README.md - Estado en vivo → Consultas API: obtiene estado
frontend/src/tiempo-real/useCasaEnVivo.ts - Seguimiento comandos → Consultas API: envía y sigue
frontend/src/tiempo-real/useComandoEnCurso.ts - Aplicación FastAPI → Autenticación y sesiones: registra rutas
backend/app/main.py - Aplicación FastAPI → Casas y operaciones: registra rutas
backend/app/main.py - Autenticación y sesiones → Sesiones y permisos: usa sesión
backend/app/api/auth.py - Autenticación y sesiones → PostgreSQL: consulta y modifica
backend/app/api/auth.py - Sesiones y permisos → PostgreSQL: consulta sesión
backend/app/services/auth.py - Ingesta MQTT → Broker MQTT: suscribe mensajes
backend/app/services/mqtt_ingesta.py - Ingesta MQTT → Procesador de eventos: despacha mensajes
backend/app/services/mqtt_ingesta.py - Ingesta MQTT → Conexión MQTT: actualiza conexión
backend/app/services/mqtt_ingesta.py - Procesador de eventos → Distribución WebSocket: distribuye eventos
backend/app/services/procesador.py - Procesador de eventos → Avisos y Web Push: genera avisos
backend/app/services/procesador.py - Procesador de eventos → PostgreSQL: persiste eventos
- Modelos de dominio → PostgreSQL: representa datos
- Central de puerta → Broker MQTT: publica estado
- Nodos ESP32 → Central de puerta: reporta sensores