Endpoints / Alertas
Resumen de alertas
Obtiene un resumen agregado de alertas visibles y no vistas de la empresa del usuario autenticado.
/alerts/summaryCaso de Uso
Usa este endpoint cuando la aplicación necesita mostrar contadores, indicadores o paneles resumidos de alertas sin cargar el listado completo. Al usarlo, el usuario obtiene totales generales, totales por tipo de alerta y totales por sucursal.
Autenticación
Requiere token JWT en el header Authorization: Bearer <token>.
Parámetros de ruta
Este endpoint no recibe parámetros de ruta.
Body
No aplica.
Reglas de negocio
Solo resume alertas de la empresa del usuario autenticado.
La empresa del usuario autenticado debe estar activa.
El usuario autenticado debe estar activo.
El usuario autenticado debe tener rol administrador, jefe o empleado.
totalVisible cuenta todas las alertas visibles.
totalUnseen cuenta las alertas visibles que aún no han sido vistas.
byType agrupa los totales por tipo de alerta.
byBranch agrupa los totales por sucursal.
Errores esperados
No se envió un token JWT válido o el token no contiene información válida del usuario.
La empresa asociada al usuario autenticado no fue encontrada.
El usuario autenticado no fue encontrado dentro de su empresa.
La empresa asociada al usuario autenticado está inactiva.
El usuario autenticado no pertenece a la empresa indicada por su sesión.
El usuario autenticado intentó acceder a información de una empresa distinta a la suya.
El rol del usuario no tiene permiso para consultar el resumen de alertas.
El usuario autenticado está inactivo y no puede usar el sistema.
Notas de uso
Este endpoint no recibe parámetros de ruta, query params ni body.
Úsalo para contadores, badges y dashboards rápidos.
Este endpoint no reemplaza GET /alerts, porque devuelve solo información agregada.
Los totales se calculan sobre alertas visibles de la empresa autenticada.