Especificación Técnica: mae_personas_juridicas¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: — (nueva, personas jurídicas externas)
Propósito: Personas jurídicas externas al grupo (empresas cliente, consultores que facturan con RUC) que pueden tener cuenta de usuario. Hereda de mae_entidades.
1. Justificación y Mejoras de Arquitectura¶
- Un usuario puede representar a una persona jurídica externa; sus datos (identificación fiscal, razón social, ubicación) no van en
mae_personas(exclusiva de personas naturales con cédula). - No es una empresa del grupo: esas viven en
mae_empresas(tenencia/RLS). De ahí el nombremae_personas_juridicas. - PK = FK a
mae_entidades.id; sinDEFAULT: el id nace enmae_entidadesy se copia en la misma transacción. - Identificación, país, ciudad y tipo de documento referenciados por UUID a los catálogos globales (igual que
mae_empresas). - Tabla global (sin
empresa_idni RLS). - Columnas de auditoría propias (
is_activo,created_at,updated_at,deleted_at,created_by,updated_by), igual quemae_personas.
2. Definiciones de Implementación¶
Table core.identidad.mae_personas_juridicas {
id uuid [pk, ref: > mae_entidades.id]
nombre varchar(200) [not null]
nombre_comercial varchar(200)
identificacion varchar(20) [not null]
pais_id uuid [ref: > cat_paises.id]
ciudad_id uuid [ref: > cat_ciudades.id]
tipo_identificacion_id uuid [ref: > cat_tipos_identificacion.id]
// Auditoría General
is_activo boolean [not null, default: `true`, note: 'Estado lógico del registro']
created_at timestamptz [not null, default: `now()`, note: 'Fecha de creación']
updated_at timestamptz [not null, default: `now()`, note: 'Fecha de última actualización']
deleted_at timestamptz [note: 'Fecha de eliminación lógica']
created_by uuid [note: 'Usuario creador']
updated_by uuid [note: 'Usuario modificador']
Indexes {
(identificacion) [unique, name: 'uq_mae_personas_juridicas_identificacion']
}
}
CREATE TABLE IF NOT EXISTS core.identidad.mae_personas_juridicas (
id UUID NOT NULL PRIMARY KEY,
nombre VARCHAR(200) NOT NULL,
nombre_comercial VARCHAR(200),
identificacion VARCHAR(20) NOT NULL,
pais_id UUID,
ciudad_id UUID,
tipo_identificacion_id UUID,
-- Auditoría General
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 uq_mae_personas_juridicas_identificacion UNIQUE (identificacion),
CONSTRAINT fk_mae_personas_juridicas_entidad FOREIGN KEY (id) REFERENCES core.identidad.mae_entidades (id),
CONSTRAINT fk_mae_personas_juridicas_pais FOREIGN KEY (pais_id) REFERENCES core.identidad.cat_paises (id),
CONSTRAINT fk_mae_personas_juridicas_ciudad FOREIGN KEY (ciudad_id) REFERENCES core.identidad.cat_ciudades (id),
CONSTRAINT fk_mae_personas_juridicas_tipo_identificacion FOREIGN KEY (tipo_identificacion_id) REFERENCES core.identidad.cat_tipos_identificacion (id)
);
-- Comentarios
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.id IS 'Mismo id de mae_entidades (herencia de tabla)';
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.nombre IS 'Razón social';
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.nombre_comercial IS 'Nombre comercial';
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.identificacion IS 'Número de identificación fiscal (RUC)';
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.pais_id IS 'País';
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.ciudad_id IS 'Ciudad';
COMMENT ON COLUMN core.identidad.mae_personas_juridicas.tipo_identificacion_id IS 'Tipo de identificación';