metis-desk/docs/cierre-auditoria-uiux-ficha-puesto-trabajo.md
2026-10-25 01:19:17 +02:00

11 KiB
Raw Blame History

Cierre consolidado de la auditoría UI/UX: ficha de puesto

Fecha: 24 de octubre de 2026. Ruta: /companies/:companyId/workstations/:id.

Dictamen y alcance

Se consolidan los nueve hallazgos de la auditoría inicial y las entregas v1, v2.1, v2.2 y v3. La implementación visual se considera estabilizada dentro de los escenarios comprobados, con las limitaciones de accesibilidad y la deuda de backend descritas abajo. Esto no constituye una certificación WCAG ni un cierre integral de la operación bajo concurrencia normal.

No se convierte la ficha en un dashboard nuevo ni se cambian modelos, permisos, ciclo de vida o persistencia. Los documentos de cada entrega conservan sus resultados históricos y sus límites; este cierre no los reescribe como si hubieran ejecutado pruebas que quedaron pendientes.

Objetivos originales y estado M01–M09

Mejora Hallazgo original Entrega Estado de implementación y evidencia
M01 Cabecera móvil y orientación consumían altura antes del contenido v1 Implementada: retorno compacto, nombre completo y metadatos conservados. Informe y comparación.
M02 Soporte mezclaba resumen y gestión, con peso visual excesivo v1 Implementada: resumen documental y gestión en diálogo, con CRUD/historial/retirados y foco. Informe y sus regresiones.
M03 Tabla de perfiles necesitaba adaptarse a la capacidad real v2.1 Implementada: 5/4/2 columnas, identidad y estado juntos en compacto, valores completos. Informe.
M04 Metadatos técnicos dificultaban escanear las configuraciones v2.1 Implementada: disclosure de ruta/permisos/cuenta; revisión, cobertura y notas visibles. Informe.
M05 Acciones repetidas podían comunicar ámbitos ambiguos v2.2 Implementada: edición completa con prominencia contextual distinta, ambos historiales justificados y Software compacto. Matriz de acciones.
M06 El preview no explicaba suficientemente total y alcance v2.1 Implementada: contadores conocidos y filas mostradas/total, sin cero falso. Informe. v3 corrige únicamente su contraste local.
M07 Los paneles incompletos repetían la dependencia del principal v2.2 Implementada: orientación en Equipamiento y mensajes secundarios breves; ausencia, bloqueo, carga, error e incertidumbre separados. Modelo de estados.
M08 Recetas diferentes de estados y avisos sin contraste medido v3 Evaluada e implementada donde se justificó: Software con Badge, correcciones de edición/contadores, estados técnicos y teletrabajo; conservación del ámbar que supera su umbral. Matriz y contraste.
M09 Skeleton uniforme diferente de la composición final v3 Medida y refinada: cabecera, bandas 900/1000 y pila lateral; cargas independientes y movimiento reducido. Comparación controlada. No se afirma una mejora general de CLS.

El cierre de implementación de M08/M09 depende de los resultados finales registrados en v3 y mediciones, que permiten distinguir muestras, recorridos y limitaciones.

Resultados acumulados verificables

Las cifras se mantienen dentro de su comparación original. No se suman porcentajes ni se combinan fixtures diferentes para fabricar un resultado global.

Dimensión Resultado comprobado Condiciones y límites
Geometría M01 Equipamiento comienza 46 px antes a 390 y 66 px antes a 320 Antes/después de v1, misma fixture de esa entrega. No es una medición de tiempo de usuario.
Geometría M02 Soporte a 1440 pasa de 798 a 642 px y de cuatro controles de gestión a uno visible La gestión completa se conserva en diálogo. Comparación v1.
Capacidad M03 Tabla de 1364,4 px pasa a caber en 624,6 px útiles a 1440 Comparación v2.1 con cuenta extensa. No se truncan valores; se conserva acceso a enlaces.
Lectura M04 Configuraciones a 390 pasan de 949 a 661 px con detalles cerrados Comparación v2.1; abrir conserva ruta de 219 caracteres y cuenta de 141.
Claridad M05 Cabecera de Software de 65 a 32 px a 1440/390/320 Comparación v2.2; título y gestión en una fila, ámbito escrito debajo.
Claridad M07 Tres paneles dependientes a 390: 402,25 → 289,75 px; menciones literales del principal: 5 → 1 Comparación v2.2 del puesto incompleto; no es un estudio de comprensión.
Accesibilidad M08 Pares de texto/fondo medidos en claro/oscuro; corregidos los contrastes insuficientes demostrados Matriz v3. No acredita todos los requisitos de WCAG ni todos los diálogos de la aplicación.
Estabilidad M09 Skeleton con estructura y umbrales coherentes; geometría y eventos de carga registrados Serie controlada v3, separada de observación exploratoria. No es un benchmark de CLS de producción.
Conservación funcional Regresiones de cabecera, soporte, tabla, detalles, acciones, contadores y vacíos Resultados de cada entrega y repetición acumulada en v3; escrituras solo sobre datos desechables.

