Saltar al contenido principal

REQ-NOT-02 — Rediseño y usabilidad del panel de notificaciones

· 3 min de lectura
Yovany Suárez Silva
Software Engineer - FullStack Developer

Implementación del requerimiento REQ-NOT-02 (Rediseño y usabilidad del panel de notificaciones), dentro de Notificaciones y con prioridad Media. El centro de notificaciones deja de ser una lista plana y pasa a ser una bandeja de trabajo: filtros combinables, búsqueda, grupos por fecha, acciones directas y estado persistido por usuario.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 — Jerarquía leída/no leída y contadorEstilo diferenciado por elemento e insignia de pendientes sobre el icono de campana
CA2 — Orden y fecha relativaOrden creado DESC en el API y formato «hace 5 minutos» con fecha absoluta en el tooltip
CA3 — Filtros por estado y tipoPestañas Todas / No leídas / Leídas / Archivadas y selector de tipo
CA4 — Búsqueda respetando filtrosq con ILIKE sobre título y mensaje, combinado con estado, tipo y módulo
CA5 — Agrupación y origenGrupos Hoy / Ayer / Esta semana / Anteriores y etiqueta del módulo emisor
CA6 — Acciones directasVer origen, marcar leída/no leída, archivar/restaurar y eliminar
CA7 — Marcar todas y lectura por usuarioPUT /panel/leidas y tabla notificacion_estado_usuario
CA8 — Paginación y estado vacíoPágina de 20 + «Cargar más» + estados vacíos contextuales
CA9 — Escritorio y móvilAcciones de 36 px, texto sin desbordes y filtros en rejilla adaptable
CA10 — Filtros persistentessessionStorage por usuario durante la sesión del navegador

🧩 Cómo funciona​

  • El servidor filtra y pagina. El nuevo endpoint GET /api/notifications/panel aplica el ámbito del usuario, el estado, el tipo, el módulo, la búsqueda y la paginación en una sola consulta. La interfaz no descarga toda la bandeja para filtrarla en el navegador.
  • Estado por usuario sin romper lo existente. notificacion_estado_usuario guarda leído, archivado y eliminado por notificación y destinatario. notifications.leido se conserva para la app móvil y los consumidores heredados; el panel usa el estado nuevo cuando existe.
  • Archivar y eliminar con política. Archivar es reversible, marca como leída y mueve la fila a Archivadas. Eliminar es lógico: deja de listarse y contarse, pero se conserva para auditoría.
  • Origen accionable. Cada aviso resuelve su módulo por tipo o por moduloOrigen; los emisores guardan referencia_origen (por ejemplo SOL-2026-014) para abrir el origen con contexto.
  • Persistencia de sesión. Estado, tipo, módulo, búsqueda y usuario seleccionado se guardan en sessionStorage con la clave notificaciones:panel:filtros:v1:<idUsuario>.

🗂️ Archivos principales​

CapaArchivo
API · migraciónsrc/database/migrations/051-panel-notificaciones.ts
API · entidadsrc/domains/notifications/entities/notificacion-estado-usuario.entity.ts
API · serviciosrc/domains/notifications/notification.service.ts
API · controladorsrc/domains/notifications/notification.controller.ts
API · catálogosrc/domains/notifications/catalogo-notificaciones.ts
Web · panelsrc/components/notification/panel-notificaciones.tsx
Web · elementosrc/components/notification/notificacion-item.tsx
Web · iconosrc/components/general-dashboard/notifications-item.tsx
Web · utilidadessrc/utils/notificaciones.ts
Web · cliente APIsrc/api/notification.ts

✅ Verificación​

cd ccf-almacen-api
npm run migration:run
npm run verificar:notificaciones
  • tsc --noEmit y eslint de las áreas tocadas: 0 errores.
  • Jest API (src/domains/notifications): 4 suites / 16 pruebas.
  • Jest web (panel + utilidades): 2 suites / 8 pruebas.
  • Migración 051 aplicada en ccf_almacen.
  • Verificación real contra PostgreSQL: listado, resumen, paginación y ciclo de acciones sobre una fila temporal (leída → archivada → restaurada → eliminada), con limpieza posterior.

🔌 Compatibilidad​

  • La app móvil sigue usando GET /api/notifications, PUT /read/:id y PUT /read-all.
  • Las preferencias y el push de UX-004 no cambian.
  • El envío de documentos de REQ-NOT-01 no cambia; el panel solo muestra y gestiona sus avisos.