Saltar a contenido

CfgSecuenciaPedido — fuerza_ventas.cfg_secuencia_pedido

Configuración y control de secuencia numérica correlativa de pedidos.

import uuid
from datetime import datetime
from typing import Optional

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


class Base(DeclarativeBase):
    pass


class CfgSecuenciaPedido(Base):
    """
    Configuración y control de secuencia numérica correlativa de pedidos.

    Garantiza la generación concurrente y atómica de correlativos anuales
    de órdenes de pedido para la fuerza de ventas segregadas por tenant.

    Legacy:
        Control de secuencias monolítico o autonumérico centralizado
    """

    __tablename__ = "cfg_secuencia_pedido"

    __table_args__ = (
        UniqueConstraint(
            "empresa_id",
            "id",
            name="uq_cfg_secuencia_pedido_empresa_id",
        ),
        UniqueConstraint(
            "empresa_id",
            "anio",
            name="uq_cfg_secuencia_pedido_empresa_anio",
        ),
        CheckConstraint(
            "anio >= 2000 AND anio <= 2100",
            name="ck_cfg_secuencia_pedido_anio_valido",
        ),
        CheckConstraint(
            "ultimo_numero >= 0",
            name="ck_cfg_secuencia_pedido_ultimo_numero_positivo",
        ),
        Index(
            "ix_cfg_secuencia_pedido_empresa_id",
            "empresa_id",
        ),
        Index(
            "ix_cfg_secuencia_pedido_empresa_anio",
            "empresa_id",
            "anio",
        ),
        {
            "schema": "fuerza_ventas",
            "comment": "Configuración y control de secuencias y correlativos numéricos de pedidos de venta por año y empresa.",
        },
    )

    # Clave Primaria
    id: Mapped[int] = mapped_column(
        BigInteger,
        primary_key=True,
        autoincrement=True,
        comment="Identificador interno autogenerado.",
    )

    # Multi-Tenant & Secuencia
    empresa_id: Mapped[int] = mapped_column(
        BigInteger,
        nullable=False,
        comment="Identificador BIGINT de la empresa en core.identidad (RLS).",
    )

    anio: Mapped[int] = mapped_column(
        SmallInteger,
        nullable=False,
        comment="Año fiscal de la secuencia del pedido.",
    )

    ultimo_numero: Mapped[int] = mapped_column(
        BigInteger,
        nullable=False,
        server_default=text("0"),
        comment="Último número de secuencia generado para el año.",
    )

    # Auditoría General
    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.",
    )

    created_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario que creó la fila en core.identidad.",
    )

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

    updated_by: Mapped[Optional[uuid.UUID]] = mapped_column(
        UUID(as_uuid=True),
        nullable=True,
        comment="Usuario que realizó la última modificación.",
    )