Saltar al contenido principal

UX-002 — Atajos de Teclado

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

Implementación de la mejora UX-002 (Atajos de Teclado), dentro de 7. Experiencia de Usuario. El sistema gana un sistema de atajos centralizado, con ayuda en pantalla y combinaciones personalizables, en lugar del único Ctrl+Q (cerrar sesión) que existía y de las etiquetas decorativas del menú de usuario.


📋 Alcance​

RFEntregable
RF-UX-002-01Atajos para operaciones frecuentes (crear solicitud, buscar producto) y navegación
RF-UX-002-02Diálogo con la lista de atajos, abrible con ? o con el botón de la cabecera
RF-UX-002-03Personalización de combinaciones con captura de teclas, validación y conflictos

⚙️ Cómo funciona​

  • Catálogo + proveedor: ShortcutsProvider escucha el keydown global, resuelve la combinación contra un mapa y ejecuta la acción. Las acciones globales (buscar, ayuda, cerrar sesión y navegación) las resuelve el proveedor; las de página (nueva solicitud, buscar producto) las registra cada pantalla con useShortcutAction.
  • Acción pendiente: si la pantalla de una acción no está montada, el proveedor abre su módulo y marca la acción como pendiente; al montarse, la ejecuta.
  • Permisos: la navegación reutiliza el filtro de menú por rol (menu-permisos.ts), y el menú se importa de forma dinámica para evitar un ciclo de importación con las páginas.
  • Guardia de escritura: los atajos sin Ctrl/Alt/⌘ se ignoran al escribir en un campo.

⌨️ Atajos por defecto​

Ctrl+K buscar · ? ayuda · Ctrl+Q cerrar sesión · / buscar producto · N nueva solicitud · Alt+1..7 navegación (Inicio, Bandeja, Solicitudes, Inventarios, Movimientos, Productos, Reportes).

💾 Persistencia​

Los atajos personalizados se guardan en localStorage (clave ccf:atajos), solo las diferencias respecto a los valores por defecto. Es por dispositivo/navegador; hay «Restablecer todo».

🐛 Hallazgos corregidos​

  • Se retiró el listener ad-hoc de Ctrl+Q del menú de usuario (lo asume el proveedor) y las etiquetas de atajo decorativas (⇧⌘P, ⌘B) que no hacían nada.
  • Ciclo de importación sidebar-option → páginas → useShortcutAction → proveedor resuelto con import dinámico; y useShortcutAction pasa a ser tolerante a la ausencia del proveedor (rutas prerenderizadas).
  • Filtro de menú por rol unificado en menu-permisos.ts: sidebar.tsx y search.tsx tenían copias que habían divergido. La búsqueda global no incluía 90 (Sesiones) para Usuario Interno/Auditor y no restringía 84 (Seguridad 2FA, solo Administrador); ahora ambos usan la regla canónica del sidebar.

✅ Verificación​

  • Suite web: 126 pruebas / 24 suites / 0 fallos (incluye 29 nuevas de atajos y del filtro de menú).
  • tsc EXIT 0, next lint EXIT 0 y next build EXIT 0.

📚 Documentación​

  • Manual: docs/manuales/dashboard/atajos-teclado.md
  • Spec: docs/mejoras/ux-002-atajos-teclado.md