0010. Motor genérico de catálogos (CatalogCrud)¶
Estado: Aceptado
Fecha: 2026-10-26
Autor: Duval Alcivar
Módulo(s) afectado(s): panel administrativo (core-admin): catálogos de identidad
Evidencia: commit 05e835f (2026-10-26) y CatalogCrud, CatalogField
Contexto¶
Los catálogos maestros comparten el mismo ciclo: listar, buscar, ordenar, paginar, crear, editar y borrar. Escribir ese ciclo una vez por catálogo multiplicaba formularios, tablas y validaciones idénticas, y cada corrección había que repetirla en todos.
Decisión¶
Un único componente, CatalogCrud, resuelve el ciclo completo a partir de un
descriptor CatalogField con type, required, options, min/max,
lockedOnEdit, tableOnly, virtual y maxDate. Cada catálogo es una vista de
8–11 líneas que solo declara sus campos y las cuatro funciones de API.
Alternativas descartadas¶
- Un CRUD a mano por catálogo — empresas y sucursales mantienen tabla y modales propios por sus reglas particulares; replicar ese costo en catálogos planos duplicaría el ciclo sin aportar nada.
Consecuencias¶
Agregar un catálogo nuevo cuesta una vista corta y un descriptor. La contrapartida es que cualquier regla fuera del descriptor obliga a salir del motor y duplicar la tabla, como ya ocurre con empresas y sucursales.
Documentado a posteriori desde el código y el historial de Git del repositorio core-admin; la fecha corresponde al commit que introdujo la decisión, no a la fecha de publicación en este sitio (2026-11-09).