Especificación Técnica: mae_entidades¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: — (nueva, patrón party)
Propósito: Raíz polimórfica de la que "heredan" personas naturales (mae_personas) y jurídicas (mae_personas_juridicas). mae_usuarios referencia una entidad sin importar el subtipo.
1. Justificación y Mejoras de Arquitectura¶
- Patrón party: un usuario puede representar a una persona natural (cédula) o a una persona jurídica externa (RUC);
mae_usuariosnecesita un único FK (entidad_id) y no debe condicionar en código. - Herencia por tabla (joined table inheritance): el
idnace aquí y la fila hija copia el mismo UUID; las hijas no tienenDEFAULT gen_random_uuid(). tipo_entidades el discriminador (PERSONA_NATURAL/PERSONA_JURIDICA).- Tabla global (sin
empresa_idni RLS): igual quemae_personas, la identidad no pertenece a una sola empresa. - Lleva la auditoría general completa (
is_activo,created_at,updated_at,deleted_at,created_by,updated_by), igual que sus subtipos: el borrado lógico es compuesto (marca la raíz y la hija en la misma operación), así la raíz sabe si está activa sin mirar a la hija.
2. Definiciones de Implementación¶
Table core.identidad.mae_entidades {
id uuid [pk, default: `gen_random_uuid()`]
tipo_entidad varchar(20) [not null, note: 'PERSONA_NATURAL | PERSONA_JURIDICA']
is_activo boolean [not null, default: true]
created_at timestamptz [not null, default: `now()`]
updated_at timestamptz [not null, default: `now()`]
deleted_at timestamptz
created_by uuid
updated_by uuid
Note: 'CHECK chk_mae_entidades_tipo: tipo_entidad IN (PERSONA_NATURAL, PERSONA_JURIDICA)'
}
CREATE TABLE IF NOT EXISTS core.identidad.mae_entidades (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
tipo_entidad VARCHAR(20) NOT NULL,
is_activo BOOLEAN NOT NULL DEFAULT true,
created_at TIMESTAMPTZ NOT NULL DEFAULT now(),
updated_at TIMESTAMPTZ NOT NULL DEFAULT now(),
deleted_at TIMESTAMPTZ,
created_by UUID,
updated_by UUID,
CONSTRAINT chk_mae_entidades_tipo
CHECK (tipo_entidad IN ('PERSONA_NATURAL', 'PERSONA_JURIDICA'))
);
-- Comentarios
COMMENT ON COLUMN core.identidad.mae_entidades.tipo_entidad IS 'Discriminador (PERSONA_NATURAL/PERSONA_JURIDICA)';