Alertas y notificaciones

Reglas de umbral

Se definen por tipo de dispositivo en el catálogo (ROOT): campo de telemetría, condición (>, ≥, <, ≤), umbral y severidad (warning / critical). La ingesta las evalúa con cada lectura.

Ciclo de vida

lectura incumple → ACTIVE ──(usuario)──► ACKED
        │                        │
        └── lectura vuelve a rango ──► RESOLVED

• Mientras siga incumpliendo, la alerta abierta se actualiza (no se duplica).
• Una alerta reconocida (ACKED) no vuelve a ACTIVE: si el valor se normaliza y reincide, se abre una alerta nueva.

API

Endpoint	Uso
GET /v1/alerts?state=ACTIVE&severity=critical	Listado scoped, orden por fecha
POST /v1/alerts/:id/ack	Reconocer una alerta activa
GET /v1/alerts/summary	Contadores para badges ({active, critical, warning})
PUT /v1/device-models/:id/alert-rules	Sustituir las reglas del tipo (ROOT)

Notificaciones por email

Cada usuario configura sus reglas en Notificaciones:

• Alerta generada (alert.raised) — opcionalmente solo críticas.
• Solicitud de vinculación (binding.requested, solo ROOT) — incluye el ICC de la SIM para su activación en la plataforma del operador.

Los avisos se registran en un historial (outbox) y se envían con la plantilla corporativa. Además se envían correos transaccionales automáticos: bienvenida al registrarse, vinculación aprobada, cambio de contraseña y PIN de la verificación en dos pasos.