Saltar a contenido

0024. Fusión de catálogos: tipos de identificación absorbe tipos de documentos

Estado: Complementado por ADR 0029 Fecha: 2026-09-29 Autor: Duval Alcivar Módulo(s) afectado(s): core-svc-identidad (dominio catalogos) Complementado por: ADR 0029 - escrituras root-only y longitud validada contra el catálogo Modificado por: ADR 0031 - mae_personas_juridicas pasa a mae_personas_comerciales

Contexto

El catálogo legacy i035t_doc_ident ("documento de identificación") revela que cat_tipos_identificacion y cat_tipos_documentos modelan el mismo concepto: los documentos de identificación (cédula, RUC, pasaporte).

  • cat_tipos_documentos duplicaba esa semántica con campos ricos (codigo único, descripcion, longitud_minima, longitud_maxima, expresion_validacion), pero no tiene ninguna referencia entrante.
  • cat_tipos_identificacion quedó reducida a solo nombre, pero es la tabla a la que apuntan 3 claves foráneas físicas: mae_empresas, mae_personas y mae_personas_juridicas.

Decisión

Fusionar ambos catálogos conservando cat_tipos_identificacion, que se enriquece con los campos de cat_tipos_documentos:

  • codigo (UNIQUE, uq_cat_tipos_identificacion_codigo), descripcion, longitud_minima, longitud_maxima y expresion_validacion.
  • La migración 20260929_001 agrega las columnas, migra los datos y elimina cat_tipos_documentos. Las filas previas de cat_tipos_identificacion reciben codigo = upper(nombre).
  • El endpoint /api/v1/catalogos/tipos-documentos desaparece; el de tipos-identificacion pasa a validar codigo duplicado con 409.

El ADR local 0012 de core-svc-identidad documenta la misma decisión a nivel de implementación (migración, endpoints y consecuencias operativas).

Alternativas descartadas

  • Fusionar en cat_tipos_documentos — rompería las 3 FK que apuntan a cat_tipos_identificacion y obligaría a migrar las referencias de las maestras.
  • Mantener ambas tablas sincronizadas — no resuelve la duplicación conceptual y agrega un mecanismo de sincronización sin valor.

Consecuencias

  • Supera parcialmente al ADR 0003 en el punto de estos dos catálogos; el resto de ese ADR (catálogos y maestros generales) sigue vigente.
  • Los consumidores externos que referenciaban cat_tipos_documentos por codigo siguen funcionando: codigo sobrevive en la tabla fusionada.
  • Los catálogos por empresa siguen a la espera de la capa de autenticación (la escritura de catálogos queda pendiente hasta la administración autenticada).