Documento — core.identidad.mae_documentos¶
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.
from datetime import datetime, date
from typing import Optional
import uuid
from sqlalchemy import (
BigInteger,
Boolean,
CheckConstraint,
Date,
DateTime,
ForeignKey,
Identity,
Index,
Integer,
SmallInteger,
String,
Text,
UniqueConstraint,
text,
)
from sqlalchemy.dialects import postgresql
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column
class Base(DeclarativeBase):
pass
class MaeDocumento(Base):
__tablename__ = 'mae_documentos'
__table_args__ = (
UniqueConstraint('empresa_id', 'hash_sha256', name='uq_mae_documentos_empresa_hash'),
Index('ix_mae_documentos_empresa_origen', 'empresa_id', 'svc_origen'),
{"schema": 'core.identidad'},
)
id: Mapped[uuid.UUID] = mapped_column(
UUID(as_uuid=True),
primary_key=True,
server_default=text("gen_random_uuid()"),
)
empresa_id: Mapped[int] = mapped_column(
BigInteger,
nullable=False,
comment='Empresa propietaria del documento',
)
nombre: Mapped[str] = mapped_column(
String(255),
nullable=False,
comment='Nombre del archivo',
)
tipo_mime: Mapped[str] = mapped_column(
String(100),
nullable=False,
comment='Tipo MIME del documento (application/pdf, image/jpeg, etc.)',
)
tamano_bytes: Mapped[int] = mapped_column(
BigInteger,
nullable=False,
comment='Tamaño del archivo en bytes',
)
hash_sha256: Mapped[str] = mapped_column(
String(64),
nullable=False,
comment='Hash SHA-256 del contenido (integridad y deduplicación)',
)
url: Mapped[str] = mapped_column(
Text,
nullable=False,
comment='URL de referencia en Object Storage (S3 / MinIO)',
)
svc_origen: Mapped[str] = mapped_column(
String(50),
nullable=False,
comment='Microservicio que generó o registró el documento',
)
# Auditoría General
is_activo: Mapped[bool] = mapped_column(
Boolean,
nullable=False,
server_default=text("true"),
comment='Estado lógico del registro',
)
created_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True),
nullable=False,
server_default=text("now()"),
comment='Fecha de creación',
)
updated_at: Mapped[datetime] = mapped_column(
DateTime(timezone=True),
nullable=False,
server_default=text("now()"),
comment='Fecha de última actualización',
)
deleted_at: Mapped[datetime | None] = mapped_column(
DateTime(timezone=True),
comment='Fecha de eliminación lógica',
)
created_by: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True),
comment='Usuario creador',
)
updated_by: Mapped[uuid.UUID | None] = mapped_column(
UUID(as_uuid=True),
comment='Usuario modificador',
)