Notificaciones — Sistema de alertas, avisos de liderazgo y comunicados

Tema: Módulo de notificaciones — Alertas automáticas al líder, avisos de eventos de liderazgo y comunicados masivos
Idioma: ES

Resumen en pocas palabras

El sistema de notificaciones cubre tres frentes. Primero, avisa automáticamente al líder directo cuando alguno de sus colaboradores tiene una dimensión del eMap por debajo del umbral esperado, o lleva más de tres semanas sin completar una sesión de Brun-E. Segundo, notifica a los usuarios sobre los eventos de su actividad de liderazgo (solicitudes, invitaciones, transferencias, aceptaciones, rechazos y desvinculaciones). Tercero, permite a un administrador de plataforma enviar comunicados masivos dirigidos. El aviso llega por dos canales: un badge en la aplicación con un panel de detalle, y —según el caso— un email directo. Las notificaciones personales persisten hasta que el usuario las descarta manualmente, y cada alerta de líder lleva un acceso directo a la vista del colaborador en cuestión.

Objetivo de negocio

Que los líderes estén informados de forma proactiva cuando algún colaborador necesita atención, sin tener que revisar activamente el eMap de cada persona. El sistema detecta condiciones relevantes de manera automática y las pone en conocimiento del líder por los canales que ya usa, reduciendo el riesgo de que situaciones importantes pasen desapercibidas.

Contexto y alcance

Qué está incluido

Detección automática diaria de dos condiciones de alerta por colaborador (eMap bajo e inactividad Brun-E)
Notificaciones de eventos de liderazgo dirigidas al usuario involucrado (solicitud, invitación, transferencia, aceptación, rechazo, desvinculación)
Comunicados masivos (broadcasts) emitidos por un administrador de plataforma, con alcance configurable y opción de envío por email
Notificación in-app: badge con contador en el navbar + panel con lista de notificaciones activas
Notificación por email al líder cuando se genera una nueva alerta, y por email opcional a los destinatarios de un comunicado masivo
Descarte manual de notificaciones
Navegación directa desde cada alerta de líder a la vista del colaborador en el eMap grupal
Alertas de líder solo para líderes directos (relación leader_id establecida en el módulo de Liderazgo)

Qué no está incluido en este documento

Configuración de preferencias por parte del usuario (activar/desactivar tipos de alerta o canal)
Notificaciones push (mobile o browser push)
Limpieza automática de notificaciones al cambiar de líder (fase posterior)
La lógica del eMap individual o grupal (ver 13-e-map-individual.md y 14-e-map-grupal.md)
La lógica de sesiones de Brun-E (ver 12-brun-e-sesiones-voz.md)
La lógica de las relaciones de liderazgo que disparan estos avisos (ver 15-liderazgo.md)

Actores

Actor	Qué hace
Líder	Usuario con al menos un colaborador asignado (`is_leader: true`). Recibe las alertas in-app y por email sobre sus colaboradores. Descarta notificaciones manualmente. Navega al perfil del colaborador desde la alerta.
Colaborador	Usuario con un líder directo asignado. Su actividad (eMap y sesiones Brun-E) es evaluada automáticamente cada día. No interactúa directamente con este módulo.
Usuario	Cualquier persona de la organización. Recibe notificaciones in-app por los eventos de liderazgo que le involucran y por los comunicados masivos que le alcanzan.
Administrador de plataforma (SUPER_ADMIN)	Emite comunicados masivos, define su alcance (global o a organizaciones específicas), elige si se envían también por email, consulta el historial y revoca comunicados.
Sistema (backend)	Evalúa diariamente las condiciones de alerta para todos los colaboradores con líder asignado, genera las notificaciones de eventos de liderazgo, distribuye los comunicados masivos y envía los emails correspondientes.

Tipos de notificación

Alertas automáticas al líder

