Saltar a contenido

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_usuarios necesita un único FK (entidad_id) y no debe condicionar en código.
  • Herencia por tabla (joined table inheritance): el id nace aquí y la fila hija copia el mismo UUID; las hijas no tienen DEFAULT gen_random_uuid().
  • tipo_entidad es el discriminador (PERSONA_NATURAL / PERSONA_JURIDICA).
  • Tabla global (sin empresa_id ni RLS): igual que mae_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)';