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_documentosduplicaba esa semántica con campos ricos (codigoúnico,descripcion,longitud_minima,longitud_maxima,expresion_validacion), pero no tiene ninguna referencia entrante.cat_tipos_identificacionquedó reducida a solonombre, pero es la tabla a la que apuntan 3 claves foráneas físicas:mae_empresas,mae_personasymae_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_maximayexpresion_validacion.- La migración
20260929_001agrega las columnas, migra los datos y eliminacat_tipos_documentos. Las filas previas decat_tipos_identificacionrecibencodigo = upper(nombre). - El endpoint
/api/v1/catalogos/tipos-documentosdesaparece; el detipos-identificacionpasa a validarcodigoduplicado 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 acat_tipos_identificaciony 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_documentosporcodigosiguen funcionando:codigosobrevive 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).