Admin Notificaciones
El sistema de notificaciones enruta alertas de eventos del sistema a los destinatarios correctos con la urgencia apropiada. Tres pestañas: reglas configuradas, horario de despacho y catálogo de eventos disponibles.
Clases de entrega (delivery_class)
Cada regla de notificación tiene una clase de entrega que determina cuándo y cómo se envía la notificación al destinatario:
| Clase | Código | Comportamiento | Cuándo usar |
|---|---|---|---|
| Urgente | urgente |
Envío inmediato en el momento del evento. No espera el resumen diario. | Eventos críticos: SLA vencido en QEM crítico, no conformidad crítica, falla de verificación CCM |
| Normal | normal |
Incluida en el email de resumen diario. Se agrupa con otras notificaciones del mismo período. | Eventos operacionales regulares: nuevo documento para aprobar, training asignado, CC en evaluación |
| Informativa | informativa |
Incluida en el resumen semanal. Para información de contexto sin urgencia. | Métricas de calidad, resúmenes de estado, recordatorios de bajo impacto |
Si no configurás una regla específica para un evento, el sistema usa la clase de entrega por defecto definida en el Catálogo de Eventos.
Tab Reglas configuradas
Lista todas las reglas de notificación activas e inactivas del sistema. Cada regla define qué hacer cuando ocurre un evento específico.
La tabla muestra por regla:
- Evento: tipo de evento del sistema (ej:
cdms:document_approved) - Clase de entrega (chip con color)
- Destino: rol (ej:
rol: qa, admin) o usuario específico - Módulo (qué módulo origina el evento)
- Estado: Activa / Inactiva
- Acciones: ✏️ editar · 🗑 eliminar
Filtros de la lista
Podés filtrar por: módulo (CDMS, CTR, TMS, CCM, QEM, AUM, Sistema), clase de entrega, estado (activas/inactivas/todas) y texto libre en el evento.
Crear o editar una regla
Hacé clic en el botón + Nueva regla o en el ícono ✏️ de una regla existente. El modal de creación/edición tiene:
| Campo | Descripción |
|---|---|
| Tipo de evento | Selector de todos los eventos disponibles del catálogo. Filtrá por módulo para encontrar el evento. Ej: ccm:cc_approved, qem:event_created. |
| Clase de entrega | Urgente / Normal / Informativa. El selector se pre-rellena con el default del catálogo al elegir el evento. |
| Tipo de destino | Rol: notifica a todos los usuarios activos con ese rol. Usuario: notifica a un usuario específico. |
| Roles | Solo si tipo destino = Rol. Checkboxes con los roles disponibles: admin, qa, tecnico, aprobador. Podés seleccionar varios. |
| Usuario | Solo si tipo destino = Usuario. Selector de usuarios activos del sistema. |
| Habilitada | Toggle. Las reglas deshabilitadas quedan en la lista pero no generan notificaciones. |
| Notas | Texto opcional para documentar el motivo de la regla o condiciones especiales. |
Verificar una regla existente
Al editar una regla ya guardada, aparece el botón Verificar regla. Llama a GET /admin/notification-rules/{id} y muestra el estado actual de la regla: si está activa, el evento, la clase de entrega y el destino. Útil para confirmar que la regla está configurada correctamente antes de que ocurra el evento.
Eliminar una regla
Hacé clic en 🗑 → aparece el diálogo de confirmación con el resumen de la regla (evento → delivery_class → destino). Confirmá para eliminar. La eliminación es inmediata e irreversible.
Tab Horario de despacho
Configura cuándo se envían los emails de resumen agrupados (clases Normal e Informativa). Las notificaciones Urgentes siempre se envían inmediatamente independientemente de este horario.
| Parámetro | Descripción |
|---|---|
| Hora del resumen diario (ART) | Hora y minuto en que se despacha el email de resumen con todas las notificaciones Normal del día. Ingresá en hora ART (el sistema convierte a UTC internamente). |
| Día del resumen semanal | Día de la semana para el resumen de notificaciones Informativas (0 = domingo, 1 = lunes, ... 5 = viernes). |
| Hora del resumen semanal (ART) | Hora de despacho del email semanal. |
Hacé los cambios en los campos numéricos y hacé clic en Guardar horario. Los cambios tienen efecto en el próximo ciclo del scheduler.
Tab Catálogo de eventos
El catálogo lista todos los tipos de evento del sistema que pueden disparar notificaciones. Es de solo lectura — los eventos están definidos en el código del sistema, no son configurables. Sirve como referencia para saber qué eventos existen y cuál es su delivery_class por defecto.
El catálogo muestra por evento:
- Módulo: CDMS, CTR, TMS, CCM, QEM, AUM, Sistema
- Código del evento: ej:
cdms:document_approved,qem:sla_exceeded - Descripción: qué ocurrió para generar este evento
- Delivery class por defecto: qué clase usa si no hay regla personalizada configurada
Usá el catálogo para identificar el código exacto del evento que necesitás configurar antes de crear una nueva regla.
Flujo recomendado para configurar notificaciones: (1) consultá el catálogo para identificar el evento correcto, (2) notá el delivery_class por defecto, (3) si necesitás cambiar destinatarios o urgencia, creá o editá la regla correspondiente en el Tab Reglas.