9c46f5bf3c
Catálogos y selects:
- Incoterm como catálogo (nuevo catálogo global 'incoterm') en solicitud y modal
de conversión de oportunidad.
- Moneda como catálogo en Cotizaciones (nuevo/detalle) y Facturación.
- "Tipo de transporte" desde catálogo medio_transporte (antes lista fija).
- Cotizador: origen/destino como selects alineados a las rutas de los tarifarios
activos (endpoint /rate-locations), para que el costeo siempre encuentre ruta.
Bugs de la sesión:
- Direcciones no guardaban: DTO country String(2)→String(3) (ISO alfa-3); se
amplía accounts.country y se normaliza 'MX'→'MEX' (migración).
- Contacto de proveedor mal filtrado: contacts.ts ahora envía supplier_id.
- Selects ilegibles en modo oscuro: regla global select option en app.css.
- Formas de pago SAT a 2 dígitos (01/04/08) en catálogo y valores guardados.
- RelatedManager: editar direcciones/contactos/documentos (antes solo eliminar).
Oportunidades:
- Se quitan etapas Prospecto/Contactado del embudo semilla.
- Fechas separadas won_date/lost_date + motivo de pérdida, con modal al mover a
Ganada/Perdida (migración).
Facturación:
- Folio automático F{AAAA}-{MM}-{NNN} (next_folio entidad F, sin dirección).
- Moneda como catálogo.
UI:
- Giro "otro" habilita campo para especificar (accounts.industry_other, migración).
- Lista de contactos muestra a quién pertenece (cliente/prospecto/proveedor).
- Proveedores: países/puertos/aeropuertos/aduanas por catálogo (select + chips).
Migraciones reversibles (c2d3e4f5a6b7 ya existía; d3e4f5a6b7c8, e4f5a6b7c8d9).
Suite backend en verde (109). svelte-check sin errores nuevos.
Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
77 lines
4.6 KiB
Python
77 lines
4.6 KiB
Python
from decimal import Decimal
|
|
|
|
from sqlalchemy import Integer, Numeric, String, Text, text
|
|
from sqlalchemy.orm import Mapped, mapped_column
|
|
|
|
from api.v1.common.base_models import TenantScopedMixin, TimestampMixin
|
|
from core.database import Base
|
|
|
|
|
|
class Account(Base, TenantScopedMixin, TimestampMixin):
|
|
"""Catálogo de Clientes / Prospectos.
|
|
|
|
Un mismo registro puede ser Cliente o Prospecto (``record_type``). Concentra
|
|
datos generales, comerciales y fiscales; las direcciones, contactos y
|
|
documentos viven en tablas relacionadas (crm.addresses, crm.contacts,
|
|
crm.documents).
|
|
"""
|
|
|
|
__tablename__ = "accounts"
|
|
__table_args__ = {"schema": "crm"}
|
|
|
|
id: Mapped[int] = mapped_column(Integer, primary_key=True, index=True)
|
|
|
|
# ----- Datos generales -----
|
|
name: Mapped[str] = mapped_column(String(255), nullable=False) # razón social
|
|
trade_name: Mapped[str | None] = mapped_column(String(255), nullable=True) # nombre comercial
|
|
rfc: Mapped[str | None] = mapped_column(String(13), nullable=True, index=True)
|
|
curp: Mapped[str | None] = mapped_column(String(18), nullable=True) # persona física
|
|
# Tipo de registro: cliente | prospecto
|
|
record_type: Mapped[str] = mapped_column(String(20), nullable=False, server_default=text("'cliente'"), index=True)
|
|
# Tipo de persona: fisica | moral
|
|
person_type: Mapped[str | None] = mapped_column(String(10), nullable=True)
|
|
industry: Mapped[str | None] = mapped_column(String(120), nullable=True) # giro / industria
|
|
industry_other: Mapped[str | None] = mapped_column(String(120), nullable=True) # especificar cuando giro = "otro"
|
|
# Tipo operativo (immex | agencia_aduanal | importador | exportador | transportista | otro)
|
|
account_type: Mapped[str | None] = mapped_column(String(40), nullable=True)
|
|
# Estatus: active | inactive
|
|
status: Mapped[str] = mapped_column(String(20), nullable=False, server_default=text("'active'"))
|
|
|
|
# ----- Información comercial -----
|
|
# Clasificación: importador | exportador | ambos
|
|
commercial_classification: Mapped[str | None] = mapped_column(String(20), nullable=True)
|
|
# Medio de contacto preferido: llamada | correo | videoconferencia | whatsapp | otro
|
|
preferred_contact_method: Mapped[str | None] = mapped_column(String(20), nullable=True)
|
|
# Texto libre cuando el medio de contacto es "otro"
|
|
preferred_contact_other: Mapped[str | None] = mapped_column(String(120), nullable=True)
|
|
language: Mapped[str | None] = mapped_column(String(40), nullable=True)
|
|
email: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
|
phone: Mapped[str | None] = mapped_column(String(40), nullable=True)
|
|
website: Mapped[str | None] = mapped_column(String(255), nullable=True)
|
|
commercial_observations: Mapped[str | None] = mapped_column(Text, nullable=True) # observaciones generales
|
|
|
|
# ----- Información fiscal -----
|
|
tax_regime: Mapped[str | None] = mapped_column(String(120), nullable=True) # régimen fiscal
|
|
cfdi_use: Mapped[str | None] = mapped_column(String(60), nullable=True) # uso de CFDI
|
|
payment_method: Mapped[str | None] = mapped_column(String(60), nullable=True) # método de pago
|
|
payment_form: Mapped[str | None] = mapped_column(String(60), nullable=True) # forma de pago
|
|
currency: Mapped[str | None] = mapped_column(String(3), nullable=True) # moneda
|
|
credit_limit: Mapped[Decimal | None] = mapped_column(Numeric(14, 2), nullable=True)
|
|
credit_days: Mapped[int | None] = mapped_column(Integer, nullable=True)
|
|
commercial_terms: Mapped[str | None] = mapped_column(Text, nullable=True) # condiciones comerciales
|
|
|
|
# ----- Datos aduaneros / ubicación rápida -----
|
|
patente_aduanal: Mapped[str | None] = mapped_column(String(20), nullable=True)
|
|
# Ubicación de referencia (el detalle vive en crm.addresses)
|
|
address: Mapped[str | None] = mapped_column(Text, nullable=True)
|
|
city: Mapped[str | None] = mapped_column(String(120), nullable=True)
|
|
state: Mapped[str | None] = mapped_column(String(120), nullable=True)
|
|
country: Mapped[str | None] = mapped_column(String(3), nullable=True, server_default=text("'MEX'"))
|
|
|
|
# ----- Observaciones y auditoría -----
|
|
notes: Mapped[str | None] = mapped_column(Text, nullable=True) # comentarios generales
|
|
internal_notes: Mapped[str | None] = mapped_column(Text, nullable=True) # notas internas
|
|
owner_user_id: Mapped[str | None] = mapped_column(String(64), nullable=True, index=True) # vendedor
|
|
created_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
|
|
updated_by: Mapped[str | None] = mapped_column(String(64), nullable=True)
|