feat(funnel): leads entran como Afluencia al funnel de Oportunidades

- Captura rápida crea lead + oportunidad en etapa Afluencia (vinculadas
  por nueva tabla LeadOportunidad); también aplica a leads creados
  directo en Monday vía webhook
- Transiciones automáticas: AGENDA CITA → Agendo Cita, descarte →
  Perdido (+ dropdown Motivo No Compra), cotización con mismo teléfono
  ACTUALIZA la oportunidad (no duplica) → Cotizador, alta de cliente
  con leadMondayId → Aparto (dedup previo para no duplicar Apartado)
- Columna Desarrollo agregada al board Oportunidades (color_mm6sa20t)
- Migración lead_oportunidad aplicada con migrate diff + resolve (la DB
  tiene drift histórico por db push; migrate dev pedía reset)
- Tests: 322 verdes; smoke en vivo verificado y limpiado

api-gateway/src/controllers/cotizaciones.controller.test.ts

@@ -0,0 +1,114 @@
+import { beforeEach, describe, expect, it, vi } from 'vitest'
+import type { Request, Response } from 'express'
+
+// ---------- Prisma, Monday y Funnel mockeados (los tests no tocan BD ni red) ----------
+
+const prismaMock = vi.hoisted(() => ({
+  cotizacion: {
+    create: vi.fn(),
+    update: vi.fn(),
+  },
+}))
+
+const mondayMock = vi.hoisted(() => ({
+  getUnidad: vi.fn(),
+  crearOportunidad: vi.fn(),
+  actualizarOportunidadCotizacion: vi.fn(),
+}))
+
+const funnelMock = vi.hoisted(() => ({
+  oportunidadPorTelefono: vi.fn(),
+}))
+
+vi.mock('../services/prisma.js', () => ({ prisma: prismaMock }))
+vi.mock('../services/monday.service.js', () => ({ mondayService: mondayMock }))
+vi.mock('../services/funnel.service.js', () => ({ funnelService: funnelMock }))
+
+import { crearCotizacion } from './cotizaciones.controller.js'
+
+const unidadFake = {
+  codigo: 'U-101',
+  modelo: 'M1',
+  fechaEntrega: null,
+  supEstacionamiento: 0,
+  supConstruccion: 60,
+  supExcedente: 0,
+  precioSinAcabados: 1_000_000,
+  precioConAcabados: 1_100_000,
+  status: 'DISPONIBLE',
+  desarrollo: 'DIAGONAL',
+}
+
+const bodyBase = {
+  unidadCodigo: 'U-101',
+  acabados: false,
+  clienteNombre: 'Cliente Demo',
+  clienteTelefono: '4771234567',
+  tipoPropuesta: 'BANCARIO' as const,
+}
+
+function reqFake(body: unknown): Request {
+  return { body } as Request
+}
+
+function resFake() {
+  const json = vi.fn()
+  const status = vi.fn().mockReturnValue({ json })
+  return { res: { json, status } as unknown as Response, status, json }
+}
+
+beforeEach(() => {
+  vi.clearAllMocks()
+  mondayMock.getUnidad.mockResolvedValue(unidadFake)
+  mondayMock.crearOportunidad.mockResolvedValue('op-nueva')
+  mondayMock.actualizarOportunidadCotizacion.mockResolvedValue(undefined)
+  funnelMock.oportunidadPorTelefono.mockResolvedValue(null)
+  prismaMock.cotizacion.create.mockImplementation(async ({ data }) => ({ id: 'cot-1', ...data }))
+  prismaMock.cotizacion.update.mockResolvedValue({})
+})
+
+describe('crearCotizacion (POST /api/cotizaciones) — match con el funnel', () => {
+  it('sin oportunidad mapeada para el teléfono: crea una nueva (comportamiento actual)', async () => {
+    const { res, status, json } = resFake()
+    await crearCotizacion(reqFake(bodyBase), res)
+    expect(status).toHaveBeenCalledWith(201)
+    expect(mondayMock.crearOportunidad).toHaveBeenCalledOnce()
+    expect(mondayMock.actualizarOportunidadCotizacion).not.toHaveBeenCalled()
+    expect(json.mock.calls[0]?.[0]).toMatchObject({ mondayItemId: 'op-nueva' })
+  })
+
+  it('con teléfono de lead mapeado: ACTUALIZA esa oportunidad (no duplica) y la pasa a Cotizador', async () => {
+    funnelMock.oportunidadPorTelefono.mockResolvedValue('op-del-lead')
+    const { res, status, json } = resFake()
+    await crearCotizacion(reqFake(bodyBase), res)
+    expect(status).toHaveBeenCalledWith(201)
+    expect(funnelMock.oportunidadPorTelefono).toHaveBeenCalledWith('4771234567')
+    expect(mondayMock.crearOportunidad).not.toHaveBeenCalled()
+    expect(mondayMock.actualizarOportunidadCotizacion).toHaveBeenCalledOnce()
+    const [opId, datos] = mondayMock.actualizarOportunidadCotizacion.mock.calls[0] as [string, Record<string, unknown>]
+    expect(opId).toBe('op-del-lead')
+    expect(datos).toMatchObject({ unidadCodigo: 'U-101', tipoPropuestaLabel: 'CREDITO BANCARIO', estadoLabel: 'Cotizador' })
+    expect(json.mock.calls[0]?.[0]).toMatchObject({ mondayItemId: 'op-del-lead' })
+    expect(prismaMock.cotizacion.update).toHaveBeenCalledWith({
+      where: { id: 'cot-1' },
+      data: { mondayItemId: 'op-del-lead' },
+    })
+  })
+
+  it('sin teléfono en el body no consulta el funnel', async () => {
+    const { res } = resFake()
+    const { clienteTelefono: _omitido, ...sinTelefono } = bodyBase
+    await crearCotizacion(reqFake(sinTelefono), res)
+    expect(funnelMock.oportunidadPorTelefono).not.toHaveBeenCalled()
+    expect(mondayMock.crearOportunidad).toHaveBeenCalledOnce()
+  })
+
+  it('si Monday falla, la cotización igual se crea (201 con mondayItemId null)', async () => {
+    mondayMock.crearOportunidad.mockRejectedValue(new Error('Monday caído'))
+    const { res, status, json } = resFake()
+    await crearCotizacion(reqFake(bodyBase), res)
+    expect(status).toHaveBeenCalledWith(201)
+    expect(json.mock.calls[0]?.[0]).toMatchObject({ mondayItemId: null })
+    expect(prismaMock.cotizacion.create).toHaveBeenCalledOnce()
+  })
+})