Especificación Técnica: mae_documentos¶
Esquema: core.identidad
Base de Datos: core
Servicio: svc-identidad
Tabla Legacy Origen: core_sigfa.mae_documentos
Propósito: Maestro de documentos del núcleo: metadatos normalizados de los artefactos generados o recibidos por la plataforma (PDF, Excel, imágenes), independiente de la lógica de negocio de cada servicio.
1. Justificación y Mejoras de Arquitectura¶
- Registro central de metadatos de documentos accesible por cualquier microservicio; el binario vive en Object Storage (S3 / MinIO) y aquí se guarda la referencia.
svc_origenindica qué microservicio generó o subió el documento (factura, reporte, acta, etc.).hash_sha256permite deduplicación e integridad del artefacto.- Unique
(empresa_id, hash_sha256)evita registrar el mismo archivo dos veces por empresa. - RLS por empresa aísla los documentos de cada tenant.
2. Definiciones de Implementación¶
Table core.identidad.mae_documentos {
id uuid [pk, default: `gen_random_uuid()`]
empresa_id bigint [not null]
nombre varchar(255) [not null]
tipo_mime varchar(100) [not null]
tamano_bytes bigint [not null]
hash_sha256 varchar(64) [not null]
url text [not null]
svc_origen varchar(50) [not null]
// 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 {
(empresa_id, hash_sha256) [unique, name: 'uq_mae_documentos_empresa_hash']
(empresa_id, svc_origen) [name: 'ix_mae_documentos_empresa_origen']
}
// RLS por empresa actual
}
CREATE TABLE IF NOT EXISTS core.identidad.mae_documentos (
id UUID NOT NULL DEFAULT gen_random_uuid() PRIMARY KEY,
empresa_id BIGINT NOT NULL,
nombre VARCHAR(255) NOT NULL,
tipo_mime VARCHAR(100) NOT NULL,
tamano_bytes BIGINT NOT NULL,
hash_sha256 VARCHAR(64) NOT NULL,
url TEXT NOT NULL,
svc_origen VARCHAR(50) NOT NULL,
-- 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_documentos_empresa_hash UNIQUE (empresa_id, hash_sha256)
);
CREATE INDEX IF NOT EXISTS ix_mae_documentos_empresa_origen ON core.identidad.mae_documentos (empresa_id, svc_origen);
-- Row-Level Security
ALTER TABLE core.identidad.mae_documentos ENABLE ROW LEVEL SECURITY;
CREATE POLICY aislamiento_empresa ON core.identidad.mae_documentos
FOR ALL
USING (empresa_id = NULLIF(current_setting('app.current_empresa_id', true), '')::BIGINT);
-- Comentarios
COMMENT ON COLUMN core.identidad.mae_documentos.empresa_id IS 'Empresa propietaria del documento';
COMMENT ON COLUMN core.identidad.mae_documentos.nombre IS 'Nombre del archivo';
COMMENT ON COLUMN core.identidad.mae_documentos.tipo_mime IS 'Tipo MIME del documento (application/pdf, image/jpeg, etc.)';
COMMENT ON COLUMN core.identidad.mae_documentos.tamano_bytes IS 'Tamaño del archivo en bytes';
COMMENT ON COLUMN core.identidad.mae_documentos.hash_sha256 IS 'Hash SHA-256 del contenido (integridad y deduplicación)';
COMMENT ON COLUMN core.identidad.mae_documentos.url IS 'URL de referencia en Object Storage (S3 / MinIO)';
COMMENT ON COLUMN core.identidad.mae_documentos.svc_origen IS 'Microservicio que generó o registró el documento';