Tipo	Condición de disparo	Descripción para el líder
eMap bajo	Alguna dimensión del último eMap registrado del colaborador tiene un valor ≤ 6 sobre una escala de 1 a 10	Una dimensión emocional del colaborador está por debajo del umbral esperado
Inactividad Brun-E	El colaborador no completó ninguna sesión de Brun-E en más de 21 días, o nunca completó una	El colaborador lleva más de tres semanas sin realizar una sesión con el coach de IA

Notificaciones de eventos de liderazgo

Dirigidas al usuario involucrado en cada evento del módulo de Liderazgo. No dependen de la relación líder-colaborador ni de la evaluación diaria: se generan en el momento en que ocurre el evento.

Tipo	Cuándo se genera	Quién la recibe
Solicitud recibida	Alguien pide a esta persona que sea su líder	El destinatario de la solicitud
Invitación recibida	Alguien invita a esta persona a ser su liderado	El destinatario de la invitación
Transferencia recibida	Un usuario solicita transferir su liderazgo hacia esta persona	El nuevo líder propuesto
Solicitud aceptada	La persona a quien se le envió una solicitud o invitación la aceptó	Quien había enviado la solicitud
Solicitud rechazada	La persona a quien se le envió una solicitud o invitación la rechazó	Quien había enviado la solicitud
Desvinculación	Se disuelve una relación de liderazgo (por desvinculación directa o por transferencia aceptada que rompe el vínculo anterior)	La contraparte de la relación disuelta

Comunicados masivos (broadcasts)

Mensajes emitidos por un administrador de plataforma hacia un conjunto de destinatarios. Aparecen en el panel de notificaciones de cada usuario alcanzado durante una ventana de tiempo, y opcionalmente se envían también por email. Ver los casos de uso CU-6 a CU-8.

Casos de uso

CU-1 Recibir notificación in-app

Cuando el sistema detecta una condición de alerta para un colaborador del líder, aparece un badge con el conteo de alertas activas sobre el ícono de campana en el navbar. El badge se actualiza de forma automática mientras el líder navega por la aplicación.

CU-2 Ver el panel de notificaciones

El líder hace click sobre el ícono de campana y se abre un panel con la lista de sus notificaciones activas. Para cada una ve el nombre del colaborador, el tipo de alerta y el tiempo transcurrido desde que fue detectada.

CU-3 Navegar al colaborador desde la notificación

Desde cualquier notificación en el panel, el líder puede hacer click para ir directamente a la vista del eMap grupal con ese colaborador destacado. La notificación no se descarta automáticamente al navegar.

CU-4 Descartar una notificación

El líder puede descartar una notificación desde el panel usando el botón de descarte de cada ítem. Al descartarla, desaparece del panel y el contador del badge se actualiza. La notificación descartada queda guardada como historial pero ya no se muestra como activa.

CU-5 Recibir alerta por email

Cuando el sistema genera una nueva alerta de líder (eMap bajo o inactividad Brun-E), le envía al líder un email con el nombre del colaborador y el tipo de alerta detectada. El email no incluye un link de acción en esta fase.

CU-6 Recibir notificación de un evento de liderazgo

Cuando ocurre un evento de liderazgo que involucra al usuario (recibe una solicitud, invitación o transferencia; su solicitud es aceptada o rechazada; se disuelve una relación), aparece una notificación in-app en su panel indicando el evento y la persona involucrada. Estas notificaciones son in-app; no se envían por email.

CU-7 Enviar un comunicado masivo

Un administrador de plataforma (SUPER_ADMIN) redacta un comunicado con título y mensaje, define su alcance —global (todos los usuarios activos de la plataforma) o dirigido a organizaciones específicas— y elige si además se envía por email a los destinatarios. Al confirmarlo, el comunicado queda distribuido a todos los usuarios alcanzados.

CU-8 Consultar historial y revocar comunicados

El administrador de plataforma puede consultar el historial de comunicados emitidos y revocar cualquiera de ellos. Un comunicado revocado deja de mostrarse en el panel de los usuarios.

CU-9 Ver y descartar un comunicado masivo

