0029. Catálogos: lectura autenticada y escritura exclusiva de root¶
Estado: Aceptado
Fecha: 2026-10-27
Autor: Duval Alcivar
Módulo(s) afectado(s): svc-identidad (core_sigfa), catálogos globales y listas maestras
Complementa a: ADR 0003, ADR 0024
Origen: ADR 0012 de implementación, ADR 0052 de implementación, ADR 0053 de implementación, ADR 0055 de implementación
Contexto¶
Los ADR 0003 y 0024 cerraron la fusión de catálogos, pero dejaron abierta la superficie de acceso; la implementación la resolvió con lectura autenticada y escritura root-only.
Decisión¶
- Las escrituras de los catálogos globales quedan reservadas a
root; el resto de los usuarios solo lee. - Las listas maestras se leen con token autenticado; ya no se asume lectura anónima ni queda pendiente de definir.
- La longitud de las identificaciones se valida contra
cat_tipos_identificacion(longitud_minima/longitud_maxima), no con reglas fijas en el servicio. - La fusión de catálogos de 0024 se ratifica y
cat_tipos_documentosqueda fuera del esquema.
Alternativas descartadas¶
- Lectura anónima de listas maestras — expone datos de configuración sin credencial y complica la trazabilidad.
- Escritura por permiso de acción — los catálogos globales no son de tenant y no tienen sujeto al que conceder.
- Longitudes fijas en código — obliga a desplegar el servicio para ajustar cada tipo de identificación.
Consecuencias¶
Todo consumidor de listas maestras necesita token, incluso el bootstrap de formularios. La escritura root-only concentra el mantenimiento de catálogos en un solo rol y evita divergencias por empresa.
Se incorporó a este sitio el 2026-11-09. La fecha del ADR corresponde a la última decisión de implementación que resume, no a la fecha de publicación en este sitio.