metis-desk/docs/cierre-auditoria-uiux-ficha-puesto-trabajo.md

# 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](auditoria-uiux-ficha-puesto-trabajo.md) 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](implementacion-uiux-ficha-puesto-v1.md#4-m01-orientación-y-cabecera) y [comparación](auditorias/ficha-puesto-trabajo/implementacion-v1/comparaciones/comparacion.md). |
| 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](implementacion-uiux-ficha-puesto-v1.md) 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](implementacion-uiux-ficha-puesto-v2.1.md#m03-personas-y-perfiles). |
| M04 | Metadatos técnicos dificultaban escanear las configuraciones | v2.1 | Implementada: disclosure de ruta/permisos/cuenta; revisión, cobertura y notas visibles. [Informe](implementacion-uiux-ficha-puesto-v2.1.md#m04-configuraciones-y-detalles-técnicos). |
| 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](implementacion-uiux-ficha-puesto-v2.2.md#m05-inventario-de-acciones-y-decisiones). |
| M06 | El preview no explicaba suficientemente total y alcance | v2.1 | Implementada: contadores conocidos y filas mostradas/total, sin cero falso. [Informe](implementacion-uiux-ficha-puesto-v2.1.md#m06-totales-y-alcance). 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](implementacion-uiux-ficha-puesto-v2.2.md#m07-modelo-de-estados-y-tratamiento). |
| 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](auditorias/ficha-puesto-trabajo/implementacion-v3/comparaciones/estados-y-contraste.md). |
| 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](auditorias/ficha-puesto-trabajo/implementacion-v3/comparaciones/carga.md). No se afirma una mejora general de CLS. |

El cierre de implementación de M08/M09 depende de los resultados finales registrados en [v3](implementacion-uiux-ficha-puesto-v3.md) y [mediciones](auditorias/ficha-puesto-trabajo/implementacion-v3/mediciones.json), 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](auditorias/ficha-puesto-trabajo/implementacion-v1/comparaciones/comparacion.md), [v2.1](auditorias/ficha-puesto-trabajo/implementacion-v2.1/comparaciones/comparacion.md), [v2.2](auditorias/ficha-puesto-trabajo/implementacion-v2.2/comparaciones/README.md) y [v3](auditorias/ficha-puesto-trabajo/implementacion-v3/comparaciones/README.md). 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.