Alarmas y notificaciones

Una alarma avisa que algo en la máquina necesita atención: una lectura fuera de rango, una bomba sin flujo, un canal de dosificación tapado. La máquina la levanta sola; las personas la reconocen ("ya la vi") y la resuelven ("ya está atendida").

Ciclo de una alarma

flowchart LR
  A["Activa"] -- ACK --> R["Reconocida"]
  R -- Resolver --> S["Resuelta"]
  A -- "Silenciar 30 min" --> P["Silenciada"]
  P -- "a los 30 min" --> A

Estado	Significa	Quién lo cambia
Activa	Ocurrió y nadie la ha atendido.	La máquina la levanta.
Reconocida	Alguien la vio y se está ocupando.	Una persona (ACK).
Resuelta	Atendida.	Una persona (Resolver).
Silenciada	Alguien la apartó 30 minutos (App o Console). Al vencer el plazo vuelve a activa sola.	Una persona.

Lo importante:

• La máquina nunca cierra una alarma sola, aunque la condición ya se haya corregido. Hay que resolverla.
• Si la condición vuelve a ocurrir y la alarma ya estaba reconocida, resuelta o silenciada, aparece una alarma activa nueva. Además, una silenciada vuelve a activa ella sola cuando se cumplen los 30 minutos.
• Severidades: Crítica (requiere atención inmediata; envía notificación al teléfono), Advertencia e Informativa.

Quién puede atender alarmas

Operador, agrónomo y administrador. Técnico y visor las ven, pero no pueden cambiarlas: la Console y la App les muestran la lista de solo consulta, sin botones de ACK, Resolver ni Silenciar.

En la Console

Alarmas en el menú.

1. Arriba, cuatro tarjetas: Críticas activas, Warnings activas, Info activas y En vivo (la lista se actualiza sola cuando llega una alarma).
2. Filtra por estado (1): activas (por omisión), reconocidas, resueltas o todas; por severidad y por máquina.
3. En una alarma activa toca ACK (2) para reconocerla. La fila pasa a reconocida.
4. Cuando la hayas atendido, toca Resolver.

5. El ojo (3) abre su Bitácora: cuándo se levantó, se reconoció, se silenció y se resolvió, y quién hizo cada cosa.

   

Reglas (4) abre las reglas de umbral (abajo).

Una alarma que no se deja resolver

La alarma No se está detectando el flujo en la línea principal no se puede resolver mientras siga activo el desbloqueo de dosificación sin flujo: la máquina la vuelve a abrir cada 10 minutos. Revoca el desbloqueo desde el detalle de la máquina (ver Desbloquear la dosificación sin flujo).

1. Silenciar 30 min aparta la alarma media hora, como en la App; el filtro de estado incluye silenciadas. Exportar CSV descarga la lista tal como está filtrada. Si un ACK, Resolver o Silenciar falla (permisos, servidor), el error aparece en la propia fila.

Si dos personas atienden la misma alarma a la vez, la segunda verá vN en servidor — refresco y la lista se recarga con el estado nuevo.

En la App

Pestaña Alarmas. Arriba dice cuántas hay activas y reconocidas; el botón de ajustes filtra por severidad.

• Desliza a la izquierda una alarma activa para reconocerla (ACK) o una reconocida para Resolver.
• Desliza a la derecha para Silenciar 30 min.

Verás Alarma reconocida, Alarma resuelta o Silenciada 30 min. Al tocar una notificación, la App abre esta pantalla filtrada a esa máquina. Abajo, Resueltas y silenciadas junta las que ya no están activas. Con rol técnico o visor no hay deslizamiento: la lista avisa Solo lectura: tu rol no puede atender alarmas.

En el kiosco

El tablero muestra Alarmas activas de esa máquina con su texto y su código. Es solo lectura: se reconocen en la App o la Console.

Reglas de umbral

Además de las alarmas fijas de la máquina, puedes crear las tuyas: "si el drenaje de la charola T02 baja de 15 %, avisa".

Antes de empezar

• Dónde: Console → Alarmas → Reglas.
• Quién: operador, agrónomo o administrador.

1. Toca Nueva regla.

2. Llena el formulario:

   Campo	Qué poner
   Máquina	La máquina que vigila.
   Code	Un nombre corto sin espacios: drenaje_bajo_z03. Es el código de la alarma.
   Variable	La lectura a vigilar: ph_in, ec_in_ms_cm, drainage_pct_T02... (pide a soporte la lista de tu máquina).
   Operador	< (menor que), ≤, >, ≥ o fuera de [min, max].
   Valor / Valor alto	El umbral; con fuera de, el mínimo y el máximo.
   Severidad	Info, Advertencia o Crítica (solo las críticas mandan notificación).
   Habilitada	Marcada para que funcione.
   Mensaje (plantilla)	El texto de la alarma. Usa {value} (lectura), {threshold} (umbral) y {high} (máximo).

   

3. Toca Crear (1). La regla llega a la máquina en segundos.