El usuario ve los comunicados vigentes que le alcanzan dentro de su panel de notificaciones, junto con sus notificaciones personales. Puede descartar un comunicado individualmente; al hacerlo desaparece de su panel sin afectar a los demás usuarios.

Reglas de negocio

R-1.1 Solo los líderes directos reciben notificaciones

Las notificaciones se generan únicamente para el usuario que tiene asignado al colaborador como leader_id. No se notifica a otras personas de la organización ni a administradores.

R-1.2 Solo colaboradores con líder asignado son evaluados

El sistema evalúa únicamente a los usuarios que tienen un líder directo activo. Si un usuario no tiene líder asignado, no genera notificaciones aunque cumpla las condiciones de alerta.

R-1.3 No se generan notificaciones duplicadas activas

Si ya existe una notificación activa (no descartada) del mismo tipo para el mismo par líder-colaborador, el sistema no crea otra hasta que la existente sea descartada.

R-1.4 El email se envía una sola vez por notificación nueva

El email se envía únicamente cuando se crea una nueva notificación. Si la condición de alerta persiste varios días sin que el líder descarte la notificación, no se reenvía el email.

R-1.5 El descarte es manual y definitivo para esa instancia

El líder descarta cada notificación de forma explícita. Si la condición de alerta desaparece (el colaborador registra un eMap con valores normales o completa una sesión Brun-E), la notificación activa no desaparece sola: queda hasta que el líder la descarte.

R-1.6 Una notificación descartada puede regenerarse si la condición persiste

Al descartar una notificación, si la condición de alerta sigue presente en el siguiente ciclo de evaluación diaria, el sistema genera una nueva notificación. El ciclo de detección se reanuda desde cero.

R-1.7 El badge solo es visible para líderes

El ícono de campana y su badge solo se muestran a los usuarios que tienen el flag is_leader activo. Los usuarios sin colaboradores asignados no ven este elemento en el navbar.

R-1.8 El umbral del eMap se evalúa sobre el último registro disponible

Se considera el eMap más reciente del colaborador. Si el colaborador nunca registró un eMap, no se genera alerta de este tipo.

R-1.9 La inactividad de Brun-E se mide sobre sesiones completadas

Solo se considera una sesión completada si el colaborador finalizó el flujo completo de Brun-E. Las sesiones iniciadas pero no terminadas no cuentan.

R-1.10 Las notificaciones de liderazgo se dirigen solo a la persona involucrada

Cada notificación de evento de liderazgo se genera para el usuario directamente afectado por el evento (quien recibe la solicitud, quien la envió, o la contraparte de una relación disuelta). No se notifica a terceros.

R-1.11 Las notificaciones de liderazgo son in-app

Los eventos de liderazgo se comunican únicamente por el panel in-app. No generan email en esta fase.

R-1.12 Un comunicado masivo requiere un alcance válido

Si el alcance es "organizaciones específicas", debe indicarse al menos una organización; de lo contrario el sistema rechaza la creación. Si el alcance es "global", el comunicado llega a todos los usuarios activos de la plataforma.

R-1.13 Solo un administrador de plataforma emite y revoca comunicados

La creación, el listado del historial y la revocación de comunicados masivos están restringidos al rol SUPER_ADMIN.

R-1.14 El email de un comunicado es opcional y se envía una sola vez

El envío por email de un comunicado es una opción que elige el emisor al crearlo. Cuando está activa, el email se envía una única vez a los destinatarios activos alcanzados por el comunicado; no se reenvía luego.

R-1.15 Los comunicados se muestran dentro de una ventana de tiempo y el descarte es por usuario

Cada usuario ve los comunicados vigentes que le alcanzan dentro de una ventana reciente. El descarte de un comunicado afecta solo al usuario que lo descarta; los demás destinatarios lo siguen viendo. Un comunicado revocado por el administrador deja de mostrarse a todos.

Validaciones y mensajes al usuario

