metis-desk/docs/inventario-de-modales.md
2026-10-08 16:43:34 +02:00

11 KiB

Inventario de interacciones modales

Revisión de 2026-10-08. Se inspeccionaron las primitivas y wrappers importados, sus consumidores, los bloques condicionales y las implementaciones manuales posibles: Dialog, AlertDialog, Sheet, Drawer, FormDialog, portales, elementos dialog, aria-modal y roles dialog/alertdialog. La búsqueda no dependió del nombre de los componentes.

El código propio contiene 81 componentes que construyen una interacción modal. Todos usan FormDialog de @repo/shadcn-ui y tienen un componente principal por fichero. Un componente puede representar variantes de alta, edición o copia, y catálogos con distintos tipos; el número no es un recuento de todos los estados posibles de las ventanas. No se encontraron otras implementaciones propias con AlertDialog, Sheet, Drawer ni diálogos HTML/manuales.

La implementación vendor de packages/shadcn-ui queda fuera de la refactorización según AGENTS.md. Sus primitivas y el diálogo de configuración de tablas se consultan y consumen, no se duplican ni reorganizan. Los popovers de selectores y menús de acciones no se contabilizan como formularios o ventanas modales funcionales.

Responsabilidades y consumidores

Las páginas y listados conservan apertura, selección y callbacks. Los componentes enumerados encapsulan título, disposición, anchura, contenido y cierre. Los formularios existentes mantienen sus schemas, borradores, mutaciones, ayuda y errores. EndRelationshipDialog posee además la mutación de confirmación y sus estados pendientes y de error.

CompanyEditorDialog, PersonEditorDialog, DepartmentEditorDialog y SiteEditorDialog se reutilizan desde listados y altas rápidas equivalentes. BrandEditorDialog y SupportToolEditorDialog comparten el patrón entre catálogo y selector. Los callbacks de selección permanecen en el consumidor que posee el borrador. Las altas anidadas conservan sus restricciones existentes.

Se integró el contenido exclusivo de los antiguos SupportHistory, ApplicationHistory, CertificateHistory y PrinterHistory en sus respectivos componentes de diálogo, tras comprobar sus referencias. No se eliminaron historiales ni acciones. Los archivos anteriores se pueden recuperar desde Git.

Componentes por área

modules/assets/src/web

modules/companies/src/web/access

modules/companies/src/web/applications

modules/companies/src/web/certificates

modules/companies/src/web/components

modules/companies/src/web/folders

modules/companies/src/web/intervention-templates

modules/companies/src/web/interventions

modules/companies/src/web/mail

modules/companies/src/web/printers

modules/companies/src/web/processes

modules/companies/src/web/profiles

modules/companies/src/web/remote

modules/companies/src/web/telework

modules/companies/src/web/tickets

modules/identity/src/web/components

modules/resources/src/web

Comprobaciones y límites

Typecheck, lint, pruebas de los módulos y validaciones globales correctos. Las pruebas existentes comprueban traducciones es/en, listados sin formularios visibles, ayuda, restricciones de altas anidadas, estados y contratos. Se amplió la prueba del dashboard con datos no vacíos de los paneles extraídos.

No se ejecutó una sesión interactiva de navegador. Queda por comprobar manualmente apertura, Escape, restauración del foco, cancelación, envío y error en modales simples y anidados, en español, inglés y anchura móvil. El render estático y el lint no sustituyen esa comprobación.

Véase revisión de buenas prácticas para el alcance y los resultados globales, y componentes de interfaz para los patrones compartidos.