Saltar a contenido

TrxVisitasRequerimiento — fuerza_ventas.trx_visitas_requerimientos

Requerimientos comerciales, técnicos, materiales POP y reclamos solicitados durante una visita. Normaliza requerimientos 1:N con ciclo de vida, fechas de compromiso y asignación de responsables.

from datetime import date, datetime
from typing import Optional
import uuid

from sqlalchemy import (
    BigInteger,
    Boolean,
    Date,
    DateTime,
    ForeignKeyConstraint,
    Index,
    String,
    Text,
    UniqueConstraint,
    text,
)
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column, relationship


class Base(DeclarativeBase):
    pass


class TrxVisitasRequerimiento(Base):
    __tablename__ = "trx_visitas_requerimientos"
    __table_args__ = (
        UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_trx_visitas_req_empresa_id",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "visita_id"],
            ["fuerza_ventas.trx_visitas.empresa_id", "fuerza_ventas.trx_visitas.id"],
            ondelete="CASCADE",
            name="fk_trx_visitas_req_visita",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "tipo_requerimiento_id"],
            ["fuerza_ventas.cat_tipos_requerimiento_visita.empresa_id", "fuerza_ventas.cat_tipos_requerimiento_visita.id"],
            ondelete="RESTRICT",
            name="fk_trx_visitas_req_tipo",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "prioridad_id"],
            ["fuerza_ventas.cat_prioridades_requerimiento.empresa_id", "fuerza_ventas.cat_prioridades_requerimiento.id"],
            ondelete="RESTRICT",
            name="fk_trx_visitas_req_prioridad",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "estado_atencion_id"],
            ["fuerza_ventas.cat_estados_requerimiento_visita.empresa_id", "fuerza_ventas.cat_estados_requerimiento_visita.id"],
            ondelete="RESTRICT",
            name="fk_trx_visitas_req_estado",
        ),
        Index(
            "ix_trx_visitas_req_empresa_visita",
            "empresa_id",
            "visita_id",
        ),
        Index(
            "ix_trx_visitas_req_empresa_tipo",
            "empresa_id",
            "tipo_requerimiento_id",
        ),
        Index(
            "ix_trx_visitas_req_empresa_estado",
            "empresa_id",
            "estado_atencion_id",
        ),
        Index(
            "ix_trx_visitas_req_empresa_responsable",
            "empresa_id",
            "usuario_responsable_id",
        ),
        Index(
            "ix_trx_visitas_req_empresa_activo",
            "empresa_id",
            "is_activo",
        ),
        {"schema": "fuerza_ventas"},
    )

    # Identificadores y Claves
    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 origen asociada",
    )

    tipo_requerimiento_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Identificador del tipo de requerimiento (FK cat_tipos_requerimiento_visita)",
    )

    # Campos de Negocio
    descripcion_requerimiento: Mapped[str] = mapped_column(
        Text,
        nullable=False,
        comment="Detalle de lo solicitado por el cliente",
    )

    prioridad_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Nivel de prioridad (FK cat_prioridades_requerimiento)",
    )

    estado_atencion_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Estado de resolución (FK cat_estados_requerimiento_visita)",
    )

    fecha_compromiso: Mapped[Optional[date]] = mapped_column(
        Date,
        nullable=True,
        comment="Fecha límite acordada para resolución",
    )

    fecha_atencion: Mapped[Optional[datetime]] = mapped_column(
        DateTime(timezone=True),
        nullable=True,
        comment="Fecha y hora real en que se completó",
    )

    usuario_responsable_id: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario asignado para resolver (correlación core.identidad)",
    )

    observaciones_resolucion: Mapped[Optional[str]] = mapped_column(
        Text,
        nullable=True,
        comment="Comentarios de cierre o dictamen de atención",
    )

    # 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()"),
        onupdate=datetime.utcnow,
        comment="Fecha de última actualización",
    )

    deleted_at: Mapped[Optional[datetime]] = mapped_column(
        DateTime(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",
    )