# diazperillaj/sistema-monitoreo architecture

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

- Interactive diagram: https://gitdiagram.com/diazperillaj/sistema-monitoreo
- Repository: https://github.com/diazperillaj/sistema-monitoreo

## Overview

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: [`backend/app/services/procesador.py`](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/procesador.py) (Procesador de eventos), [`frontend/src/api/consultas.ts`](https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/api/consultas.ts) (Consultas API), [`backend/app/db.py`](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/db.py) (PostgreSQL), [`backend/app/services/mqtt_ingesta.py`](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/mqtt_ingesta.py) (Ingesta MQTT)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Aplicación web"]
  node_webapp["Interfaz y rutas<br/>[main.tsx]"]
  node_views["Vistas del hogar"]
  node_webapi["Cliente HTTP<br/>[cliente.ts]"]
  node_queries["Consultas API<br/>[consultas.ts]"]
  node_livehook["Estado en vivo<br/>[useCasaEnVivo.ts]"]
  node_commandhook["Seguimiento comandos"]
end

subgraph group_api["API y dominio"]
  node_fastapi["Aplicación FastAPI<br/>[main.py]"]
  node_authapi["Autenticación y sesiones<br/>[auth.py]"]
  node_authsvc["Sesiones y permisos<br/>[auth.py]"]
  node_domainapi["Casas y operaciones"]
end

subgraph group_realtime["Tiempo real y avisos"]
  node_processor["Procesador de eventos<br/>[procesador.py]"]
  node_mqttingest["Ingesta MQTT<br/>[mqtt_ingesta.py]"]
  node_mqttstate["Conexión MQTT<br/>[mqtt_cliente.py]"]
  node_wshub["Distribución WebSocket<br/>[ws_hub.py]"]
  node_notifier["Avisos y Web Push<br/>[notificador.py]"]
end

subgraph group_data["Persistencia"]
  node_postgres[("PostgreSQL<br/>[db.py]")]
  node_models["Modelos de dominio<br/>[models.py]"]
end

subgraph group_devices["Dispositivos"]
  node_central["Central de puerta<br/>[app_web.h]"]
  node_nodes["Nodos ESP32<br/>[nodo_espnow.h]"]
end

node_user(("Usuario"))
node_broker["Broker MQTT"]

node_user -->|"usa"| node_webapp
node_webapp -->|"navega"| node_views
node_views -.->|"consulta"| node_queries
node_queries -->|"ejecuta solicitudes"| node_webapi
node_webapi -->|"llama API"| node_fastapi
node_livehook -->|"obtiene estado"| node_queries
node_commandhook -->|"envía y sigue"| node_queries
node_fastapi -->|"registra rutas"| node_authapi
node_fastapi -->|"registra rutas"| node_domainapi
node_authapi -->|"usa sesión"| node_authsvc
node_authapi -->|"consulta y modifica"| node_postgres
node_authsvc -->|"consulta sesión"| node_postgres
node_mqttingest -->|"suscribe mensajes"| node_broker
node_mqttingest -->|"despacha mensajes"| node_processor
node_mqttingest -->|"actualiza conexión"| node_mqttstate
node_processor -.->|"distribuye eventos"| node_wshub
node_processor -.->|"genera avisos"| node_notifier
node_processor -.->|"persiste eventos"| node_postgres
node_models -.->|"representa datos"| node_postgres
node_central -.->|"publica estado"| node_broker
node_nodes -.->|"reporta sensores"| node_central

