Saltar a contenido

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 (no core.identidad); 28 tablas; cat_tipos_documentos queda eliminada por la fusión ya decidida en 0024.
  • Usuarios/credenciales: trx_refresh_tokens con prefijo de empresa, log_sesiones particionada con PK (id, created_at), rel_usuario_sucursal con RLS por subconsulta a mae_sucursales, password_temp corta el login en el paso 1 y nueva trx_password_changes con historial de contraseñas.
  • mae_usuarios_img guarda la imagen global del usuario.
  • Entidades: la unicidad de identificacion deja de ser global y pasa a ser por tipo_entidad; la longitud se valida contra cat_tipos_identificacion; GET /api/v1/entidades expone personas naturales y jurídicas en una sola forma.
  • Permisos: se implementa rel_usuario_accion (sujeto usuario_id XOR tipo_usuario_id) y desaparecen cat_permisos, rel_usuario_permiso, rel_usuario_menu y rel_usuario_menu_accion; cat_tipos_usuario sigue 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 POST compuesto: 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.