Cobertura y mantenimiento

Qué se ha documentado

La base es el checkout local 2aec1b16cc011ee61d147283f1a02ff12f662ddf. El catálogo recorre todas las rutas src/app/**/page.tsx y sigue los componentes JSX hacia los adaptadores y las vistas. No importa secretos ni consulta la API.

Cada ficha recoge campos y controles declarados, enlaces de estado, propiedades de restricción, acciones y handlers, columnas literales, estados reutilizados, clases de presentación y dependencias directas de hooks, API y helpers.

Las 56 rutas sin parámetros y 15 rutas de detalle o edición incluyen una captura de escritorio del tenant de demostración Reformas Vera, S.L. Se excluyen las seis rutas de «Acceso e inicio». Cada ficha con identificador se capturó después de abrir un registro válido; ninguna imagen sustituye el identificador por datos inventados.

Límites de la evidencia

• Las tablas de campos son un inventario estático, no una grabación de uso.
• Un componente importado puede aparecer solo bajo una condición o en un diálogo.
• Labels y columnas construidos dinámicamente pueden no tener texto resoluble.
• La validación en helpers y servidor requiere lectura adicional; no se deduce que un campo sea opcional porque no tenga required en JSX.
• Las capturas acreditan la composición visible en escritorio de 71 rutas; no acreditan por sí solas el guardado, los errores ni los estados condicionales.
• Dos rutas con parámetros no tienen captura: el tenant no contiene activos de inmovilizado y la mensajería no está configurada, por lo que no existe un registro real que permita abrir sus fichas.
• No se ha comparado este checkout con el desplegado ni con una actualización remota.

Actualizar el catálogo

Desde el repositorio de documentación:

node scripts/frontend-catalog.cjs /ruta/a/pimia-web-shadcn
npx fern-api@5.119.2 check --warnings

El script utiliza el TypeScript instalado en el repositorio fuente. Regenera las fichas y el bloque marcado de navegación; no sobrescribe las guías editoriales. Las imágenes de fern/assets/frontend/screenshots/ se enlazan por el mismo slug de la ficha y no se modifican. frontend-inventory.json conserva revisión, rutas, captura disponible y componentes. Revisa los cambios de rutas eliminadas y borra sus fichas obsoletas si procede.

Revisar un cambio frontend

Ejecuta pnpm check y el build en el checkout modificado. Después prueba los recorridos afectados con datos adecuados: carga, vacío, error, permiso denegado, creación, edición y acciones que el cambio toque. Comprueba teclado, etiquetas, foco, móvil, zoom, oscuro y scroll. Distingue estas pruebas de la validación de Fern: que una página MDX compile no prueba el ERP.