Saltar a contenido

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',
    )