Sin notificaciones activas: El panel muestra un mensaje indicando que no hay alertas activas en este momento.
Usuario que no es líder: No ve el ícono de campana ni puede acceder al panel de notificaciones.
Notificación ya descartada: No puede descartarse dos veces; el sistema ignora solicitudes duplicadas de descarte.

Criterios de aceptación

AC-1 Badge visible con conteo correcto

Un líder con notificaciones activas ve el badge sobre el ícono de campana con el número exacto de alertas no descartadas. Un líder sin notificaciones activas ve el ícono sin badge.

AC-2 Panel con lista de alertas

Al abrir el panel, el líder ve cada alerta activa con: nombre del colaborador, tipo de alerta (eMap bajo / Inactividad Brun-E) y tiempo transcurrido desde la detección.

AC-3 Navegación al colaborador

Al hacer click sobre una notificación (fuera del botón de descarte), el líder es llevado a la vista del eMap grupal con ese colaborador destacado. La notificación sigue activa hasta que la descarte.

AC-4 Descarte manual

Al presionar el botón de descarte de una notificación, esta desaparece del panel y el contador del badge se reduce en uno. Si era la última, el badge desaparece.

AC-5 Email al generar una nueva alerta

El líder recibe un email cada vez que el sistema genera una nueva notificación para uno de sus colaboradores. El email indica el nombre del colaborador y el tipo de alerta.

AC-6 Sin duplicados activos

Si el líder ya tiene una notificación activa del tipo "eMap bajo" para un colaborador, el sistema no genera otra del mismo tipo para ese mismo colaborador hasta que la existente sea descartada.

AC-7 No visible para no-líderes

Un usuario sin colaboradores asignados no ve el ícono de campana ni puede acceder al panel de notificaciones.

AC-8 Regeneración tras descarte

Si el líder descarta una notificación y la condición de alerta sigue presente al día siguiente, el sistema genera una nueva notificación y envía un nuevo email.

AC-9 Notificación de evento de liderazgo

Cuando ocurre un evento de liderazgo que involucra a un usuario, este ve en su panel una notificación in-app del tipo correspondiente (solicitud, invitación, transferencia, aceptación, rechazo o desvinculación) con la persona involucrada.

AC-10 Comunicado masivo distribuido según alcance

Un administrador de plataforma crea un comunicado global y todos los usuarios activos lo ven en su panel; si el alcance es a organizaciones específicas, solo los usuarios de esas organizaciones lo ven. Un comunicado con alcance "organizaciones" sin ninguna organización indicada es rechazado.

AC-11 Email opcional de comunicado

Si el emisor marca el envío por email, los destinatarios activos reciben un email una sola vez con el título y el mensaje. Si no lo marca, no se envía email.

AC-12 Revocar y descartar comunicado

Un comunicado revocado por el administrador desaparece del panel de todos los usuarios. El descarte de un comunicado por un usuario lo quita solo de su propio panel.

Trazabilidad