click node_webapp "https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/main.tsx"
click node_views "https://github.com/diazperillaj/sistema-monitoreo/tree/main/frontend/src/vistas"
click node_webapi "https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/api/cliente.ts"
click node_queries "https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/api/consultas.ts"
click node_livehook "https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/tiempo-real/useCasaEnVivo.ts"
click node_commandhook "https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/tiempo-real/useComandoEnCurso.ts"
click node_fastapi "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/main.py"
click node_authapi "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/api/auth.py"
click node_authsvc "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/auth.py"
click node_domainapi "https://github.com/diazperillaj/sistema-monitoreo/tree/main/backend/app/api"
click node_processor "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/procesador.py"
click node_mqttingest "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/mqtt_ingesta.py"
click node_mqttstate "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/mqtt_cliente.py"
click node_wshub "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/ws_hub.py"
click node_notifier "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/notificador.py"
click node_postgres "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/db.py"
click node_models "https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/models.py"
click node_central "https://github.com/diazperillaj/sistema-monitoreo/blob/main/firmware/gateway_puerta/app_web.h"
click node_nodes "https://github.com/diazperillaj/sistema-monitoreo/blob/main/firmware/nodo_bano/nodo_espnow.h"

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_webapp,node_views,node_webapi,node_queries,node_livehook,node_commandhook toneBlue
class node_fastapi,node_authapi,node_authsvc,node_domainapi toneAmber
class node_processor,node_mqttingest,node_mqttstate,node_wshub,node_notifier toneMint
class node_postgres,node_models toneRose
class node_central,node_nodes,node_user,node_broker toneIndigo
```

## Components

### Aplicación web

- [Interfaz y rutas](https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/main.tsx): `frontend/src/main.tsx`
- [Vistas del hogar](https://github.com/diazperillaj/sistema-monitoreo/tree/main/frontend/src/vistas): `frontend/src/vistas`
- [Cliente HTTP](https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/api/cliente.ts): `frontend/src/api/cliente.ts`
- [Consultas API](https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/api/consultas.ts): `frontend/src/api/consultas.ts`
- [Estado en vivo](https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/tiempo-real/useCasaEnVivo.ts): `frontend/src/tiempo-real/useCasaEnVivo.ts`
- [Seguimiento comandos](https://github.com/diazperillaj/sistema-monitoreo/blob/main/frontend/src/tiempo-real/useComandoEnCurso.ts): `frontend/src/tiempo-real/useComandoEnCurso.ts`

### API y dominio

- [Aplicación FastAPI](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/main.py): `backend/app/main.py`
- [Autenticación y sesiones](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/api/auth.py): `backend/app/api/auth.py`
- [Sesiones y permisos](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/auth.py): `backend/app/services/auth.py`
- [Casas y operaciones](https://github.com/diazperillaj/sistema-monitoreo/tree/main/backend/app/api): `backend/app/api`

### Tiempo real y avisos

- [Procesador de eventos](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/procesador.py): `backend/app/services/procesador.py`
- [Ingesta MQTT](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/mqtt_ingesta.py): `backend/app/services/mqtt_ingesta.py`
- [Conexión MQTT](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/mqtt_cliente.py): `backend/app/services/mqtt_cliente.py`
- [Distribución WebSocket](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/ws_hub.py): `backend/app/services/ws_hub.py`
- [Avisos y Web Push](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/services/notificador.py): `backend/app/services/notificador.py`

### Persistencia

- [PostgreSQL](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/db.py): `backend/app/db.py`
- [Modelos de dominio](https://github.com/diazperillaj/sistema-monitoreo/blob/main/backend/app/models.py): `backend/app/models.py`

### Dispositivos

- [Central de puerta](https://github.com/diazperillaj/sistema-monitoreo/blob/main/firmware/gateway_puerta/app_web.h): `firmware/gateway_puerta/app_web.h`
- [Nodos ESP32](https://github.com/diazperillaj/sistema-monitoreo/blob/main/firmware/nodo_bano/nodo_espnow.h): `firmware/nodo_bano/nodo_espnow.h`

### Other components

- **Usuario**
- **Broker MQTT**

## Connections

- Usuario → Interfaz y rutas: usa (evidence: `README.md`)
- Interfaz y rutas → Vistas del hogar: navega (evidence: `frontend/src/main.tsx`)
- Vistas del hogar → Consultas API: consulta
- Consultas API → Cliente HTTP: ejecuta solicitudes (evidence: `frontend/src/api/consultas.ts`)
- Cliente HTTP → Aplicación FastAPI: llama API (evidence: `README.md`)
- Estado en vivo → Consultas API: obtiene estado (evidence: `frontend/src/tiempo-real/useCasaEnVivo.ts`)
- Seguimiento comandos → Consultas API: envía y sigue (evidence: `frontend/src/tiempo-real/useComandoEnCurso.ts`)
- Aplicación FastAPI → Autenticación y sesiones: registra rutas (evidence: `backend/app/main.py`)
- Aplicación FastAPI → Casas y operaciones: registra rutas (evidence: `backend/app/main.py`)
- Autenticación y sesiones → Sesiones y permisos: usa sesión (evidence: `backend/app/api/auth.py`)
- Autenticación y sesiones → PostgreSQL: consulta y modifica (evidence: `backend/app/api/auth.py`)
- Sesiones y permisos → PostgreSQL: consulta sesión (evidence: `backend/app/services/auth.py`)
- Ingesta MQTT → Broker MQTT: suscribe mensajes (evidence: `backend/app/services/mqtt_ingesta.py`)
- Ingesta MQTT → Procesador de eventos: despacha mensajes (evidence: `backend/app/services/mqtt_ingesta.py`)
- Ingesta MQTT → Conexión MQTT: actualiza conexión (evidence: `backend/app/services/mqtt_ingesta.py`)
- Procesador de eventos → Distribución WebSocket: distribuye eventos (evidence: `backend/app/services/procesador.py`)
- Procesador de eventos → Avisos y Web Push: genera avisos (evidence: `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
