Saltar a contenido

0024 - trx_visitas

"""create trx_visitas

Revision ID: 0024
Revises: 0023
Create Date: 2026-09-09
"""

from typing import Sequence, Union

from alembic import op
import sqlalchemy as sa
from sqlalchemy.dialects import postgresql


# revision identifiers, used by Alembic.
revision: str = "0024"
down_revision: Union[str, Sequence[str], None] = "0023"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None


def upgrade() -> None:

    op.create_table(
        "trx_visitas",

        sa.Column(
            "id",
            postgresql.UUID(as_uuid=True),
            nullable=False,
            server_default=sa.text("gen_random_uuid()"),
            comment="Identificador único UUID",
        ),

        sa.Column(
            "empresa_id",
            sa.BigInteger(),
            nullable=False,
            comment="Identificador BIGINT de la empresa en core.identidad (RLS)",
        ),

        sa.Column(
            "promotor_id",
            postgresql.UUID(as_uuid=True),
            nullable=False,
            comment="Promotor comercial asignado a la visita",
        ),

        sa.Column(
            "cliente_id",
            postgresql.UUID(as_uuid=True),
            nullable=True,
            comment="Cliente formal visitado",
        ),

        sa.Column(
            "local_id",
            postgresql.UUID(as_uuid=True),
            nullable=True,
            comment="Punto de venta o local físico específico",
        ),

        sa.Column(
            "prospecto_id",
            postgresql.UUID(as_uuid=True),
            nullable=True,
            comment="Prospecto lead visitado",
        ),

        sa.Column(
            "tipo_actividad_id",
            postgresql.UUID(as_uuid=True),
            nullable=False,
            comment="Tipo de gestión comercial efectuada",
        ),

        sa.Column(
            "estado_visita_id",
            postgresql.UUID(as_uuid=True),
            nullable=False,
            comment="Estado de ejecución de la visita",
        ),

        sa.Column(
            "fecha_planificada",
            sa.Date(),
            nullable=False,
            comment="Fecha programada en la ruta comercial",
        ),

        sa.Column(
            "hora_estimada_llegada",
            sa.TIMESTAMP(timezone=True),
            nullable=True,
            comment="Hora estimada de llegada",
        ),

        sa.Column(
            "fecha_checkin",
            sa.TIMESTAMP(timezone=True),
            nullable=True,
            comment="Timestamp real de check-in capturado por la app",
        ),

        sa.Column(
            "fecha_checkout",
            sa.TIMESTAMP(timezone=True),
            nullable=True,
            comment="Timestamp real de check-out capturado por la app",
        ),

        sa.Column(
            "latitud_checkin",
            sa.Float(precision=53),
            nullable=True,
            comment="Coordenada GPS Latitud en check-in",
        ),

        sa.Column(
            "longitud_checkin",
            sa.Float(precision=53),
            nullable=True,
            comment="Coordenada GPS Longitud en check-in",
        ),

        sa.Column(
            "latitud_checkout",
            sa.Float(precision=53),
            nullable=True,
            comment="Coordenada GPS Latitud en check-out",
        ),

        sa.Column(
            "longitud_checkout",
            sa.Float(precision=53),
            nullable=True,
            comment="Coordenada GPS Longitud en check-out",
        ),

        sa.Column(
            "distancia_metros_checkin",
            sa.Numeric(precision=8, scale=2),
            nullable=True,
            comment="Distancia calculada en metros respecto al local",
        ),

        sa.Column(
            "is_checkin_fuera_rango",
            sa.Boolean(),
            nullable=False,
            server_default=sa.text("false"),
            comment="Indica si el check-in excedió la geocerca configurada",
        ),

        sa.Column(
            "observaciones_visita",
            sa.Text(),
            nullable=True,
            comment="Bitácora y comentarios comerciales del promotor",
        ),

        # Auditoría General
        sa.Column(
            "is_activo",
            sa.Boolean(),
            nullable=False,
            server_default=sa.text("true"),
            comment="Estado lógico del registro",
        ),

        sa.Column(
            "created_at",
            sa.TIMESTAMP(timezone=True),
            nullable=False,
            server_default=sa.text("now()"),
            comment="Fecha de creación",
        ),

        sa.Column(
            "updated_at",
            sa.TIMESTAMP(timezone=True),
            nullable=False,
            server_default=sa.text("now()"),
            comment="Fecha de última actualización",
        ),

        sa.Column(
            "deleted_at",
            sa.TIMESTAMP(timezone=True),
            nullable=True,
            comment="Fecha de eliminación lógica",
        ),

        sa.Column(
            "created_by",
            postgresql.UUID(as_uuid=True),
            nullable=True,
            comment="Usuario creador",
        ),

        sa.Column(
            "updated_by",
            postgresql.UUID(as_uuid=True),
            nullable=True,
            comment="Usuario modificador",
        ),

        sa.PrimaryKeyConstraint(
            "id",
            name="pk_trx_visitas",
        ),

        sa.UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_trx_visitas_empresa_id",
        ),

        sa.CheckConstraint(
            "num_nonnulls(cliente_id, prospecto_id) = 1",
            name="ck_trx_visitas_destino_exclusivo",
        ),

        sa.ForeignKeyConstraint(
            ["empresa_id", "promotor_id"],
            ["fuerza_ventas.mae_promotores.empresa_id", "fuerza_ventas.mae_promotores.id"],
            name="fk_trx_visitas_promotor",
        ),

        sa.ForeignKeyConstraint(
            ["empresa_id", "tipo_actividad_id"],
            ["fuerza_ventas.cat_tipos_actividad.empresa_id", "fuerza_ventas.cat_tipos_actividad.id"],
            name="fk_trx_visitas_tipo_actividad",
        ),

        sa.ForeignKeyConstraint(
            ["empresa_id", "estado_visita_id"],
            ["fuerza_ventas.cat_estados_visita.empresa_id", "fuerza_ventas.cat_estados_visita.id"],
            name="fk_trx_visitas_estado",
        ),

        comment="Transacción de Visitas y Agenda en Campo",
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_trx_visitas_empresa_activo",
        "trx_visitas",
        ["empresa_id", "is_activo"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_trx_visitas_empresa_promotor_fecha",
        "trx_visitas",
        ["empresa_id", "promotor_id", "fecha_planificada"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_trx_visitas_empresa_cliente",
        "trx_visitas",
        ["empresa_id", "cliente_id"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_trx_visitas_empresa_prospecto",
        "trx_visitas",
        ["empresa_id", "prospecto_id"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_trx_visitas_empresa_estado",
        "trx_visitas",
        ["empresa_id", "estado_visita_id"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.execute(
        """
        ALTER TABLE fuerza_ventas.trx_visitas
        ENABLE ROW LEVEL SECURITY;
        """
    )

    op.execute(
        """
        CREATE POLICY rls_trx_visitas_empresa
        ON fuerza_ventas.trx_visitas
        FOR ALL
        USING (
            empresa_id = current_setting(
                'app.current_empresa_id',
                true
            )::BIGINT
        )
        WITH CHECK (
            empresa_id = current_setting(
                'app.current_empresa_id',
                true
            )::BIGINT
        );
        """
    )


def downgrade() -> None:

    op.execute(
        """
        DROP POLICY IF EXISTS rls_trx_visitas_empresa
        ON fuerza_ventas.trx_visitas;
        """
    )

    op.execute(
        """
        ALTER TABLE fuerza_ventas.trx_visitas
        DISABLE ROW LEVEL SECURITY;
        """
    )

    op.drop_index(
        "ix_trx_visitas_empresa_estado",
        table_name="trx_visitas",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_trx_visitas_empresa_prospecto",
        table_name="trx_visitas",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_trx_visitas_empresa_cliente",
        table_name="trx_visitas",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_trx_visitas_empresa_promotor_fecha",
        table_name="trx_visitas",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_trx_visitas_empresa_activo",
        table_name="trx_visitas",
        schema="fuerza_ventas",
    )

    op.drop_table(
        "trx_visitas",
        schema="fuerza_ventas",
    )