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