Saltar a contenido

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_documentos queda 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.