Saltar a contenido

RelVendedorUnidadComercial — fuerza_ventas.rel_vendedor_unidad_comercial

Habilitación y acceso de vendedores a unidades comerciales por sucursal.

import uuid
from datetime import datetime
from typing import Optional

from sqlalchemy import (
    BigInteger,
    Boolean,
    ForeignKeyConstraint,
    Index,
    UniqueConstraint,
    text,
)
from sqlalchemy.dialects.postgresql import TIMESTAMP, UUID
from sqlalchemy.orm import DeclarativeBase, Mapped, mapped_column


class Base(DeclarativeBase):
    pass


class RelVendedorUnidadComercial(Base):
    """
    Habilitación y acceso de vendedores a unidades comerciales por sucursal.

    Legacy:
        i748t_acceso_uni_comer
    """

    __tablename__ = "rel_vendedor_unidad_comercial"

    __table_args__ = (
        UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_rel_vendedor_unidad_comercial_empresa_id",
        ),
        UniqueConstraint(
            "empresa_id",
            "promotor_id",
            "unidad_comercial_id",
            "sucursal_id",
            name="uq_rel_vendedor_unidad_comercial_asignacion",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "promotor_id"],
            ["fuerza_ventas.mae_promotores.empresa_id", "fuerza_ventas.mae_promotores.id"],
            ondelete="CASCADE",
            name="fk_rel_vendedor_unidad_comercial_promotor",
        ),
        Index(
            "ix_rel_vendedor_unidad_comercial_empresa_activo",
            "empresa_id",
            "is_activo",
        ),
        Index(
            "ix_rel_vendedor_unidad_comercial_empresa_promotor",
            "empresa_id",
            "promotor_id",
        ),
        Index(
            "ix_rel_vendedor_unidad_comercial_empresa_unidad",
            "empresa_id",
            "unidad_comercial_id",
        ),
        Index(
            "ix_rel_vendedor_unidad_comercial_empresa_sucursal",
            "empresa_id",
            "sucursal_id",
        ),
        Index(
            "ix_rel_vendedor_unidad_comercial_lookup",
            "empresa_id",
            "sucursal_id",
            "unidad_comercial_id",
        ),
        {
            "schema": "fuerza_ventas",
            "comment": "Habilitación y acceso de vendedores a unidades comerciales específicas por sucursal.",
        },
    )

    # Clave Primaria UUID
    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        primary_key=True,
        server_default=text("gen_random_uuid()"),
        comment="Identificador interno de la fila, autogenerado UUID.",
    )

    # Multi-Tenant & Relaciones
    empresa_id: Mapped[int] = mapped_column(
        BigInteger,
        nullable=False,
        comment="Empresa dueña del registro (tenencia multiempresa); una política RLS filtra las filas automáticamente por esta columna.",
    )

    promotor_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Referencia a fuerza_ventas.mae_promotores — vendedor/promotor asignado.",
    )

    unidad_comercial_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Referencia lógica a clientes.cat_unidades_comerciales (sin FK real cross-service).",
    )

    sucursal_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        nullable=False,
        comment="Referencia lógica a core.identidad.mae_sucursales (sin FK real cross-database).",
    )

    # 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(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment="Fecha y hora de creación de la fila, la fija un trigger — no la escribe la aplicación.",
    )

    updated_at: Mapped[datetime] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=False,
        server_default=text("now()"),
        comment="Fecha y hora de la última modificación, la mantiene un trigger.",
    )

    deleted_at: Mapped[Optional[datetime]] = mapped_column(
        TIMESTAMP(timezone=True),
        nullable=True,
        comment="Fecha de borrado lógico; NULL mientras la fila está vigente — nunca se borra físicamente una fila.",
    )

    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario que creó la fila (id lógico hacia identidad.mae_usuarios en core_sigfa — sin FK real entre bases).",
    )

    updated_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario que hizo la última modificación (id lógico hacia core_sigfa).",
    )