Saltar a contenido

TrxVisitasDocumentos — fuerza_ventas.trx_visitas_documentos

Documentos y Evidencias de Visita.

import uuid
from datetime import datetime
from typing import Optional

from sqlalchemy import (
    BigInteger,
    Boolean,
    Double,
    ForeignKeyConstraint,
    Index,
    String,
    UniqueConstraint,
    text,
)
from sqlalchemy.dialects.postgresql import TIMESTAMP, UUID
from sqlalchemy.orm import Mapped, mapped_column

from app.db.base import Base


class TrxVisitasDocumentos(Base):
    """
    Documentos y Evidencias de Visita.

    Evidencias fotográficas, firmas digitales y actas de visita capturadas
    en la app móvil y almacenadas en MinIO/S3.

    Legacy:
        c064t_documentos_agenda
    """

    __tablename__ = "trx_visitas_documentos"

    __table_args__ = (
        UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_trx_visitas_docs_empresa_id",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "visita_id"],
            ["fuerza_ventas.trx_visitas.empresa_id", "fuerza_ventas.trx_visitas.id"],
            ondelete="CASCADE",
            name="fk_trx_visitas_docs_visita",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "tipo_evidencia_id"],
            ["fuerza_ventas.cat_tipos_evidencia_visita.empresa_id", "fuerza_ventas.cat_tipos_evidencia_visita.id"],
            ondelete="RESTRICT",
            name="fk_trx_visitas_docs_tipo_evidencia",
        ),
        Index(
            "ix_trx_visitas_docs_empresa_activo",
            "empresa_id",
            "is_activo",
        ),
        Index(
            "ix_trx_visitas_docs_empresa_visita",
            "empresa_id",
            "visita_id",
        ),
        Index(
            "ix_trx_visitas_docs_empresa_tipo",
            "empresa_id",
            "tipo_evidencia_id",
        ),
        {
            "schema": "fuerza_ventas",
            "comment": "Documentos y Evidencias de Visita",
        },
    )

    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        primary_key=True,
        server_default=text("gen_random_uuid()"),
        comment="Identificador único UUID",
    )

    empresa_id: Mapped[int] = mapped_column(
        BigInteger,
        nullable=False,
        comment="Identificador BIGINT de la empresa en core.identidad (RLS)",
    )

    visita_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Visita asociada",
    )

    tipo_evidencia_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Tipo de evidencia (FK cat_tipos_evidencia_visita)",
    )

    url_almacenamiento: Mapped[str] = mapped_column(
        String(500),
        nullable=False,
        comment="URL en Object Storage (S3/MinIO)",
    )

    mime_type: Mapped[str] = mapped_column(
        String(100),
        nullable=False,
        comment="Tipo de contenido MIME",
    )

    tamano_bytes: Mapped[int] = mapped_column(
        BigInteger,
        nullable=False,
        comment="Tamaño del archivo en bytes",
    )

    hash_sha256: Mapped[Optional[str]] = mapped_column(
        String(64),
        nullable=True,
        comment="Hash criptográfico SHA-256 para verificación de integridad",
    )

    latitud_captura: Mapped[Optional[float]] = mapped_column(
        Double,
        nullable=True,
        comment="Coordenada GPS Latitud al capturar la evidencia",
    )

    longitud_captura: Mapped[Optional[float]] = mapped_column(
        Double,
        nullable=True,
        comment="Coordenada GPS Longitud al capturar la evidencia",
    )

    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(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment="Fecha de creación",
    )

    updated_at: Mapped[datetime] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment="Fecha de última actualización",
    )

    deleted_at: Mapped[Optional[datetime]] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=True,
        comment="Fecha de eliminación lógica",
    )

    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario creador",
    )

    updated_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario modificador",
    )