REQ-NOT-02 — Rediseño y usabilidad del panel de notificaciones
· 3 min de lectura
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ón | Entregable |
|---|---|
| CA1 — Jerarquía leída/no leída y contador | Estilo diferenciado por elemento e insignia de pendientes sobre el icono de campana |
| CA2 — Orden y fecha relativa | Orden creado DESC en el API y formato «hace 5 minutos» con fecha absoluta en el tooltip |
| CA3 — Filtros por estado y tipo | Pestañas Todas / No leídas / Leídas / Archivadas y selector de tipo |
| CA4 — Búsqueda respetando filtros | q con ILIKE sobre título y mensaje, combinado con estado, tipo y módulo |
| CA5 — Agrupación y origen | Grupos Hoy / Ayer / Esta semana / Anteriores y etiqueta del módulo emisor |
| CA6 — Acciones directas | Ver origen, marcar leída/no leída, archivar/restaurar y eliminar |
| CA7 — Marcar todas y lectura por usuario | PUT /panel/leidas y tabla notificacion_estado_usuario |
| CA8 — Paginación y estado vacío | Página de 20 + «Cargar más» + estados vacíos contextuales |
| CA9 — Escritorio y móvil | Acciones de 36 px, texto sin desbordes y filtros en rejilla adaptable |
| CA10 — Filtros persistentes | sessionStorage por usuario durante la sesión del navegador |
🧩 Cómo funciona
- El servidor filtra y pagina. El nuevo endpoint
GET /api/notifications/panelaplica 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_usuarioguarda leído, archivado y eliminado por notificación y destinatario.notifications.leidose 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 guardanreferencia_origen(por ejemploSOL-2026-014) para abrir el origen con contexto. - Persistencia de sesión. Estado, tipo, módulo, búsqueda y usuario seleccionado se guardan en
sessionStoragecon la clavenotificaciones:panel:filtros:v1:<idUsuario>.
🗂️ Archivos principales
| Capa | Archivo |
|---|---|
| API · migración | src/database/migrations/051-panel-notificaciones.ts |
| API · entidad | src/domains/notifications/entities/notificacion-estado-usuario.entity.ts |
| API · servicio | src/domains/notifications/notification.service.ts |
| API · controlador | src/domains/notifications/notification.controller.ts |
| API · catálogo | src/domains/notifications/catalogo-notificaciones.ts |
| Web · panel | src/components/notification/panel-notificaciones.tsx |
| Web · elemento | src/components/notification/notificacion-item.tsx |
| Web · icono | src/components/general-dashboard/notifications-item.tsx |
| Web · utilidades | src/utils/notificaciones.ts |
| Web · cliente API | src/api/notification.ts |
✅ Verificación
cd ccf-almacen-api
npm run migration:run
npm run verificar:notificaciones
tsc --noEmity 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
051aplicada enccf_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/:idyPUT /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.