Editar cambia una regla; la papelera la borra (pide confirmación).

Guardar reglas vuelve a disparar las alarmas

Cada vez que guardas una regla, la máquina recarga todas las de esa máquina y las alarmas cuya condición siga presente vuelven a aparecer. Es normal.

Si el servidor rechaza la regla verás un mensaje en inglés, por ejemplo op=outside requires value_high (falta el valor alto) o threshold ... already exists (ese código ya existe en la máquina).

Notificaciones en el teléfono

Aviso	Cuándo llega	Se apaga en
Alarmas críticas	Una alarma de severidad crítica.	App → Yo → Qué avisos recibir
Receta terminada	Un riego terminó bien.	Ídem
Control manual en el kiosco	Alguien opera la máquina a mano.	Ídem

• Las notificaciones llegan a los teléfonos con la App y avisos activados de las personas que tienen esa máquina asignada (los administradores las reciben de todas las máquinas; ver Usuarios y permisos).
• Por privacidad, la notificación no trae detalles: dice Alarma crítica / Abre la app para ver el detalle (Android) o Nueva alarma · toca para ver (iPhone). Tócala para ver la alarma.
• No hay horario de silencio: si apagas Alarmas críticas, deja de llegarte a cualquier hora (por eso pide confirmación).
• Para activar los avisos en tu teléfono y revisar los dispositivos, ver Cuenta y ajustes.

Catálogo de alarmas

Agua y sensores

Alarma	Qué pasó	Qué hacer
ph_out_of_range pH fuera de rango	El pH está fuera del rango de la regla (de fábrica 5.0–7.5).	Revisa consignas, tanque de ácido y calibración de la sonda.
ec_sensor_drift	La CE salió de su rango (de fábrica 0.3–4.0 mS/cm).	Revisa la sonda de CE y los tanques de nutrientes.
sensor_stale.<variable> Sensor sin datos	Una sonda dejó de reportar.	Revisa cable y alimentación de la sonda.

Flujo y bombas

Alarma	Qué pasó	Qué hacer
pump_no_flow	Las bombas arrancaron y no se detectó flujo.	Revisa válvula de sector cerrada, succión sin agua o el sensor de flujo.
main_flow_without_irrigation	Hay flujo sin riego mandado.	Posible fuga, válvula abierta a mano o sensor con ruido. Mientras, no se dosifica.
main_flow_out_of_range	El caudalímetro marca más que su máximo; la lectura se descarta.	Revisa el sensor y su calibración.
main_flow_unverified	Está activo el desbloqueo de dosificación sin flujo (se repite cada 10 min).	Revócalo en cuanto el sensor vuelva a detectar flujo.
flow_loop_no_flow.<inyector> (crítica)	Un canal de dosificación abierto sin caudal; se cerró.	Tanque vacío, Venturi tapado o válvula manual cerrada.
flow_loop_flow_while_closed.<inyector>	Caudal en un canal con la válvula cerrada.	Posible fuga, sifón o sensor con ruido.
flow_loop_out_of_range.<inyector>	El caudalímetro del canal marca más que su máximo.	Revisa el sensor del canal.

Dosificación (canales en dosis fija)

Alarma	Qué pasó	Qué hacer
dose_below_min.<inyector>	La dosis es tan baja que no se puede medir: el canal no dosifica.	Sube la dosis o revisa el caudal de riego.
dose_clamped_max.<inyector>	La dosis se recortó al máximo del inyector.	Baja la dosis o usa otro inyector.
dose_no_main_flow_rate.<inyector>	Dosis en L/m³ sin caudal principal: el canal no dosifica.	Revisa el caudalímetro principal.
dose_estimated_main_flow	La concentración se estima con el caudal nominal.	Verifica pH y CE con más frecuencia.

Tarjetas, energía y sistema

Alarma	Qué pasó	Qué hacer
machine_offline (crítica)	La nube dejó de recibir reportes de la máquina por más de 10 min (la levanta la nube, no la máquina). Se resuelve sola cuando vuelve a reportar y llega el aviso «Máquina en línea de nuevo».	Revisa la luz del equipo y su internet (Wi-Fi o módem LTE: señal y saldo de la SIM).
iom_bus_noise	Ruido en el bus de las tarjetas al conmutar cargas.	Técnico: supresores RC en bobinas, cable del bus separado de potencia.
edge_unexpected_reboot (crítica)	El controlador se reinició sin apagado ordenado.	Casi siempre es la alimentación: revisa la fuente (5 V, 3 A) y los cortes de luz.
schedule_missed.<horario>	Un riego programado no se hizo; el texto dice la hora y el detalle el motivo (máquina apagada, válvula ocupada...).	Revisa el horario y, si hace falta, lanza el riego a mano. Ver Programación.
safe_mode_engaged (crítica)	La máquina entró en modo seguro.	Ver Modo seguro.

Las alarmas de tus reglas de umbral usan el código y el mensaje que tú definiste.