0026. Modelo de datos: 28 tablas, permiso único y entidades party¶
Estado: Aceptado
Fecha: 2026-11-06
Autor: Duval Alcivar
Módulo(s) afectado(s): svc-identidad (core_sigfa), modelo de datos y contratos de alta
Modifica a: ADR 0005, ADR 0007, ADR 0009, ADR 0022
Modificado por: ADR 0031 - PERSONA/PERSONA_COMERCIAL, mae_personas_comerciales y tipo_contribuyente
Complementa a: ADR 0001, ADR 0023
Origen: ADR 0004 de implementación, ADR 0012 de implementación, ADR 0015 de implementación, ADR 0025 de implementación, ADR 0029 de implementación, ADR 0035 de implementación, ADR 0061 de implementación
Contexto¶
Los ADR 0005, 0007, 0009 y 0022 describieron el modelo objetivo, pero al implementarlo cambiaron la forma de las claves, el número de tablas y la superficie de alta. El esquema real es identidad y el servicio expone 28 tablas.
Decisión¶
- Esquema literal
identidad(nocore.identidad); 28 tablas;cat_tipos_documentosqueda eliminada por la fusión ya decidida en 0024. - Usuarios/credenciales:
trx_refresh_tokenscon prefijo de empresa,log_sesionesparticionada con PK(id, created_at),rel_usuario_sucursalcon RLS por subconsulta amae_sucursales,password_tempcorta el login en el paso 1 y nuevatrx_password_changescon historial de contraseñas. mae_usuarios_imgguarda la imagen global del usuario.- Entidades: la unicidad de
identificaciondeja de ser global y pasa a ser portipo_entidad; la longitud se valida contracat_tipos_identificacion;GET /api/v1/entidadesexpone personas naturales y jurídicas en una sola forma. - Permisos: se implementa
rel_usuario_accion(sujetousuario_idXORtipo_usuario_id) y desaparecencat_permisos,rel_usuario_permiso,rel_usuario_menuyrel_usuario_menu_accion;cat_tipos_usuariosigue vigente como catálogo de roles. - El borrado lógico (
deleted_at) es un filtro automático del ORM, no una convención por repositorio. - El alta de usuario deja de ser un
POSTcompuesto: primero la entidad (POST /api/v1/entidades) y luego el usuario (POST /api/v1/usuarios).
Alternativas descartadas¶
- Conservar
core.identidad— no coincide con el esquema real y obliga a mapeos en cada consulta. - Mantener
identificacionúnica global — impide reutilizar el mismo número en otra entidad, algo que el modelo party no exige. - Alta compuesta entidad+usuario — mezcla dos agregados y duplica la validación de identificaciones.
Consecuencias¶
Los clientes de alta deben encadenar dos llamadas y manejar el caso de entidad creada sin usuario. La unicidad por tipo simplifica el alta, pero cualquier cambio de tipo debe revisar la unicidad existente.
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.