UX-002 — Atajos de Teclado
· 3 min de lectura
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
| RF | Entregable |
|---|---|
| RF-UX-002-01 | Atajos para operaciones frecuentes (crear solicitud, buscar producto) y navegación |
| RF-UX-002-02 | Diálogo con la lista de atajos, abrible con ? o con el botón de la cabecera |
| RF-UX-002-03 | Personalización de combinaciones con captura de teclas, validación y conflictos |
⚙️ Cómo funciona
- Catálogo + proveedor:
ShortcutsProviderescucha elkeydownglobal, 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 conuseShortcutAction. - 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+Qdel 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 → proveedorresuelto con import dinámico; yuseShortcutActionpasa a ser tolerante a la ausencia del proveedor (rutas prerenderizadas). - Filtro de menú por rol unificado en
menu-permisos.ts:sidebar.tsxysearch.tsxtenían copias que habían divergido. La búsqueda global no incluía90(Sesiones) para Usuario Interno/Auditor y no restringía84(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ú).
tscEXIT 0,next lintEXIT 0 ynext buildEXIT 0.
📚 Documentación
- Manual:
docs/manuales/dashboard/atajos-teclado.md - Spec:
docs/mejoras/ux-002-atajos-teclado.md