ID	Tipo	Descripción breve	Criterio de prueba
CU-1	Caso de uso	Recibir notificación in-app	AC-1
CU-2	Caso de uso	Ver panel de notificaciones	AC-2
CU-3	Caso de uso	Navegar al colaborador	AC-3
CU-4	Caso de uso	Descartar notificación	AC-4
CU-5	Caso de uso	Recibir alerta por email	AC-5
CU-6	Caso de uso	Recibir notificación de evento de liderazgo	AC-9
CU-7	Caso de uso	Enviar comunicado masivo	AC-10
CU-8	Caso de uso	Historial y revocar comunicados	AC-12
CU-9	Caso de uso	Ver y descartar comunicado masivo	AC-12
R-1.1	Regla	Solo líder directo recibe alertas	AC-7
R-1.2	Regla	Solo colaboradores con líder asignado	AC-6
R-1.3	Regla	Sin duplicados activos	AC-6
R-1.4	Regla	Email solo al crear notificación nueva	AC-5, AC-8
R-1.5	Regla	Descarte manual y explícito	AC-4
R-1.6	Regla	Condición persistente regenera notificación	AC-8
R-1.7	Regla	Badge solo para líderes	AC-7
R-1.8	Regla	eMap evaluado sobre último registro	AC-6
R-1.9	Regla	Inactividad sobre sesiones completadas	AC-6
R-1.10	Regla	Notificación de liderazgo solo a la persona involucrada	AC-9
R-1.11	Regla	Notificaciones de liderazgo son in-app	AC-9
R-1.12	Regla	Comunicado requiere alcance válido	AC-10
R-1.13	Regla	Solo SUPER_ADMIN emite y revoca comunicados	AC-10, AC-12
R-1.14	Regla	Email de comunicado opcional y único	AC-11
R-1.15	Regla	Ventana de tiempo y descarte por usuario	AC-12
AC-1	Aceptación	Badge con conteo correcto	Badge visible + número exacto
AC-2	Aceptación	Panel con lista de alertas	Nombre + tipo + tiempo
AC-3	Aceptación	Navegación al colaborador	Redirección a eMap grupal
AC-4	Aceptación	Descarte manual	Desaparece del panel + badge actualizado
AC-5	Aceptación	Email al generar alerta	Email recibido al crear notificación
AC-6	Aceptación	Sin duplicados activos	No se crea segunda notificación activa
AC-7	Aceptación	No visible para no-líderes	Sin ícono ni panel
AC-8	Aceptación	Regeneración tras descarte	Nueva notificación si condición persiste
AC-9	Aceptación	Notificación de evento de liderazgo	Notificación in-app del tipo correcto
AC-10	Aceptación	Comunicado distribuido según alcance	Global vs. organizaciones; rechazo sin alcance
AC-11	Aceptación	Email opcional de comunicado	Email único solo si se marcó envío
AC-12	Aceptación	Revocar y descartar comunicado	Revocado quita a todos; descarte solo al usuario

Supuestos

La relación líder-colaborador se gestiona exclusivamente a través del módulo de Liderazgo. Este módulo consume esa relación como está; no la modifica.
El umbral de dimensión eMap (≤ 6 sobre escala 1–10) es un valor fijo de sistema, no configurable por organización en esta fase.
La ventana de inactividad de Brun-E (21 días) es un valor fijo de sistema, no configurable por organización en esta fase.
La evaluación diaria corre en un horario fijo configurado en el backend; no hay garantía de hora exacta desde la perspectiva del usuario.
El email usa el servicio de mailing existente (MailerSend) con el mismo remitente configurado en el sistema.

Preguntas abiertas (para cerrar con el cliente)

¿Los valores de umbral serán configurables por organización en el futuro? (umbral eMap ≤ 6 y ventana de inactividad de 21 días)
¿El email debería incluir un link directo a la aplicación? Para esta fase se deja sin link, pero puede ser útil para facilitar el acceso.
¿Se desea un resumen semanal por email en lugar de un email por cada alerta? Podría reducir la cantidad de emails si un líder tiene varios colaboradores con alertas simultáneas.
¿Qué ocurre con las notificaciones activas del líder anterior cuando se transfiere un colaborador? En esta fase quedan visibles hasta que el líder las descarte manualmente.

Correcciones / historial de validación

Fecha	Versión	Cambio
2026-05-12	v1.0	Documento inicial. Sistema de notificaciones in-app y email para líderes: alertas de eMap bajo e inactividad Brun-E, badge en navbar, panel con lista, descarte manual, deep-link al colaborador.
2026-07-02	v1.1	Se documentan los tipos de notificación de eventos de liderazgo (solicitud, invitación, transferencia, aceptación, rechazo, desvinculación) y los comunicados masivos (broadcasts) del SUPER_ADMIN con alcance global/organizaciones y email opcional. Nuevos CU-6 a CU-9, reglas R-1.10 a R-1.15 y AC-9 a AC-12. Se precisan los umbrales (eMap ≤ 6 sobre escala 1–10; inactividad Brun-E más de 21 días).