Semántica conservada

  • Configurado documenta una configuración; no acredita acceso efectivo.
  • Pendiente, revisión, retirada pendiente, desconocido y error siguen diferenciados.
  • Desconocido no equivale a cero; refetch conserva datos previos con feedback de su fuente.
  • Activo o disponible no significa conectado en tiempo real.
  • Cobertura documental/autorización no prueba permisos SMB efectivos.
  • Aplicaciones asignadas a perfiles no equivalen a software instalado en el ordenador.
  • Archivado conserva información histórica; no equivale a eliminado.

La simplificación no elimina acciones, restricciones, datos extensos ni recuperación de errores. La edición desde Equipamiento sigue siendo el editor completo, y ambos historiales siguen mostrando el mismo alcance.

Skills utilizadas según las entregas

Entrega Skills documentadas y aportación
v1 frontend-design, shadcn, ux-dashboard, ux-navigation, ux-microcopy, composición y React; cabecera, resumen/gestión y contexto. Revisión con ux-design-review y verificaciones MCP disponibles.
v2.1 ux-tables principal, frontend-design, shadcn, ux-dashboard, ux-navigation, ux-microcopy, ui-ux-pro-max, composición, React, rdx-solid y ux-design-review; capacidad de tabla, metadatos y preview.
v2.2 ux-microcopy y ux-empty-states principales; ux-dashboard, shadcn y complementarias de diseño, navegación, errores, formularios, composición, React, rdx-solid y revisión.
v3 shadcn, frontend-design, ux-error-recovery y ux-microcopy principales; ux-dashboard, ux-empty-states, búsqueda dirigida Pro Max, React, composición, rdx-solid y ux-design-review.

Las listas reflejan los informes existentes, no ejecuciones nuevas de auditores especializados. Los auditores ausentes no se instalaron ni simularon. DESIGN.md y los patrones normativos prevalecieron sobre sugerencias genéricas.

Accesibilidad: hecho, pendiente y alcance

Comprobado en los recorridos: nombres accesibles, encabezados de main, regiones, tablas, estado expandido/contraído, Enter/Espacio, Escape, retorno de foco y controles sin depender de hover. Se conserva el foco al completar Equipamiento, cuando desaparece su acción del vacío. Se inspeccionan datos/errores/vacíos a 320 px y controles de contenedor alrededor de los umbrales relevantes.

v3 añade medición de contraste efectivo y uso de tokens oscuros, inspección nativa del árbol accesible y prueba de reducción de movimiento. Los mensajes de estado conservan texto; no dependen exclusivamente del color.

No ejecutado: lector de pantalla real y zoom nativo 200/400 %. No había una combinación instalada de lector/navegador; el atajo no cambió zoom y la página de ajustes fue bloqueada por el contexto aislado de Playwright. El reflow emulado de v2.1 y el responsive de las otras versiones se conservan como pruebas distintas. No se presentan como sustitutos de esas verificaciones.

Limitaciones y deuda restante

Tipo Estado al cierre
Defecto ajeno observado en ejecución Agotamiento del pool durante consultas anidadas de Recursos. Las pruebas reproducibles posteriores limitan la concurrencia del navegador a dos peticiones; esto no soluciona el backend ni acredita operación sin esa limitación.
Fallos globales ajenos Typecheck de vendor calendar.tsx, lint/formato global y fallos de tests observados en v3. Los resultados actuales concretos están en su informe; no se asumen idénticos a los de v2.2.
Verificaciones no ejecutadas Zoom nativo 200/400 %, lector real, matriz completa de dispositivos/navegadores y contraste integral de otras pantallas.
Investigación no realizada Comprensión con usuarios, tiempos de tarea y datos de campo de CLS. Las mejoras documentadas son geométricas, semánticas y funcionales.
Futuro opcional Evaluar otras pantallas y el sistema global de contraste en una tarea propia; no extender automáticamente estas recetas locales ni cambiar vendor.

Evidencias, seguridad y recomendación

Se mantienen las evidencias de v1, v2.1, v2.2 y v3. Sus condiciones están identificadas y los hashes permiten comprobar integridad. Las sesiones y credenciales no forman parte de la documentación.

Recomendación: aceptar los cambios visuales implementados y mantener M01–M09 como alcance refinado, sin reabrir su composición. Mantener abierto el cierre integral de accesibilidad y la incidencia operativa de concurrencia ajena. La validación controlada de UI no autoriza afirmar que esos pendientes estén resueltos ni sustituye una aceptación de producción.