Saltar a contenido

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).