Saltar a contenido

0034 - cfg_comision_promotor

"""create cfg_comision_promotor

Revision ID: 0034
Revises: 0033
Create Date: 2026-09-18
"""

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 = "0034"
down_revision: Union[str, Sequence[str], None] = "0033"
branch_labels: Union[str, Sequence[str], None] = None
depends_on: Union[str, Sequence[str], None] = None


def upgrade() -> None:

    op.create_table(
        "cfg_comision_promotor",

        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="Referencia a fuerza_ventas.mae_promotores — promotor comercial al que aplica la configuración.",
        ),

        sa.Column(
            "modelo_comercial_id",
            postgresql.UUID(as_uuid=True),
            nullable=False,
            comment="Referencia a clientes.cat_modelos_comerciales — modelo o modalidad comercial aplicable.",
        ),

        sa.Column(
            "porcentaje",
            sa.Numeric(precision=5, scale=2),
            nullable=False,
            server_default=sa.text("0.00"),
            comment="Porcentaje de comisión aplicado sobre las ventas propias del promotor.",
        ),

        sa.Column(
            "porcentaje_supervisado",
            sa.Numeric(precision=5, scale=2),
            nullable=False,
            server_default=sa.text("0.00"),
            comment="Porcentaje de comisión aplicado sobre las ventas de los promotores supervisados.",
        ),

        sa.Column(
            "is_individual",
            sa.Boolean(),
            nullable=False,
            server_default=sa.text("true"),
            comment="Indica si la comisión se calcula de forma individual (no compartida).",
        ),

        sa.Column(
            "tope_venta",
            sa.Numeric(precision=14, scale=2),
            nullable=True,
            comment="Monto tope de venta sobre el que se calcula la comisión, si aplica un límite.",
        ),

        sa.Column(
            "cupo_venta",
            sa.Numeric(precision=14, scale=2),
            nullable=True,
            comment="Cupo de venta objetivo del promotor para este período.",
        ),

        sa.Column(
            "porcentaje_cupo",
            sa.Numeric(precision=5, scale=2),
            nullable=True,
            comment="Porcentaje de bono asociado al cumplimiento del cupo de venta.",
        ),

        sa.Column(
            "bono_cupo",
            sa.Numeric(precision=12, scale=2),
            nullable=True,
            comment="Monto de bono por cumplimiento de cupo, si aplica.",
        ),

        sa.Column(
            "vigente_desde",
            sa.Date(),
            nullable=False,
            server_default=sa.text("CURRENT_DATE"),
            comment="Fecha desde la que rige esta configuración de comisión.",
        ),

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

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

        sa.CheckConstraint(
            "(((porcentaje >= (0)::numeric) AND (porcentaje <= (100)::numeric)) "
            "AND ((porcentaje_supervisado >= (0)::numeric) AND (porcentaje_supervisado <= (100)::numeric)) "
            "AND ((porcentaje_cupo IS NULL) OR ((porcentaje_cupo >= (0)::numeric) AND (porcentaje_cupo <= (100)::numeric))))",
            name="ck_cfg_comision_promotor_porcentajes",
        ),

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

        comment="Configuración de comisión del promotor comercial, con vigencia temporal desde fecha de aplicación e histórico.",
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_cfg_comision_promotor_empresa_id",
        "cfg_comision_promotor",
        ["empresa_id"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_cfg_comision_promotor_empresa_promotor",
        "cfg_comision_promotor",
        ["empresa_id", "promotor_id"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_cfg_comision_promotor_empresa_modelo",
        "cfg_comision_promotor",
        ["empresa_id", "modelo_comercial_id"],
        unique=False,
        schema="fuerza_ventas",
    )

    op.create_index(
        "ix_cfg_comision_promotor_empresa_vigencia",
        "cfg_comision_promotor",
        ["empresa_id", "vigente_desde"],
        unique=False,
        schema="fuerza_ventas",
    )

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

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

    op.execute(
        """
        CREATE POLICY rls_cfg_comision_promotor_empresa
        ON fuerza_ventas.cfg_comision_promotor
        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_cfg_comision_promotor_empresa
        ON fuerza_ventas.cfg_comision_promotor;
        """
    )

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

    op.drop_index(
        "ix_cfg_comision_promotor_empresa_activo",
        table_name="cfg_comision_promotor",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_cfg_comision_promotor_empresa_vigencia",
        table_name="cfg_comision_promotor",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_cfg_comision_promotor_empresa_modelo",
        table_name="cfg_comision_promotor",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_cfg_comision_promotor_empresa_promotor",
        table_name="cfg_comision_promotor",
        schema="fuerza_ventas",
    )

    op.drop_index(
        "ix_cfg_comision_promotor_empresa_id",
        table_name="cfg_comision_promotor",
        schema="fuerza_ventas",
    )

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