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