Saltar a contenido

Cliente — clientes.mae_clientes

Identidad comercial y fiscal básica del cliente.

"""``clientes.mae_clientes``: identidad comercial y fiscal básica del cliente."""

import uuid
from datetime import date

from sqlalchemy import BigInteger, Date, ForeignKeyConstraint, Index, String, UniqueConstraint, text
from sqlalchemy.dialects.postgresql import UUID
from sqlalchemy.orm import Mapped, mapped_column

from app.db.base import Base
from app.models.mixins import AuditMixin


class Cliente(AuditMixin, Base):
    __tablename__ = "mae_clientes"
    __table_args__ = (
        UniqueConstraint("empresa_id", "id", name="uq_mae_clientes_empresa_id"),
        UniqueConstraint(
            "empresa_id", "codigo", name="uq_mae_clientes_empresa_codigo"
        ),
        UniqueConstraint(
            "empresa_id",
            "tipo_identificacion_id",
            "numero_documento",
            name="uq_mae_clientes_empresa_documento",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "tipo_cliente_id"],
            [
                "clientes.cat_tipos_clientes.empresa_id",
                "clientes.cat_tipos_clientes.id",
            ],
            name="fk_mae_clientes_tipo_cliente",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "tipo_canal_id"],
            [
                "clientes.cat_tipos_canal_comercial.empresa_id",
                "clientes.cat_tipos_canal_comercial.id",
            ],
            name="fk_mae_clientes_tipo_canal",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "clase_cliente_id"],
            [
                "clientes.cat_clases_cliente.empresa_id",
                "clientes.cat_clases_cliente.id",
            ],
            name="fk_mae_clientes_clase",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "modelo_comercial_id"],
            [
                "clientes.cat_modelos_comerciales.empresa_id",
                "clientes.cat_modelos_comerciales.id",
            ],
            name="fk_mae_clientes_modelo",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "grupo_economico_id"],
            [
                "clientes.mae_grupos_economicos.empresa_id",
                "clientes.mae_grupos_economicos.id",
            ],
            name="fk_mae_clientes_grupo_economico",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "unidad_comercial_id"],
            [
                "clientes.cat_unidades_comerciales.empresa_id",
                "clientes.cat_unidades_comerciales.id",
            ],
            name="fk_mae_clientes_unidad_comercial",
        ),
        ForeignKeyConstraint(
            ["empresa_id", "termino_pago_id"],
            [
                "clientes.cat_terminos_pago.empresa_id",
                "clientes.cat_terminos_pago.id",
            ],
            name="fk_mae_clientes_termino_pago",
        ),
        # Referencia circular con rel_clientes_contactos: solo puede crearse
        # una vez que esa tabla exista, por lo que se declara con
        # use_alter=True (ALTER TABLE ... ADD CONSTRAINT posterior), igual
        # que en el script SQL de rel_clientes_contactos.md.
        ForeignKeyConstraint(
            ["empresa_id", "id", "contacto_principal_id"],
            [
                "clientes.rel_clientes_contactos.empresa_id",
                "clientes.rel_clientes_contactos.cliente_id",
                "clientes.rel_clientes_contactos.contacto_id",
            ],
            name="fk_mae_clientes_contacto_principal",
            use_alter=True,
        ),
        Index("ix_mae_clientes_empresa_tipo_canal", "empresa_id", "tipo_canal_id"),
        Index("ix_mae_clientes_empresa_clase", "empresa_id", "clase_cliente_id"),
        Index(
            "ix_mae_clientes_empresa_grupo_economico",
            "empresa_id",
            "grupo_economico_id",
        ),
        Index(
            "ix_mae_clientes_empresa_unidad_comercial",
            "empresa_id",
            "unidad_comercial_id",
        ),
        Index(
            "ix_mae_clientes_empresa_termino_pago",
            "empresa_id",
            "termino_pago_id",
        ),
        {"schema": "clientes"},
    )

    id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True),
        primary_key=True,
        server_default=text("gen_random_uuid()"),
    )
    empresa_id: Mapped[int] = mapped_column(BigInteger, nullable=False)
    codigo: Mapped[str] = mapped_column(String(30), nullable=False)
    razon_social: Mapped[str] = mapped_column(String(200), nullable=False)
    nombre_comercial: Mapped[str | None] = mapped_column(String(200), nullable=True)
    tipo_identificacion_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True), nullable=False
    )
    numero_documento: Mapped[str] = mapped_column(String(30), nullable=False)
    tipo_cliente_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True), nullable=False
    )
    tipo_canal_id: Mapped[uuid.UUID] = mapped_column(
        UUID(as_uuid=True), nullable=False
    )
    clase_cliente_id: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True), nullable=True
    )
    modelo_comercial_id: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True), nullable=True
    )
    grupo_economico_id: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True), nullable=True
    )
    unidad_comercial_id: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True), nullable=True
    )
    termino_pago_id: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True), nullable=True
    )
    contacto_principal_id: Mapped[uuid.UUID | None] = mapped_column(
        UUID(as_uuid=True), nullable=True
    )
    fecha_registro: Mapped[date] = mapped_column(Date, nullable=False)