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