Saltar al contenido principal

REQ-UX-01 — Confirmación de salida

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

Implementación del requerimiento REQ-UX-01 (Confirmación de salida), dentro de Experiencia de Usuario y con prioridad Media. Hasta ahora, cerrar o recargar la pestaña —o pulsar «Cerrar sesión»— sacaba al usuario del sistema sin avisar y sin posibilidad de arrepentirse.


📋 Alcance​

Criterio de aceptaciónEntregable
CA1 · Al intentar salir o cerrar el sistema se pregunta si realmente quiere salirDiálogo del navegador en beforeunload + diálogo propio al pulsar «Cerrar sesión»
CA2 · Se evita la salida repentina sin confirmaciónEl guard solo se registra con sesión activa; las salidas automáticas del sistema quedan exentas

⚙️ Cómo funciona​

  • Cerrar/recargar/abandonar el sitio: un hook registra el evento beforeunload mientras hay sesión. El navegador dibuja su diálogo de confirmación (los navegadores actuales ignoran el texto personalizado; el sistema solo lo dispara con preventDefault()).
  • «Cerrar sesión»: en lugar de cerrar la sesión de inmediato, se abre un diálogo («Confirmar salida» → Sí, salir / Cancelar). Vale para el botón del perfil, el menú lateral y el atajo Ctrl + Q.
  • Sin interrupciones molestas: el cierre por inactividad (10 min) y el cierre por sesión expirada ejecutan el cierre directamente, sin confirmación, para que la sesión termine aunque no haya nadie delante.
Sesión activa
├─ cerrar / recargar pestaña ──▶ beforeunload ──▶ diálogo del navegador
├─ «Cerrar sesión» ──▶ AlertDialog ──▶ Sí, salir ──▶ cerrarSesion()
├─ inactividad (10 min) ──▶ cerrarSesion() (sin confirmar)
└─ sesión expirada (API) ──▶ redirección al login (sin confirmar)

🧩 Detalles de implementación​

PiezaRol
hooks/use-confirmacion-salida.tsRegistra/retira el manejador beforeunload
components/confirmacion-salida/confirmacion-salida.tsxActiva el guard solo con sesión
components/confirmacion-salida/confirmacion-salida-dialog.tsxDiálogo AlertDialog del cierre de sesión
utils/confirmacion-salida.tsMensaje + bandera de omisión de un solo uso
services/auth-provider.tsxSepara cerrarSesion (automático) de handleLogout (confirmado)

Las redirecciones de documento completo que lanza el sistema (sesión expirada, contraseña vencida) marcan la salida como programática para no pedir confirmación en medio de un flujo automático.

🧪 Pruebas​

  • ccf-almacen-web/src/components/__tests__/confirmacion-salida.test.tsx — 6 casos: confirma con sesión, no interfiere sin sesión, omite una sola vez las salidas del sistema, desregistra el manejador al desmontar y confirmar/cancelar en el diálogo.
  • tsc EXIT 0 y next lint EXIT 0 (solo warnings previos).

Nota: la suite web completa mantiene 3 suites previas en rojo (sesiones, login-2fa, sesion-aviso) que aún esperan el token en localStorage, retirado por TEC-019; son ajenas a este requerimiento.

📚 Documentación​