REQ-UX-01 — Confirmación de salida
· 3 min de lectura
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ón | Entregable |
|---|---|
| CA1 · Al intentar salir o cerrar el sistema se pregunta si realmente quiere salir | Diálogo del navegador en beforeunload + diálogo propio al pulsar «Cerrar sesión» |
| CA2 · Se evita la salida repentina sin confirmación | El 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
beforeunloadmientras hay sesión. El navegador dibuja su diálogo de confirmación (los navegadores actuales ignoran el texto personalizado; el sistema solo lo dispara conpreventDefault()). - «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
| Pieza | Rol |
|---|---|
hooks/use-confirmacion-salida.ts | Registra/retira el manejador beforeunload |
components/confirmacion-salida/confirmacion-salida.tsx | Activa el guard solo con sesión |
components/confirmacion-salida/confirmacion-salida-dialog.tsx | Diálogo AlertDialog del cierre de sesión |
utils/confirmacion-salida.ts | Mensaje + bandera de omisión de un solo uso |
services/auth-provider.tsx | Separa 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.tscEXIT 0 ynext lintEXIT 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 enlocalStorage, retirado por TEC-019; son ajenas a este requerimiento.
