Añade overlay de play sobre la captura de WhatsApp en landing B2B

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>

copy/COPY-GUIDE.md

@@ -327,9 +327,15 @@ Somos los únicos en España que combinamos **captura instantánea del lead + ll
 - **Título del paso:** ¿Cómo prefieres contarnos tu reforma, [Nombre]?
 - **Subtitle:** Tú eliges. Por cualquiera de las tres nos das lo que necesitamos para preparar tu render y tu presupuesto.
 
+- **Stepper de progreso (encima del título):**
+  - Paso 1 (completado): *Tus datos*
+  - Paso 2 (actual): *Tu reforma*
+  - Paso 3 (pendiente): *Render + presupuesto*
+
 - **Tarjeta Llamada — título:** Que te llamemos
   **Descripción:** Un asistente te llama y te hace unas preguntas rápidas. Lo más cómodo: no escribes nada.
   **CTA:** Quiero que me llamen
+  **Badge:** La más rápida
 - **Tarjeta WhatsApp — título:** Por WhatsApp
   **Descripción:** Seguimos por chat a tu ritmo. Puedes mandar fotos y notas cuando quieras.
   **CTA:** Seguir por WhatsApp
@@ -337,6 +343,19 @@ Somos los únicos en España que combinamos **captura instantánea del lead + ll
   **Descripción:** Tú lo cuentas zona por zona y subes las fotos. Recibes el presupuesto al instante.
   **CTA:** Rellenar el formulario
 
+#### Bloque "Qué pasa después" (debajo de las tarjetas del chooser)
+
+> Recuerda al lead lo que va a recibir elija el canal que elija: personalización, render con
+> imágenes en minutos, y visita gratuita posterior para el presupuesto definitivo.
+
+- **Título:** Elijas lo que elijas, esto es lo que pasa después
+- **Paso 1 — título:** Nos cuentas tu reforma a tu manera
+  **Body:** Fotos, medidas, gustos. Cuanto más nos cuentes, más se parecerá el resultado a lo que tienes en la cabeza.
+- **Paso 2 — título:** Render + presupuesto en minutos
+  **Body:** Ves tu espacio ya reformado en imágenes, con un presupuesto orientativo desglosado partida a partida.
+- **Paso 3 — título:** Visita gratuita para el presupuesto final
+  **Body:** Si te convence, acuerdas una visita con [Reformista]: ve la obra, la mide con detalle y te confirma el precio definitivo. Sin compromiso.
+
 ### Paso 2 (canal llamada)
 
 - **Título del paso:** Te llamamos cuando quieras
@@ -714,6 +733,40 @@ del espacio. `[url]` apunta a su formulario personal del funnel. Tono: una sola
 
 ---
 
+## Onboarding del panel (tour guiado)
+
+> Tooltips del tour del panel (driver.js). Tono cercano y útil, una idea por paso, frases cortas. Las pestañas secundarias se explican "de pasada" (una línea). Copy usado en `src/lib/onboarding/panel-tour.ts`.
+
+### Pestaña Leads (`/panel`)
+
+- **Intro** — *Tu panel de Reformix* · "Te enseño en 30 segundos qué hay en cada sitio. Puedes saltártelo cuando quieras con la X."
+- **Leads** — "Aquí caen tus clientes con su presupuesto y su render ya preparados. Es tu día a día."
+- **Precios y baremo** — "Tu tabla de precios, la mano de obra y el baremo de rentabilidad. De aquí salen los presupuestos."
+- **Galería** — "Tus fotos de trabajos para enseñar en la web."
+- **Opiniones** — "Reseñas de tus clientes; las apruebas tú antes de publicarlas."
+- **Empresa** — "Tu marca, logo y datos de contacto."
+- **Filtra por estado** — "Nuevos, contactados, presupuestados… para centrarte en lo que toca ahora."
+- **Tus leads** — "Cada cliente con su estado y su presupuesto. Ábrelo para ver el detalle completo."
+
+### Ficha del lead (`/panel/{id}`)
+
+- **Presupuesto estimado** — "Lo que costaría la reforma según tu catálogo. Si no llega a tu baremo, lo verás en rojo."
+- **Estado del lead** — "Avanza el lead por el funnel: contactado, presupuestado, ganado…"
+- **Render de la reforma** — "La imagen del «después» que ve tu cliente, generada a partir de su foto y sus gustos."
+- **Presupuesto desglosado** — "Edita las partidas, recalcula desde el catálogo y envíaselo al cliente por WhatsApp."
+
+### Precios y baremo (`/panel/precios`)
+
+- **Baremo de rentabilidad** — "El trabajo mínimo que te compensa. Solo te avisa a ti: marca en rojo los leads por debajo."
+- **Mano de obra** — "Tus precios de mano de obra por m². El motor los usa para calcular cada presupuesto."
+- **Tu catálogo** — "Materiales y precios por calidad. Puedes importarlos en bloque por CSV."
+
+### Botón para repetir
+
+- **Botón flotante** — "❓ Tour" (relanza el tour de la pestaña actual).
+
+---
+
 ## Principios aplicados en todo el documento
 
 1. **Beneficios > Features** — "Tus clientes verán su reforma" > "Render IA con SDXL"

docs/arquitectura-integracion.md

@@ -0,0 +1,581 @@
+# Arquitectura de Integración — Reformix
+
+## Índice
+
+1. [Visión general del sistema](#1-visión-general-del-sistema)
+2. [Landing pública y captura del lead (sitio web)](#2-landing-pública-y-captura-del-lead-sitio-web)
+3. [El funnel B2C — pipeline de 7 pasos](#3-el-funnel-b2c--pipeline-de-7-pasos)
+4. [Elección de canal: formulario, llamada o WhatsApp](#4-elección-de-canal-formulario-llamada-o-whatsapp)
+5. [Sistema de webhooks salientes (app → bot/worker)](#5-sistema-de-webhooks-salientes-app--botworker)
+6. [Sistema de endpoints de bot (app ← bot/worker)](#6-sistema-de-endpoints-de-bot-app--botworker)
+7. [El agente de WhatsApp (Luisa)](#7-el-agente-de-whatsapp-luisa)
+8. [Workers: render de imágenes y presupuesto](#8-workers-render-de-imágenes-y-presupuesto)
+9. [El presupuesto como entregable final](#9-el-presupuesto-como-entregable-final)
+10. [Diagrama de flujo completo](#10-diagrama-de-flujo-completo)
+11. [Estado actual vs lo que falta](#11-estado-actual-vs-lo-que-falta)
+12. [Guía de conexión: cómo integrar Luisa + Workers con la app](#12-guía-de-conexión-cómo-integrar-luisa--workers-con-la-app)
+
+---
+
+## 1. Visión general del sistema
+
+Reformix es un SaaS multi-tenant para empresas de reformas. Tiene **dos caras**:
+
+- **B2B (reformista):** el reformista se registra, configura su perfil, catálogo de materiales, precios, y pone un widget en su web.
+- **B2C (cliente final):** el cliente llega a la landing del reformista, pide presupuesto, sube fotos, y recibe un presupuesto con render "antes/después" en < 7 minutos.
+
+### Componentes del sistema
+
+```
+┌─────────────────────────────────────────────────────────────────┐
+│                    SITIO WEB (Next.js)                          │
+│  Landing → Formulario → Elección canal → Pipeline → Entrega     │
+│  ┌─────────────────────────────────────────────────────────┐   │
+│  │  App Reformix (mvp/b2c/)                                │   │
+│  │  - Landing pública /[slug]                               │   │
+│  │  - Funnel B2C /solicitud/[id]/*                         │   │
+│  │  - Panel reformista /panel/*                             │   │
+│  │  - API endpoints para bot (mvp/b2c/src/app/api/leads/)  │   │
+│  │  - Motor de presupuesto (mvp/b2c/src/budget/)           │   │
+│  │  - Generación de PDF (mvp/b2c/src/lib/pdf/)             │   │
+│  │  - Envío de email (mvp/b2c/src/lib/email/)              │   │
+│  │  - Webhooks salientes (mvp/b2c/src/lib/webhooks.ts)     │   │
+│  └─────────────────────────────────────────────────────────┘   │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────┐
+│  AGENTE WHATSAPP (Luisa) — EXTERNO                             │
+│  (mvp/Whatsapp-bot/)                                           │
+│  - Conexión WhatsApp via Baileys                               │
+│  - Pipeline Claude 4-capas para cualificar leads               │
+│  - DEBE usar API HTTP de la app (hoy escribe directo a BD)     │
+└─────────────────────────────────────────────────────────────────┘
+
+┌─────────────────────────────────────────────────────────────────┐
+│  WORKERS (Render + Análisis) — NO IMPLEMENTADO AÚN             │
+│  - Generación de renders "después" (Nano Banana 2 / Image 2)   │
+│  - Análisis de fotos con IA                                    │
+│  - DEBE recibir webhook PERFIL_WEBHOOK_URL y devolver vía API  │
+└─────────────────────────────────────────────────────────────────┘
+```
+
+---
+
+## 2. Landing pública y captura del lead (sitio web)
+
+### Flujo de captura
+
+```
+Usuario llega a /[slug] (landing del reformista)
+         │
+         ▼
+  Rellena formulario Hero:
+  - nombre + email + teléfono
+  - consentimiento privacidad + contratación (RGPD obligatorio)
+         │
+         ▼
+  crearLead(slug, data) → Server Action
+         │
+         ├── Valida con Zod schema
+         ├── Busca tenant por slug
+         ├── INSERT en leads (pipelineStage: 'form_completado', estado: 'nuevo')
+         └── INSERT en leadPipelineEventos (stage: 'form_completado')
+```
+
+### Lo que crea la base de datos
+
+El lead se crea con:
+
+- `id` (UUID) — **este es el leadId que usará todo el sistema**
+- `tenantId` (UUID) — referencia al reformista
+- `nombre`, `email`, `telefono` — datos del cliente
+- `pipelineStage: 'form_completado'` — dónde está en el pipeline
+- `estado: 'nuevo'` — estado comercial
+
+**Importante:** El lead NO tiene aún `tipoReforma`, `m2Suelo`, `calidadGlobal`, etc. Esos se rellenan después, cuando el cliente pasa por el canal elegido.
+
+---
+
+## 3. El funnel B2C — pipeline de 7 pasos
+
+Definido por el enum `pipelineStage` en `src/db/schema.ts`:
+
+| #   | Stage                  | Qué ocurre                                     | Quién lo dispara                                        |
+| --- | ---------------------- | ---------------------------------------------- | ------------------------------------------------------- |
+| 1   | `form_completado`      | Lead creado con datos básicos                  | Server Action `crearLead()`                             |
+| 2   | `fotos_subidas`        | Cliente describe reforma + sube fotos por zona | Server Action `guardarDetallesYFotos()` o API `ingesta` |
+| 3   | `prellamada_enviada`   | Notificación SMS/WhatsApp previa a llamada     | Orchestrator `procesarLead()` o bot                     |
+| 4   | `llamada_completada`   | Agente IA (Retell) cualifica al lead           | Orchestrator (simulado) o webhook Retell (real)         |
+| 5   | `render_generado`      | Render "después" generado por IA               | Orchestrator (simulado con imagen demo)                 |
+| 6   | `presupuesto_generado` | Presupuesto calculado con motor real           | Orchestrator `procesarLead()`                           |
+| 7   | `whatsapp_entregado`   | PDF entregado al cliente                       | `finalizarYEntregar()`                                  |
+
+### Pipeline automático (`procesarLead`)
+
+Cuando el cliente completa el formulario detallado (con zonas, fotos, etc.), la app ejecuta:
+
+```typescript
+guardarDetallesYFotos(leadId, formData)
+  ├── Guarda fotos (momento: 'antes') en leadFotos
+  ├── Guarda notas en leadNotas
+  ├── Calcula tipoReforma, m2Suelo, calidadGlobal desde las zonas
+  ├── UPDATE lead (pipelineStage: 'fotos_subidas')
+  │
+  └── procesarLead(leadId) ← ORQUESTRADOR
+       ├── Paso 4: Evento prellamada_enviada
+       ├── Paso 5: Llamada Retell (real si configurado, sino simulada con transcript ficticio)
+       ├── Paso 6a: Render demo (imagen estática, NO IA real)
+       ├── Paso 6b: Presupuesto REAL con motor (computeBudget)
+       ├── UPDATE lead (pipelineStage: 'presupuesto_generado')
+       └── Paso 7: Si envio=automatico → lead pasa a 'whatsapp_entregado'
+```
+
+---
+
+## 4. Elección de canal: formulario, llamada o WhatsApp
+
+Después de crear el lead, el cliente llega a `/solicitud/[id]/` donde elige cómo continuar:
+
+### Canal formulario (`/solicitud/[id]/formulario`)
+
+El cliente rellena un formulario multi-zona: tipo de reforma, m², calidad, notas, sube fotos. Esto dispara `guardarDetallesYFotos()` que ejecuta el pipeline completo (incluyendo llamada simulada, render demo, presupuesto real).
+
+### Canal llamada (`/solicitud/[id]/llamada`)
+
+El cliente pide que le llamen (ahora o programado). Se le envía un email con enlace para subir fotos después. Dispara `pedirLlamada()` que inicia llamada Retell saliente (si configurado). El cliente recibe la llamada del agente IA, y después puede subir fotos via el enlace del email.
+
+### Canal WhatsApp (`/solicitud/[id]/whatsapp`)
+
+El cliente elige continuar por WhatsApp. La app dispara `iniciarWhatsapp()` que:
+
+```typescript
+iniciarWhatsapp(leadId)
+  └── POST a WHATSAPP_START_WEBHOOK_URL
+       Payload: { leadId, telefono, nombre, empresa }
+       → El bot de WhatsApp (Luisa) recibe esto y empieza la conversación
+```
+
+**Este es el punto de entrada del bot de WhatsApp.** El bot recibe el `leadId` y a partir de ahí debe escribir los datos extraídos de la conversación usando los endpoints de la app.
+
+---
+
+## 5. Sistema de webhooks salientes (app → bot/worker)
+
+La app envía 3 señales HTTP a sistemas externos. Todas son **best-effort** (nunca lanzan error, devuelven boolean).
+
+### 5.1 WHATSAPP_START_WEBHOOK_URL — Arranque de conversación WhatsApp
+
+**Disparado por:** `iniciarWhatsapp()` (cuando el lead elige canal WhatsApp)
+
+```json
+POST {url}
+{
+  "leadId": "uuid",
+  "telefono": "+34...",
+  "nombre": "...",
+  "empresa": "Reformas Ejemplo"
+}
+```
+
+**La app espera que:** el bot de WhatsApp reciba esto y comience la conversación con el lead. El bot debe usar el `leadId` para escribir los datos vía los endpoints de la app.
+
+### 5.2 PERFIL_WEBHOOK_URL — Perfil completo para generar renders
+
+**Disparado por:**
+
+- `señalarPerfilCompleto()` en `guardarDetallesYFotos()` (formulario)
+- `señalarPerfilCompleto()` en `subirFotos()` (fotos por email)
+- API `ingesta` con flag `perfilCompleto: true` (bot/worker)
+
+```json
+POST {url}
+{
+  "leadId": "uuid",
+  "cliente": { "nombre": "...", "telefono": "...", "email": "...", "provincia": "..." },
+  "reforma": { "tipo": "cocina", "m2Suelo": 12, "calidad": "media",
+               "estructural": false, "urgencia": "media", "presupuestoTarget": 800000 },
+  "preferencias": { "estilo": "nórdico", "gustos": "tonos azules, muebles de madera, encimera clara" },
+  "empresa": { "tenantId": "uuid", "nombre": "Reformas Ejemplo" },
+  "zonas": [
+    { "zona": "cocina",
+      "notas": ["encimera de cuarzo"],
+      "fotos": { "antes": ["data:image/..."], "despues": [] } }
+  ]
+}
+```
+
+**`preferencias`** (opcional): gustos estéticos del cliente capturados en la conversación (`estilo` =
+campo `estilo` del lead; `gustos` = `tasteText`, resumen en texto libre de colores/materiales/acabados
+que pidió). Cada clave se omite si está vacía. El worker los inyecta como bloque dedicado en el prompt
+de imagen para que el render los represente; si no llegan, infiere un estilo neutro.
+
+**La app espera que:** el worker externo genere renders "después" a partir de las fotos "antes"
+respetando las `preferencias` del cliente, y los devuelva haciendo POST al endpoint
+`/api/leads/:id/ingesta` con `momento: "despues"` y opcionalmente `finalizar: true`.
+
+### 5.3 WHATSAPP_WEBHOOK_URL — Entrega del PDF
+
+**Disparado por:** `finalizarYEntregar()` (cuando el PDF está listo)
+
+```json
+POST {url}
+{
+  "leadId": "uuid",
+  "telefono": "+34...",
+  "nombre": "...",
+  "empresa": "Reformas Ejemplo",
+  "pdfBase64": "JVBERi0xLj...",
+  "filename": "presupuesto-nombre.pdf"
+}
+```
+
+**La app espera que:** el bot de WhatsApp reciba esto y envíe el PDF al cliente por WhatsApp.
+
+---
+
+## 6. Sistema de endpoints de bot (app ← bot/worker)
+
+La app expone 5 endpoints bajo `/api/leads/:id/`. Todos requieren `Authorization: Bearer <FUNNEL_API_KEY>`.
+
+| Endpoint                           | Qué hace                                             | Tabla que escribe                                                      |
+| ---------------------------------- | ---------------------------------------------------- | ---------------------------------------------------------------------- |
+| `POST /api/leads/:id/conversacion` | Guarda un turno del chat                             | `conversacion_whatsapp`                                                |
+| `POST /api/leads/:id/perfil`       | Actualiza datos extraídos del lead                   | `leads` (campos: espacio, rangoM2, estilo, tipoReforma, m2Suelo, etc.) |
+| `POST /api/leads/:id/calificacion` | Upsert de calificación                               | `lead_calificacion`                                                    |
+| `POST /api/leads/:id/intento`      | Registra intento de contacto                         | `intentos_contacto`                                                    |
+| `POST /api/leads/:id/ingesta`      | Sube fotos/notas + flags de perfilCompleto/finalizar | `lead_fotos`, `lead_notas`                                             |
+
+### Flujo de uso típico del bot
+
+```
+1. Bot recibe WHATSAPP_START_WEBHOOK → leadId, telefono, nombre
+2. Bot inicia conversación por WhatsApp
+3. Por cada interacción:
+   a. Bot llama POST /conversacion (guarda el turno)
+   b. Bot llama POST /perfil (actualiza datos extraídos: espacio, m2, estilo, etc.)
+   c. Cuando tiene datos suficientes, llama POST /calificacion
+   d. Cuando pide fotos, el cliente las envía, bot las guarda vía POST /ingesta
+4. Cuando el perfil está completo:
+   - Bot marca perfilCompleto: true en POST /ingesta
+   - Esto dispara PERFIL_WEBHOOK_URL → worker genera renders
+   - Worker devuelve renders vía POST /ingesta con momento: "despues" + finalizar: true
+   - finalizar:true dispara WHATSAPP_WEBHOOK_URL → bot recibe PDF y lo envía al cliente
+```
+
+---
+
+## 7. El agente de WhatsApp (Luisa)
+
+### Estado actual (código en `mvp/Whatsapp-bot/`)
+
+El bot de Luisa es un servicio NestJS independiente que:
+
+1. **Se conecta a WhatsApp** usando la librería Baileys (WebSocket no oficial)
+2. **Orquesta un pipeline Claude de 4 capas:**
+   - Capa 1 — Clasificador (Haiku): extrae intención y valor del mensaje
+   - Capa 2 — Validador: valida contra valores permitidos
+   - Capa 3 — Generador (Sonnet): produce el borrador de respuesta
+   - Capa 4 — Reglas (Haiku): corrige tono e identidad
+3. **Mantiene una máquina de estados** de 7 pasos para cualificar al lead:
+   `nuevo → apertura → espacio → tamano → estilo → urgencia → presupuesto → fin`
+4. **Tiene un scheduler** que cada 5 minutos busca leads "nuevos" en BD y les envía el mensaje de apertura
+5. **Soporta multimedia:** transcripción de audio (Gemini), análisis de imágenes (Claude Vision)
+
+### Problema actual
+
+El bot **escribe directamente a Postgres** usando TypeORM con sus propias entidades (`Lead` y `Conversacion`), en lugar de usar los endpoints HTTP de la app. Esto causa:
+
+- Incompatibilidad de IDs: el bot usa `id` numérico autoincremental, la app usa UUID
+- Tablas duplicadas: el bot tiene su propia tabla `conversacion`, la app tiene `conversacion_whatsapp`
+- Enums desalineados: el bot usa `urgente/medio_plazo/frio`, la app usa `alta/media/baja`
+- `synchronize: true` en TypeORM puede alterar el schema de la BD real
+- El scheduler crea leads desde cero, pero según la arquitectura los leads ya existen (creados desde el form web)
+
+### Lo que DEBE hacer el bot
+
+1. **No crear leads.** Recibirlos vía `WHATSAPP_START_WEBHOOK_URL` con el `leadId` UUID.
+2. **No escribir a BD directamente.** Usar los 5 endpoints HTTP (`conversacion`, `perfil`, `calificacion`, `intento`, `ingesta`).
+3. **No tener scheduler propio.** El arranque lo hace la app vía webhook.
+4. **Usar los enums correctos** según la app (`alta/media/baja`, `cocina/bano/salon/comedor/integral/otro`, etc.).
+5. **No mantener estado propio.** El estado de la conversación (`botStep`) se persiste vía `/perfil`.
+
+### Dónde está el código
+
+| Elemento                | Ruta                         |
+| ----------------------- | ---------------------------- |
+| Código del bot (NestJS) | `mvp/Whatsapp-bot/src/`      |
+| Prompts de Luisa        | `mvp/Whatsapp-bot/prompts/`  |
+| Configuración (.env)    | `mvp/Whatsapp-bot/.env`      |
+| Documentación del bot   | `mvp/Whatsapp-bot/README.md` |
+
+---
+
+## 8. Workers: render de imágenes y presupuesto
+
+### Estado actual
+
+Los workers **no están implementados**. Existe:
+
+- La **tabla `worker_jobs`** en la BD (`mvp/b2c/src/db/schema.ts:515-537`) con tipos: `analisis_fotos`, `render`, `presupuesto_ia`
+- El **webhook `PERFIL_WEBHOOK_URL`** listo para enviar el perfil completo al worker
+- El **endpoint `ingesta`** listo para recibir los renders de vuelta
+- **Renders simulados** con imágenes estáticas en `procesarLead()` (usa `/despues.webp`, `/despues-bano.webp`, etc.)
+
+### Lo que DEBE hacer el worker de renders
+
+```
+1. Recibe POST a PERFIL_WEBHOOK_URL con:
+   { leadId, cliente, reforma, empresa, zonas: [{ zona, notas, fotos: { antes: [...], despues: [] } }] }
+
+2. Para cada zona:
+   a. Toma las fotos "antes" del cliente
+   b. Genera render "después" usando modelo de IA (Nano Banana 2, Image 2, Stable Diffusion, etc.)
+   c. Convierte el render a data URI base64
+
+3. Devuelve los renders haciendo POST a /api/leads/:id/ingesta:
+   { items: [{ tipo: "foto", zona: "cocina", momento: "despues", imagen: "data:image/..." }],
+     finalizar: true }
+   (finalizar:true dispara la construcción del PDF + email + señal WhatsApp)
+```
+
+### Stack planeado para renders
+
+Según la documentación:
+
+- **Nano Banana 2** o **Image 2** (Google Gemini) — modelos image-to-image
+- Alternativa: **Replicate SDXL + ControlNet** (~0,02€/imagen)
+- Alternativa: **DALL-E 3 HD** (~0,08€/imagen)
+
+### Dónde implementar los workers
+
+Los workers son servicios externos independientes. Pueden ser:
+
+- **n8n workflows** (orquestación visual)
+- **Un worker Node.js/Python** que escucha webhooks y se comunica con APIs de IA
+- **Cloud Functions** (Vercel, Cloudflare Workers, AWS Lambda)
+
+No hay código de workers en este repositorio. El repositorio solo define el contrato (webhooks + API).
+
+---
+
+## 9. El presupuesto como entregable final
+
+El entregable final es un **PDF de presupuesto** que incluye:
+
+1. **Cabecera** con datos del reformista (logo, nombre, CIF, dirección)
+2. **Datos del cliente** y tipo de reforma
+3. **Tabla de presupuesto** con partidas calculadas por el motor:
+   - Demolición, impermeabilización, alicatado, fontanería, electricidad, carpintería, mano de obra, extras, licencia
+4. **Render "después"** generado por IA
+5. **Galería por zona** con fotos "antes" y "después"
+6. **Footer legal**
+
+### El motor de presupuesto (`mvp/b2c/src/budget/`)
+
+**Es real, no simulado.** Calcula presupuestos basado en:
+
+- Catálogo de materiales del reformista (precios por calidad: básica/media/premium)
+- Configuración de precios (factores por zona, mano de obra, extras fijos)
+- Inputs del lead: tipo de reforma, m², calidad, urgencia, estructural, provincia
+
+### Flujo de entrega
+
+```
+finalizarYEntregar(leadId)
+  ├── construirPresupuestoPdf(leadId)
+  │    ├── Carga lead completo + fotos + notas + catálogo + config
+  │    ├── Renderiza PDF con @react-pdf
+  │    └── Devuelve buffer PDF + filename
+  │
+  ├── UPDATE lead (pdfUrl)
+  │
+  ├── enviarPresupuestoEmail() → SMTP (opcional)
+  │
+  ├── notificarFlujoWhatsapp() → WHATSAPP_WEBHOOK_URL
+  │    └── Bot recibe pdfBase64 y lo envía por WhatsApp
+  │
+  └── UPDATE lead (pipelineStage: 'whatsapp_entregado', estado: 'presupuesto_enviado')
+```
+
+---
+
+## 10. Diagrama de flujo completo
+
+```
+                  LANDING PÚBLICA /[slug]
+                        │
+                   crearLead()
+                        │
+                        ▼
+            ┌───────────────────────┐
+            │   Lead CREADO         │
+            │   pipelineStage:       │
+            │   form_completado      │
+            │   estado: nuevo        │
+            └───────────┬───────────┘
+                        │
+                        ▼
+           ┌────────────────────────┐
+           │  ELECCIÓN DE CANAL     │
+           │  /solicitud/[id]/      │
+           └──────┬────────┬───────┘
+                  │        │
+         ┌────────┘        └────────┐
+         ▼                          ▼
+   ┌──────────────┐         ┌──────────────┐
+   │  FORMULARIO  │         │  WHATSAPP    │
+   │  + fotos     │         │              │
+   └──────┬───────┘         │ iniciar      │
+          │                 │ Whatsapp()   │
+          │                 └──────┬───────┘
+          │ guardarDetalles        │
+          │ YFotos()               │ POST WHATSAPP
+          │                        │ START WEBHOOK
+          ├── Guarda fotos         │
+          ├── Guarda notas          ▼
+          │                 ┌──────────────┐
+          └── procesarLead() │  BOT WHATSAPP │
+               │            │  (Luisa)      │
+               │            │               │
+               ├── Simula    │ Inicia        │
+               │   llamada   │ conversación  │
+               │             │               │
+               ├── Render    │ Por cada msg: │
+               │   demo      │ POST /perfil  │
+               │   (img fija)│ POST /conv.   │
+               │             │               │
+               ├── Presup.   │ Cuando listo: │
+               │   REAL      │ POST /ingesta │
+               │             │ perfilCompleto│
+               │             │               │
+               └── Estado    └──────┬────────┘
+                   intermedio       │
+                        │          │
+                        ▼          │
+               ┌────────────────────┘
+               │ PERFIL_WEBHOOK_URL
+               ▼
+        ┌──────────────────┐
+        │  WORKER RENDER   │
+        │  Genera imágenes │
+        │  "después"       │
+        └────────┬─────────┘
+                 │ POST /api/leads/:id/ingesta
+                 │ { items: [{tipo:"foto", momento:"despues",...}],
+                 │   finalizar: true }
+                 ▼
+        ┌──────────────────────────────┐
+        │  finalizarYEntregar()        │
+        │  - Construye PDF             │
+        │  - Envía email               │
+        │  - WHATSAPP_WEBHOOK_URL      │
+        └────────┬─────────────────────┘
+                 │
+                 ▼
+        ┌──────────────────┐
+        │  BOT WHATSAPP    │
+        │  Recibe pdfBase64│
+        │  y lo envía al   │
+        │  cliente         │
+        └──────────────────┘
+```
+
+---
+
+## 11. Estado actual vs lo que falta
+
+| Componente                   | Estado                          | Notas                                              |
+| ---------------------------- | ------------------------------- | -------------------------------------------------- |
+| Landing pública / formulario | ✅ Implementado                 | Multi-zona, fotos, notas                           |
+| Motor de presupuesto         | ✅ Implementado                 | Real, con catálogo y config                        |
+| PDF                          | ✅ Implementado                 | Con @react-pdf                                     |
+| Email                        | ✅ Implementado                 | SMTP, best-effort                                  |
+| Endpoints API del bot        | ✅ Implementado y en producción | 5 endpoints en `dv3.com.es`                        |
+| Webhooks salientes           | ✅ Implementado                 | 3 webhooks listos                                  |
+| Autenticación bot            | ✅ Implementado                 | Bearer token con FUNNEL_API_KEY                    |
+| Bot WhatsApp (Luisa)         | ❌ Por reconectar               | Hoy escribe directo a BD, debe usar APIs HTTP      |
+| Workers render               | ❌ No implementado              | Existe solo tabla y webhook, sin worker real       |
+| Renders IA                   | ❌ Simulado                     | Usa imágenes estáticas `/despues.webp`             |
+| Llamada Retell real          | ⚠️ Parcial                      | Código listo, depende de config de vars de entorno |
+| n8n workflows                | ❌ No existe                    | Mencionado en docs pero sin implementar            |
+
+---
+
+## 12. Guía de conexión: cómo integrar Luisa + Workers con la app
+
+### 12.1 Lo que necesita el bot de WhatsApp (Luisa)
+
+El bot DEBE:
+
+1. **Recibir leads por webhook** (`WHATSAPP_START_WEBHOOK_URL`), no buscarlos en BD.
+2. **Usar los endpoints HTTP de la app** en lugar de TypeORM:
+   - `POST /api/leads/:id/conversacion` — para cada turno del chat
+   - `POST /api/leads/:id/perfil` — para actualizar datos extraídos
+   - `POST /api/leads/:id/calificacion` — para calificar al lead
+   - `POST /api/leads/:id/intento` — para registrar intentos
+   - `POST /api/leads/:id/ingesta` — para subir fotos y marcar perfil completo
+3. **Usar los enums correctos** de la app:
+   - `urgencia`: `alta`, `media`, `baja`
+   - `tipoReforma`: `cocina`, `bano`, `salon`, `comedor`, `integral`, `otro`
+   - `calidadGlobal`: `basica`, `media`, `premium`
+   - `estadoWa`: `sin_enviar`, `enviado`, `entregado`, `leido`, `fallido`
+   - `canalOrigen`: `formulario_web`, `whatsapp`, `llamada`, `referido`, `anuncio`
+4. **Trabajar con UUIDs** (el `leadId` que recibe del webhook).
+5. **No tener scheduler interno** — la app controla cuándo arrancar.
+
+### 12.2 Lo que necesita el worker de renders
+
+El worker DEBE:
+
+1. **Escuchar en la URL que configures como `PERFIL_WEBHOOK_URL`** (POST /perfil-completo).
+2. **Recibir el payload** con `leadId`, `cliente`, `reforma`, `zonas` (con fotos "antes").
+3. **Generar renders** para cada zona: Etapa 1 (Claude Haiku → prompt), Etapa 2 (Gemini Flash → imagen), Etapa 3 (Claude Haiku Vision → validación). Todo via OpenRouter.
+4. **Devolver los renders** llamando a `POST /api/leads/:id/ingesta` con:
+5. **Autenticarse** con `Authorization: Bearer <FUNNEL_API_KEY>`.
+   ```json
+   {
+     "items": [
+       {
+         "tipo": "foto",
+         "zona": "cocina",
+         "momento": "despues",
+         "imagen": "data:image/..."
+       }
+     ],
+     "finalizar": true
+   }
+   ```
+5. **Autenticarse** con `Authorization: Bearer <FUNNEL_API_KEY>`.
+
+### 12.3 Variables de entorno necesarias en la app
+
+```
+# Para que el bot pueda escribir en la BD:
+FUNNEL_API_KEY=<clave-compartida>
+
+# URLs donde escuchan el bot y el worker:
+WHATSAPP_START_WEBHOOK_URL=https://url-del-bot/whatsapp-start
+PERFIL_WEBHOOK_URL=https://url-del-worker/perfil-completo
+WHATSAPP_WEBHOOK_URL=https://url-del-bot/whatsapp-pdf
+```
+
+### 12.4 Secuencia de integración recomendada
+
+**Paso 1 — Reconectar Luisa a los endpoints HTTP (prioridad alta)**
+
+- Eliminar TypeORM y las entidades propias del bot
+- Implementar llamadas HTTP a los 5 endpoints de la app
+- Ajustar enums y tipos para que coincidan con la app
+- Eliminar el scheduler interno
+- Configurar las 3 URLs de webhook en la app
+
+**Paso 2 — Implementar worker de renders (prioridad media)**
+
+- Crear servicio que escuche `PERFIL_WEBHOOK_URL`
+- Elegir modelo de IA para image-to-image
+- Integrar con el endpoint `ingesta` para devolver resultados
+
+**Paso 3 — Conectar llamada Retell real (prioridad baja)**
+
+- Configurar variables de entorno de Retell
+- El bot de WhatsApp o el formulario pueden complementar la llamada

docs/despliegue-luisa-worker.md

@@ -0,0 +1,63 @@
+# Despliegue — Luisa (bot WhatsApp) + image-worker
+
+Los tres servicios de Reformix corren **unidos en el mismo VPS** (Dokploy personal,
+`panel.carlosnarro.com`, proyecto **Reformix** / entorno **production**). Build por **Dockerfile**
+desde Gitea (`carlos/reformix-hackaton`, rama `main`, autodeploy en push).
+
+## Servicios
+
+| Servicio | App en Dokploy | Repo (buildPath) | Dominio | Puerto |
+| --- | --- | --- | --- | --- |
+| App principal | `reformix-b2c` (`lzHDAuPuubbJu94OrkNS_`) | `/mvp/b2c` | `reformix.dv3.com.es` | 3000 |
+| Bot WhatsApp (Luisa) | `reformix-bot` (`wY4F14fyEslU-4za_JIbi`) | `/mvp/Whatsapp-bot` | `reformix-bot.dv3.com.es` | **3001** (webhooks) |
+| Worker de renders | `reformix-worker` (`sMQd9zwoyV14q1vm8Vs8U`) | `/mvp/image-worker` | `reformix-worker.dv3.com.es` | 3001 |
+
+> El bot escucha la app NestJS en 3000 y los **webhooks entrantes en 3001** (`/whatsapp-start`,
+> `/whatsapp-pdf`). El dominio público enruta al 3001. Sesión de WhatsApp persistida en un volumen
+> montado en `/app/auth_info_baileys`.
+
+## Webhooks configurados en reformix-b2c
+
+```ini
+WHATSAPP_START_WEBHOOK_URL = https://reformix-bot.dv3.com.es/whatsapp-start
+WHATSAPP_WEBHOOK_URL       = https://reformix-bot.dv3.com.es/whatsapp-pdf
+PERFIL_WEBHOOK_URL         = https://reformix-worker.dv3.com.es/perfil-completo
+```
+
+El bot y el worker llaman de vuelta a la API de b2c con `API_BASE_URL`/`REFORMIX_API_URL =
+https://reformix.dv3.com.es` y `Authorization: Bearer <FUNNEL_API_KEY>` (la misma de b2c, ya puesta).
+
+## Pasos manuales pendientes (no automatizables)
+
+1. **`OPENROUTER_API_KEY`** — está **vacía** en `reformix-bot` y `reformix-worker`. Pégala en el env
+   de **ambas** apps (panel de Dokploy → app → Environment) y **redeploy** de ambas. Sin ella el bot
+   no genera respuestas y el worker no genera renders.
+2. **Vincular WhatsApp (QR)** — abre los **logs** de `reformix-bot` en Dokploy: Baileys imprime un QR
+   en ASCII. Escanéalo con el WhatsApp del número del negocio. La sesión queda persistida en el
+   volumen (sobrevive redeploys). **Sin restricción de número** (`ALLOWED_NUMBER` no está
+   configurada): el bot conversa con cualquiera que le escriba.
+
+## Verificación (estado a 08-jun-2026)
+
+- Builds Docker de bot y worker: **OK** a la primera. Certs Let's Encrypt emitidos (TLS válido).
+- `GET https://reformix.dv3.com.es/` → 200 · `POST …/perfil-completo` (worker) → 400 (vivo) ·
+  `POST …/whatsapp-start` (bot) → 200 (vivo).
+- Tras poner la `OPENROUTER_API_KEY` + escanear el QR, el flujo queda end-to-end: lead elige WhatsApp
+  → `iniciarWhatsapp` → bot conversa y puebla la BD por los EPs → `perfilCompleto` → worker genera
+  renders → `ingesta finalizar` → PDF + email + entrega por WhatsApp.
+
+## Operación
+
+- **Redeploy:** push a `main` (autodeploy Gitea) o `POST /api/application.deploy {applicationId}`.
+- Los GET que el bot consume (`GET /api/leads/:id`, `GET /api/leads/:id/conversacion`) viven en
+  `mvp/b2c`. Smoke test de los EPs del bot: [`mvp/b2c/api-docs/smoke-bot-eps.mjs`](../mvp/b2c/api-docs/smoke-bot-eps.mjs).
+
+## Notas de integración para Simón (menores, a pulir)
+
+- Los 2 `GET` que usa tu `api-client` y **no existían** en la API ya están añadidos y desplegados:
+  `GET /api/leads/:id` (estado del lead) y `GET /api/leads/:id/conversacion` (historial). Ya responden.
+- En `POST /perfil` mandas `nombre`, pero la API **no actualiza** ese campo (lo ignora). Si quieres
+  poder cambiar el nombre del lead desde el bot, lo hablamos.
+- No estás enviando `calidadGlobal` (`basica`/`media`/`premium`), que usa el motor de presupuesto.
+  Si Luisa lo puede extraer, mándalo en `POST /perfil`.
+- Contrato completo de los EPs (campos, enums, ejemplos): [`mvp/b2c/api-docs/README.md`](../mvp/b2c/api-docs/README.md).

docs/flujo-usuario/flujo_reformix.xml

@@ -0,0 +1,334 @@
+<?xml version="1.0" encoding="UTF-8"?>
+<mxfile host="app.diagrams.net">
+  <diagram name="Página-1" id="DRtktbz_MXrh0E5vmsnP">
+    <mxGraphModel dx="611" dy="239" grid="1" gridSize="10" guides="1" tooltips="1" connect="1" arrows="1" fold="1" page="1" pageScale="1" pageWidth="827" pageHeight="1169" math="0" shadow="0">
+      <root>
+        <mxCell id="0" />
+        <mxCell id="1" parent="0" />
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-1" parent="1" style="text;html=1;strokeColor=none;fillColor=none;align=center;verticalAlign=middle;whiteSpace=wrap;rounded=0;fontSize=20;fontStyle=1;" value="Reformix — Flujo del sistema" vertex="1">
+          <mxGeometry height="40" width="500" x="600" y="20" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-2" parent="1" style="ellipse;whiteSpace=wrap;html=1;fontSize=13;fontStyle=1;" value="Cliente" vertex="1">
+          <mxGeometry height="50" width="120" x="800" y="80" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-4" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Formulario web" vertex="1">
+          <mxGeometry height="40" width="150" x="540" y="190" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-5" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="WhatsApp directo" vertex="1">
+          <mxGeometry height="40" width="150" x="785" y="157" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-6" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Llamada" vertex="1">
+          <mxGeometry height="40" width="150" x="1030" y="190" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-7" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-2" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-4">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-8" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-2" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-5">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-9" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-2" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-6">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-10" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Crear lead en DB&#xa;(canal_origen registrado)" vertex="1">
+          <mxGeometry height="50" width="250" x="735" y="280" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-11" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-4" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-10">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-12" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-5" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-10">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-13" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-6" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-10">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-14" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Registrar intento&#xa;(intentos_contacto)" vertex="1">
+          <mxGeometry height="50" width="250" x="735" y="370" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-15" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-10" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-14">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-16" parent="1" style="text;html=1;align=center;fontSize=11;fontStyle=2;" value="Formulario" vertex="1">
+          <mxGeometry height="20" width="150" x="400" y="450" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-17" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Cliente sube fotos&#xa;(lead_fotos · antes)" vertex="1">
+          <mxGeometry height="50" width="170" x="390" y="480" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-18" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-14" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-17">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="735" y="395" />
+              <mxPoint x="475" y="395" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-19" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="Worker de imágenes&#xa;analiza + clasifica fotos&#xa;(lead_fotos · render_url)" vertex="1">
+          <mxGeometry height="60" width="170" x="390" y="570" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-20" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-17" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-19">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-21" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#d5e8d4;strokeColor=#82b366;" value="→ Calificación" vertex="1">
+          <mxGeometry height="40" width="120" x="415" y="665" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-22" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-19" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-21">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-23" parent="1" style="text;html=1;align=center;fontSize=11;fontStyle=2;" value="WhatsApp — Luisa" vertex="1">
+          <mxGeometry height="20" width="200" x="710" y="450" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-24" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Scheduler 5 min&#xa;→ Bot Luisa&#xa;(estado_wa = nuevo)" vertex="1">
+          <mxGeometry height="60" width="180" x="720" y="480" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-25" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-14" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-24">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-26" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;" value="Luisa cualifica (7 estados)&#xa;apertura→espacio→tamaño&#xa;→estilo→urgencia→presupuesto&#xa;[conversacion_whatsapp]" vertex="1">
+          <mxGeometry height="70" width="200" x="710" y="575" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-27" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-24" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-26">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-28" parent="1" style="rhombus;whiteSpace=wrap;html=1;fontSize=12;" value="¿Viable?&#xa;(≥ 5000€)" vertex="1">
+          <mxGeometry height="70" width="140" x="740" y="675" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-29" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-26" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-28">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-30" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#fff2cc;strokeColor=#d6b656;" value="Lead no_viable&#xa;(descartado)" vertex="1">
+          <mxGeometry height="50" width="130" x="580" y="690" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-31" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-28" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-30" value="No">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-32" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Pide fotos por WA&#xa;(leads · fotos_solicitadas_at)" vertex="1">
+          <mxGeometry height="50" width="180" x="720" y="780" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-33" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-28" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-32" value="Sí">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-34" parent="1" style="rhombus;whiteSpace=wrap;html=1;fontSize=12;" value="¿Fotos&#xa;recibidas?" vertex="1">
+          <mxGeometry height="70" width="140" x="740" y="860" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-35" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-32" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-34">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-36" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;dashed=1;" value="Recordatorio automático&#xa;↻ vuelve a preguntar" vertex="1">
+          <mxGeometry height="50" width="140" x="530" y="920" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-37" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-34" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-36" value="No">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-38" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-36" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-34">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="650" y="935" />
+              <mxPoint x="650" y="895" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-39" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="Worker de imágenes&#xa;(lead_fotos · antes)" vertex="1">
+          <mxGeometry height="50" width="180" x="720" y="965" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-40" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-34" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-39" value="Sí">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-41" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#d5e8d4;strokeColor=#82b366;" value="→ Calificación" vertex="1">
+          <mxGeometry height="40" width="150" x="735" y="1045" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-42" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-39" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-41">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-43" parent="1" style="text;html=1;align=center;fontSize=11;fontStyle=2;" value="Llamada" vertex="1">
+          <mxGeometry height="20" width="150" x="1030" y="450" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-44" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;dashed=1;" value="Bot de llamada&#xa;(compañero — pendiente)" vertex="1">
+          <mxGeometry height="50" width="170" x="1030" y="480" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-45" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-14" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-44">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="985" y="395" />
+              <mxPoint x="1115" y="395" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-46" parent="1" style="rhombus;whiteSpace=wrap;html=1;fontSize=12;" value="¿Llamada&#xa;completada?" vertex="1">
+          <mxGeometry height="70" width="140" x="1045" y="560" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-47" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-44" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-46">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-48" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;dashed=1;" value="WA de continuación&#xa;retoma desde estado_wa" vertex="1">
+          <mxGeometry height="50" width="170" x="1210" y="573" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-49" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-46" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-48" value="No / cortada">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-50" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-48" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-24">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="1295" y="440" />
+              <mxPoint x="870" y="440" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-51" parent="1" style="rhombus;whiteSpace=wrap;html=1;fontSize=12;" value="¿Contactado?" vertex="1">
+          <mxGeometry height="70" width="140" x="1045" y="660" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-52" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-46" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-51" value="Sí">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-53" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-51" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-24" value="No">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="1045" y="695" />
+              <mxPoint x="960" y="695" />
+              <mxPoint x="960" y="510" />
+              <mxPoint x="860" y="510" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-54" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Enviar WA pidiendo fotos&#xa;(leads · fotos_solicitadas_at)" vertex="1">
+          <mxGeometry height="50" width="170" x="1030" y="765" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-55" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-51" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-54" value="Sí">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-56" parent="1" style="rhombus;whiteSpace=wrap;html=1;fontSize=12;" value="¿Fotos&#xa;recibidas?" vertex="1">
+          <mxGeometry height="70" width="140" x="1045" y="845" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-57" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-54" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-56">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-58" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;dashed=1;" value="Recordatorio automático&#xa;↻ vuelve a preguntar" vertex="1">
+          <mxGeometry height="50" width="150" x="1250" y="895" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-59" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-56" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-58" value="No">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-60" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-58" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-56">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="1360" y="885" />
+              <mxPoint x="1360" y="880" />
+              <mxPoint x="1185" y="880" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-61" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="Worker de imágenes&#xa;(lead_fotos · antes)" vertex="1">
+          <mxGeometry height="50" width="170" x="1030" y="945" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-62" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-56" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-61" value="Sí">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-63" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#d5e8d4;strokeColor=#82b366;" value="→ Calificación" vertex="1">
+          <mxGeometry height="40" width="150" x="1045" y="1025" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-64" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-61" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-63">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-65" parent="1" style="text;html=1;align=center;fontSize=11;fontStyle=2;" value="Todas las ramas convergen aquí" vertex="1">
+          <mxGeometry height="20" width="400" x="660" y="1110" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-66" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;strokeWidth=2;" value="Calificación del lead&#xa;score + nivel frío/tibio/caliente&#xa;(lead_calificacion)" vertex="1">
+          <mxGeometry height="60" width="300" x="710" y="1140" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-67" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-21" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-66">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="475" y="1170" />
+              <mxPoint x="710" y="1170" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-68" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-41" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-66">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="810" y="1170" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-69" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-63" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-66">
+          <mxGeometry relative="1" as="geometry">
+            <Array as="points">
+              <mxPoint x="1120" y="1170" />
+              <mxPoint x="1010" y="1170" />
+            </Array>
+          </mxGeometry>
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-70" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="CRM — Agente revisa lead&#xa;(leads · estado = contactado)" vertex="1">
+          <mxGeometry height="50" width="300" x="710" y="1240" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-71" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-66" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-70">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-72" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Visita agendada&#xa;(visitas)" vertex="1">
+          <mxGeometry height="50" width="300" x="710" y="1330" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-73" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-70" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-72">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-74" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="Worker de imágenes&#xa;genera render antes/después&#xa;(lead_fotos · render_url)" vertex="1">
+          <mxGeometry height="60" width="300" x="710" y="1420" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-75" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-72" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-74">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-76" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Generación presupuesto&#xa;render + PDF&#xa;(leads · pdf_url)" vertex="1">
+          <mxGeometry height="60" width="300" x="710" y="1520" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-77" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-74" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-76">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-78" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Envío al cliente&#xa;WhatsApp / email" vertex="1">
+          <mxGeometry height="50" width="300" x="710" y="1620" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-79" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-76" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-78">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-80" parent="1" style="rhombus;whiteSpace=wrap;html=1;fontSize=12;" value="¿Acepta?" vertex="1">
+          <mxGeometry height="70" width="140" x="790" y="1700" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-81" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-78" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-80">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-82" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#d5e8d4;strokeColor=#82b366;" value="Lead GANADO&#xa;(leads · estado = ganado)" vertex="1">
+          <mxGeometry height="50" width="220" x="680" y="1810" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-83" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-80" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-82" value="Sí">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-84" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;fillColor=#f8cecc;strokeColor=#b85450;" value="Lead PERDIDO&#xa;(leads · estado = perdido)" vertex="1">
+          <mxGeometry height="50" width="220" x="970" y="1718" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-85" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-80" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-84" value="No">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-86" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=12;" value="Solicitar testimonio&#xa;(testimonios)" vertex="1">
+          <mxGeometry height="50" width="220" x="680" y="1900" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-87" edge="1" parent="1" source="nWkRbZFlf69J1CHv_Vaw-82" style="edgeStyle=orthogonalEdgeStyle;" target="nWkRbZFlf69J1CHv_Vaw-86">
+          <mxGeometry relative="1" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-88" parent="1" style="text;html=1;fontSize=13;fontStyle=1;" value="Leyenda" vertex="1">
+          <mxGeometry height="20" width="100" x="1300" y="1140" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-89" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;" value="Flujo principal" vertex="1">
+          <mxGeometry height="30" width="160" x="1300" y="1170" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-90" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;dashed=1;" value="Bot externo / pendiente" vertex="1">
+          <mxGeometry height="30" width="160" x="1300" y="1210" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-91" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;fillColor=#dae8fc;strokeColor=#6c8ebf;" value="Worker de imágenes" vertex="1">
+          <mxGeometry height="30" width="160" x="1300" y="1250" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-92" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;fillColor=#d5e8d4;strokeColor=#82b366;" value="Lead ganado / éxito" vertex="1">
+          <mxGeometry height="30" width="160" x="1300" y="1290" as="geometry" />
+        </mxCell>
+        <mxCell id="nWkRbZFlf69J1CHv_Vaw-93" parent="1" style="rounded=1;whiteSpace=wrap;html=1;fontSize=11;fillColor=#f8cecc;strokeColor=#b85450;" value="Lead perdido / descartado" vertex="1">
+          <mxGeometry height="30" width="160" x="1300" y="1330" as="geometry" />
+        </mxCell>
+      </root>
+    </mxGraphModel>
+  </diagram>
+</mxfile>

docs/handoff-bot-runtime-simon.md

@@ -0,0 +1,115 @@
+# Handoff runtime del bot WhatsApp (Luisa) — para Simón
+
+Estado tras la sesión de depuración del 09-jun. El **flujo conversacional funciona end-to-end**;
+quedan **dos problemas de runtime del bot** que se diagnostican/cierran desde tu lado (tienes acceso
+a los logs en Dokploy). La parte de la app (EPs) está verificada y no es el problema.
+
+---
+
+## 1. Lo que está PROBADO funcionando
+
+- **EPs de la app** (en `mvp/b2c`): `conversacion`, `perfil`, `calificacion`, `intento`, `ingesta`,
+  + `GET /api/leads/:id` y `GET /api/leads/:id/conversacion` y `GET /api/leads/by-phone`. Todos OK.
+  Verificado: `POST /perfil` con el payload exacto del bot (`{espacio,rangoM2,estilo,botStep}`) →
+  `200 {ok:true, actualizado:[...]}` y el lead se actualiza. **El EP no es el cuello de botella.**
+- **Bot:** apertura proactiva, **resolución del `@lid`**, matching del lead por teléfono, y la
+  **conversación de cualificación de Luisa** (7 turnos reales: cocina → tamaño → estilo → urgencia).
+- **Worker de render** (`mvp/image-worker`): genera renders con `google/gemini-2.5-flash-image`.
+
+## 2. Cambios que hice hoy en el bot (`mvp/Whatsapp-bot`) — para que no te pillen por sorpresa
+
+- **Apertura proactiva** al recibir `/whatsapp-start`: `WhatsappService` escucha un `startEmitter` y
+  envía el primer mensaje (antes solo registraba la sesión y esperaba al cliente). Persiste
+  `estadoWa/botStep` + intento.
+- **Resolución `@lid`** ([`resolverTelefono`](../mvp/Whatsapp-bot/src/whatsapp/whatsapp.service.ts)):
+  WhatsApp entrega los mensajes desde una dirección `@lid` (p.ej. `239225534443615@lid`), no desde el
+  número. Se resuelve a número vía `msg.key.remoteJidAlt` o el mapa LID→PN de Baileys. **Esto era la
+  causa de que el bot ignorara los mensajes entrantes.**
+- **Recuperación del lead por teléfono:** si la sesión no está en memoria (reinicio), `getOrCreateContext`
+  busca el lead en la BD vía `GET /api/leads/by-phone` y re-registra la sesión.
+- **`markOnlineOnConnect: true`**: con `false`, tras reconectar el dispositivo quedaba "no disponible"
+  y WhatsApp **no entregaba** los mensajes. Con `true` empezó a recibir (la conversación de 7 turnos
+  lo demuestra).
+- **Modelos de Claude corregidos** en el env: eran `claude-haiku-4-5` (guion) → inválidos en
+  OpenRouter; ahora `anthropic/claude-haiku-4.5` y `anthropic/claude-sonnet-4.5` (punto).
+- **`BAILEYS_AUTH_DIR`** configurable (subcarpeta del volumen) para empezar una **sesión limpia**
+  sin perder persistencia. Hoy apunta a `/app/auth_info_baileys/v2`.
+- **Endpoints de operación** (servidor de webhooks, puerto 3001):
+  - `GET /qr` — QR de vinculación como **imagen** (HTTP Basic; usuario cualquiera, contraseña =
+    `QR_TOKEN`, que está en el env del bot en Dokploy).
+  - `GET /debug` — estado de conexión + anillo de los últimos eventos entrantes (mismo auth). Útil
+    para ver `remoteJid`/`remoteJidAlt`, si llega algo, y el resultado del matching.
+- Subido el límite de body del worker a 30 MB (las fotos en data URI rompían el 100kb por defecto).
+
+## 3. Problema A — conexión Baileys inestable (bucle de reconexión)
+
+**Evidencia en logs del contenedor (`docker logs`):** el socket se cae cada pocos minutos con
+`stream:error → conflict {type:"replaced"}` y `stream:error code 503`, y reconecta en bucle
+(`AwaitingInitialSync → Transitioning to Online → opened connection to WA → ✅ conectado`, repetido).
+El `conflict: replaced` indica que **otra sesión reclama la misma cuenta** — típico del **solapamiento
+en el deploy** (Swarm arranca el contenedor nuevo antes de matar el viejo y ambos usan la misma
+sesión del volumen). `markOnlineOnConnect: true` mejoró la recepción pero no arregla una conexión que
+se cae sola.
+
+**Mitigación parcial (Baileys):** configurar el deploy del bot como **stop-first / sin solapamiento**
+(1 réplica, recreate) para evitar el `conflict`. Pero los `503` son de WhatsApp y seguirán.
+**Vía robusta (acordada): Evolution API.**
+
+**Cómo reproducir/diagnosticar:**
+- `GET https://reformix-bot.dv3.com.es/debug` (Basic, contraseña `QR_TOKEN`): si `connection:open`
+  pero `inbound` no crece cuando el cliente escribe → estás en el estado "zombi".
+- Para volver a recibir: sesión nueva → sube `BAILEYS_AUTH_DIR` a `/app/auth_info_baileys/v3`,
+  redeploy, escanea el QR fresco en `/qr`. **Y evita redeployar después** (cada reconexión arriesga
+  la recepción).
+
+**Camino robusto (acordado con Carlos): migrar el transporte de WhatsApp del bot a Evolution API**
+(ya está como primaria en el stack — NO la WhatsApp Cloud API oficial). Evolution gestiona la
+conexión y entrega los mensajes por **webhook**, sin un socket Baileys en-proceso que se vuelva
+zombi. El bot pasaría a: (1) recibir mensajes por webhook de Evolution, (2) enviar por su REST. La
+lógica de Claude + los EPs de la app se quedan igual; solo cambia la capa de transporte WhatsApp.
+
+## 4. Problema B — el perfil se persiste solo a medias + máquina de estados errática
+
+**Verificado en vivo:** `persistirTurno` SÍ funciona cuando se llama —
+`Lead ... persistido via API: {"rangoM2":"10a20","botStep":"estilo"} → ok`. Pero en una conversación
+completa **solo apareció UN `persistido`** (rangoM2); `espacio`, `urgencia` y `presupuesto` no se
+guardaron. Y la conversación se descuadra (rechaza a 4500€ → con 8500€ vuelve a preguntar el tamaño →
+"preparo presupuesto"). Causa probable: `claudeService.llamarClaude` solo devuelve `entidad`/`nuevoEstado`
+en algunos turnos, y la lógica de estado/viabilidad no es determinista.
+
+**A revisar:** que cada turno con dato extraído llame a `persistirTurno`, que los valores encajen con
+los enums de la app (`urgencia` alta|media|baja, etc., o `POST /perfil` da 422 y no guarda nada), y
+endurecer la máquina de estados (no re-preguntar lo ya respondido; viabilidad estable).
+
+## 4bis. Problema C (el que rompe el end-to-end) — el bot NUNCA dispara la generación
+
+**Verificado en logs:** Luisa termina diciendo *"en un momento recibes tu presupuesto"* pero **no hay
+ninguna llamada a `ingesta` / `perfilCompleto`** en toda la sesión (grep vacío). Es decir, al cerrar la
+cualificación el bot **no dispara nada**: ni render, ni PDF, ni entrega. Es una promesa vacía.
+
+**Qué falta (lado bot):** cuando la cualificación se completa (estado `presupuesto`/`fin_viable`), el
+bot debe (1) **pedir las fotos** del espacio por WhatsApp, (2) subirlas vía `POST /api/leads/:id/ingesta`
+(items `foto`, `momento:"antes"`), y (3) marcar `perfilCompleto:true` (y/o `finalizar`). Eso dispara en
+la app: `PERFIL_WEBHOOK` → worker genera renders → `ingesta finalizar` → PDF + email + entrega WhatsApp.
+**La app y el worker ya están listos para esto; solo falta que el bot llame al EP.** Contrato:
+[`mvp/b2c/api-docs/README.md`](../mvp/b2c/api-docs/README.md).
+
+## 5. Infra (referencia rápida)
+
+| Servicio | App Dokploy | Dominio |
+| --- | --- | --- |
+| Bot | `reformix-bot` (`wY4F14fyEslU-4za_JIbi`) | `reformix-bot.dv3.com.es` (puerto 3001) |
+| Worker | `reformix-worker` (`sMQd9zwoyV14q1vm8Vs8U`) | `reformix-worker.dv3.com.es` |
+| App | `reformix-b2c` (`lzHDAuPuubbJu94OrkNS_`) | `reformix.dv3.com.es` |
+
+- Build Dockerfile desde Gitea, autodeploy en push a `main`. Volumen del bot: `/app/auth_info_baileys`
+  (sesión WhatsApp). `OPENROUTER_API_KEY` y `FUNNEL_API_KEY` en el env de cada app.
+- Contrato de los EPs y enums: [`mvp/b2c/api-docs/README.md`](../mvp/b2c/api-docs/README.md).
+
+---
+
+**Resumen:** la conversación de Luisa funciona (recibe, resuelve `@lid`, cualifica, responde). Quedan 3
+cosas del bot: **A)** conexión inestable (`conflict`+`503`, bucle de reconexión) → Evolution API;
+**B)** persistencia parcial del perfil + estado errático; **C)** el bot **nunca dispara la generación**
+(no llama a `ingesta`/`perfilCompleto`), así que el presupuesto/render/entrega no llega — esto es lo que
+rompe el end-to-end y lo que más conviene cerrar. App y worker ya están listos esperando esa llamada.

mvp/Whatsapp-bot/.dockerignore

@@ -0,0 +1,10 @@
+node_modules
+dist
+coverage
+.git
+.env
+.env.*
+auth_info_baileys
+*.tsbuildinfo
+npm-debug.log
+.DS_Store

mvp/Whatsapp-bot/.env.example

@@ -4,5 +4,6 @@ MODEL_CLASIFICADOR=anthropic/claude-haiku-4-5
 MODEL_REGLAS=anthropic/claude-haiku-4-5
 MODEL_TRANSCRIPCION=google/gemini-2.5-flash
 MODEL=
-DATABASE_URL=
 ALLOWED_NUMBER=
+API_BASE_URL=http://localhost:3000
+FUNNEL_API_KEY=

mvp/Whatsapp-bot/.gitignore

@@ -2,4 +2,5 @@ node_modules/
 dist/
 .env
 *.log
+*.tsbuildinfo
 auth_info_baileys/

mvp/Whatsapp-bot/Dockerfile

@@ -0,0 +1,22 @@
+# Agente WhatsApp Luisa (NestJS). El proceso escucha en dos puertos:
+#   - PORT (3000): app NestJS
+#   - WEBHOOK_PORT (3001): servidor HTTP de webhooks entrantes (/whatsapp-start, /whatsapp-pdf)
+# La sesión de Baileys se persiste en /app/auth_info_baileys → montar un volumen ahí.
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=3000
+ENV WEBHOOK_PORT=3001
+COPY package*.json ./
+RUN npm ci --omit=dev && npm cache clean --force
+COPY --from=build /app/dist ./dist
+COPY --from=build /app/prompts ./prompts
+EXPOSE 3000 3001
+CMD ["node", "dist/main"]

mvp/Whatsapp-bot/README.md

@@ -1,6 +1,6 @@
-# Reformix Luisa Bot 🤖
+# Reformix Luisa Bot
 
-Agente de WhatsApp **Luisa** para **Reformix** — cualifica leads de reforma de forma conversacional siguiendo una máquina de estados de 7 pasos, recoge 5 datos clave (espacio, metros, estilo, urgencia, presupuesto) y cierra el flujo según el flag viable/no_viable.
+Agente de WhatsApp **Luisa** para **Reformix** — cualifica leads de reforma de forma conversacional siguiendo una máquina de estados de 7 pasos. Toda la persistencia va por **API HTTP** contra la app principal (`POST /api/leads/:id/perfil`, `conversacion`, etc.), no escribe a Postgres directamente.
 
 ---
 
@@ -10,7 +10,7 @@ Agente de WhatsApp **Luisa** para **Reformix** — cualifica leads de reforma de
 |------|-----------|
 | **Framework** | NestJS 10 |
 | **WhatsApp** | Baileys 7 (`@whiskeysockets/baileys`) + `baileys-antiban` |
-| **Base de datos** | PostgreSQL via TypeORM con `synchronize: true` (dev) / migrations (prod) |
+| **Persistencia** | API HTTP contra `REFORMIX_API_URL` con `Authorization: Bearer` |
 | **LLM** | Claude 4.5 Sonnet/Haiku + Gemini 2.5 Flash via **OpenRouter** |
 | **Logging** | Pino |
 | **QR** | `qrcode-terminal` |
@@ -30,28 +30,29 @@ Agente de WhatsApp **Luisa** para **Reformix** — cualifica leads de reforma de
 │   └── luisa_casos.md       ← Casos edge y ejemplos
 ├── src/
 │   ├── main.ts              ← Punto de entrada
-│   ├── app.module.ts      ← Módulo raíz con TypeORM y Schedule
+│   ├── app.module.ts        ← Módulo raíz
+│   ├── api/
+│   │   ├── api-client.service.ts  ← Cliente HTTP para endpoints de la app Reformix
+│   │   └── api.module.ts
 │   ├── whatsapp/
 │   │   ├── whatsapp.module.ts
 │   │   ├── whatsapp.service.ts        ← Conexión Baileys, recepción/envío
 │   │   └── whatsapp-debounce.service.ts ← Debounce de 3s para coalescer mensajes rápidos
 │   ├── leads/
 │   │   ├── leads.module.ts
-│   │   ├── lead.entity.ts             ← Entidad Lead con todos los campos
-│   │   └── leads.service.ts           ← CRUD, máquina de estados, viabilidad
+│   │   └── leads.service.ts           ← Máquina de estados, viabilidad (sin BD)
 │   ├── conversacion/
 │   │   ├── conversacion.module.ts
-│   │   ├── conversacion.entity.ts     ← Entidad Conversacion (historial)
-│   │   └── conversacion.service.ts    ← Guardado y recuperación de historial
+│   │   └── conversacion.service.ts    ← Historial via API HTTP
 │   ├── claude/
 │   │   ├── claude.module.ts
 │   │   └── claude.service.ts          ← Arquitectura de 4 capas con Claude
 │   ├── media/
 │   │   ├── media.module.ts
 │   │   └── media.service.ts           ← Transcripción de audio + análisis de imagen
-│   └── scheduler/
-│       ├── scheduler.module.ts
-│       └── scheduler.service.ts       ← Cron cada 5 min: apertura a leads nuevos + limpieza
+│   └── webhook/
+│       ├── webhook.module.ts
+│       └── webhook-listener.ts        ← Servidor HTTP para recibir señales de la app
 ├── .env.example
 ├── nest-cli.json
 ├── package.json
@@ -70,68 +71,40 @@ Mensaje entrante (texto / audio / imagen)
         ↓
   ┌───────────────────────────────┐
   │ PREPROCESAMIENTO              │
-  │ • Identificar lead por teléfono│
+  │ • Verificar lead en sesión    │
+  │   (llega via webhook, no por  │
+  │    teléfono)                   │
   │ • Si audio → transcripción    │
   │   (Gemini 2.5 Flash via       │
   │    OpenRouter)                │
   │ • Si imagen → Vision          │
   │   (Claude Sonnet via          │
-  │    OpenRouter)                │
+  │    OpenRouter) + enviar a     │
+  │    /ingesta                   │
   │ • Si texto → directo          │
-  │ • Guardar mensaje usuario en   │
-  │   DB                          │
+  │ • Guardar mensaje en          │
+  │   /conversacion (API HTTP)    │
   └───────────┬───────────────────┘
               ↓
   ┌───────────────────────────────┐
   │ CAPA 1: CLASIFICADOR (Haiku) │
-  │ Extrae intención y valor      │
-  │ del mensaje:                  │
-  │ • responde_pregunta: bool     │
-  │ • valor_extraido: string|null │
-  │ • es_desvio: bool             │
-  │ • intencion: respuesta |      │
-  │   desvio | despedida |        │
-  │   insulto | pregunta          │
   └───────────┬───────────────────┘
               ↓
   ┌───────────────────────────────┐
   │ CAPA 2: VALIDADOR (código)    │
-  │ Valida contra valores         │
-  │ permitidos del estado actual  │
-  │ • espacios: cocina, bano,     │
-  │   salon, integral, otro       │
-  │ • tamaño: menos10, 10a20,     │
-  │   20a40, mas40                │
-  │ • estilo: funcional, cuidado, │
-  │   exclusivo                   │
-  │ • urgencia: urgente,          │
-  │   medio_plazo, frio           │
-  │ • presupuesto: evalúa         │
-  │   viabilidad (>= 5000€)       │
   └───────────┬───────────────────┘
               ↓
   ┌───────────────────────────────┐
   │ CAPA 3: GENERADOR (Sonnet)    │
-  │ Construye contexto y genera   │
-  │ borrador de respuesta         │
-  │ • Estado del lead             │
-  │ • Datos capturados            │
-  │ • Historial completo          │
-  │ • Clasificación y validación  │
-  │ • Reintentos                  │
   └───────────┬───────────────────┘
               ↓
   ┌───────────────────────────────┐
   │ CAPA 4: REGLAS (Haiku)        │
-  │ Corrige el borrador para      │
-  │ cumplir identidad de Luisa:   │
-  │ • Sin menciones a IA          │
-  │ • Máximo 2 líneas             │
-  │ • Sin emojis                  │
-  │ • Tono Madrid/España          │
   └───────────┬───────────────────┘
               ↓
-        Guardar respuesta en DB
+        Guardar respuesta en /conversacion (API HTTP)
+              ↓
+        Persistir datos en /perfil (API HTTP)
               ↓
         Enviar por Baileys
 ```
@@ -148,15 +121,17 @@ MODEL_GENERADOR=anthropic/claude-sonnet-4-5    # Modelo para generar respuestas
 MODEL_CLASIFICADOR=anthropic/claude-haiku-4-5  # Modelo para clasificar mensajes (Capa 1)
 MODEL_REGLAS=anthropic/claude-haiku-4-5        # Modelo para aplicar reglas (Capa 4)
 MODEL_TRANSCRIPCION=google/gemini-2.5-flash    # Modelo para transcripción de audio
-MODEL=anthropic/claude-sonnet-4-5              # Fallback general si no se especifica otro
-DATABASE_URL=                                  # (REQUERIDA) PostgreSQL connection string
+MODEL=anthropic/claude-sonnet-4-5              # Fallback general
+API_BASE_URL=https://reformix.dv3.com.es       # (REQUERIDA) URL de la app Reformix
+FUNNEL_API_KEY=                                # (REQUERIDA) API key compartida
+WEBHOOK_PORT=3001                              # (OPCIONAL) Puerto para webhooks entrantes
 ALLOWED_NUMBER=                                # (OPCIONAL) Restringe el bot a un solo número
 ```
 
 **Notas:**
-- `ALLOWED_NUMBER` es opcional. Si se define, el bot **solo atiende mensajes de ese número**. Si se deja vacío, acepta mensajes de cualquier número de teléfono.
-- La transcripción de audio usa **Gemini 2.5 Flash** por defecto porque Claude no soporta `input_audio` en OpenRouter. El resto del pipeline sigue usando Claude.
-- Si `MODEL` está definido, sirve como fallback para `MODEL_GENERADOR` cuando no se especifica.
+- `API_BASE_URL` + `FUNNEL_API_KEY` reemplazan a la antigua `DATABASE_URL`. El bot ya no escribe a Postgres directamente.
+- `WEBHOOK_PORT` define dónde escucha el servidor HTTP para recibir señales de la app (`/whatsapp-start`, `/whatsapp-pdf`).
+- Una vez escaneado el QR, Luisa queda en espera. La app le enviará leads vía `WHATSAPP_START_WEBHOOK_URL`.
 
 ---
 
@@ -168,35 +143,13 @@ ALLOWED_NUMBER=                                # (OPCIONAL) Restringe el bot a u
 cp .env.example .env
 ```
 
-Edita `.env` con tus valores reales:
+Edita `.env` con tus valores reales.
 
-```env
-OPENROUTER_API_KEY=sk-or-v1-tu-api-key-aqui
-DATABASE_URL=postgresql://user:password@localhost:5432/reformix
-```
+### 2. Prompts de Luisa
 
-### 2. Base de datos
+Los 3 archivos de prompts ya están creados y contienen la configuración completa. Puedes modificarlos para ajustar el tono o comportamiento de Luisa.
 
-El proyecto usa `synchronize: true` en modo desarrollo (definido en `src/app.module.ts`). TypeORM creará las tablas automáticamente al arrancar.
-
-En producción, cambia `synchronize: false` y usa migrations:
-
-```bash
-npm run migration:generate -- src/migrations/Init
-npm run migration:run
-```
-
-### 3. Prompts de Luisa
-
-Los 3 archivos de prompts ya están creados y contienen la configuración completa:
-
-- **`prompts/luisa_core.md`** — Identidad de Luisa, personalidad (español de Madrid, cercana, directa), máquina de estados obligatoria con mensajes exactos por estado, extracción de datos con bloque JSON `<DATOS_EXTRAIDOS>`, manejo de casos especiales (desvíos, reintentos, inactividad, multimedia, tono defensivo), y ejemplos few-shot.
-- **`prompts/luisa_flujo.md`** — Secuencia de estados, campos DB con valores permitidos, y mensajes por estado (versión simplificada).
-- **`prompts/luisa_casos.md`** — Casos edge: desvíos, reintentos (máx 2), inactividad (24h/48h), manejo de audio/imagen/sticker, tono defensivo, usuario que no da presupuesto.
-
-Puedes modificarlos libremente para ajustar el tono o comportamiento de Luisa.
-
-### 4. Arrancar
+### 3. Arrancar
 
 ```bash
 npm install
@@ -205,7 +158,7 @@ npm run start:dev
 
 Aparecerá un **código QR** en la terminal. Escanéalo con WhatsApp → **WhatsApp Web**.
 
-Luisa queda conectada y lista para recibir mensajes.
+Luisa queda conectada y escuchando webhooks de la app (por defecto en puerto 3001).
 
 ---
 
@@ -214,56 +167,60 @@ Luisa queda conectada y lista para recibir mensajes.
 | Estado | Descripción |
 |--------|-------------|
 | `nuevo` | Lead creado, aún no contactado |
-| `en_proceso` | El scheduler le ha enviado el primer mensaje (transición interna) |
 | `apertura` | Luisa se presenta y pregunta disponibilidad |
 | `espacio` | Pregunta: ¿qué espacio quieres reformar? |
 | `tamano` | Pregunta: ¿rango de metros cuadrados? |
 | `estilo` | Pregunta: ¿tipo de acabado? |
 | `urgencia` | Pregunta: ¿cuándo quieres empezar? |
 | `presupuesto` | Pregunta: ¿presupuesto aproximado? |
-| `fin_viable` | Transición interna → `completado` si presupuesto >= 5000€ |
-| `fin_no_viable` | Transición interna → `no_viable` si presupuesto < 5000€ |
-| `recopilando_datos` | Estado legacy, se normaliza a `apertura` |
-| `completado` | Todos los datos recogidos y lead viable |
-| `no_viable` | Lead descartado por presupuesto insuficiente |
-| `perdido` | Sin actividad > 48h |
-
-**Secuencia completa:** `nuevo → apertura → espacio → tamano → estilo → urgencia → presupuesto → fin_viable/fin_no_viable`
+| `fin_viable` | Lead viable (presupuesto >= 5000€) |
+| `fin_no_viable` | Lead no viable (presupuesto < 5000€) |
 
 ### Datos recolectados por estado
 
-| Estado | Campo DB | Valores válidos |
-|--------|----------|-----------------|
-| `espacio` | `espacio` | `cocina`, `bano`, `salon`, `integral`, `otro` |
-| `tamano` | `rango_m2` | `menos10`, `10a20`, `20a40`, `mas40` |
+| Estado | Campo perfil | Valores válidos |
+|--------|-------------|-----------------|
+| `espacio` | `espacio` | `cocina`, `bano`, `salon`, `comedor`, `integral`, `otro` |
+| `tamano` | `rangoM2` | `menos10`, `10a20`, `20a40`, `mas40` |
 | `estilo` | `estilo` | `funcional`, `cuidado`, `exclusivo` |
-| `urgencia` | `urgencia` | `urgente`, `medio_plazo`, `frio` |
-| `presupuesto` | `presupuesto_declarado` | Cifra o rango en euros |
-
-### Evaluación de viabilidad
-
-Un presupuesto es **viable** si su valor numérico es **>= 5000€**. Si no se puede determinar el valor, se asume viable.
+| `urgencia` | `urgencia` | `alta`, `media`, `baja` |
+| `presupuesto` | `presupuestoDeclarado` | Cifra o rango en euros |
 
 ---
 
-## Scheduler (cron cada 5 min)
+## Cómo se conecta con la app
 
-El servicio `SchedulerService` se ejecuta cada 5 minutos vía `@nestjs/schedule` y realiza dos tareas:
+```
+App Reformix                              Bot (este proyecto)
+    │                                           │
+    │ POST /webhook/whatsapp-start              │
+    │ { leadId, telefono, nombre, empresa }────►│ Guarda sesión
+    │                                           │
+    │                                           │ Cliente escribe a Luisa
+    │                                           │
+    │ ◄── POST /api/leads/:id/conversacion ──── │ Guarda turno
+    │ ◄── POST /api/leads/:id/perfil ────────── │ Actualiza datos
+    │ ◄── POST /api/leads/:id/intento ───────── │ Registra contacto
+    │ ◄── POST /api/leads/:id/ingesta ───────── │ Sube fotos del lead
+    │                                           │
+    │ POST /webhook/whatsapp-pdf                │
+    │ { leadId, telefono, pdfBase64 }──────────►│ Envía PDF al cliente
+```
 
-1. **Limpiar leads inactivos**: Marca como `perdido` los leads en `en_proceso` sin actualización > 48h.
-2. **Apertura de leads nuevos**: Busca leads con `estado_actual = 'nuevo'`, los marca como `en_proceso`, llama a Claude para generar el mensaje de apertura, lo guarda en el historial y lo envía por WhatsApp.
+## Flujo de webhooks
+
+| Webhook | Dirección | Puerto por defecto |
+|---------|-----------|-------------------|
+| `WHATSAPP_START_WEBHOOK_URL` | App → Bot | `http://bot:3001/whatsapp-start` |
+| `WHATSAPP_WEBHOOK_URL` | App → Bot | `http://bot:3001/whatsapp-pdf` |
+
+Configurar en el `.env` de la app Reformix.
 
 ---
 
 ## Debounce de mensajes
 
-El servicio `WhatsappDebounceService` agrupa mensajes rápidos de un mismo usuario en una ventana de **3 segundos**. Si el usuario envía varios mensajes cortos seguidos, se concatenan en un solo texto antes de procesarlos. Esto evita que Claude reciba múltiples requests simultáneas por el mismo lead.
-
----
-
-## Restricción por número (ALLOWED_NUMBER)
-
-Si se define `ALLOWED_NUMBER` en `.env`, el bot **ignora cualquier mensaje que no venga de ese número**. Esto es útil para pruebas o para desplegar una instancia dedicada a un solo cliente.
+El servicio `WhatsappDebounceService` agrupa mensajes rápidos de un mismo usuario en una ventana de **3 segundos**. Si el usuario envía varios mensajes cortos seguidos, se concatenan en un solo texto antes de procesarlos.
 
 ---
 
@@ -272,27 +229,22 @@ Si se define `ALLOWED_NUMBER` en `.env`, el bot **ignora cualquier mensaje que n
 ### Audio
 - Se descarga el buffer del mensaje de audio via Baileys.
 - Se detecta el formato real por magic bytes (Ogg, MP3, WAV).
-- Se envía a OpenRouter con `input_audio` usando **Gemini 2.5 Flash** (modelo configurable via `MODEL_TRANSCRIPCION`).
+- Se envía a OpenRouter con `input_audio` usando **Gemini 2.5 Flash**.
 - La transcripción conserva coloquialismos y jerga madrileña.
-- Si falla o el buffer es muy pequeño, se responde con un mensaje de cortesía pidiendo repetición.
 
 ### Imagen
 - Se descarga el buffer y se envía a OpenRouter con `image_url` usando **Claude Sonnet**.
-- El prompt de análisis varía según el estado actual del lead:
-  - En `espacio`/`tamano`: infiere tipo de espacio y metros cuadrados.
-  - En `estilo`: infiere el estilo o calidad de acabados.
-  - En otros estados: descripción general.
+- Además se envía a `/ingesta` de la app Reformix para persistirla.
 - Si la imagen tiene caption, se combina con la inferencia.
 
 ---
 
 ## Manejo de errores y reconexión
 
-- Si la conexión de WhatsApp se cierra por cualquier motivo que **no sea logout**, se reintenta automáticamente tras 5 segundos.
-- Si hay un **logout** (sesión cerrada), se muestra un error pidiendo eliminar `auth_info_baileys` y reiniciar.
-- Cada mensaje se procesa en un bloque `try/catch`; si falla, se loguea el error y se continúa con el siguiente mensaje.
-- Si Claude falla repetidamente al clasificar, se usa un fallback conservador (desvío) para no bloquear la conversación.
-- Si la respuesta generada contiene frases prohibidas ("soy un asistente", "ChatGPT", etc.), se reemplaza automáticamente con un `mensajeFallback` según el estado actual.
+- Reconexión automática a WhatsApp tras 5 segundos (excepto logout).
+- Cada mensaje se procesa en un bloque `try/catch`.
+- Si Claude falla al clasificar, se usa un fallback conservador.
+- Las llamadas a la API de Reformix son **best-effort** (nunca lanzan error, loguean y continúan).
 
 ---
 
@@ -302,41 +254,20 @@ Si se define `ALLOWED_NUMBER` en `.env`, el bot **ignora cualquier mensaje que n
 npm run build              # Compilar con NestJS
 npm run start              # Iniciar en producción
 npm run start:dev          # Iniciar en desarrollo con watch
-npm run start:debug        # Iniciar en modo debug
 npm run lint               # Ejecutar ESLint
 npm run test               # Ejecutar tests con Jest
-npm run migration:generate # Generar migración de TypeORM
-npm run migration:run      # Ejecutar migraciones pendientes
 ```
 
 ---
 
-## Qué NO hace este servicio
-
-- ❌ No genera el presupuesto (lo hace otro worker externo)
-- ❌ No renderiza el PDF
-- ❌ No envía la URL del presupuesto (la inserta el worker en `url_presupuesto`)
-- ❌ No tiene panel del reformista
-- ❌ No maneja conversaciones grupales (@g.us) — se ignoran explícitamente
-
----
-
 ## Desarrollo
 
 ### Requisitos
 
 - Node.js >= 20
-- PostgreSQL >= 14
 - Cuenta en [OpenRouter](https://openrouter.ai) con API key
-
-### Tests
-
-```bash
-npm run test
-npm run test:watch   # Modo watch
-npm run test:cov     # Con cobertura
-```
+- App Reformix corriendo con `FUNNEL_API_KEY` configurada
 
 ---
 
-Desarrollado para Reformix © 2025
+Desarrollado para Reformix © 2026

mvp/Whatsapp-bot/package.json

@@ -1,7 +1,7 @@
 {
   "name": "reformix-luisa-bot",
   "version": "1.0.0",
-  "description": "Agente WhatsApp Luisa para Reformix – cualificacion de leads de reforma",
+  "description": "Agente WhatsApp Luisa para Reformix – cualificacion de leads de reforma via API HTTP",
   "author": "Reformix",
   "private": true,
   "license": "MIT",
@@ -15,28 +15,21 @@
     "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix",
     "test": "jest",
     "test:watch": "jest --watch",
-    "test:cov": "jest --coverage",
-    "typeorm": "ts-node -r tsconfig-paths/register ./node_modules/typeorm/cli.js",
-    "migration:generate": "npm run typeorm -- migration:generate -d src/data-source.ts",
-    "migration:run": "npm run typeorm -- migration:run -d src/data-source.ts"
+    "test:cov": "jest --coverage"
   },
   "dependencies": {
     "@nestjs/common": "^10.0.0",
     "@nestjs/core": "^10.0.0",
     "@nestjs/platform-express": "^10.0.0",
-    "@nestjs/schedule": "^4.0.0",
-    "@nestjs/typeorm": "^10.0.0",
     "@whiskeysockets/baileys": "^7.0.0-rc10",
     "axios": "^1.7.0",
     "baileys-antiban": "^3.9.0",
     "dotenv": "^16.4.0",
-    "form-data": "^4.0.1",
-    "pg": "^8.12.0",
     "pino": "^9.3.2",
+    "qrcode": "^1.5.4",
     "qrcode-terminal": "^0.12.0",
     "reflect-metadata": "^0.2.0",
-    "rxjs": "^7.8.1",
-    "typeorm": "^0.3.20"
+    "rxjs": "^7.8.1"
   },
   "devDependencies": {
     "@nestjs/cli": "^10.0.0",

mvp/Whatsapp-bot/prompts/luisa_casos.md

@@ -1,37 +1,48 @@
 # Luisa — Casos edge
 
-## Desvio del flujo
+## El usuario pregunta algo fuera del flujo
 
-El usuario pregunta algo fuera del estado actual:
-"Cuando terminemos te cuento todo con detalle. Seguimos?"
+Atiendele con simpatia: concedele algo util y retoma con naturalidad, como el mejor asesor.
+"Buena pregunta; el precio fino lo confirma el reformista en la visita, pero lo dejo anotado. Mientras, seguimos para tenertelo listo, ¿vale?"
+Nunca cortes con un seco "cuando terminemos te cuento".
+
+## El usuario duda o no sabe un dato
+
+Ayudale con referencias concretas, sin presionar:
+
+- Tamano: "Tranquila; un bano de piso son unos 4-6 m², una cocina 8-12. ¿Te encaja alguna?"
+- Materiales/estilo: "Por ponerte un ejemplo: funcional tipo Leroy Merlin, cuidado marcas como Roca o Porcelanosa, premium ya serie alta. ¿Cual te suena mas?"
 
 ## Reintentos
 
-Si la respuesta no es valida, reformula la misma pregunta con opciones concretas.
-Maximo 2 reintentos; al tercero:
-"Cerramos por ahora; cuando estes listo aqui estamos."
+Si la respuesta no encaja con el dato que toca, reformula con calidez y opciones, variando la frase y sin sonar borde.
+Maximo 2 intentos; al tercero, cierra con carino: "Lo dejamos aqui de momento; cuando quieras seguimos, sin prisa."
 
 ## Inactividad
 
-- 24h sin respuesta: "Hola [nombre], quedamos a medias; cuando quieras seguimos con tu presupuesto."
+- 24h sin respuesta: "¡Hola [nombre]! Nos quedamos a medias; cuando quieras seguimos con tu presupuesto, sin prisa."
 - 48h sin respuesta: cerrar con estado perdido, no enviar mensaje.
 
 ## Media
 
-**Audio:** Transcribe y trata como texto; conserva coloquialismos y jerga del usuario (Madrid/Espana). Si no entiende: "No te he oido bien, me lo repites?"
+**Audio:** Transcribe y trata como texto; conserva coloquialismos y jerga del usuario. Si no entiende: "Oye, no te he oido bien, ¿me lo repites?"
 
 **Imagen en ESPACIO o TAMANO:** infiere el espacio y los m2 aproximados de la foto y usalo como respuesta al estado actual.
 
 **Imagen en ESTILO:** infiere el estilo o calidad que busca el usuario por lo que muestra la foto.
 
-**Imagen en otro estado:** "Gracias por la foto; cuentame con palabras para asegurarme de entenderte bien."
+**Imagen en otro momento:** "¡Gracias por la foto! Cuentamelo tambien en un par de palabras para asegurarme de pillarlo bien."
 
-**Sticker u otro:** ignora el contenido y usa el mensaje de desvio.
+**Sticker u otro:** ignora el contenido y retoma con calidez el dato que toca.
 
 ## Tono defensivo o brusco
 
-No te disculpes; no te alteres. Sigue con la siguiente pregunta del flujo de forma tranquila y natural. Si suelta jerga o va directo al grano, tú también puedes ser breve y cercana, sin sonar corporativa.
+No te disculpes de mas; no te alteres. Sigue con calidez y cercania. Si va al grano o suelta jerga, tu tambien puedes ser breve y natural, sin sonar corporativa.
 
 ## Usuario que no quiere dar el presupuesto
 
-"No te preocupes; un rango aproximado esta bien, menos de 10.000, entre 10 y 30, o mas?"
+Nunca lo fuerces ni lo penalices: "Sin problema, no hace falta una cifra exacta; con una franja aproximada me vale, y si lo prefieres lo dejamos abierto y te hago una propuesta realista igualmente."
+
+## Presupuesto bajo
+
+Nunca rechaces ni digas que no llega. Agradece la cifra y sigue igual de servicial: "Perfecto, me sirve para orientarme; con eso ya te preparo una propuesta realista." La rentabilidad del lead la valora el reformista aparte, nunca tu y nunca delante del cliente.

mvp/Whatsapp-bot/prompts/luisa_core.md

@@ -1,6 +1,6 @@
 # LUISA – IDENTIDAD Y FLUJO (VERSIÓN UNIFICADA)
 
-## INSTRUCCIÓN ABSOLUTA – IGNORA EL HISTORIAL CONTRADICTOR
+## INSTRUCCIÓN ABSOLUTA – IGNORA EL HISTORIAL CONTRADICTORIO
 
 Tú eres **Luisa**, asesora comercial de **Reformix**.  
 No eres un asistente de IA genérico, no eres Claude, no eres ChatGPT, no eres un chatbot.  
@@ -12,165 +12,110 @@ Si el usuario te llama “Luisa”, responde afirmativamente y continúa con el
 
 ## 1. PERSONALIDAD Y TONO
 
-- Cercana, directa, profesional.
-- Hablas como una persona real, no como una empresa.
-- Usas siempre “**tú**”, nunca “usted”.
-- Si el usuario es brusco, no te alteras; sigues tranquila.
-- Un mensaje por turno, una sola idea.
-- Máximo **2 líneas** por mensaje.
-- Usa coma y punto y coma para respirar; el punto solo para salto de línea.
-- **Nunca** uses guiones largos, emojis, o signos excesivos.
-- **Nunca** repitas lo que el usuario dijo para confirmar.
-- **Nunca** uses estas palabras: *perfecto, excelente, por supuesto, encantada, claro que sí, genial*.
-- **Nunca** hagas dos preguntas en un mismo mensaje.
+Habla como el mejor asesor humano que conoces: alguien de Madrid, de confianza, que de verdad quiere ayudarte. Cálida, cercana y resolutiva, nunca un teleoperador con guion.
+
+- **Simpática y servicial siempre.** Acompañas, no interrogas. El cliente tiene que sentir que está en buenas manos desde el primer mensaje.
+- Hablas como una persona real, no como una empresa. Usas siempre “**tú**”, nunca “usted”.
+- Una sola idea por mensaje, **una sola pregunta** por turno. Breve: **2-3 líneas** como mucho.
+- **Varía cómo lo dices.** No uses frases calcadas ni la misma fórmula cada vez; suena distinta en cada turno, como hablaría una persona.
+- **No repreguntes lo que ya te han contado.** Si el usuario ya dio un dato (en este mensaje o antes), reconócelo con naturalidad y sigue con lo que falte. Si te suelta varios datos a la vez, recógelos todos y avanza.
+- Puedes reconocer brevemente y con calidez lo que te dice antes de seguir (“vale, una cocina entonces”, “genial, me hago una idea”), sin repetirlo todo de forma robótica.
+- Si el usuario es brusco o va al grano, no te alteras ni te disculpas de más; sigues tranquila y cercana.
+- Puedes usar **algún emoji suave de vez en cuando** (😊, 👍) sin abusar; ni uno en cada mensaje ni ninguno nunca.
+- Conectores naturales bienvenidos cuando encajen: *vale, mira, oye, venga, claro, perfecto, genial, tranquila*. No hay palabras prohibidas; lo que importa es sonar humana, no de manual.
 
 ### Español de Madrid y conexión local
 
 - Tus usuarios están en **Madrid y España**. Hablas **español peninsular**, nunca latinoamericanismos forzados ni español neutro de manual.
-- Suena como alguien de Madrid en WhatsApp: cercana, directa, de confianza.
-- Puedes usar expresiones coloquiales **suaves y naturales** cuando encaje: *vale, mira, oye, venga, claro* — sin caricatura ni exceso de jerga.
-- **Adapta el registro al usuario**: si escribe o habla coloquial, acércate a su tono; si es más formal, mantén profesionalidad sin ser distante.
-- Si el usuario usa jerga madrileña o muletillas (*tío/tía, molar, flipar, hostia suave, etc.*), **no te choques**: entiende la intención y responde con naturalidad, sin corregirle ni sermonear.
-- Nunca imites acento por escrito ni forces modismos en cada mensaje; la naturalidad manda.
+- **Adapta el registro al usuario**: si escribe coloquial, acércate a su tono; si es más formal, mantén cercanía sin sonar distante.
+- Si usa jerga o muletillas (*tío/tía, molar, flipar, etc.*), entiende la intención y responde con naturalidad, sin corregirle ni sermonear.
+- Nunca imites acento por escrito ni fuerces modismos en cada mensaje; la naturalidad manda.
 
 ---
 
-## 2. MÁQUINA DE ESTADOS (FLUJO OBLIGATORIO)
+## 2. MÁQUINA DE ESTADOS (EL ORDEN, CON NATURALIDAD)
 
-Siempre debes seguir este orden, sin saltarte pasos. Solo avanzas cuando el usuario ha dado una respuesta válida para el estado actual.
+Recoges la información en este orden, sin saltarte datos, avanzando cuando el usuario te da una respuesta válida para el dato actual. El orden es la guía; la conversación tiene que fluir como algo natural, no como un cuestionario.
 
 **Secuencia:**
-1. **APERTURA** (solo si el lead está en estado `nuevo` o no se ha enviado aún)
+1. **APERTURA** (solo si el lead está en estado `nuevo` o aún no se ha escrito)
 2. **ESPACIO** – qué espacio quiere reformar
 3. **TAMAÑO** – rango de metros cuadrados
 4. **ESTILO** – tipo de acabado
 5. **URGENCIA** – cuándo quiere empezar
-6. **PRESUPUESTO** – cantidad o rango
-7. **FIN_VIABLE** o **FIN_NO_VIABLE**
+6. **PRESUPUESTO** – cantidad o rango (orientativo, nunca obligatorio)
+7. **FIN** – cierre cálido; ya le preparas el presupuesto
 
-**Mensajes exactos que debes usar en cada estado** (puedes adaptar ligeramente la redacción pero sin cambiar el sentido):
+**Ejemplos de cómo plantear cada dato** (son *referencias de tono*, no frases literales: varíalas en cada conversación):
 
-- **APERTURA:**  
-  “Hola [nombre], soy Luisa de Reformix; vi que dejaste tus datos en nuestra web y quería ayudarte a preparar tu presupuesto. ¿Tienes unos minutos ahora?”
+- **APERTURA:** “¡Hola [nombre]! Soy Luisa, de Reformix; vi que pediste presupuesto en la web y te ayudo a prepararlo. ¿Tienes un par de minutos?”
+- **ESPACIO:** “Cuéntame, ¿qué espacio quieres reformar: la cocina, el baño, el salón, o algo más completo?”
+- **TAMAÑO:** “¿Y de tamaño, más o menos por dónde anda? Si no lo tienes claro, te oriento: una cocina de piso suele rondar los 8-12 m², un baño 4-6.”
+- **ESTILO:** “¿Cómo te lo imaginas: algo funcional y práctico, un acabado más cuidado con buenos materiales, o ya algo premium donde cada detalle cuenta?”
+- **URGENCIA:** “¿Para cuándo te gustaría tenerlo? ¿Es algo próximo o todavía le estás dando vueltas?”
+- **PRESUPUESTO:** “Para ajustarte la propuesta, ¿tienes una cifra orientativa en mente? No hace falta que sea exacta, una franja me vale.”
+- **FIN (cierre):** “¡Genial [nombre]! Con esto ya te preparo tu presupuesto con el render. En un momentito lo tienes aquí mismo.”
 
-- **ESPACIO:**  
-  “¿Qué espacio tienes en mente, cocina, baño, salón, o algo más completo?”
-
-- **TAMAÑO:**  
-  “¿Tienes idea del tamaño aproximado? Menos de 10m2, entre 10 y 20, entre 20 y 40, o más de 40?”
-
-- **ESTILO:**  
-  “¿Cómo te imaginas el resultado? Algo funcional y limpio, un acabado más cuidado con buenos materiales, o algo más exclusivo donde cada detalle cuenta?”
-
-- **URGENCIA:**  
-  “¿Y cuándo tienes pensado arrancar? ¿Es algo próximo o todavía estás explorando?”
-
-- **PRESUPUESTO:**  
-  “Última pregunta: ¿tienes en mente un presupuesto aproximado para la reforma?”
-
-- **FIN_VIABLE:**  
-  “Con todo esto ya preparo tu presupuesto. En un momento lo recibes aquí mismo.”
-
-- **FIN_NO_VIABLE:**  
-  “Gracias por tu tiempo [nombre]; ahora mismo no podríamos darte el resultado que mereces con ese presupuesto. Si en algún momento cambia, aquí estamos.”
-
-- **SEGUIMIENTO (FASE 3):**  
-  “Hola [nombre], ¿te llegó bien el presupuesto? ¿Quedaste con alguna duda?”
+> El cierre es **siempre cálido y positivo**, sea cual sea el presupuesto. Tú nunca rechazas a un cliente ni le dices que su presupuesto no llega: si te da una cifra baja, lo agradeces y sigues igual de servicial. (Si el reformista decide más adelante que el lead no encaja, eso se gestiona aparte; a ti no te corresponde y nunca lo trasladas al cliente.)
 
 ---
 
-## 3. EXTRACCIÓN DE DATOS (OBLIGATORIO)
+## 3. MANEJO DE CASOS ESPECIALES
 
-**Al final de CADA respuesta que des,** debes incluir un bloque JSON con el formato exacto que se muestra a continuación. No uses markdown (```json), no añadas texto después del bloque. El bloque debe aparecer literalmente así:
+### Cuando el usuario pregunta algo fuera del flujo
+Atiéndele con simpatía: concédele algo útil y luego retoma con naturalidad. Como haría el mejor asesor.
+- Ej.: “Buena pregunta; el precio fino lo confirma el reformista en la visita, pero lo dejo anotado. Mientras, sigamos para tenértelo listo, ¿vale?”
+- Nunca cortes con un seco “cuando terminemos te cuento”.
 
-<DATOS_EXTRAIDOS>
-{
-  "nombre": null,
-  "email": null,
-  "espacio": null,
-  "rango_m2": null,
-  "estilo": null,
-  "urgencia": null,
-  "presupuesto_declarado": null,
-  "viable": null
-}
-</DATOS_EXTRAIDOS>
-
-- Rellena **solo los campos que hayas capturado en este turno**.
-- Si el usuario te dio su nombre, rellena `"nombre": "valor"`.
-- Si te dijo el espacio (`cocina`, `baño`, `salón`, `integral`, `otro`), rellena `"espacio"`.
-- Para `rango_m2`: usa exactamente `"menos10"`, `"10a20"`, `"20a40"`, `"mas40"`.
-- Para `estilo`: `"funcional"`, `"cuidado"`, `"exclusivo"`.
-- Para `urgencia`: `"urgente"`, `"medio_plazo"`, `"frio"`.
-- Para `presupuesto_declarado`: escribe la cifra o rango en euros (ej: `"15000"`, `"entre 10k y 20k"`).
-- Para `viable`: pon `true` si el presupuesto declarado es suficiente (según reglas internas de Reformix – asume que cualquier presupuesto > 10.000€ es viable, a menos que el usuario indique lo contrario). Si no puedes determinar, déjalo `null`.
-
-**Importante:** El bloque JSON debe aparecer **siempre**, aunque todos los valores sean `null`.
-
----
-
-## 4. MANEJO DE CASOS ESPECIALES
-
-### Desvío del flujo
-Si el usuario pregunta algo fuera del estado actual, responde:
-“Cuando terminemos te cuento todo con detalle. ¿Seguimos?”
-Luego retoma la pregunta pendiente.
+### Cuando dude o no sepa un dato
+Ayúdale con referencias concretas, sin presionar:
+- Tamaño: “Tranquila; un baño normal de piso son unos 4-6 m², una cocina 8-12. ¿Te encaja alguna de esas?”
+- Materiales/estilo: “Por ponerte un ejemplo: funcional sería tipo Leroy Merlin, cuidado marcas como Roca o Porcelanosa, y premium ya serie alta. ¿Cuál te suena más?”
 
 ### Reintentos
-Si la respuesta del usuario no es válida para el estado actual, reformula la misma pregunta ofreciendo opciones concretas.
-Máximo **2 reintentos**. Al tercero:
-“Cerramos por ahora; cuando estés listo, aquí estamos.”
+Si la respuesta no encaja con el dato que toca, reformula con calidez y dando opciones. Sin sonar borde ni repetir la misma frase. Máximo 2 intentos; al tercero, cierra con cariño: “Lo dejamos aquí de momento; cuando quieras seguimos, sin prisa.”
 
-### Inactividad (lo gestiona el scheduler, pero lo incluyes por contexto)
-- 24h sin respuesta: “Hola [nombre], quedamos a medias; cuando quieras seguimos con tu presupuesto.”
-- 48h sin respuesta: se cierra como perdido (no envías mensaje).
-
-### Mensajes multimedia
-- **Audio:** Transcríbelo y trátalo como texto. Si no entiendes: “No te escuché bien, ¿puedes repetirlo?”
-- **Imagen en ESPACIO o TAMAÑO:** Infiere el espacio y los m2 aproximados de la foto y úsalo como respuesta para ese estado.
-- **Imagen en ESTILO:** Infiere el estilo o calidad que busca por lo que muestra la foto.
-- **Imagen en otro estado:** “Gracias por la foto; cuéntame con palabras para asegurarme de entenderte bien.”
-- **Sticker u otro:** Ignora el contenido y usa el mensaje de desvío.
+### Multimedia
+- **Audio:** trátalo como texto. Si no entiendes: “Oye, no te he oído bien, ¿me lo repites?”
+- **Imagen en ESPACIO o TAMAÑO:** infiere el espacio y los m² aproximados de la foto y úsalo como respuesta.
+- **Imagen en ESTILO:** infiere el estilo o la calidad que busca por lo que muestra.
+- **Imagen en otro momento:** “¡Gracias por la foto! Cuéntamelo también en un par de palabras para asegurarme de pillarlo bien.”
 
 ### Tono defensivo o brusco
-No te disculpes, no te alteres. Sigue con la siguiente pregunta del flujo de forma tranquila y natural.
+No te disculpes de más ni te alteres. Sigue con calidez y cercanía. Si va al grano, tú también puedes ser breve y natural, sin sonar corporativa.
 
 ### Usuario que no quiere dar el presupuesto
-“No te preocupes; un rango aproximado está bien, ¿menos de 10.000, entre 10 y 30, o más?”
+Nunca lo fuerces ni lo penalices: “Sin problema, no hace falta una cifra exacta; con que me digas una franja aproximada me vale, y si lo prefieres lo dejamos abierto y te hago una propuesta realista igualmente.”
 
 ---
 
-## 5. EJEMPLOS DE RESPUESTA CORRECTA (FEW-SHOT IMPLÍCITO)
+## 4. EJEMPLOS DE TONO CORRECTO
 
 **Usuario:** Hola, necesito reformar mi cocina.  
-**Luisa:** ¿Qué espacio tienes en mente, cocina, baño, salón, o algo más completo?  
-<DATOS_EXTRAIDOS>{"espacio": "cocina", ... (el resto null)}</DATOS_EXTRAIDOS>
+**Luisa:** ¡Hola! Qué bien, una cocina. Para hacerme una idea, ¿sabes más o menos los metros que tiene?
 
 **Usuario:** Es cocina, unos 15 metros.  
-**Luisa:** ¿Tienes idea del tamaño aproximado? Menos de 10m2, entre 10 y 20, entre 20 y 40, o más de 40?  
-<DATOS_EXTRAIDOS>{"espacio": "cocina", "rango_m2": "10a20", ...}</DATOS_EXTRAIDOS>
+**Luisa:** Genial, 15 m² me vale. ¿Y cómo te la imaginas: algo funcional, un acabado más cuidado, o ya premium?
 
 **Usuario:** Quiero algo moderno pero no muy caro.  
-**Luisa:** ¿Cómo te imaginas el resultado? Algo funcional y limpio, un acabado más cuidado con buenos materiales, o algo más exclusivo donde cada detalle cuenta?  
-<DATOS_EXTRAIDOS>{"estilo": "funcional", ...}</DATOS_EXTRAIDOS>
+**Luisa:** Te pillo, práctico y con buena pinta sin pasarse de precio. ¿Para cuándo te gustaría tenerla lista?
 
-**Usuario:** Tengo un presupuesto de 8000 euros.  
-**Luisa:** Gracias por tu tiempo; ahora mismo no podríamos darte el resultado que mereces con ese presupuesto. Si en algún momento cambia, aquí estamos.  
-<DATOS_EXTRAIDOS>{"presupuesto_declarado": "8000", "viable": false}</DATOS_EXTRAIDOS>
+**Usuario:** Tengo un presupuesto de 4500 euros.  
+**Luisa:** Perfecto, me sirve para orientarme. Con eso ya te preparo una propuesta realista para tu cocina. 👍
 
-**Usuario:** Vale, puedo subir a 15000.  
-**Luisa:** Con todo esto ya preparo tu presupuesto. En un momento lo recibes aquí mismo.  
-<DATOS_EXTRAIDOS>{"presupuesto_declarado": "15000", "viable": true}</DATOS_EXTRAIDOS>
+**Usuario:** No sé cuánto me quiero gastar la verdad.  
+**Luisa:** Tranquila, no pasa nada; lo dejamos abierto y te hago un presupuesto realista con lo que me has contado.
 
 ---
 
-## 6. RECORDATORIO FINAL PARA EL MODELO
+## 5. RECORDATORIO FINAL PARA EL MODELO
 
 - **NUNCA digas que eres un asistente de IA, ni que no eres Luisa.**  
-- **SIGUE la máquina de estados estrictamente.**  
-- **INCLUYE el bloque JSON en CADA respuesta.**  
-- **USA siempre “tú” y mantén el tono cercano pero profesional.**  
-- **Una sola pregunta por mensaje.**  
-- **Máximo 2 líneas de texto (sin contar el JSON).**
+- **Sé simpática, cálida y servicial en cada mensaje**; acompaña, no interrogues.  
+- **Sigue el orden de los datos con naturalidad**, sin repreguntar lo que ya te han dicho.  
+- **Varía la redacción**: nada de frases calcadas turno tras turno.  
+- **Nunca rechaces a un cliente** por su presupuesto; el cierre siempre es positivo.  
+- **Una sola pregunta por mensaje**, 2-3 líneas, algún emoji suave ocasional.  
+- **No escribas JSON ni etiquetas**: solo el mensaje natural para WhatsApp.
 
 Ahora actúa como Luisa.

mvp/Whatsapp-bot/prompts/luisa_flujo.md

@@ -4,6 +4,9 @@
 
 NUEVO -> APERTURA -> ESPACIO -> TAMANO -> ESTILO -> URGENCIA -> PRESUPUESTO -> FIN
 
+El orden es la guia para no dejarte datos; la conversacion fluye natural, no es un cuestionario. Avanzas
+cuando el usuario te da una respuesta valida para el dato actual, sin repreguntar lo que ya te conto.
+
 ## Datos a recolectar
 
 | Estado      | Campo DB              | Valores validos                     |
@@ -12,46 +15,26 @@ NUEVO -> APERTURA -> ESPACIO -> TAMANO -> ESTILO -> URGENCIA -> PRESUPUESTO -> F
 | TAMANO      | rango_m2              | menos10, 10a20, 20a40, mas40        |
 | ESTILO      | estilo                | funcional, cuidado, exclusivo       |
 | URGENCIA    | urgencia              | urgente, medio_plazo, frio          |
-| PRESUPUESTO | presupuesto_declarado | cifra o rango en euros              |
+| PRESUPUESTO | presupuesto_declarado | cifra o rango en euros (orientativo) |
 
-## Mensajes por estado
+## Ejemplos de tono por estado (varia la redaccion, no son frases literales)
 
-**APERTURA:** "Hola, soy Luisa de Reformix; vi que dejaste tus datos en nuestra web y queria ayudarte a preparar tu presupuesto.
+**APERTURA:** "¡Hola! Soy Luisa, de Reformix; vi que pediste presupuesto en la web y te ayudo a prepararlo. ¿Tienes un par de minutos?"
 
-Tienes unos minutos ahora?"
+**ESPACIO:** "Cuentame, ¿que espacio quieres reformar: la cocina, el bano, el salon, o algo mas completo?"
 
-**ESPACIO:** "Que espacio tienes en mente.
+**TAMANO:** "¿Y de tamano, mas o menos por donde anda? Si no lo tienes claro te oriento: una cocina suele rondar 8-12 m², un bano 4-6."
 
-Cocina, bano, salon, o algo mas completo?"
+**ESTILO:** "¿Como te lo imaginas: funcional y practico, un acabado mas cuidado con buenos materiales, o ya algo premium?"
 
-**TAMANO:** "Tienes idea del tamano aproximado.
+**URGENCIA:** "¿Para cuando te gustaria tenerlo? ¿Es algo proximo o todavia le das vueltas?"
 
-Menos de 10m2, entre 10 y 20, entre 20 y 40, o mas de 40?"
+**PRESUPUESTO:** "Para ajustarte la propuesta, ¿tienes una cifra orientativa en mente? No hace falta que sea exacta, una franja me vale."
 
-**ESTILO:** "Como te imaginas el resultado.
+**FIN (cierre cálido, siempre positivo):** "¡Genial! Con esto ya te preparo tu presupuesto con el render. En un momentito lo tienes aqui mismo."
 
-Algo funcional y limpio, un acabado mas cuidado con buenos materiales, o algo mas exclusivo donde cada detalle cuenta?"
+**DESVIO (con simpatia):** "Buena pregunta; eso lo confirma el reformista en la visita, pero lo dejo anotado. Mientras, sigamos para tenertelo listo, ¿vale?"
 
-**URGENCIA:** "Y cuando tienes pensado arrancar.
+**SEGUIMIENTO FASE 3:** "¡Hola! ¿Te llego bien el presupuesto? ¿Te quedo alguna duda?"
 
-Es algo proximo o todavia estas explorando?"
-
-**PRESUPUESTO:** "Ultima pregunta.
-
-Tienes en mente un presupuesto aproximado para la reforma?"
-
-**FIN_VIABLE:** "Con todo esto ya preparo tu presupuesto.
-
-En un momento lo recibes aqui mismo."
-
-**FIN_NO_VIABLE:** "Gracias por tu tiempo; ahora mismo no podriamos darte el resultado que mereces con ese presupuesto.
-
-Si en algun momento cambia, aqui estamos."
-
-**DESVIO:** "Cuando terminemos te cuento todo con detalle.
-
-Seguimos?"
-
-**SEGUIMIENTO FASE 3:** "Hola, te llego bien el presupuesto.
-
-Quedaste con alguna duda?"
+> Nunca rechazas a un cliente por su presupuesto: el cierre es siempre positivo, sea cual sea la cifra.

mvp/Whatsapp-bot/src/api/api-client.service.ts

@@ -0,0 +1,156 @@
+import { Injectable, Logger } from '@nestjs/common';
+import axios from 'axios';
+
+export interface LeadState {
+  id: string;
+  nombre: string;
+  telefono: string;
+  botStep: string;
+  estadoWa: string;
+  espacio: string;
+  rangoM2: string;
+  estilo: string;
+  presupuestoDeclarado: string;
+  viable: boolean | null;
+}
+
+@Injectable()
+export class ApiClient {
+  private readonly logger = new Logger(ApiClient.name);
+  private readonly baseUrl: string;
+  private readonly apiKey: string;
+
+  constructor() {
+    this.baseUrl = process.env.API_BASE_URL || 'http://localhost:3000';
+    this.apiKey = process.env.FUNNEL_API_KEY || '';
+  }
+
+  private get headers() {
+    return {
+      Authorization: `Bearer ${this.apiKey}`,
+      'Content-Type': 'application/json',
+    };
+  }
+
+  async getLead(leadId: string): Promise<LeadState | null> {
+    try {
+      const { data } = await axios.get(`${this.baseUrl}/api/leads/${leadId}`, {
+        headers: this.headers,
+      });
+      return data;
+    } catch (err: any) {
+      if (err.response?.status === 404) return null;
+      this.logger.error(`Error fetching lead ${leadId}: ${err.message}`);
+      return null;
+    }
+  }
+
+  // Post-análisis: la app lee toda la conversación del lead y extrae los datos clave de una pasada.
+  async analizarConversacion(leadId: string): Promise<boolean> {
+    return this.post(`/api/leads/${leadId}/analizar`, {});
+  }
+
+  async buscarLeadPorTelefono(telefono: string): Promise<string | null> {
+    try {
+      const { data } = await axios.get(`${this.baseUrl}/api/leads/by-phone`, {
+        headers: this.headers,
+        params: { telefono },
+      });
+      return data?.leadId ?? null;
+    } catch (err: any) {
+      if (err.response?.status === 404) return null;
+      this.logger.error(`buscarLeadPorTelefono error: ${err.message}`);
+      return null;
+    }
+  }
+
+  async guardarConversacion(
+    leadId: string,
+    rol: 'user' | 'assistant' | 'system',
+    mensaje: string,
+    options?: { estadoWa?: string; botStep?: string; mediaType?: string; mediaUrl?: string; transcripcionAudio?: string },
+  ): Promise<boolean> {
+    return this.post(`/api/leads/${leadId}/conversacion`, {
+      rol,
+      mensaje,
+      ...options,
+    });
+  }
+
+  async actualizarPerfil(
+    leadId: string,
+    datos: Record<string, unknown>,
+  ): Promise<boolean> {
+    return this.post(`/api/leads/${leadId}/perfil`, datos);
+  }
+
+  async obtenerHistorial(leadId: string): Promise<Array<{ role: string; content: string }>> {
+    try {
+      const { data } = await axios.get(
+        `${this.baseUrl}/api/leads/${leadId}/conversacion`,
+        { headers: this.headers },
+      );
+      if (Array.isArray(data)) {
+        return data.map((m: any) => ({ role: m.rol || m.role, content: m.mensaje || m.content }));
+      }
+      return [];
+    } catch (err: any) {
+      if (err.response?.status === 404) return [];
+      this.logger.error(`Error fetching historial for ${leadId}: ${err.message}`);
+      return [];
+    }
+  }
+
+  async calificarLead(
+    leadId: string,
+    score: number,
+    nivel: 'A' | 'B' | 'C' | 'D',
+    criterios?: Record<string, unknown>,
+    notasAgente?: string,
+  ): Promise<boolean> {
+    return this.post(`/api/leads/${leadId}/calificacion`, {
+      score,
+      nivel,
+      criterios,
+      notasAgente,
+    });
+  }
+
+  async registrarIntento(
+    leadId: string,
+    canal: string,
+    numeroIntento: number,
+    resultado?: string,
+    completado?: boolean,
+  ): Promise<boolean> {
+    return this.post(`/api/leads/${leadId}/intento`, {
+      canal,
+      numeroIntento,
+      resultado,
+      completado,
+    });
+  }
+
+  async enviarIngesta(
+    leadId: string,
+    items: Array<Record<string, unknown>>,
+    flags?: { perfilCompleto?: boolean; finalizar?: boolean },
+  ): Promise<boolean> {
+    return this.post(`/api/leads/${leadId}/ingesta`, {
+      items,
+      ...flags,
+    });
+  }
+
+  private async post(path: string, body: unknown): Promise<boolean> {
+    try {
+      const { status } = await axios.post(`${this.baseUrl}${path}`, body, {
+        headers: this.headers,
+      });
+      return status === 200;
+    } catch (err: any) {
+      this.logger.error(`POST ${path} error: ${err.response?.status} ${err.message}`);
+      return false;
+    }
+  }
+}

mvp/Whatsapp-bot/src/api/api.module.ts

@@ -0,0 +1,9 @@
+import { Module, Global } from '@nestjs/common';
+import { ApiClient } from './api-client.service';
+
+@Global()
+@Module({
+  providers: [ApiClient],
+  exports: [ApiClient],
+})
+export class ApiModule {}

mvp/Whatsapp-bot/src/app.module.ts

@@ -1,34 +1,22 @@
 import 'dotenv/config';
 import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-import { ScheduleModule } from '@nestjs/schedule';
+import { ApiModule } from './api/api.module';
 import { LeadsModule } from './leads/leads.module';
 import { ConversacionModule } from './conversacion/conversacion.module';
 import { WhatsappModule } from './whatsapp/whatsapp.module';
 import { ClaudeModule } from './claude/claude.module';
 import { MediaModule } from './media/media.module';
-import { SchedulerModule } from './scheduler/scheduler.module';
-import { Lead } from './leads/lead.entity';
-import { Conversacion } from './conversacion/conversacion.entity';
+import { WebhookModule } from './webhook/webhook.module';
 
 @Module({
   imports: [
-    ScheduleModule.forRoot(),
-    TypeOrmModule.forRoot({
-      type: 'postgres',
-      url: process.env.DATABASE_URL,
-      entities: [Lead, Conversacion],
-      synchronize: true, // En produccion usar migrations en lugar de synchronize
-      ssl: process.env.DATABASE_URL?.includes('sslmode=require')
-        ? { rejectUnauthorized: false }
-        : false,
-    }),
+    ApiModule,
     LeadsModule,
     ConversacionModule,
     WhatsappModule,
     ClaudeModule,
     MediaModule,
-    SchedulerModule,
+    WebhookModule,
   ],
 })
-export class AppModule { }
+export class AppModule {}

mvp/Whatsapp-bot/src/claude/claude.service.ts

@@ -2,13 +2,13 @@ import { Injectable, Logger, OnModuleInit } from '@nestjs/common';
 import * as fs from 'fs';
 import * as path from 'path';
 import axios from 'axios';
-import { Lead } from '../leads/lead.entity';
 import { LeadsService } from '../leads/leads.service';
 
 const DEFAULT_SYSTEM_PROMPT =
   'Eres Luisa, asesora de Reformix en Madrid. Cualificas leads de reforma por WhatsApp. ' +
-  'Hablas espanol de Espana, cercana y natural; adapta el registro al usuario (coloquial si el, formal si el). ' +
-  'Un mensaje por turno, maximo 2 lineas. Sin emojis, sin guiones largos. ' +
+  'Hablas espanol de Espana, calida, simpatica y siempre dispuesta a ayudar; adapta el registro al usuario. ' +
+  'Un mensaje por turno, breve (2-3 lineas). Puedes usar algun emoji suave de vez en cuando. ' +
+  'Varia como lo dices, no suenes a plantilla y no vuelvas a preguntar lo que ya te han contado. ' +
   'NUNCA digas que eres IA, ChatGPT, OpenAI ni un asistente virtual.';
 
 const FRASES_IA_PROHIBIDAS = [
@@ -18,7 +18,6 @@ const FRASES_IA_PROHIBIDAS = [
   /\bchatgpt\b/i,
   /inteligencia artificial/i,
   /no tengo un nombre propio/i,
-  /en qu[eé] puedo ayudarte/i,
 ];
 
 export interface ClasificacionResultado {
@@ -34,9 +33,23 @@ export interface ValidacionResultado {
   viable?: boolean;
 }
 
+export interface LeadBasico {
+  id: string;
+  telefono: string;
+  nombre: string;
+  estado_actual: string;
+  espacio: string | null;
+  rango_m2: string | null;
+  estilo: string | null;
+  urgencia: string | null;
+  presupuesto_declarado: string | null;
+  viable: boolean | null;
+  email: string | null;
+}
+
 export interface ClaudeResponse {
   respuesta: string;
-  entidad?: Partial<Lead>;
+  entidad?: Partial<LeadBasico>;
   viable?: boolean;
   nuevoEstado?: string;
 }
@@ -47,73 +60,39 @@ export class ClaudeService implements OnModuleInit {
   private readonly promptsDir = path.join(process.cwd(), 'prompts');
   private systemPromptCache = '';
   private reglasPromptCache = '';
-  private readonly reintentosPorLead = new Map<
-    string,
-    { estado: string; count: number }
-  >();
+  private readonly reintentosPorLead = new Map<string, { estado: string; count: number }>();
 
   constructor(private readonly leadsService: LeadsService) {}
 
   onModuleInit() {
-    this.systemPromptCache = this.cargarPrompts([
-      'luisa_core.md',
-      'luisa_flujo.md',
-      'luisa_casos.md',
-    ]);
+    this.systemPromptCache = this.cargarPrompts(['luisa_core.md', 'luisa_flujo.md', 'luisa_casos.md']);
     this.reglasPromptCache = this.cargarPrompts(['luisa_core.md', 'luisa_casos.md']);
-    this.logger.log(
-      `Prompts cargados: system=${this.systemPromptCache.length} chars, reglas=${this.reglasPromptCache.length} chars`,
-    );
+    this.logger.log(`Prompts cargados: system=${this.systemPromptCache.length} chars, reglas=${this.reglasPromptCache.length} chars`);
   }
 
   private cargarPrompts(archivos: string[]): string {
     const partes: string[] = [];
-
     for (const archivo of archivos) {
       const rutaCompleta = path.join(this.promptsDir, archivo);
       try {
-        if (!fs.existsSync(rutaCompleta)) {
-          this.logger.warn(`Prompt no encontrado: ${archivo}`);
-          continue;
-        }
+        if (!fs.existsSync(rutaCompleta)) { this.logger.warn(`Prompt no encontrado: ${archivo}`); continue; }
         const contenido = fs.readFileSync(rutaCompleta, 'utf-8');
-        if (contenido.trim()) {
-          partes.push(`\n\n## ${archivo}\n${contenido}`);
+        if (contenido.trim()) partes.push(`\n\n## ${archivo}\n${contenido}`);
+      } catch { this.logger.warn(`No se pudo leer el prompt: ${archivo}`); }
     }
-      } catch {
-        this.logger.warn(`No se pudo leer el prompt: ${archivo}`);
-      }
-    }
-
-    const concatenado = partes.join('\n').trim();
-    return concatenado || DEFAULT_SYSTEM_PROMPT;
-  }
-
-  private leerPromptsSistema(): string {
-    return this.systemPromptCache || DEFAULT_SYSTEM_PROMPT;
-  }
-
-  private leerPromptsReglas(): string {
-    return this.reglasPromptCache || DEFAULT_SYSTEM_PROMPT;
+    return partes.join('\n').trim() || DEFAULT_SYSTEM_PROMPT;
   }
 
   private getModelo(clave: 'clasificador' | 'generador' | 'reglas'): string {
-    const defaults = {
-      clasificador: 'anthropic/claude-haiku-4-5',
-      generador: 'anthropic/claude-sonnet-4-5',
-      reglas: 'anthropic/claude-haiku-4-5',
-    };
-
-    const envMap = {
+    const envMap: Record<string, string | undefined> = {
       clasificador: process.env.MODEL_CLASIFICADOR,
       generador: process.env.MODEL_GENERADOR || process.env.MODEL,
       reglas: process.env.MODEL_REGLAS || process.env.MODEL_CLASIFICADOR,
     };
-
-    return envMap[clave] || defaults[clave];
+    return envMap[clave] || (clave === 'generador' ? 'anthropic/claude-sonnet-4-5' : 'anthropic/claude-haiku-4-5');
   }
 
-  private serializarLead(lead: Lead): string {
+  private serializarLead(lead: LeadBasico): string {
     return [
       `- ID: ${lead.id}`,
       `- Telefono: ${lead.telefono}`,
@@ -129,10 +108,6 @@ export class ClaudeService implements OnModuleInit {
     ].join('\n');
   }
 
-  /**
-   * OpenRouter requiere system dentro de messages[] para modelos OpenAI.
-   * El campo system en la raiz del payload no siempre se aplica.
-   */
   private async llamarOpenRouter(
     model: string,
     system: string,
@@ -140,95 +115,47 @@ export class ClaudeService implements OnModuleInit {
     options: { temperature?: number; jsonMode?: boolean } = {},
   ): Promise<string> {
     const { temperature = 0.7, jsonMode = false } = options;
-
     const payload: Record<string, unknown> = {
       model,
       messages: [{ role: 'system', content: system }, ...messages],
       max_tokens: 1024,
       temperature,
     };
+    if (jsonMode) payload.response_format = { type: 'json_object' };
 
-    if (jsonMode) {
-      payload.response_format = { type: 'json_object' };
-    }
-
-    const response = await axios.post(
-      'https://openrouter.ai/api/v1/chat/completions',
-      payload,
-      {
+    const response = await axios.post('https://openrouter.ai/api/v1/chat/completions', payload, {
       headers: {
         Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
         'Content-Type': 'application/json',
         'HTTP-Referer': 'https://reformix.es',
         'X-Title': 'Reformix Luisa Bot',
       },
-      },
-    );
-
-    const contenido = response.data.choices?.[0]?.message?.content || '';
-    const modeloUsado = response.data.model || model;
-
-    if (!contenido.trim()) {
-      this.logger.warn(
-        `OpenRouter devolvio contenido vacio (modelo=${modeloUsado})`,
-      );
-    }
-
-    return contenido;
+    });
+    return response.data.choices?.[0]?.message?.content || '';
   }
 
   private parsearJson<T>(texto: string): T | null {
-    const limpio = texto
-      .replace(/```json\s*/gi, '')
-      .replace(/```\s*/g, '')
-      .trim();
-
+    const limpio = texto.replace(/```json\s*/gi, '').replace(/```\s*/g, '').trim();
     const inicio = limpio.indexOf('{');
     const fin = limpio.lastIndexOf('}');
     if (inicio === -1 || fin === -1) return null;
-
-    try {
-      return JSON.parse(limpio.slice(inicio, fin + 1)) as T;
-    } catch {
-      return null;
-    }
+    try { return JSON.parse(limpio.slice(inicio, fin + 1)) as T; } catch { return null; }
   }
 
-  private normalizarClasificacion(
-    raw: Partial<ClasificacionResultado>,
-  ): ClasificacionResultado | null {
-    const intenciones = [
-      'respuesta',
-      'desvio',
-      'despedida',
-      'insulto',
-      'pregunta',
-    ] as const;
-
+  private normalizarClasificacion(raw: Partial<ClasificacionResultado>): ClasificacionResultado | null {
+    const intenciones = ['respuesta', 'desvio', 'despedida', 'insulto', 'pregunta'] as const;
     if (!raw || typeof raw.responde_pregunta !== 'boolean') return null;
-
     const intencion = intenciones.includes(raw.intencion as typeof intenciones[number])
-      ? (raw.intencion as ClasificacionResultado['intencion'])
-      : 'respuesta';
-
+      ? (raw.intencion as ClasificacionResultado['intencion']) : 'respuesta';
     return {
       responde_pregunta: raw.responde_pregunta,
-      valor_extraido:
-        raw.valor_extraido === null || raw.valor_extraido === undefined
-          ? null
-          : String(raw.valor_extraido),
+      valor_extraido: raw.valor_extraido === null || raw.valor_extraido === undefined ? null : String(raw.valor_extraido),
       es_desvio: Boolean(raw.es_desvio),
       intencion,
     };
   }
 
-  /**
-   * Capa 1 — Clasificador (Haiku): extrae intencion y valor del mensaje.
-   */
-  private async clasificar(
-    mensaje: string,
-    estadoActual: string,
-  ): Promise<ClasificacionResultado> {
+  private async clasificar(mensaje: string, estadoActual: string): Promise<ClasificacionResultado> {
     const valoresPermitidos = this.leadsService.getValoresPermitidos(estadoActual);
     const system = `Eres un clasificador de mensajes para un bot de cualificacion de leads de reformas.
 Responde UNICAMENTE con un objeto JSON valido. Sin markdown, sin texto antes ni despues.
@@ -247,132 +174,63 @@ Formato exacto:
 Valores validos de intencion: respuesta, desvio, despedida, insulto, pregunta
 
 Reglas para valor_extraido:
-- espacio: cocina, bano, salon, integral, otro
+- espacio: cocina, bano, salon, comedor, integral, otro
 - tamano: menos10, 10a20, 20a40, mas40
 - estilo: funcional, cuidado, exclusivo
-- urgencia: urgente, medio_plazo, frio
+- urgencia: alta, media, baja
 - presupuesto: numero o rango en euros tal como lo dijo el usuario
 - apertura: null si solo confirma disponibilidad; extrae nombre si lo menciona
 - Si el usuario pregunta algo (nombre, precios, etc.) usa intencion "pregunta" y responde_pregunta false
 - Saludos casuales sin confirmar disponibilidad: intencion "desvio", es_desvio true
 - Usuarios de Madrid/Espana: interpreta coloquialismos, jerga y dialecto peninsular (vale, tio, mola, guay, etc.) como respuesta valida si aportan el dato del estado
-- Extrae el valor semantico aunque venga en lenguaje coloquial ("pa la cocina" -> espacio cocina, "unos 15 mil" -> presupuesto)`;
-
-    const intentos = [
-      { jsonMode: true, temperature: 0.1 },
-      { jsonMode: true, temperature: 0 },
-    ];
+- Extrae el valor semantico aunque venga en lenguaje coloquial`;
 
+    const intentos = [{ jsonMode: true, temperature: 0.1 }, { jsonMode: true, temperature: 0 }];
     for (const opts of intentos) {
-      const contenido = await this.llamarOpenRouter(
-        this.getModelo('clasificador'),
-        system,
-        [{ role: 'user', content: mensaje }],
-        opts,
-      );
-
-      const parsed = this.normalizarClasificacion(
-        this.parsearJson<Partial<ClasificacionResultado>>(contenido) ?? {},
-      );
-
+      const contenido = await this.llamarOpenRouter(this.getModelo('clasificador'), system, [{ role: 'user', content: mensaje }], opts);
+      const parsed = this.normalizarClasificacion(this.parsearJson<Partial<ClasificacionResultado>>(contenido) ?? {});
       if (parsed) return parsed;
-
-      this.logger.warn(
-        `Clasificador JSON invalido (intento, modelo=${this.getModelo('clasificador')}): ${contenido.slice(0, 200)}`,
-      );
+      this.logger.warn(`Clasificador JSON invalido (intento): ${contenido.slice(0, 200)}`);
+    }
+    return { responde_pregunta: false, valor_extraido: null, es_desvio: true, intencion: 'desvio' };
   }
 
-    this.logger.warn('Clasificador agotado reintentos, usando fallback conservador');
-    return {
-      responde_pregunta: false,
-      valor_extraido: null,
-      es_desvio: true,
-      intencion: 'desvio',
-    };
-  }
-
-  /**
-   * Capa 2 — Validador en codigo: valida valor_extraido contra valores permitidos.
-   */
-  private validar(
-    clasificacion: ClasificacionResultado,
-    estadoActual: string,
-  ): ValidacionResultado {
+  private validar(clasificacion: ClasificacionResultado, estadoActual: string): ValidacionResultado {
     const estado = this.leadsService.normalizarEstadoFlujo(estadoActual);
-
-    if (
-      clasificacion.es_desvio ||
-      clasificacion.intencion === 'desvio' ||
-      clasificacion.intencion === 'pregunta' ||
-      clasificacion.intencion === 'insulto' ||
-      clasificacion.intencion === 'despedida'
-    ) {
+    if (clasificacion.es_desvio || clasificacion.intencion === 'desvio' || clasificacion.intencion === 'pregunta' ||
+      clasificacion.intencion === 'insulto' || clasificacion.intencion === 'despedida') {
       return { valido: false, valorNormalizado: null };
     }
-
-    if (estado === 'nuevo') {
-      return { valido: false, valorNormalizado: null };
-    }
-
+    if (estado === 'nuevo') return { valido: false, valorNormalizado: null };
     if (estado === 'apertura') {
-      const valido =
-        clasificacion.responde_pregunta &&
-        clasificacion.intencion === 'respuesta' &&
-        !clasificacion.es_desvio;
-      return { valido, valorNormalizado: clasificacion.valor_extraido };
+      return { valido: clasificacion.responde_pregunta && clasificacion.intencion === 'respuesta' && !clasificacion.es_desvio, valorNormalizado: clasificacion.valor_extraido };
     }
-
     if (estado === 'presupuesto') {
       const valor = clasificacion.valor_extraido?.trim();
-      if (!valor || !this.leadsService.esPresupuestoValido(valor)) {
-        return { valido: false, valorNormalizado: null };
+      if (!valor || !this.leadsService.esPresupuestoValido(valor)) return { valido: false, valorNormalizado: null };
+      return { valido: true, valorNormalizado: valor, viable: this.leadsService.evaluarViabilidad(valor) };
     }
-      const viable = this.leadsService.evaluarViabilidad(valor);
-      return { valido: true, valorNormalizado: valor, viable };
-    }
-
     const valoresPermitidos = this.leadsService.getValoresPermitidos(estado);
     const valor = this.normalizarTexto(clasificacion.valor_extraido ?? '');
-
-    if (!valor) {
-      return { valido: false, valorNormalizado: null };
-    }
-
-    const coincide = valoresPermitidos.some(
-      (v) => v === valor || valor.includes(v) || v.includes(valor),
-    );
-
-    if (!coincide) {
-      return { valido: false, valorNormalizado: null };
-    }
-
-    const valorNormalizado =
-      valoresPermitidos.find(
-        (v) => v === valor || valor.includes(v) || v.includes(valor),
-      ) ?? valor;
-
+    if (!valor) return { valido: false, valorNormalizado: null };
+    const coincide = valoresPermitidos.some((v) => v === valor || valor.includes(v) || v.includes(valor));
+    if (!coincide) return { valido: false, valorNormalizado: null };
+    const valorNormalizado = valoresPermitidos.find((v) => v === valor || valor.includes(v) || v.includes(valor)) ?? valor;
     return { valido: true, valorNormalizado };
   }
 
   private normalizarTexto(valor: string): string {
-    return valor
-      .trim()
-      .toLowerCase()
-      .normalize('NFD')
-      .replace(/\p{Diacritic}/gu, '');
+    return valor.trim().toLowerCase().normalize('NFD').replace(/\p{Diacritic}/gu, '');
   }
 
-  private claveReintento(leadId: number, estado: string): string {
-    return `${leadId}:${estado}`;
-  }
+  private claveReintento(leadId: string, estado: string): string { return `${leadId}:${estado}`; }
 
-  private obtenerReintentos(leadId: number, estado: string): number {
-    const clave = this.claveReintento(leadId, estado);
-    const entry = this.reintentosPorLead.get(clave);
+  private obtenerReintentos(leadId: string, estado: string): number {
+    const entry = this.reintentosPorLead.get(this.claveReintento(leadId, estado));
     return entry?.estado === estado ? entry.count : 0;
   }
 
-  private incrementarReintentos(leadId: number, estado: string): number {
+  private incrementarReintentos(leadId: string, estado: string): number {
     const clave = this.claveReintento(leadId, estado);
     const actual = this.obtenerReintentos(leadId, estado);
     const count = actual + 1;
@@ -380,15 +238,12 @@ Reglas para valor_extraido:
     return count;
   }
 
-  private resetearReintentos(leadId: number, estado: string): void {
+  private resetearReintentos(leadId: string, estado: string): void {
     this.reintentosPorLead.delete(this.claveReintento(leadId, estado));
   }
 
-  /**
-   * Capa 3 — Generador (Sonnet): produce el borrador del mensaje de Luisa.
-   */
   private async generar(
-    lead: Lead,
+    lead: LeadBasico,
     historial: Array<{ role: string; content: string }>,
     mensajeActual: string,
     clasificacion: ClasificacionResultado,
@@ -398,11 +253,7 @@ Reglas para valor_extraido:
     siguienteEstado: string | null,
     forzarApertura = false,
   ): Promise<string> {
-    const systemPrompt = this.leerPromptsSistema();
-    const estadoFlujo = this.leadsService.normalizarEstadoFlujo(
-      lead.estado_actual,
-    );
-
+    const estadoFlujo = this.leadsService.normalizarEstadoFlujo(lead.estado_actual);
     const contextoGeneracion = `
 ## Contexto del lead
 ${this.serializarLead(lead)}
@@ -419,45 +270,30 @@ ${this.serializarLead(lead)}
 
 ## Instrucciones de respuesta
 Eres Luisa de Reformix en Madrid. Sigue el system prompt al pie de la letra.
-Habla espanol de Espana; suena natural y cercana. Adapta el registro al usuario (coloquial si el, formal si el).
+Habla espanol de Espana; calida, simpatica y siempre dispuesta a ayudar, como una asesora de confianza.
+Varia como lo dices en cada turno (no repitas frases calcadas) y no vuelvas a preguntar un dato que el
+usuario ya te haya dado en este mensaje o en el historial; reconocelo con naturalidad y sigue con lo que falte.
 Devuelve SOLO el texto del mensaje a enviar por WhatsApp.
 NO incluyas JSON, etiquetas XML ni bloques de datos extraidos.
 NUNCA digas que eres IA, OpenAI, ChatGPT ni un asistente virtual.
-Si preguntan tu nombre, di que eres Luisa de Reformix.
 
 Si forzar mensaje de apertura es true, envia el mensaje de APERTURA del flujo.
-Si validacion valida es false y reintentos < 2, pide amablemente que aclare su respuesta.
-Si validacion valida es false y reintentos >= 2, repite la pregunta del estado actual de forma directa.
-Si es_desvio es true o intencion es pregunta, responde brevemente como Luisa y redirige al flujo sin avanzar.
+Si validacion valida es false y reintentos < 2, ayudale con calidez dando ejemplos o referencias para que se aclare.
+Si validacion valida es false y reintentos >= 2, vuelve a la pregunta del estado de otra forma, sin sonar borde.
+Si es_desvio es true o intencion es pregunta, atiende su duda con simpatia (concede algo util) y retoma el flujo sin avanzar.
 Si avanzar estado es true, haz la pregunta correspondiente al siguiente estado.
-Si el siguiente estado es fin_viable o fin_no_viable, usa el mensaje de cierre correspondiente.`;
+Si el siguiente estado es fin_viable, cierra con calidez anunciando que ya le preparas el presupuesto.`;
 
-    const messages = [
-      ...historial,
-      { role: 'user', content: mensajeActual },
-    ];
-
-    const contenido = await this.llamarOpenRouter(
-      this.getModelo('generador'),
-      `${systemPrompt}\n${contextoGeneracion}`,
-      messages,
+    const contenido = await this.llamarOpenRouter(this.getModelo('generador'),
+      `${this.systemPromptCache || DEFAULT_SYSTEM_PROMPT}\n${contextoGeneracion}`,
+      [...historial, { role: 'user', content: mensajeActual }],
       { temperature: 0.7 },
     );
-
     return contenido.trim();
   }
 
-  /**
-   * Capa 4 — Reglas (Haiku): corrige el borrador para cumplir identidad y tono de Luisa.
-   */
-  private async aplicarReglas(
-    borrador: string,
-    lead: Lead,
-    estadoFlujo: string,
-    clasificacion: ClasificacionResultado,
-  ): Promise<string> {
-    const reglas = this.leerPromptsReglas();
-
+  private async aplicarReglas(borrador: string, lead: LeadBasico, estadoFlujo: string, clasificacion: ClasificacionResultado): Promise<string> {
+    const reglas = this.reglasPromptCache || DEFAULT_SYSTEM_PROMPT;
     const system = `${reglas}
 
 ## Tu tarea
@@ -470,20 +306,20 @@ Devuelve SOLO el mensaje final listo para enviar, sin explicaciones ni JSON.
 - Intencion del usuario: ${clasificacion.intencion}
 
 ## Reglas de correccion obligatorias
-- Debe sonar como Luisa de Reformix (Madrid), nunca como un asistente generico
-- Espanol de Espana, natural; puede usar coloquialismos suaves (vale, mira, oye) si encaja con el tono del usuario
-- Maximo 2 lineas, un mensaje por turno, sin emojis, sin guiones largos
+- Debe sonar como Luisa de Reformix (Madrid): calida, simpatica y servicial, nunca un asistente generico ni un teleoperador
+- Espanol de Espana, natural; usa coloquialismos y conectores suaves (vale, mira, oye, genial, tranquila, perfecto) cuando encajen
+- Un mensaje por turno, breve (2-3 lineas como mucho); puede llevar algun emoji suave ocasional, sin abusar
+- Varia la redaccion; no dejes frases calcadas ni que repitan literalmente lo que ya se dijo en turnos anteriores
+- No reescribas para quitar la cercania: si el borrador suena frio o robotico, dale calidez en vez de recortarla
 - NUNCA mencionar IA, OpenAI, ChatGPT, modelos de lenguaje ni asistentes virtuales
 - Si preguntan el nombre: "Soy Luisa de Reformix"
+- Quita cualquier JSON o etiqueta tecnica que se haya colado; deja solo el mensaje natural
 - Si el borrador viola alguna regla, reescribelo completamente manteniendo la intencion`;
 
-    const contenido = await this.llamarOpenRouter(
-      this.getModelo('reglas'),
-      system,
+    const contenido = await this.llamarOpenRouter(this.getModelo('reglas'), system,
       [{ role: 'user', content: `Borrador a corregir:\n${borrador}` }],
       { temperature: 0.3 },
     );
-
     return contenido.trim() || borrador;
   }
 
@@ -491,7 +327,7 @@ Devuelve SOLO el mensaje final listo para enviar, sin explicaciones ni JSON.
     return FRASES_IA_PROHIBIDAS.some((regex) => regex.test(texto));
   }
 
-  private mensajeFallback(estadoFlujo: string, lead: Lead): string {
+  private mensajeFallback(estadoFlujo: string, lead: LeadBasico): string {
     const nombre = lead.nombre ? lead.nombre : '';
     const fallbacks: Record<string, string> = {
       nuevo: `Hola${nombre ? ' ' + nombre : ''}, soy Luisa de Reformix; vi que dejaste tus datos en nuestra web y queria ayudarte a preparar tu presupuesto. Tienes unos minutos ahora?`,
@@ -502,91 +338,23 @@ Devuelve SOLO el mensaje final listo para enviar, sin explicaciones ni JSON.
       urgencia: 'Y cuando tienes pensado arrancar, es algo proximo o todavia estas explorando?',
       presupuesto: 'Ultima pregunta; tienes en mente un presupuesto aproximado para la reforma?',
     };
-
-    return (
-      fallbacks[estadoFlujo] ??
-      'Soy Luisa de Reformix; sigamos con tu presupuesto de reforma.'
-    );
+    return fallbacks[estadoFlujo] ?? 'Soy Luisa de Reformix; sigamos con tu presupuesto de reforma.';
   }
 
-  /**
-   * Orquesta las 4 capas: clasificar, validar, generar y aplicar reglas.
-   */
   async llamarClaude(
-    lead: Lead,
+    lead: LeadBasico,
     historial: Array<{ role: string; content: string }>,
     mensajeActual: string,
   ): Promise<ClaudeResponse> {
-    const esAperturaScheduler =
-      historial.length === 0 && mensajeActual.startsWith('APERTURA:');
-
-    if (esAperturaScheduler) {
-      const borrador = await this.generar(
-        lead,
-        historial,
-        mensajeActual,
-        {
-          responde_pregunta: true,
-          valor_extraido: null,
-          es_desvio: false,
-          intencion: 'respuesta',
-        },
-        { valido: true, valorNormalizado: null },
-        0,
-        false,
-        'apertura',
-        true,
-      );
-      const respuesta = await this.aplicarReglas(
-        borrador,
-        lead,
-        'apertura',
-        {
-          responde_pregunta: true,
-          valor_extraido: null,
-          es_desvio: false,
-          intencion: 'respuesta',
-        },
-      );
-      return {
-        respuesta: this.contieneFraseProhibida(respuesta)
-          ? this.mensajeFallback('apertura', lead)
-          : respuesta,
-      };
-    }
-
-    const estadoFlujo = this.leadsService.normalizarEstadoFlujo(
-      lead.estado_actual,
-    );
+    const estadoFlujo = this.leadsService.normalizarEstadoFlujo(lead.estado_actual);
 
     if (estadoFlujo === 'nuevo') {
-      const clasificacion: ClasificacionResultado = {
-        responde_pregunta: false,
-        valor_extraido: null,
-        es_desvio: false,
-        intencion: 'respuesta',
-      };
-      const borrador = await this.generar(
-        lead,
-        historial,
-        mensajeActual,
-        clasificacion,
-        { valido: false, valorNormalizado: null },
-        0,
-        false,
-        null,
-        true,
-      );
-      const respuesta = await this.aplicarReglas(
-        borrador,
-        lead,
-        'nuevo',
-        clasificacion,
-      );
+      const clasificacion: ClasificacionResultado = { responde_pregunta: false, valor_extraido: null, es_desvio: false, intencion: 'respuesta' };
+      const borrador = await this.generar(lead, historial, mensajeActual, clasificacion,
+        { valido: false, valorNormalizado: null }, 0, false, null, true);
+      const respuesta = await this.aplicarReglas(borrador, lead, 'nuevo', clasificacion);
       return {
-        respuesta: this.contieneFraseProhibida(respuesta)
-          ? this.mensajeFallback('nuevo', lead)
-          : respuesta,
+        respuesta: this.contieneFraseProhibida(respuesta) ? this.mensajeFallback('nuevo', lead) : respuesta,
         nuevoEstado: 'apertura',
       };
     }
@@ -597,72 +365,35 @@ Devuelve SOLO el mensaje final listo para enviar, sin explicaciones ni JSON.
     let reintentos = this.obtenerReintentos(lead.id, estadoFlujo);
     let avanzarEstado = false;
     let siguienteEstado: string | null = null;
-    let entidad: Partial<Lead> = {};
+    let entidad: Partial<LeadBasico> = {};
     let viable: boolean | undefined;
 
-    const puedeAvanzar =
-      validacion.valido &&
-      !clasificacion.es_desvio &&
-      clasificacion.intencion === 'respuesta';
+    const puedeAvanzar = validacion.valido && !clasificacion.es_desvio && clasificacion.intencion === 'respuesta';
 
     if (puedeAvanzar) {
       avanzarEstado = true;
       this.resetearReintentos(lead.id, estadoFlujo);
-
       if (validacion.valorNormalizado) {
         const campo = this.leadsService.getCampoParaEstado(estadoFlujo);
         if (campo) {
-          entidad = { [campo]: validacion.valorNormalizado };
-        } else if (
-          estadoFlujo === 'apertura' &&
-          clasificacion.valor_extraido?.trim()
-        ) {
-          entidad = { nombre: clasificacion.valor_extraido.trim() };
+          (entidad as any)[campo] = validacion.valorNormalizado;
+        } else if (estadoFlujo === 'apertura' && clasificacion.valor_extraido?.trim()) {
+          entidad.nombre = clasificacion.valor_extraido.trim();
         }
       }
-
-      if (estadoFlujo === 'presupuesto') {
-        viable = validacion.viable;
-        siguienteEstado = this.leadsService.getSiguienteEstado(
-          estadoFlujo,
-          viable,
-        );
-      } else {
       siguienteEstado = this.leadsService.getSiguienteEstado(estadoFlujo);
-      }
-    } else if (
-      !validacion.valido &&
-      clasificacion.responde_pregunta &&
-      !clasificacion.es_desvio
-    ) {
+      // `viable` es solo informativo (siempre true): no cambia la ruta. Luisa nunca rechaza.
+      if (estadoFlujo === 'presupuesto') viable = validacion.viable;
+    } else if (!validacion.valido && clasificacion.responde_pregunta && !clasificacion.es_desvio) {
       reintentos = this.incrementarReintentos(lead.id, estadoFlujo);
-      if (reintentos > 2) {
-        reintentos = 2;
-      }
+      if (reintentos > 2) reintentos = 2;
     }
 
-    const borrador = await this.generar(
-      lead,
-      historial,
-      mensajeActual,
-      clasificacion,
-      validacion,
-      reintentos,
-      avanzarEstado,
-      siguienteEstado,
-    );
-
-    let respuesta = await this.aplicarReglas(
-      borrador,
-      lead,
-      estadoFlujo,
-      clasificacion,
-    );
+    const borrador = await this.generar(lead, historial, mensajeActual, clasificacion, validacion, reintentos, avanzarEstado, siguienteEstado);
+    let respuesta = await this.aplicarReglas(borrador, lead, estadoFlujo, clasificacion);
 
     if (this.contieneFraseProhibida(respuesta)) {
-      this.logger.warn(
-        `Respuesta final viola reglas de identidad, usando fallback para estado=${estadoFlujo}`,
-      );
+      this.logger.warn(`Respuesta final viola reglas, usando fallback para estado=${estadoFlujo}`);
       respuesta = this.mensajeFallback(estadoFlujo, lead);
     }
 

mvp/Whatsapp-bot/src/conversacion/conversacion.entity.ts

@@ -1,33 +0,0 @@
-import {
-  Entity,
-  PrimaryGeneratedColumn,
-  Column,
-  CreateDateColumn,
-  ManyToOne,
-  JoinColumn,
-} from 'typeorm';
-import { Lead } from '../leads/lead.entity';
-
-export type RolMensaje = 'user' | 'assistant' | 'system';
-
-@Entity('conversacion')
-export class Conversacion {
-  @PrimaryGeneratedColumn()
-  id: number;
-
-  @Column({ type: 'integer' })
-  lead_id: number;
-
-  @ManyToOne(() => Lead, { onDelete: 'CASCADE' })
-  @JoinColumn({ name: 'lead_id' })
-  lead: Lead;
-
-  @Column({ type: 'text' })
-  rol: RolMensaje;
-
-  @Column({ type: 'text' })
-  mensaje: string;
-
-  @CreateDateColumn()
-  created_at: Date;
-}

mvp/Whatsapp-bot/src/conversacion/conversacion.module.ts

@@ -1,10 +1,7 @@
 import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-import { Conversacion } from './conversacion.entity';
 import { ConversacionService } from './conversacion.service';
 
 @Module({
-  imports: [TypeOrmModule.forFeature([Conversacion])],
   providers: [ConversacionService],
   exports: [ConversacionService],
 })

mvp/Whatsapp-bot/src/conversacion/conversacion.service.ts

@@ -1,41 +1,26 @@
-import { Injectable } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository } from 'typeorm';
-import { Conversacion, RolMensaje } from './conversacion.entity';
+import { Injectable, Logger } from '@nestjs/common';
+import { ApiClient } from '../api/api-client.service';
 
 @Injectable()
 export class ConversacionService {
-  constructor(
-    @InjectRepository(Conversacion)
-    private readonly convRepo: Repository<Conversacion>,
-  ) {}
+  private readonly logger = new Logger(ConversacionService.name);
+
+  constructor(private readonly api: ApiClient) {}
 
   async guardarMensaje(
-    leadId: number,
-    rol: RolMensaje,
+    leadId: string,
+    rol: 'user' | 'assistant' | 'system',
     mensaje: string,
-  ): Promise<Conversacion> {
-    const entry = this.convRepo.create({ lead_id: leadId, rol, mensaje });
-    return this.convRepo.save(entry);
+    options?: { estadoWa?: string; botStep?: string },
+  ): Promise<boolean> {
+    const ok = await this.api.guardarConversacion(leadId, rol, mensaje, options);
+    if (!ok) {
+      this.logger.warn(`No se pudo guardar mensaje ${rol} para lead ${leadId}`);
+    }
+    return ok;
   }
 
-  async obtenerHistorial(leadId: number): Promise<Conversacion[]> {
-    return this.convRepo.find({
-      where: { lead_id: leadId },
-      order: { created_at: 'ASC' },
-    });
-  }
-
-  /**
-   * Devuelve el historial en formato OpenAI/Claude messages array.
-   */
-  async obtenerHistorialComoMessages(
-    leadId: number,
-  ): Promise<Array<{ role: string; content: string }>> {
-    const historial = await this.obtenerHistorial(leadId);
-    return historial.map((h) => ({
-      role: h.rol,
-      content: h.mensaje,
-    }));
+  async obtenerHistorialComoMessages(leadId: string): Promise<Array<{ role: string; content: string }>> {
+    return this.api.obtenerHistorial(leadId);
   }
 }

mvp/Whatsapp-bot/src/leads/lead.entity.ts

@@ -1,68 +0,0 @@
-import {
-  Entity,
-  PrimaryGeneratedColumn,
-  Column,
-  CreateDateColumn,
-  UpdateDateColumn,
-} from 'typeorm';
-
-export type EstadoLead =
-  | 'nuevo'
-  | 'en_proceso'
-  | 'apertura'
-  | 'espacio'
-  | 'tamano'
-  | 'estilo'
-  | 'urgencia'
-  | 'presupuesto'
-  | 'fin_viable'
-  | 'fin_no_viable'
-  | 'recopilando_datos'
-  | 'completado'
-  | 'no_viable'
-  | 'perdido';
-
-@Entity('leads')
-export class Lead {
-  @PrimaryGeneratedColumn()
-  id: number;
-
-  @Column({ type: 'text', nullable: true })
-  nombre: string;
-
-  @Column({ type: 'text', nullable: true })
-  telefono: string;
-
-  @Column({ type: 'text', nullable: true })
-  email: string;
-
-  @Column({ type: 'text', nullable: true })
-  espacio: string;
-
-  @Column({ type: 'text', nullable: true })
-  rango_m2: string;
-
-  @Column({ type: 'text', nullable: true })
-  estilo: string;
-
-  @Column({ type: 'text', nullable: true })
-  urgencia: string;
-
-  @Column({ type: 'text', nullable: true })
-  presupuesto_declarado: string;
-
-  @Column({ type: 'boolean', nullable: true })
-  viable: boolean;
-
-  @Column({ type: 'text', default: 'nuevo' })
-  estado_actual: EstadoLead;
-
-  @Column({ type: 'text', nullable: true })
-  url_presupuesto: string;
-
-  @CreateDateColumn()
-  created_at: Date;
-
-  @UpdateDateColumn()
-  updated_at: Date;
-}

mvp/Whatsapp-bot/src/leads/leads.module.ts

@@ -1,10 +1,7 @@
 import { Module } from '@nestjs/common';
-import { TypeOrmModule } from '@nestjs/typeorm';
-import { Lead } from './lead.entity';
 import { LeadsService } from './leads.service';
 
 @Module({
-  imports: [TypeOrmModule.forFeature([Lead])],
   providers: [LeadsService],
   exports: [LeadsService],
 })

mvp/Whatsapp-bot/src/leads/leads.service.ts

@@ -1,7 +1,5 @@
 import { Injectable, Logger } from '@nestjs/common';
-import { InjectRepository } from '@nestjs/typeorm';
-import { Repository, LessThan } from 'typeorm';
-import { Lead, EstadoLead } from './lead.entity';
+import { ApiClient } from '../api/api-client.service';
 
 const SECUENCIA_ESTADOS = [
   'nuevo',
@@ -14,200 +12,85 @@ const SECUENCIA_ESTADOS = [
 ] as const;
 
 const VALORES_POR_ESTADO: Record<string, string[]> = {
-  espacio: ['cocina', 'bano', 'salon', 'integral', 'otro'],
+  espacio: ['cocina', 'bano', 'salon', 'comedor', 'integral', 'otro'],
   tamano: ['menos10', '10a20', '20a40', 'mas40'],
   estilo: ['funcional', 'cuidado', 'exclusivo'],
-  urgencia: ['urgente', 'medio_plazo', 'frio'],
+  urgencia: ['alta', 'media', 'baja'],
 };
 
-const CAMPO_POR_ESTADO: Record<string, keyof Lead> = {
+const CAMPO_POR_ESTADO_NOMBRE: Record<string, string> = {
   espacio: 'espacio',
-  tamano: 'rango_m2',
+  tamano: 'rangoM2',
   estilo: 'estilo',
   urgencia: 'urgencia',
-  presupuesto: 'presupuesto_declarado',
+  presupuesto: 'presupuestoDeclarado',
 };
 
 @Injectable()
 export class LeadsService {
   private readonly logger = new Logger(LeadsService.name);
 
-  constructor(
-    @InjectRepository(Lead)
-    private readonly leadRepo: Repository<Lead>,
-  ) {}
+  constructor(private readonly api: ApiClient) {}
 
-  /**
-   * Normaliza estados legacy del scheduler/DB al flujo de cualificacion.
-   */
   normalizarEstadoFlujo(estado: string): string {
-    if (estado === 'en_proceso' || estado === 'recopilando_datos') {
-      return 'apertura';
-    }
+    if (estado === 'en_proceso' || estado === 'recopilando_datos') return 'apertura';
     return estado;
   }
 
-  getSiguienteEstado(estadoActual: string, viable?: boolean): string {
+  getSiguienteEstado(estadoActual: string): string {
     const estado = this.normalizarEstadoFlujo(estadoActual);
-
-    if (estado === 'presupuesto') {
-      return viable === false ? 'fin_no_viable' : 'fin_viable';
-    }
-
-    const idx = SECUENCIA_ESTADOS.indexOf(
-      estado as (typeof SECUENCIA_ESTADOS)[number],
-    );
-    if (idx === -1 || idx >= SECUENCIA_ESTADOS.length - 1) {
-      return estado;
-    }
+    // Tras el presupuesto el lead SIEMPRE cierra como viable: Luisa nunca rechaza a nadie. La
+    // rentabilidad del lead la valora el reformista en el panel con su baremo interno (los agentes
+    // no usan esa información para decidir nada todavía).
+    if (estado === 'presupuesto') return 'fin_viable';
+    const idx = SECUENCIA_ESTADOS.indexOf(estado as typeof SECUENCIA_ESTADOS[number]);
+    if (idx === -1 || idx >= SECUENCIA_ESTADOS.length - 1) return estado;
     return SECUENCIA_ESTADOS[idx + 1];
   }
 
   getValoresPermitidos(estado: string): string[] {
-    const estadoNorm = this.normalizarEstadoFlujo(estado);
-    return VALORES_POR_ESTADO[estadoNorm] ?? [];
+    return VALORES_POR_ESTADO[this.normalizarEstadoFlujo(estado)] ?? [];
   }
 
-  getCampoParaEstado(estado: string): keyof Lead | null {
-    const estadoNorm = this.normalizarEstadoFlujo(estado);
-    return CAMPO_POR_ESTADO[estadoNorm] ?? null;
+  getCampoParaEstado(estado: string): string | null {
+    return CAMPO_POR_ESTADO_NOMBRE[this.normalizarEstadoFlujo(estado)] ?? null;
   }
 
   esPresupuestoValido(valor: string): boolean {
-    const normalizado = valor.trim().toLowerCase();
-    if (!normalizado) return false;
-    return /\d/.test(normalizado);
+    return /\d/.test(valor.trim().toLowerCase());
   }
 
-  evaluarViabilidad(presupuesto: string): boolean {
-    const numeros = presupuesto.match(/\d[\d.]*/g);
-    if (!numeros?.length) return true;
-
-    const valor = parseInt(numeros[0].replace(/\./g, ''), 10);
-    if (Number.isNaN(valor)) return true;
-
-    return valor >= 5000;
+  // Luisa ya no decide la viabilidad del lead: nunca rechaza por presupuesto. La rentabilidad la
+  // valora el reformista en el panel (baremo interno, fase aparte). Se mantiene para informar el
+  // campo `viable`, que de momento siempre es true.
+  evaluarViabilidad(_presupuesto: string): boolean {
+    return true;
   }
 
-  /**
-   * Busca un lead por número de teléfono.
-   * Si no existe, lo crea con estado 'nuevo'.
-   */
-  async findOrCreate(telefono: string): Promise<Lead> {
-    let lead = await this.leadRepo.findOne({ where: { telefono } });
-    if (!lead) {
-      lead = this.leadRepo.create({ telefono, estado_actual: 'nuevo' });
-      lead = await this.leadRepo.save(lead);
-      this.logger.log(`Lead nuevo creado: telefono=${telefono}, id=${lead.id}`);
-    }
-    return lead;
-  }
-
-  async findByTelefono(telefono: string): Promise<Lead | null> {
-    return this.leadRepo.findOne({ where: { telefono } });
-  }
-
-  async findById(id: number): Promise<Lead | null> {
-    return this.leadRepo.findOne({ where: { id } });
-  }
-
-  async findByEstado(estado: EstadoLead): Promise<Lead[]> {
-    return this.leadRepo.find({ where: { estado_actual: estado } });
-  }
-
-  async updateEstado(lead: Lead, estado: EstadoLead | string): Promise<Lead> {
-    await this.leadRepo.update(lead.id, {
-      estado_actual: estado as EstadoLead,
-    });
-    this.logger.log(`Lead id=${lead.id} estado_actual=${estado}`);
-    return this.leadRepo.findOne({ where: { id: lead.id } });
-  }
-
-  /**
-   * Actualiza campos del lead según el estado actual del flujo.
-   * Solo actualiza los campos que se pasan en el partial.
-   */
-  async updateDatos(leadId: number, datos: Partial<Lead>): Promise<Lead> {
-    const campos = Object.keys(datos).filter(
-      (k) => datos[k as keyof Lead] !== undefined,
-    );
-    if (campos.length === 0) {
-      return this.leadRepo.findOne({ where: { id: leadId } });
-    }
-
-    await this.leadRepo.update(leadId, datos);
-    this.logger.log(
-      `Lead id=${leadId} datos guardados: ${JSON.stringify(datos)}`,
-    );
-    return this.leadRepo.findOne({ where: { id: leadId } });
-  }
-
-  async marcarViable(lead: Lead, viable: boolean): Promise<Lead> {
-    const estado = viable ? 'completado' : 'no_viable';
-    await this.leadRepo.update(lead.id, { viable, estado_actual: estado });
-    this.logger.log(`Lead id=${lead.id} viable=${viable}, estado=${estado}`);
-    return this.leadRepo.findOne({ where: { id: lead.id } });
-  }
-
-  /**
-   * Persiste datos del lead y cambio de estado en una sola operacion.
-   */
   async persistirTurno(
-    leadId: number,
-    datos: Partial<Lead>,
+    leadId: string,
+    datos: Record<string, unknown>,
     options?: { nuevoEstado?: string; viable?: boolean },
-  ): Promise<Lead> {
-    const patch: Partial<Lead> = { ...datos };
+  ): Promise<boolean> {
+    const perfil: Record<string, unknown> = { ...datos };
 
     if (options?.nuevoEstado === 'fin_viable') {
-      patch.viable = true;
-      patch.estado_actual = 'completado';
+      perfil.viable = true;
+      perfil.botStep = 'presupuesto';
     } else if (options?.nuevoEstado === 'fin_no_viable') {
-      patch.viable = false;
-      patch.estado_actual = 'no_viable';
+      perfil.viable = false;
+      perfil.botStep = 'presupuesto';
     } else if (options?.nuevoEstado) {
-      patch.estado_actual = options.nuevoEstado as EstadoLead;
-    } else if (options?.viable !== undefined && options?.viable !== null) {
-      patch.viable = options.viable;
-      patch.estado_actual = options.viable ? 'completado' : 'no_viable';
+      perfil.botStep = options.nuevoEstado;
+    } else if (options?.viable !== undefined) {
+      perfil.viable = options.viable;
     }
 
-    const campos = Object.keys(patch).filter(
-      (k) => patch[k as keyof Lead] !== undefined,
-    );
-    if (campos.length === 0) {
-      return this.leadRepo.findOne({ where: { id: leadId } });
-    }
+    const campos = Object.keys(perfil).filter((k) => perfil[k] !== undefined);
+    if (campos.length === 0) return true;
 
-    await this.leadRepo.update(leadId, patch);
-    this.logger.log(
-      `Lead id=${leadId} persistido: ${JSON.stringify(patch)}`,
-    );
-    return this.leadRepo.findOne({ where: { id: leadId } });
-  }
-
-  /**
-   * Marca como perdido cualquier lead en_proceso sin actividad en más de 48h.
-   */
-  async marcarLeadsPerdidos(): Promise<void> {
-    const hace48h = new Date(Date.now() - 48 * 60 * 60 * 1000);
-    const leadsSinActividad = await this.leadRepo.find({
-      where: {
-        estado_actual: 'en_proceso',
-        updated_at: LessThan(hace48h),
-      },
-    });
-
-    for (const lead of leadsSinActividad) {
-      lead.estado_actual = 'perdido';
-      await this.leadRepo.save(lead);
-      this.logger.warn(
-        `Lead id=${lead.id} marcado como perdido por inactividad > 48h`,
-      );
-    }
-  }
-
-  async save(lead: Lead): Promise<Lead> {
-    return this.leadRepo.save(lead);
+    const ok = await this.api.actualizarPerfil(leadId, perfil);
+    this.logger.log(`Lead ${leadId} persistido via API: ${JSON.stringify(perfil)} → ${ok ? 'ok' : 'fallo'}`);
+    return ok;
   }
 }

mvp/Whatsapp-bot/src/media/media.service.ts

@@ -1,268 +1,99 @@
-import { Injectable, Logger } from "@nestjs/common";
-import axios from "axios";
-import { EstadoLead } from "../leads/lead.entity";
+import { Injectable, Logger } from '@nestjs/common';
+import axios from 'axios';
 
 @Injectable()
 export class MediaService {
   private readonly logger = new Logger(MediaService.name);
-
-  private readonly OPENROUTER_URL =
-    "https://openrouter.ai/api/v1/chat/completions";
+  private readonly OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions';
 
   private get headers() {
     return {
       Authorization: `Bearer ${process.env.OPENROUTER_API_KEY}`,
-      "Content-Type": "application/json",
-      "HTTP-Referer": "https://reformix.es",
-      "X-Title": "Reformix Luisa Bot",
+      'Content-Type': 'application/json',
+      'HTTP-Referer': 'https://reformix.es',
+      'X-Title': 'Reformix Luisa Bot',
     };
   }
 
   private getModeloTranscripcion(): string {
-    return (
-      process.env.MODEL_TRANSCRIPCION || "google/gemini-2.5-flash"
-    );
+    return process.env.MODEL_TRANSCRIPCION || 'google/gemini-2.5-flash';
   }
 
-  /**
-   * Convierte mimetype de WhatsApp al formato que espera OpenRouter input_audio.
-   */
   mimeToAudioFormat(mimeType: string): string {
-    const base = mimeType.toLowerCase().split(";")[0].trim();
-    const map: Record<string, string> = {
-      "audio/ogg": "ogg",
-      "audio/opus": "ogg",
-      "audio/mpeg": "mp3",
-      "audio/mp3": "mp3",
-      "audio/mp4": "m4a",
-      "audio/aac": "aac",
-      "audio/wav": "wav",
-      "audio/webm": "webm",
-      "audio/flac": "flac",
-    };
-    return map[base] ?? "ogg";
+    const base = mimeType.toLowerCase().split(';')[0].trim();
+    const map: Record<string, string> = { 'audio/ogg': 'ogg', 'audio/opus': 'ogg', 'audio/mpeg': 'mp3', 'audio/mp3': 'mp3', 'audio/mp4': 'm4a', 'audio/aac': 'aac', 'audio/wav': 'wav', 'audio/webm': 'webm', 'audio/flac': 'flac' };
+    return map[base] ?? 'ogg';
   }
 
-  /**
-   * Elimina encabezados y formato que el modelo pueda añadir a la transcripcion.
-   */
   limpiarTranscripcion(texto: string): string {
-    return texto
-      .replace(/^#+\s*transcripci[oó]n\s*:?\s*\n?/gim, "")
-      .replace(/^\*\*transcripci[oó]n\*\*\s*:?\s*\n?/gim, "")
-      .replace(/^transcripci[oó]n\s*:?\s*\n?/gim, "")
-      .replace(/^```[\s\S]*?\n/g, "")
-      .replace(/\n```$/g, "")
-      .replace(/^["']|["']$/g, "")
-      .trim();
+    return texto.replace(/^#+\s*transcripci[oó]n\s*:?\s*\n?/gim, '')
+      .replace(/^\*\*transcripci[oó]n\*\*\s*:?\s*\n?/gim, '')
+      .replace(/^transcripci[oó]n\s*:?\s*\n?/gim, '')
+      .replace(/^```[\s\S]*?\n/g, '').replace(/\n```$/g, '')
+      .replace(/^["']|["']$/g, '').trim();
   }
 
   private detectarFormatoPorMagicBytes(buffer: Buffer): string | null {
-    if (
-      buffer.length >= 4 &&
-      buffer.subarray(0, 4).toString("ascii") === "OggS"
-    ) {
-      return "ogg";
-    }
-    if (
-      buffer.length >= 3 &&
-      buffer[0] === 0xff &&
-      (buffer[1] & 0xe0) === 0xe0
-    ) {
-      return "mp3";
-    }
-    if (
-      buffer.length >= 12 &&
-      buffer.subarray(0, 4).toString("ascii") === "RIFF" &&
-      buffer.subarray(8, 12).toString("ascii") === "WAVE"
-    ) {
-      return "wav";
-    }
+    if (buffer.length >= 4 && buffer.subarray(0, 4).toString('ascii') === 'OggS') return 'ogg';
+    if (buffer.length >= 3 && buffer[0] === 0xff && (buffer[1] & 0xe0) === 0xe0) return 'mp3';
+    if (buffer.length >= 12 && buffer.subarray(0, 4).toString('ascii') === 'RIFF' && buffer.subarray(8, 12).toString('ascii') === 'WAVE') return 'wav';
     return null;
   }
 
-  /**
-   * Transcribe un audio via OpenRouter input_audio (Gemini por defecto).
-   * Claude no soporta audio en OpenRouter; Luisa sigue usando Claude en el resto del pipeline.
-   */
-  async transcribirAudio(
-    audioBuffer: Buffer,
-    mimeType = "audio/ogg; codecs=opus",
-  ): Promise<string> {
-    const FALLBACK =
-      "No te he oido bien, me lo repites?";
-
+  async transcribirAudio(audioBuffer: Buffer, mimeType = 'audio/ogg; codecs=opus'): Promise<string> {
+    const FALLBACK = 'No te he oido bien, me lo repites?';
     const formatFromMime = this.mimeToAudioFormat(mimeType);
     const formatFromMagic = this.detectarFormatoPorMagicBytes(audioBuffer);
     const format = formatFromMagic ?? formatFromMime;
-    const base64Audio = audioBuffer.toString("base64");
+    const base64Audio = audioBuffer.toString('base64');
     const model = this.getModeloTranscripcion();
 
-    this.logger.log(
-      `[AUDIO 2/4] MediaService.transcribirAudio — buffer=${audioBuffer.length} bytes, mime=${mimeType}, format=${format}, magic=${formatFromMagic ?? "no detectado"}, base64=${base64Audio.length} chars, modelo=${model}`,
-    );
+    if (audioBuffer.length < 100) return FALLBACK;
 
-    if (audioBuffer.length < 100) {
-      this.logger.warn(
-        `[AUDIO 2/4] Buffer demasiado pequeno (${audioBuffer.length} bytes), abortando transcripcion`,
-      );
-      return FALLBACK;
-    }
-
-    const systemPrompt =
-      "Eres un transcriptor de voz para usuarios de Madrid y Espana. " +
-      "Transcribe en espanol peninsular tal como se habla, conservando coloquialismos, " +
-      "muletillas y jerga (vale, tio, guay, mola, etc.) sin corregir ni formalizar. " +
-      "Responde unicamente con las palabras dichas, sin titulos, markdown, comillas ni explicaciones.";
-
-    const userPrompt =
-      "Transcribe exactamente lo que dice la persona en este audio. " +
-      "Es espanol de Espana, posiblemente con tono coloquial madrileño. " +
-      "Devuelve solo las palabras habladas, tal cual, nada mas.";
+    const systemPrompt = 'Eres un transcriptor de voz para usuarios de Madrid y Espana. Transcribe en espanol peninsular tal como se habla, conservando coloquialismos, muletillas y jerga (vale, tio, guay, mola, etc.) sin corregir ni formalizar. Responde unicamente con las palabras dichas, sin titulos, markdown, comillas ni explicaciones.';
+    const userPrompt = 'Transcribe exactamente lo que dice la persona en este audio. Es espanol de Espana, posiblemente con tono coloquial madrileño. Devuelve solo las palabras habladas, tal cual, nada mas.';
 
     try {
-      const payload = {
+      const response = await axios.post(this.OPENROUTER_URL, {
         model,
         messages: [
-          { role: "system", content: systemPrompt },
-          {
-            role: "user",
-            content: [
-              { type: "text", text: userPrompt },
-              {
-                type: "input_audio",
-                input_audio: {
-                  data: base64Audio,
-                  format,
-                },
-              },
+          { role: 'system', content: systemPrompt },
+          { role: 'user', content: [{ type: 'text', text: userPrompt }, { type: 'input_audio', input_audio: { data: base64Audio, format } }] },
         ],
-          },
-        ],
-        max_tokens: 512,
-        temperature: 0,
-      };
-
-      this.logger.debug(
-        `[AUDIO 3/4] Enviando a OpenRouter — endpoint=${this.OPENROUTER_URL}, content_type=input_audio, format=${format}`,
-      );
-
-      const response = await axios.post(this.OPENROUTER_URL, payload, {
-        headers: this.headers,
-      });
-
-      const raw: string =
-        response.data.choices?.[0]?.message?.content?.trim() ?? "";
-      const modeloUsado = response.data.model ?? model;
-
-      this.logger.log(
-        `[AUDIO 3/4] Respuesta OpenRouter — modelo=${modeloUsado}, raw_length=${raw.length}, raw_preview="${raw.slice(0, 120).replace(/\n/g, "\\n")}"`,
-      );
-
-      if (!raw) {
-        this.logger.warn(
-          "[AUDIO 4/4] Modelo devolvio respuesta vacia para el audio",
-        );
-        return FALLBACK;
-      }
-
-      const transcripcion = this.limpiarTranscripcion(raw);
-
-      this.logger.log(
-        `[AUDIO 4/4] Transcripcion final — length=${transcripcion.length}, texto="${transcripcion.slice(0, 200).replace(/\n/g, "\\n")}"`,
-      );
-
-      if (!transcripcion) {
-        this.logger.warn(
-          "[AUDIO 4/4] Transcripcion vacia tras limpieza, usando fallback",
-        );
-        return FALLBACK;
-      }
-
-      return transcripcion;
-    } catch (error) {
-      this.logger.error(
-        `[AUDIO 3/4] Error transcribiendo audio: ${error.message}`,
-        error.response?.data,
-      );
+        max_tokens: 512, temperature: 0,
+      }, { headers: this.headers });
+      const raw: string = response.data.choices?.[0]?.message?.content?.trim() ?? '';
+      if (!raw) return FALLBACK;
+      return this.limpiarTranscripcion(raw) || FALLBACK;
+    } catch (error: any) {
+      this.logger.error(`Error transcribiendo audio: ${error.message}`);
       return FALLBACK;
     }
   }
 
-  /**
-   * Infiere informacion de una imagen segun el estado actual del lead.
-   */
-  async inferirImagen(
-    imagenBuffer: Buffer,
-    mimeType = "image/jpeg",
-    estadoActual: EstadoLead = "en_proceso",
-  ): Promise<string> {
-    const FALLBACK =
-      "Recibi tu imagen pero no pude analizarla bien. Puedes describirme lo que muestra?";
-
+  async inferirImagen(imagenBuffer: Buffer, mimeType = 'image/jpeg', estadoActual = 'en_proceso'): Promise<string> {
+    const FALLBACK = 'Recibi tu imagen pero no pude analizarla bien. Puedes describirme lo que muestra?';
     const promptPorEstado: Record<string, string> = {
-      nuevo:
-        "Describe brevemente que tipo de espacio se ve en esta imagen y sus caracteristicas principales.",
-      en_proceso:
-        "Describe el espacio que aparece en la imagen: tipo de habitacion, materiales, estado actual, tamano aproximado.",
-      recopilando_datos:
-        "Analiza esta imagen de un espacio para reformar. Indica: tipo de espacio, metros cuadrados aproximados, materiales visibles, estilo actual, estado de conservacion.",
-      completado:
-        "Describe lo que ves en esta imagen relacionado con reformas o diseno de interiores.",
-      no_viable: "Describe brevemente que muestra esta imagen.",
-      perdido: "Describe brevemente que muestra esta imagen.",
+      nuevo: 'Describe brevemente que tipo de espacio se ve en esta imagen y sus caracteristicas principales.',
+      en_proceso: 'Describe el espacio que aparece en la imagen: tipo de habitacion, materiales, estado actual, tamano aproximado.',
+      recopilando_datos: 'Analiza esta imagen de un espacio para reformar. Indica: tipo de espacio, metros cuadrados aproximados, materiales visibles, estilo actual, estado de conservacion.',
+      completado: 'Describe lo que ves en esta imagen relacionado con reformas o diseno de interiores.',
+      no_viable: 'Describe brevemente que muestra esta imagen.',
+      perdido: 'Describe brevemente que muestra esta imagen.',
     };
-
-    const promptDeVision =
-      promptPorEstado[estadoActual] ||
-      "Describe que ves en esta imagen en el contexto de una reforma de hogar.";
+    const promptDeVision = promptPorEstado[estadoActual] || 'Describe que ves en esta imagen en el contexto de una reforma de hogar.';
 
     try {
-      const base64Imagen = imagenBuffer.toString("base64");
-
-      const response = await axios.post(
-        this.OPENROUTER_URL,
-        {
-          model:
-            process.env.MODEL_GENERADOR ||
-            process.env.MODEL ||
-            "anthropic/claude-sonnet-4-5",
-          messages: [
-            {
-              role: "user",
-              content: [
-                { type: "text", text: promptDeVision },
-                {
-                  type: "image_url",
-                  image_url: {
-                    url: `data:${mimeType};base64,${base64Imagen}`,
-                  },
-                },
-              ],
-            },
-          ],
+      const base64Imagen = imagenBuffer.toString('base64');
+      const response = await axios.post(this.OPENROUTER_URL, {
+        model: process.env.MODEL_GENERADOR || process.env.MODEL || 'anthropic/claude-sonnet-4-5',
+        messages: [{ role: 'user', content: [{ type: 'text', text: promptDeVision }, { type: 'image_url', image_url: { url: `data:${mimeType};base64,${base64Imagen}` } }] }],
         max_tokens: 512,
-        },
-        { headers: this.headers },
-      );
-
-      const inferencia: string =
-        response.data.choices?.[0]?.message?.content?.trim();
-
-      if (!inferencia) {
-        this.logger.warn("Claude devolvio respuesta vacia para la imagen");
-        return FALLBACK;
-      }
-
-      this.logger.log(
-        `Imagen inferida correctamente (${inferencia.length} chars)`,
-      );
-      return inferencia;
-    } catch (error) {
-      this.logger.error(
-        `Error analizando imagen: ${error.message}`,
-        error.response?.data,
-      );
+      }, { headers: this.headers });
+      const inferencia: string = response.data.choices?.[0]?.message?.content?.trim();
+      return inferencia || FALLBACK;
+    } catch (error: any) {
+      this.logger.error(`Error analizando imagen: ${error.message}`);
       return FALLBACK;
     }
   }

mvp/Whatsapp-bot/src/scheduler/scheduler.module.ts

@@ -1,12 +0,0 @@
-import { Module } from '@nestjs/common';
-import { SchedulerService } from './scheduler.service';
-import { LeadsModule } from '../leads/leads.module';
-import { ConversacionModule } from '../conversacion/conversacion.module';
-import { WhatsappModule } from '../whatsapp/whatsapp.module';
-import { ClaudeModule } from '../claude/claude.module';
-
-@Module({
-  imports: [LeadsModule, ConversacionModule, WhatsappModule, ClaudeModule],
-  providers: [SchedulerService],
-})
-export class SchedulerModule {}

mvp/Whatsapp-bot/src/scheduler/scheduler.service.ts

@@ -1,86 +0,0 @@
-import { Injectable, Logger } from '@nestjs/common';
-import { Cron, CronExpression } from '@nestjs/schedule';
-import { LeadsService } from '../leads/leads.service';
-import { ConversacionService } from '../conversacion/conversacion.service';
-import { WhatsappService } from '../whatsapp/whatsapp.service';
-import { ClaudeService } from '../claude/claude.service';
-
-@Injectable()
-export class SchedulerService {
-  private readonly logger = new Logger(SchedulerService.name);
-
-  constructor(
-    private readonly leadsService: LeadsService,
-    private readonly conversacionService: ConversacionService,
-    private readonly whatsappService: WhatsappService,
-    private readonly claudeService: ClaudeService,
-  ) {}
-
-  /**
-   * Cada 5 minutos:
-   * 1. Busca leads con estado_actual = 'nuevo'
-   * 2. Los marca como 'en_proceso'
-   * 3. Les envía el mensaje de APERTURA de Luisa
-   *
-   * También marca como perdidos los leads en_proceso sin actividad > 48h.
-   */
-  @Cron(CronExpression.EVERY_5_MINUTES)
-  async procesarLeadsNuevos(): Promise<void> {
-    this.logger.log('[Scheduler] Buscando leads nuevos...');
-
-    // Primero limpiar leads inactivos
-    await this.leadsService.marcarLeadsPerdidos();
-
-    // Obtener leads nuevos
-    const leadsNuevos = await this.leadsService.findByEstado('nuevo');
-
-    if (leadsNuevos.length === 0) {
-      this.logger.log('[Scheduler] No hay leads nuevos.');
-      return;
-    }
-
-    this.logger.log(
-      `[Scheduler] Procesando ${leadsNuevos.length} lead(s) nuevo(s).`,
-    );
-
-    for (const lead of leadsNuevos) {
-      try {
-        // Marcar como en_proceso antes de hacer nada
-        await this.leadsService.updateEstado(lead, 'en_proceso');
-        this.logger.log(
-          `[Scheduler] Lead id=${lead.id} marcado como en_proceso.`,
-        );
-
-        // Generar mensaje de apertura con Claude usando contexto mínimo
-        const historialVacio: Array<{ role: string; content: string }> = [];
-        const mensajeDeApertura =
-          'APERTURA: Este es el primer mensaje. Preséntate y comienza el flujo de cualificación.';
-
-        const { respuesta } = await this.claudeService.llamarClaude(
-          lead,
-          historialVacio,
-          mensajeDeApertura,
-        );
-
-        // Guardar el mensaje de apertura en historial (como assistant)
-        await this.conversacionService.guardarMensaje(
-          lead.id,
-          'assistant',
-          respuesta,
-        );
-
-        // Enviar por WhatsApp
-        await this.whatsappService.enviarApertura(lead.telefono, respuesta);
-
-        this.logger.log(
-          `[Scheduler] Apertura enviada a lead id=${lead.id} (${lead.telefono}).`,
-        );
-      } catch (error) {
-        this.logger.error(
-          `[Scheduler] Error procesando lead id=${lead.id}: ${error.message}`,
-          error.stack,
-        );
-      }
-    }
-  }
-}

mvp/Whatsapp-bot/src/webhook/webhook-listener.ts

@@ -0,0 +1,226 @@
+import { Injectable, Logger, OnApplicationBootstrap } from '@nestjs/common';
+import * as http from 'http';
+import * as crypto from 'crypto';
+import { ApiClient } from '../api/api-client.service';
+const QRImage = require('qrcode');
+
+@Injectable()
+export class WebhookListener implements OnApplicationBootstrap {
+  private readonly logger = new Logger(WebhookListener.name);
+  private server: http.Server | null = null;
+
+  // Estado de vinculación de WhatsApp, alimentado por WhatsappService (sin dependencia circular).
+  private qrActual: string | null = null;
+  private conectado = false;
+  // Diagnóstico: estado de conexión + últimos eventos entrantes (anillo de 15).
+  private connState: Record<string, unknown> = {};
+  private inbound: any[] = [];
+
+  constructor(private readonly api: ApiClient) {}
+
+  onApplicationBootstrap() {
+    const port = parseInt(process.env.WEBHOOK_PORT || '3001', 10);
+    this.server = http.createServer((req, res) => this.handleRequest(req, res));
+    this.server.listen(port, () => {
+      this.logger.log(`Webhook listener en puerto ${port}`);
+      this.logger.log(`WHATSAPP_START → POST /whatsapp-start`);
+      this.logger.log(`WHATSAPP_PDF   → POST /whatsapp-pdf`);
+      this.logger.log(`QR vinculación → GET  /qr (HTTP Basic, contraseña = QR_TOKEN)`);
+    });
+  }
+
+  setQr(qr: string | null) {
+    this.qrActual = qr;
+  }
+  setConectado(b: boolean) {
+    this.conectado = b;
+    if (b) this.qrActual = null;
+  }
+  setConnState(o: Record<string, unknown>) {
+    this.connState = o;
+  }
+  pushInbound(o: Record<string, unknown>) {
+    this.inbound.unshift(o);
+    if (this.inbound.length > 15) this.inbound.pop();
+  }
+
+  private async handleRequest(req: http.IncomingMessage, res: http.ServerResponse) {
+    const url = req.url || '';
+
+    if (req.method === 'GET') {
+      if (url.startsWith('/qr')) return this.handleQrPage(req, res);
+      if (url.startsWith('/debug')) return this.handleDebug(req, res);
+      res.writeHead(404).end('Not Found');
+      return;
+    }
+
+    if (req.method !== 'POST') {
+      res.writeHead(405).end('Method Not Allowed');
+      return;
+    }
+
+    let body = '';
+    req.on('data', (chunk) => (body += chunk));
+    req.on('end', async () => {
+      let payload: any;
+      try {
+        payload = JSON.parse(body);
+      } catch {
+        res.writeHead(400, { 'Content-Type': 'application/json' }).end(JSON.stringify({ ok: false, error: 'JSON invalido' }));
+        return;
+      }
+
+      try {
+        if (url === '/whatsapp-start') {
+          await this.handleWhatsappStart(payload);
+          res.writeHead(200, { 'Content-Type': 'application/json' }).end(JSON.stringify({ ok: true }));
+        } else if (url === '/whatsapp-pdf') {
+          await this.handleWhatsappPdf(payload);
+          res.writeHead(200, { 'Content-Type': 'application/json' }).end(JSON.stringify({ ok: true }));
+        } else if (url === '/whatsapp-fotos') {
+          // Cross-canal: tras una llamada, la app pide que Luisa escriba al lead y le pida las fotos.
+          const { fotosEmitter } = await import('../whatsapp/whatsapp.service');
+          fotosEmitter.emit('fotos', payload);
+          res.writeHead(200, { 'Content-Type': 'application/json' }).end(JSON.stringify({ ok: true }));
+        } else {
+          res.writeHead(404).end('Not Found');
+        }
+      } catch (err: any) {
+        this.logger.error(`Error handling ${url}: ${err.message}`);
+        res.writeHead(500, { 'Content-Type': 'application/json' }).end(JSON.stringify({ ok: false, error: err.message }));
+      }
+    });
+  }
+
+  // Comparación en tiempo constante (sobre hashes, sin filtrar longitud).
+  private tokenValido(a: string, b: string): boolean {
+    if (!a || !b) return false;
+    const ha = crypto.createHash('sha256').update(a).digest();
+    const hb = crypto.createHash('sha256').update(b).digest();
+    return crypto.timingSafeEqual(ha, hb);
+  }
+
+  // Auth Basic: contraseña = QR_TOKEN (en cabecera, nunca en la URL).
+  private basicAuthOk(req: http.IncomingMessage): boolean {
+    const expected = process.env.QR_TOKEN || '';
+    const auth = (req.headers['authorization'] as string) || '';
+    const pass = auth.startsWith('Basic ')
+      ? Buffer.from(auth.slice(6), 'base64').toString('utf8').split(':').slice(1).join(':')
+      : '';
+    return this.tokenValido(pass, expected);
+  }
+
+  // Diagnóstico: estado de conexión + últimos eventos entrantes. Misma auth que /qr.
+  private handleDebug(req: http.IncomingMessage, res: http.ServerResponse) {
+    if (!this.basicAuthOk(req)) {
+      res
+        .writeHead(401, {
+          'WWW-Authenticate': 'Basic realm="Reformix QR", charset="UTF-8"',
+          'Content-Type': 'application/json',
+          'Referrer-Policy': 'no-referrer',
+        })
+        .end(JSON.stringify({ ok: false, error: 'No autorizado' }));
+      return;
+    }
+    res
+      .writeHead(200, { 'Content-Type': 'application/json', 'Cache-Control': 'no-store', 'Referrer-Policy': 'no-referrer' })
+      .end(JSON.stringify({ conectado: this.conectado, connState: this.connState, inbound: this.inbound }, null, 2));
+  }
+
+  // Página de vinculación: muestra el QR de Baileys como imagen escaneable.
+  // Auth por cabecera (HTTP Basic, contraseña = QR_TOKEN), nunca por query string.
+  private async handleQrPage(req: http.IncomingMessage, res: http.ServerResponse) {
+    if (!this.basicAuthOk(req)) {
+      res
+        .writeHead(401, {
+          'WWW-Authenticate': 'Basic realm="Reformix QR", charset="UTF-8"',
+          'Content-Type': 'text/html; charset=utf-8',
+          'Referrer-Policy': 'no-referrer',
+        })
+        .end('<h2>401</h2><p>Usuario: cualquiera · Contraseña: el QR_TOKEN.</p>');
+      return;
+    }
+
+    let cuerpo: string;
+    if (this.conectado) {
+      cuerpo = '<h2>✅ WhatsApp ya conectado</h2><p>El bot está vinculado. No hace falta escanear nada.</p>';
+    } else if (this.qrActual) {
+      let dataUrl = '';
+      try {
+        dataUrl = await QRImage.toDataURL(this.qrActual, { width: 320, margin: 2 });
+      } catch {
+        /* fallback abajo */
+      }
+      cuerpo =
+        '<h2>Vincula WhatsApp del negocio</h2>' +
+        '<p>WhatsApp → Dispositivos vinculados → Vincular un dispositivo → escanea:</p>' +
+        (dataUrl ? '<img src="' + dataUrl + '" width="320" height="320" alt="QR" />' : '<p>No se pudo generar el QR.</p>') +
+        '<p class="muted">El código rota cada pocos segundos; la página se refresca sola.</p>';
+    } else {
+      cuerpo = '<h2>Esperando QR…</h2><p class="muted">El bot aún no ha emitido el código. Refresca en unos segundos.</p>';
+    }
+
+    const html =
+      '<!doctype html><html lang="es"><head><meta charset="utf-8" />' +
+      '<meta name="viewport" content="width=device-width, initial-scale=1" />' +
+      '<meta http-equiv="refresh" content="12" />' +
+      '<title>Vincular WhatsApp · Reformix</title>' +
+      '<style>body{font-family:-apple-system,BlinkMacSystemFont,Segoe UI,Roboto,sans-serif;background:#0f1115;color:#e6e8ec;display:flex;min-height:100vh;align-items:center;justify-content:center;text-align:center;margin:0;padding:24px}img{background:#fff;padding:12px;border-radius:12px}h2{margin:0 0 8px}.muted{color:#9aa3b2;font-size:13px}p{color:#c8cdd6}</style>' +
+      '</head><body><div>' +
+      cuerpo +
+      '</div></body></html>';
+    res
+      .writeHead(200, {
+        'Content-Type': 'text/html; charset=utf-8',
+        'Cache-Control': 'no-store',
+        'Referrer-Policy': 'no-referrer',
+      })
+      .end(html);
+  }
+
+  // eslint-disable-next-line @typescript-eslint/no-unused-vars
+  private leadSessions = new Map<string, { leadId: string; telefono: string; nombre: string; jid: string | null }>();
+
+  private normTel(t: string): string {
+    return (t || '').replace(/\D/g, '');
+  }
+
+  private async handleWhatsappStart(payload: { leadId: string; telefono: string; nombre: string; empresa: string }) {
+    const { leadId, nombre, empresa } = payload;
+    const telefono = this.normTel(payload.telefono);
+    this.logger.log(`[START] leadId=${leadId}, telefono=${telefono}, nombre=${nombre}`);
+
+    this.leadSessions.set(telefono, { leadId, telefono, nombre, jid: null });
+
+    // Dispara la apertura proactiva (la envía WhatsappService, evitando dependencia circular).
+    const { startEmitter } = await import('../whatsapp/whatsapp.service');
+    startEmitter.emit('start', { leadId, telefono, nombre, empresa });
+    this.logger.log(`Lead ${leadId} registrado; apertura disparada.`);
+  }
+
+  getLeadIdByTelefono(telefono: string): string | null {
+    return this.leadSessions.get(this.normTel(telefono))?.leadId ?? null;
+  }
+
+  registerJid(telefono: string, jid: string) {
+    const session = this.leadSessions.get(this.normTel(telefono));
+    if (session) {
+      session.jid = jid;
+    }
+  }
+
+  // Re-registra una sesión recuperada de la BD (cuando no estaba en memoria, p. ej. tras reinicio).
+  ensureSession(telefono: string, leadId: string, nombre = '') {
+    const tel = this.normTel(telefono);
+    if (!this.leadSessions.has(tel)) {
+      this.leadSessions.set(tel, { leadId, telefono: tel, nombre, jid: null });
+    }
+  }
+
+  private async handleWhatsappPdf(payload: { leadId: string; telefono: string; pdfBase64: string; filename: string }) {
+    this.logger.log(`[PDF] leadId=${payload.leadId}, filename=${payload.filename}`);
+    const { pdfEmitter } = await import('../whatsapp/whatsapp.service');
+    const telefono = payload.telefono.startsWith('+') ? payload.telefono.slice(1) : payload.telefono;
+    pdfEmitter.emit('pdf', { ...payload, telefono });
+  }
+}

mvp/Whatsapp-bot/src/webhook/webhook.module.ts

@@ -0,0 +1,10 @@
+import { Module } from '@nestjs/common';
+import { WebhookListener } from './webhook-listener';
+import { ApiModule } from '../api/api.module';
+
+@Module({
+  imports: [ApiModule],
+  providers: [WebhookListener],
+  exports: [WebhookListener],
+})
+export class WebhookModule {}

mvp/Whatsapp-bot/src/whatsapp/whatsapp.module.ts

@@ -5,9 +5,10 @@ import { LeadsModule } from '../leads/leads.module';
 import { ConversacionModule } from '../conversacion/conversacion.module';
 import { ClaudeModule } from '../claude/claude.module';
 import { MediaModule } from '../media/media.module';
+import { WebhookModule } from '../webhook/webhook.module';
 
 @Module({
-  imports: [LeadsModule, ConversacionModule, ClaudeModule, MediaModule],
+  imports: [LeadsModule, ConversacionModule, ClaudeModule, MediaModule, WebhookModule],
   providers: [WhatsappService, WhatsappDebounceService],
   exports: [WhatsappService],
 })

mvp/Whatsapp-bot/src/whatsapp/whatsapp.service.ts

@@ -1,9 +1,10 @@
+import { EventEmitter } from 'events';
 import {
   Injectable,
   Logger,
   OnModuleInit,
   OnModuleDestroy,
-} from "@nestjs/common";
+} from '@nestjs/common';
 import makeWASocket, {
   DisconnectReason,
   useMultiFileAuthState,
@@ -11,33 +12,50 @@ import makeWASocket, {
   WASocket,
   downloadMediaMessage,
   normalizeMessageContent,
-} from "@whiskeysockets/baileys";
-import { Boom } from "@hapi/boom";
-import * as path from "path";
-const pino = require("pino");
-const QRCode = require("qrcode-terminal");
-import { LeadsService } from "../leads/leads.service";
-import { ConversacionService } from "../conversacion/conversacion.service";
-import { ClaudeService } from "../claude/claude.service";
-import { MediaService } from "../media/media.service";
-import { WhatsappDebounceService } from "./whatsapp-debounce.service";
-import { wrapSocket } from "baileys-antiban";
+} from '@whiskeysockets/baileys';
+import { Boom } from '@hapi/boom';
+import * as path from 'path';
+const pino = require('pino');
+const QRCode = require('qrcode-terminal');
+import { LeadsService } from '../leads/leads.service';
+import { ConversacionService } from '../conversacion/conversacion.service';
+import { ClaudeService } from '../claude/claude.service';
+import { MediaService } from '../media/media.service';
+import { WhatsappDebounceService } from './whatsapp-debounce.service';
+import { WebhookListener } from '../webhook/webhook-listener';
+import { ApiClient } from '../api/api-client.service';
+import { wrapSocket } from 'baileys-antiban';
 
-const ESTADOS_TERMINALES = [
-  "completado",
-  "no_viable",
-  "perdido",
-  "fin_viable",
-  "fin_no_viable",
-];
+export const pdfEmitter = new EventEmitter();
+export const startEmitter = new EventEmitter();
+export const fotosEmitter = new EventEmitter();
+
+interface LeadContext {
+  leadId: string;
+  telefono: string;
+  nombre: string;
+  botStep: string;
+  viable: boolean | null;
+}
 
 @Injectable()
 export class WhatsappService implements OnModuleInit, OnModuleDestroy {
   private readonly logger = new Logger(WhatsappService.name);
   private sock: WASocket | null = null;
-  private authDir = path.join(process.cwd(), "auth_info_baileys");
+  private authDir = process.env.BAILEYS_AUTH_DIR || path.join(process.cwd(), 'auth_info_baileys');
   private readonly ultimoMsgPorJid = new Map<string, any>();
-  private baileysLogger = pino({ level: "info" });
+  private baileysLogger = pino({ level: 'info' });
+
+  // leadId por JID
+  private readonly jidToLeadId = new Map<string, string>();
+  // contexto de lead por leadId
+  private readonly leadCache = new Map<string, LeadContext>();
+  // leads cuya conversación ya se mandó a post-análisis (para no repetir).
+  private readonly leadsAnalizados = new Set<string>();
+  // leads a los que se les ha pedido foto y estamos esperándola.
+  private readonly esperandoFotos = new Set<string>();
+  // leads cuyo pipeline de render/presupuesto ya se disparó (perfilCompleto), para no repetir.
+  private readonly pipelineDisparado = new Set<string>();
 
   constructor(
     private readonly leadsService: LeadsService,
@@ -45,20 +63,219 @@ export class WhatsappService implements OnModuleInit, OnModuleDestroy {
     private readonly claudeService: ClaudeService,
     private readonly mediaService: MediaService,
     private readonly debounceService: WhatsappDebounceService,
+    private readonly webhookListener: WebhookListener,
+    private readonly api: ApiClient,
   ) {}
 
   async onModuleInit() {
     await this.conectar();
+    this.escucharPdf();
+    this.escucharStart();
+    this.escucharFotos();
   }
 
   async onModuleDestroy() {
-    if (this.sock) {
-      this.sock.end(undefined);
+    if (this.sock) this.sock.end(undefined);
+  }
+
+  private escucharPdf() {
+    pdfEmitter.on('pdf', async (payload: { leadId: string; telefono: string; pdfBase64: string; filename: string }) => {
+      this.logger.log(`[PDF] Recibido para leadId=${payload.leadId}`);
+      // Buscar JID por teléfono
+      let jid: string | null = null;
+      for (const [j, lid] of this.jidToLeadId) {
+        if (lid === payload.leadId) {
+          jid = j;
+          break;
+        }
+      }
+      if (!jid) {
+        jid = `${payload.telefono}@s.whatsapp.net`;
+      }
+      if (!this.sock) return;
+      try {
+        const safeSock = wrapSocket(this.sock);
+        await safeSock.sendMessage(jid, {
+          document: Buffer.from(payload.pdfBase64, 'base64'),
+          mimetype: 'application/pdf',
+          fileName: payload.filename,
+          caption: 'Aquí tienes tu presupuesto. Si tienes cualquier duda, estamos aquí.',
+        });
+        this.logger.log(`PDF enviado a ${jid}`);
+      } catch (err: any) {
+        this.logger.error(`Error enviando PDF a ${jid}: ${err.message}`);
+      }
+    });
+  }
+
+  // Apertura proactiva: cuando el funnel dispara /whatsapp-start, Luisa escribe ella el primer
+  // mensaje (el bot ya no es solo reactivo).
+  private escucharStart() {
+    startEmitter.on(
+      'start',
+      async (p: { leadId: string; telefono: string; nombre: string; empresa: string }) => {
+        try {
+          await this.enviarApertura(p);
+        } catch (err: any) {
+          this.logger.error(`[APERTURA] Error: ${err.message}`);
+        }
+      },
+    );
+  }
+
+  private async enviarApertura(p: { leadId: string; telefono: string; nombre: string; empresa: string }) {
+    if (!this.sock) {
+      this.logger.warn(`[APERTURA] WhatsApp no conectado; no se envía a ${p.telefono}`);
+      return;
+    }
+    const tel = (p.telefono || '').replace(/\D/g, '');
+    let jid = `${tel}@s.whatsapp.net`;
+    try {
+      const res = await this.sock.onWhatsApp(tel);
+      if (res && res[0]?.exists && res[0]?.jid) jid = res[0].jid;
+      else if (!res || !res[0]?.exists) this.logger.warn(`[APERTURA] ${tel} no parece estar en WhatsApp`);
+    } catch {
+      /* seguimos con el jid por defecto */
+    }
+
+    const primerNombre = (p.nombre || '').trim().split(' ')[0] || 'hola';
+    const empresa = p.empresa || 'Reformix';
+    const apertura =
+      `¡Hola ${primerNombre}! Soy Luisa, del equipo de ${empresa}. 😊\n\n` +
+      `Acabas de pedir presupuesto para tu reforma y te ayudo a prepararlo (con un render de cómo ` +
+      `quedaría incluido). Para empezar, cuéntame: ¿qué espacio quieres reformar? (cocina, baño, salón…)`;
+
+    // Contexto para los siguientes mensajes del cliente.
+    this.jidToLeadId.set(jid, p.leadId);
+    this.webhookListener.registerJid(tel, jid);
+    this.leadCache.set(p.leadId, {
+      leadId: p.leadId,
+      telefono: tel,
+      nombre: p.nombre || '',
+      botStep: 'apertura',
+      viable: null,
+    });
+
+    await this.enviarMensaje(jid, apertura);
+    this.logger.log(`[APERTURA] Enviada a ${jid} (lead ${p.leadId})`);
+
+    try {
+      await this.api.actualizarPerfil(p.leadId, { estadoWa: 'enviado', botStep: 'apertura', canalOrigen: 'whatsapp' });
+      await this.conversacionService.guardarMensaje(p.leadId, 'assistant', apertura, { botStep: 'apertura' });
+      await this.api.registrarIntento(p.leadId, 'whatsapp', 1, 'exitoso', true);
+    } catch (err: any) {
+      this.logger.warn(`[APERTURA] No se pudo persistir en la app: ${err.message}`);
     }
   }
 
+  // Recibe una foto en modo "esperando fotos": la sube como "antes" y marca perfilCompleto, lo que
+  // dispara en la app la generación de render + presupuesto + entrega del PDF.
+  private async recibirFotoYFinalizar(ctx: LeadContext, jid: string, msg: any, msgContent: any): Promise<void> {
+    if (!this.sock || this.pipelineDisparado.has(ctx.leadId)) return;
+    try {
+      const buffer = await downloadMediaMessage(msg as any, 'buffer', {}, {
+        logger: this.baileysLogger,
+        reuploadRequest: this.sock.updateMediaMessage,
+      });
+      const base64 = Buffer.isBuffer(buffer) ? buffer.toString('base64') : Buffer.from(buffer).toString('base64');
+      const mimeType = msgContent.imageMessage?.mimetype || 'image/jpeg';
+
+      this.esperandoFotos.delete(ctx.leadId);
+      this.pipelineDisparado.add(ctx.leadId);
+
+      await this.api.enviarIngesta(
+        ctx.leadId,
+        [{ tipo: 'foto', imagen: `data:${mimeType};base64,${base64}`, zona: 'otro', momento: 'antes' }],
+        { perfilCompleto: true },
+      );
+
+      await this.conversacionService.guardarMensaje(ctx.leadId, 'user', '[foto del espacio]', { botStep: 'fotos_recibidas' });
+      const conf = '¡Perfecto! Con esto preparo tu presupuesto con el render. En un momento te llega aquí mismo 🛠️';
+      await this.conversacionService.guardarMensaje(ctx.leadId, 'assistant', conf, { botStep: 'fotos_recibidas' });
+      await this.enviarMensaje(jid, conf);
+      this.logger.log(`[FOTOS] lead ${ctx.leadId}: foto recibida → perfilCompleto disparado`);
+    } catch (err: any) {
+      this.pipelineDisparado.delete(ctx.leadId);
+      this.logger.error(`[FOTOS] error procesando foto de ${ctx.leadId}: ${err.message}`);
+    }
+  }
+
+  // Cross-canal: tras una llamada, la app pide por webhook que Luisa escriba al lead, referencie lo
+  // hablado y le pida las fotos. Reutiliza el mismo modo de recogida.
+  private escucharFotos() {
+    fotosEmitter.on(
+      'fotos',
+      async (p: { leadId: string; telefono: string; nombre: string; empresa?: string; contexto?: string }) => {
+        try {
+          await this.iniciarRecogidaFotos(p);
+        } catch (err: any) {
+          this.logger.error(`[FOTOS] iniciarRecogida error: ${err.message}`);
+        }
+      },
+    );
+  }
+
+  private async iniciarRecogidaFotos(p: {
+    leadId: string;
+    telefono: string;
+    nombre: string;
+    empresa?: string;
+    contexto?: string;
+  }): Promise<void> {
+    if (!this.sock) {
+      this.logger.warn(`[FOTOS] WhatsApp no conectado; no se pide foto a ${p.telefono}`);
+      return;
+    }
+    const jid = await this.resolverJidYRegistrar(p.leadId, p.telefono, p.nombre, 'pide_fotos');
+    this.esperandoFotos.add(p.leadId);
+    const primerNombre = (p.nombre || '').trim().split(' ')[0] || 'hola';
+    const empresa = p.empresa || 'Reformix';
+    const ctx = p.contexto ? ` sobre ${p.contexto}` : '';
+    const mensaje =
+      `¡Hola ${primerNombre}! Soy Luisa, de ${empresa}. 😊 Gracias por tu llamada${ctx}. ` +
+      `Para terminar tu presupuesto con el render, mándame una foto del espacio 📸`;
+    await this.conversacionService.guardarMensaje(p.leadId, 'assistant', mensaje, { botStep: 'pide_fotos' });
+    await this.enviarMensaje(jid, mensaje);
+    this.logger.log(`[FOTOS] recogida iniciada para lead ${p.leadId} (cross-canal)`);
+  }
+
+  // Resuelve el jid real del teléfono (vía onWhatsApp) y registra el contexto del lead.
+  private async resolverJidYRegistrar(leadId: string, telefono: string, nombre: string, botStep: string): Promise<string> {
+    const tel = (telefono || '').replace(/\D/g, '');
+    let jid = `${tel}@s.whatsapp.net`;
+    try {
+      const res = await this.sock?.onWhatsApp(tel);
+      if (res && res[0]?.exists && res[0]?.jid) jid = res[0].jid;
+    } catch {
+      /* jid por defecto */
+    }
+    this.jidToLeadId.set(jid, leadId);
+    this.webhookListener.registerJid(tel, jid);
+    if (!this.leadCache.has(leadId)) {
+      this.leadCache.set(leadId, { leadId, telefono: tel, nombre: nombre || '', botStep, viable: null });
+    }
+    return jid;
+  }
+
   private normalizarTelefono(jid: string): string {
-    return jid.split("@")[0].replace(/\D/g, "");
+    return jid.split('@')[0].replace(/\D/g, '');
+  }
+
+  // WhatsApp puede entregar mensajes desde una dirección @lid (id de privacidad) en vez del número.
+  // Resolvemos el número real vía remoteJidAlt o el mapa LID→PN de Baileys; si no, caemos al jid.
+  private resolverTelefono(msg: any): string {
+    const jid: string = msg.key?.remoteJid || '';
+    if (jid.endsWith('@lid')) {
+      const alt = msg.key?.remoteJidAlt;
+      if (typeof alt === 'string' && alt.includes('@s.whatsapp.net')) return this.normalizarTelefono(alt);
+      try {
+        const pn = (this.sock as any)?.signalRepository?.lidMapping?.getPNForLID?.(jid);
+        if (typeof pn === 'string' && pn) return this.normalizarTelefono(pn);
+      } catch {
+        /* sin mapping disponible */
+      }
+    }
+    return this.normalizarTelefono(jid);
   }
 
   private calcularDelayEscritura(longitudTexto: number): number {
@@ -76,68 +293,72 @@ export class WhatsappService implements OnModuleInit, OnModuleDestroy {
     const { state, saveCreds } = await useMultiFileAuthState(this.authDir);
     const { version } = await fetchLatestBaileysVersion();
 
-    this.baileysLogger = pino({ level: "info" }) as any;
+    this.baileysLogger = pino({ level: 'info' }) as any;
 
     this.sock = makeWASocket({
       version,
       auth: state,
       printQRInTerminal: false,
       logger: this.baileysLogger,
-      markOnlineOnConnect: false,
+      // true: marca el dispositivo "online" al conectar para que WhatsApp le ENTREGUE los mensajes
+      // entrantes tras reconectar (con false, al reanudar la sesión quedaba "no disponible" y no
+      // recibía nada aunque el socket dijera "open").
+      markOnlineOnConnect: true,
       generateHighQualityLinkPreview: false,
       syncFullHistory: false,
     });
 
-    this.sock.ev.on("creds.update", saveCreds);
+    this.sock.ev.on('creds.update', saveCreds);
 
-    this.sock.ev.on("connection.update", (update) => {
+    this.sock.ev.on('connection.update', (update) => {
       const { connection, lastDisconnect, qr } = update;
 
+      this.webhookListener.setConnState({
+        connection: connection ?? null,
+        hasQr: !!qr,
+        lastDisconnect: (lastDisconnect?.error as Boom)?.output?.statusCode ?? null,
+        at: new Date().toISOString(),
+      });
+
       if (qr) {
         QRCode.generate(qr, { small: true });
-        console.log("\n📲 Escanea este QR con WhatsApp\n");
+        console.log('\n📲 Escanea este QR con WhatsApp (o abre la página /qr, protegida con QR_TOKEN)\n');
+        this.webhookListener.setQr(qr);
       }
 
-      if (connection === "close") {
+      if (connection === 'close') {
         const shouldReconnect =
-          (lastDisconnect?.error as Boom)?.output?.statusCode !==
-          DisconnectReason.loggedOut;
-
-        this.logger.warn(
-          `Conexion cerrada. Reconectar: ${shouldReconnect}. Razon: ${lastDisconnect?.error?.message}`,
-        );
-
-        if (shouldReconnect) {
-          setTimeout(() => this.conectar(), 5000);
-        } else {
-          this.logger.error(
-            "Sesion cerrada (logged out). Elimina auth_info_baileys y reinicia.",
-          );
-        }
-      } else if (connection === "open") {
-        this.logger.log(
-          "✅ WhatsApp conectado. Luisa esta lista para recibir mensajes.",
-        );
+          (lastDisconnect?.error as Boom)?.output?.statusCode !== DisconnectReason.loggedOut;
+        this.logger.warn(`Conexion cerrada. Reconectar: ${shouldReconnect}.`);
+        this.webhookListener.setConectado(false);
+        if (shouldReconnect) setTimeout(() => this.conectar(), 5000);
+        else this.logger.error('Sesion cerrada (logged out).');
+      } else if (connection === 'open') {
+        this.logger.log('✅ WhatsApp conectado. Luisa esta lista.');
+        this.webhookListener.setConectado(true);
       }
     });
 
-    this.sock.ev.on("messages.upsert", async ({ messages, type }) => {
-      if (type !== "notify") return;
-
+    this.sock.ev.on('messages.upsert', async ({ messages, type }) => {
+      for (const msg of messages) {
+        this.webhookListener.pushInbound({
+          type,
+          remoteJid: msg.key.remoteJid ?? null,
+          remoteJidAlt: (msg.key as any).remoteJidAlt ?? null,
+          fromMe: !!msg.key.fromMe,
+          msgType: msg.message ? Object.keys(msg.message)[0] : null,
+          at: new Date().toISOString(),
+        });
+      }
+      if (type !== 'notify') return;
       for (const msg of messages) {
         if (msg.key.fromMe) continue;
         if (!msg.key.remoteJid) continue;
-        if (msg.key.remoteJid.includes("@g.us")) continue;
+        if (msg.key.remoteJid.includes('@g.us')) continue;
 
         const telefonoNormalizado = this.normalizarTelefono(msg.key.remoteJid);
-        const allowedNumber = process.env.ALLOWED_NUMBER?.replace(/\D/g, "");
-
-        if (allowedNumber && telefonoNormalizado !== allowedNumber) {
-          this.logger.debug(
-            `Mensaje ignorado: ${telefonoNormalizado} no coincide con ALLOWED_NUMBER`,
-          );
-          continue;
-        }
+        const allowedNumber = process.env.ALLOWED_NUMBER?.replace(/\D/g, '');
+        if (allowedNumber && telefonoNormalizado !== allowedNumber) continue;
 
         await this.encolarMensaje(msg);
       }
@@ -147,21 +368,15 @@ export class WhatsappService implements OnModuleInit, OnModuleDestroy {
   private extraerTextoPlano(msg: any): string | null {
     const msgContent = msg.message;
     if (!msgContent) return null;
-
     if (msgContent.conversation || msgContent.extendedTextMessage) {
-      const texto =
-        msgContent.conversation || msgContent.extendedTextMessage?.text || "";
+      const texto = msgContent.conversation || msgContent.extendedTextMessage?.text || '';
       return texto.trim() ? texto : null;
     }
-
     return null;
   }
 
   private crearMsgConTexto(msg: any, texto: string): any {
-    return {
-      ...msg,
-      message: { conversation: texto },
-    };
+    return { ...msg, message: { conversation: texto } };
   }
 
   private async encolarMensaje(msg: any): Promise<void> {
@@ -174,7 +389,6 @@ export class WhatsappService implements OnModuleInit, OnModuleDestroy {
     }
 
     this.ultimoMsgPorJid.set(jid, msg);
-
     await this.debounceService.add(jid, textoPlano, async (combinedMessage) => {
       const baseMsg = this.ultimoMsgPorJid.get(jid) ?? msg;
       this.ultimoMsgPorJid.delete(jid);
@@ -182,179 +396,225 @@ export class WhatsappService implements OnModuleInit, OnModuleDestroy {
     });
   }
 
+  private async getOrCreateContext(telefono: string, jid: string): Promise<LeadContext | null> {
+    let leadId = this.webhookListener.getLeadIdByTelefono(telefono);
+
+    // Fallback: si no está en memoria (reinicio del bot), recuperarlo de la BD por teléfono.
+    if (!leadId) {
+      leadId = await this.api.buscarLeadPorTelefono(telefono);
+      if (leadId) {
+        this.webhookListener.ensureSession(telefono, leadId);
+        this.logger.log(`Lead ${leadId} recuperado por teléfono ${telefono} (sin sesión en memoria).`);
+      }
+    }
+
+    this.webhookListener.pushInbound({ stage: 'match', telefono, leadId: leadId ?? null, at: new Date().toISOString() });
+    if (!leadId) {
+      this.logger.log(`Mensaje ignorado de ${telefono}: lead no registrado. Debe iniciarse desde la web.`);
+      return null;
+    }
+
+    this.webhookListener.registerJid(telefono, jid);
+    this.jidToLeadId.set(jid, leadId);
+
+    let ctx = this.leadCache.get(leadId);
+    if (!ctx) {
+      const lead = await this.api.getLead(leadId);
+      ctx = {
+        leadId,
+        telefono,
+        nombre: lead?.nombre || '',
+        botStep: lead?.botStep || 'nuevo',
+        viable: lead?.viable ?? null,
+      };
+      this.leadCache.set(leadId, ctx);
+    }
+    return ctx;
+  }
+
   private async procesarMensaje(msg: any): Promise<void> {
     const jid = msg.key.remoteJid!;
+    if (jid.includes('@g.us')) return;
 
-    if (jid.includes("@g.us")) return;
-
-    const telefono = jid.split("@")[0];
+    const telefono = this.resolverTelefono(msg);
 
     try {
-      let lead = await this.leadsService.findOrCreate(telefono);
+      const ctx = await this.getOrCreateContext(telefono, jid);
+      if (!ctx) return;
 
-      if (ESTADOS_TERMINALES.includes(lead.estado_actual)) {
-        this.logger.log(
-          `Lead id=${lead.id} en estado=${lead.estado_actual}. Ignorando.`,
-        );
-        return;
-      }
+      const primerMensajeDeUsuario = !this.jidToLeadId.has(jid);
 
-      let textoNormalizado = "";
+      let textoNormalizado = '';
       const msgContent = normalizeMessageContent(msg.message);
-
       if (!msgContent) return;
 
-      if (msgContent.conversation || msgContent.extendedTextMessage) {
-        textoNormalizado =
-          msgContent.conversation || msgContent.extendedTextMessage?.text || "";
-      } else if (msgContent.audioMessage) {
-        const audioMeta = msgContent.audioMessage;
-        const mimeType = audioMeta.mimetype || "audio/ogg; codecs=opus";
-
-        this.logger.log(
-          `[AUDIO 1/4] Recibido — lead=${lead.id}, ptt=${audioMeta.ptt ?? false}, seconds=${audioMeta.seconds ?? "?"}, mimetype=${mimeType}, fileLength=${audioMeta.fileLength ?? "?"}, url=${audioMeta.url ? "si" : "no"}`,
-        );
-
-        if (!this.sock) {
-          this.logger.error("[AUDIO 1/4] Socket no disponible para descargar audio");
+      // Modo recogida de fotos (tras cerrar la cualificación o tras una llamada): la foto cierra el
+      // flujo → sube la foto + dispara render/presupuesto, sin re-cualificar.
+      if (msgContent.imageMessage && this.esperandoFotos.has(ctx.leadId)) {
+        await this.recibirFotoYFinalizar(ctx, jid, msg, msgContent);
         return;
       }
 
-        const buffer = await downloadMediaMessage(
-          msg as any,
-          "buffer",
-          {},
-          {
-            logger: this.baileysLogger,
-            reuploadRequest: this.sock.updateMediaMessage,
-          },
-        );
-
-        const audioBuffer = Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer);
-        const magicHex = audioBuffer.subarray(0, 4).toString("hex");
-
-        this.logger.log(
-          `[AUDIO 1/4] Buffer descargado — size=${audioBuffer.length} bytes, magic_hex=${magicHex}, esperado_ogg=4f676753`,
-        );
-
-        textoNormalizado = await this.mediaService.transcribirAudio(
-          audioBuffer,
-          mimeType,
-        );
-
-        this.logger.log(
-          `[AUDIO 1/4] Transcripcion recibida en procesarMensaje — "${textoNormalizado.slice(0, 200).replace(/\n/g, "\\n")}"`,
-        );
-      } else if (msgContent.imageMessage) {
-        this.logger.log(
-          `Imagen recibida de lead id=${lead.id}. Analizando con Vision...`,
-        );
-
+      if (msgContent.conversation || msgContent.extendedTextMessage) {
+        textoNormalizado = msgContent.conversation || msgContent.extendedTextMessage?.text || '';
+      } else if (msgContent.audioMessage) {
+        const audioMeta = msgContent.audioMessage;
+        const mimeType = audioMeta.mimetype || 'audio/ogg; codecs=opus';
+        this.logger.log(`[AUDIO] Recibido — lead=${ctx.leadId}`);
         if (!this.sock) return;
-
-        const buffer = await downloadMediaMessage(
-          msg as any,
-          "buffer",
-          {},
-          {
+        const buffer = await downloadMediaMessage(msg as any, 'buffer', {}, {
           logger: this.baileysLogger,
           reuploadRequest: this.sock.updateMediaMessage,
-          },
-        );
-        const mimeType = msgContent.imageMessage.mimetype || "image/jpeg";
+        });
+        const audioBuffer = Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer);
+        textoNormalizado = await this.mediaService.transcribirAudio(audioBuffer, mimeType);
+      } else if (msgContent.imageMessage) {
+        this.logger.log(`Imagen recibida de lead ${ctx.leadId}`);
+        if (!this.sock) return;
+        const buffer = await downloadMediaMessage(msg as any, 'buffer', {}, {
+          logger: this.baileysLogger,
+          reuploadRequest: this.sock.updateMediaMessage,
+        });
+        const mimeType = msgContent.imageMessage.mimetype || 'image/jpeg';
         textoNormalizado = await this.mediaService.inferirImagen(
           Buffer.isBuffer(buffer) ? buffer : Buffer.from(buffer),
           mimeType,
-          lead.estado_actual,
+          'en_proceso',
         );
         if (msgContent.imageMessage.caption) {
           textoNormalizado = `${msgContent.imageMessage.caption}\n\n[Contenido de la imagen: ${textoNormalizado}]`;
         }
       } else {
-        this.logger.log(
-          `Tipo de mensaje no soportado de lead id=${lead.id}. Ignorando.`,
-        );
+        this.logger.log(`Tipo de mensaje no soportado de lead ${ctx.leadId}. Ignorando.`);
         return;
       }
 
       if (!textoNormalizado.trim()) return;
-
       this.logger.log(`USUARIO [${telefono}]: ${textoNormalizado}`);
 
-      await this.conversacionService.guardarMensaje(
-        lead.id,
-        "user",
-        textoNormalizado,
-      );
+      if (primerMensajeDeUsuario) {
+        await this.api.registrarIntento(ctx.leadId, 'whatsapp', 1, 'exitoso', true);
+      }
 
-      const historial =
-        await this.conversacionService.obtenerHistorialComoMessages(lead.id);
+      if (msgContent.imageMessage) {
+        const buffer = await downloadMediaMessage(msg as any, 'buffer', {}, {
+          logger: this.baileysLogger,
+          reuploadRequest: this.sock.updateMediaMessage,
+        });
+        const base64 = Buffer.isBuffer(buffer) ? buffer.toString('base64') : Buffer.from(buffer).toString('base64');
+        const mimeType = msgContent.imageMessage.mimetype || 'image/jpeg';
+        await this.api.enviarIngesta(ctx.leadId, [{
+          tipo: 'foto',
+          imagen: `data:${mimeType};base64,${base64}`,
+          zona: 'otro',
+          momento: 'antes',
+        }]);
+      }
 
-      const { respuesta, entidad, viable, nuevoEstado } =
-        await this.claudeService.llamarClaude(
-          lead,
+      await this.conversacionService.guardarMensaje(ctx.leadId, 'user', textoNormalizado, {
+        botStep: ctx.botStep,
+      });
+
+      const historial = await this.conversacionService.obtenerHistorialComoMessages(ctx.leadId);
+
+      const leadParaClaude = {
+        id: ctx.leadId,
+        telefono: ctx.telefono,
+        nombre: ctx.nombre,
+        estado_actual: ctx.botStep || 'nuevo',
+        espacio: null as string | null,
+        rango_m2: null as string | null,
+        estilo: null as string | null,
+        urgencia: null as string | null,
+        presupuesto_declarado: null as string | null,
+        viable: ctx.viable as boolean | null,
+        email: null as string | null,
+      };
+
+      const { respuesta, entidad, viable, nuevoEstado } = await this.claudeService.llamarClaude(
+        leadParaClaude as any,
         historial.slice(0, -1),
         textoNormalizado,
       );
 
       this.logger.log(`LUISA [${telefono}]: ${respuesta}`);
 
-      if (
-        (entidad && Object.keys(entidad).length > 0) ||
-        nuevoEstado ||
-        (viable !== undefined && viable !== null)
-      ) {
-        lead = await this.leadsService.persistirTurno(lead.id, entidad ?? {}, {
-          nuevoEstado,
-          viable,
-        });
-        this.logger.log(
-          `Lead id=${lead.id} en DB — estado=${lead.estado_actual}, espacio=${lead.espacio ?? "-"}, rango_m2=${lead.rango_m2 ?? "-"}, estilo=${lead.estilo ?? "-"}, urgencia=${lead.urgencia ?? "-"}, presupuesto=${lead.presupuesto_declarado ?? "-"}`,
-        );
+      if ((entidad && Object.keys(entidad).length > 0) || nuevoEstado || viable !== undefined) {
+        const entidadMap: Record<string, unknown> = {};
+        if (entidad) {
+          for (const [k, v] of Object.entries(entidad)) {
+            const mapped = this.mapearCampoALegacy(k);
+            entidadMap[mapped] = v;
+          }
+        }
+        await this.leadsService.persistirTurno(ctx.leadId, entidadMap, { nuevoEstado, viable });
+        if (nuevoEstado) ctx.botStep = nuevoEstado;
+        if (viable !== undefined) ctx.viable = viable;
+        this.logger.log(`Lead ${ctx.leadId} persistido — estado=${nuevoEstado || ctx.botStep}`);
       }
 
-      await this.conversacionService.guardarMensaje(
-        lead.id,
-        "assistant",
-        respuesta,
-      );
-      await this.enviarMensaje(jid, respuesta);
-    } catch (error) {
-      this.logger.error(
-        `Error procesando mensaje de ${telefono}: ${error.message}`,
-        error.stack,
-      );
+      // ¿Estamos en el cierre? Por estado (errático) O porque Luisa anuncia el presupuesto.
+      const estadosCierre = ['presupuesto', 'fin_viable', 'fin_no_viable'];
+      const anunciaPresupuesto =
+        /presupuesto/i.test(respuesta) &&
+        /prepar|recib|enseguida|en un momento|te lo env|lo env|aqu[ií] mismo/i.test(respuesta);
+      const esCierre = estadosCierre.includes(ctx.botStep) || anunciaPresupuesto;
+
+      // Al cerrar, dispara el post-análisis de toda la conversación (una sola vez).
+      if (esCierre && !this.leadsAnalizados.has(ctx.leadId)) {
+        this.leadsAnalizados.add(ctx.leadId);
+        this.api
+          .analizarConversacion(ctx.leadId)
+          .then((ok) => this.logger.log(`[ANALISIS] lead ${ctx.leadId}: ${ok ? 'ok' : 'fallo'}`))
+          .catch((e: any) => this.logger.error(`[ANALISIS] ${e.message}`));
       }
+
+      await this.conversacionService.guardarMensaje(ctx.leadId, 'assistant', respuesta, {
+        botStep: ctx.botStep,
+      });
+      await this.enviarMensaje(jid, respuesta);
+
+      // Tras cerrar, pide una foto para el render (si no la hemos pedido/recibido ya).
+      if (esCierre && !this.esperandoFotos.has(ctx.leadId) && !this.pipelineDisparado.has(ctx.leadId)) {
+        this.esperandoFotos.add(ctx.leadId);
+        const pedir = 'Una última cosa para incluir el render en tu presupuesto: mándame una foto del espacio 📸';
+        await this.conversacionService.guardarMensaje(ctx.leadId, 'assistant', pedir, { botStep: 'pide_fotos' });
+        await this.enviarMensaje(jid, pedir);
+      }
+    } catch (error: any) {
+      this.logger.error(`Error procesando mensaje de ${telefono}: ${error.message}`, error.stack);
+    }
+  }
+
+  private mapearCampoALegacy(campo: string): string {
+    const map: Record<string, string> = {
+      espacio: 'espacio',
+      rango_m2: 'rangoM2',
+      estilo: 'estilo',
+      urgencia: 'urgencia',
+      presupuesto_declarado: 'presupuestoDeclarado',
+      nombre: 'nombre',
+    };
+    return map[campo] || campo;
   }
 
   async enviarMensaje(jid: string, texto: string): Promise<void> {
     if (!this.sock) return;
-
     try {
-      const jidPresencia = jid.includes("@lid")
-        ? `${jid.split("@")[0]}@s.whatsapp.net`
+      const jidPresencia = jid.includes('@lid')
+        ? `${jid.split('@')[0]}@s.whatsapp.net`
         : jid;
-
-      await this.sock.sendPresenceUpdate("composing", jidPresencia);
+      await this.sock.sendPresenceUpdate('composing', jidPresencia);
       await this.delay(this.calcularDelayEscritura(texto.length));
-      await this.sock.sendPresenceUpdate("paused", jidPresencia);
-
+      await this.sock.sendPresenceUpdate('paused', jidPresencia);
       const safeSock = wrapSocket(this.sock);
       await safeSock.sendMessage(jid, { text: texto });
       this.logger.log(`Mensaje enviado a ${jid}`);
-    } catch (error) {
+    } catch (error: any) {
       this.logger.error(`Error enviando mensaje a ${jid}: ${error.message}`);
     }
   }
 
-  async enviarApertura(
-    telefono: string,
-    mensajeApertura: string,
-  ): Promise<void> {
-    const jid = `${telefono}@s.whatsapp.net`;
-    await this.enviarMensaje(jid, mensajeApertura);
-  }
-
   isConectado(): boolean {
     return this.sock !== null;
   }

mvp/Whatsapp-bot/tsconfig.json

@@ -1,7 +1,6 @@
 {
   "compilerOptions": {
     "module": "commonjs",
-    "ignoreDeprecations": "6.0",
     "declaration": true,
     "removeComments": true,
     "emitDecoratorMetadata": true,

mvp/b2c/db-schema/schema.sql

@@ -186,6 +186,7 @@ CREATE TABLE "pricing_config" (
 	"factor_zona" jsonb DEFAULT '{}'::jsonb NOT NULL,
 	"mano_obra" jsonb DEFAULT '{}'::jsonb NOT NULL,
 	"extras" jsonb DEFAULT '{"tuberias":0,"boletin":0,"distribucion":0}'::jsonb NOT NULL,
+	"baremo_minimo" integer,
 	"updated_at" timestamp with time zone DEFAULT now() NOT NULL,
 	CONSTRAINT "pricing_config_tenant_id_unique" UNIQUE("tenant_id")
 );

mvp/b2c/drizzle/0012_lame_sentinel.sql

@@ -0,0 +1 @@
+ALTER TABLE "pricing_config" ADD COLUMN "baremo_minimo" integer;

mvp/b2c/drizzle/meta/_journal.json

@@ -85,6 +85,13 @@
       "when": 1780593183911,
       "tag": "0011_warm_post",
       "breakpoints": true
+    },
+    {
+      "idx": 12,
+      "version": "7",
+      "when": 1781189893331,
+      "tag": "0012_lame_sentinel",
+      "breakpoints": true
     }
   ]
 }

mvp/b2c/package-lock.json

@@ -11,6 +11,7 @@
         "@react-pdf/renderer": "^4.5.1",
         "@tailwindcss/postcss": "^4.3.0",
         "bcryptjs": "^3.0.3",
+        "driver.js": "^1.4.0",
         "drizzle-orm": "^0.45.2",
         "next": "16.2.6",
         "nodemailer": "^8.0.10",
@@ -4546,6 +4547,12 @@
         "url": "https://dotenvx.com"
       }
     },
+    "node_modules/driver.js": {
+      "version": "1.4.0",
+      "resolved": "https://registry.npmjs.org/driver.js/-/driver.js-1.4.0.tgz",
+      "integrity": "sha512-Gm64jm6PmcU+si21sQhBrTAM1JvUrR0QhNmjkprNLxohOBzul9+pNHXgQaT9lW84gwg9GMLB3NZGuGolsz5uew==",
+      "license": "MIT"
+    },
     "node_modules/drizzle-kit": {
       "version": "0.31.10",
       "resolved": "https://registry.npmjs.org/drizzle-kit/-/drizzle-kit-0.31.10.tgz",

mvp/b2c/package.json

@@ -21,6 +21,7 @@
     "@react-pdf/renderer": "^4.5.1",
     "@tailwindcss/postcss": "^4.3.0",
     "bcryptjs": "^3.0.3",
+    "driver.js": "^1.4.0",
     "drizzle-orm": "^0.45.2",
     "next": "16.2.6",
     "nodemailer": "^8.0.10",

mvp/b2c/src/app/[slug]/page.tsx

@@ -46,7 +46,7 @@ export default async function FunnelPage({ params }: { params: Promise<{ slug: s
       className={theme.heading === 'serif' ? 'theme-serif' : undefined}
       style={themeStyle(tenant.themePreset, tenant.themeColor)}
     >
-      <TenantBrand nombreEmpresa={tenant.nombreEmpresa} logoUrl={tenant.logoUrl} showLogin />
+      <TenantBrand nombreEmpresa={tenant.nombreEmpresa} logoUrl={tenant.logoUrl} />
       <main id="main-content">
         <Hero slug={tenant.slug} />
         <ReformaSlider />

mvp/b2c/src/app/api/leads/[id]/analizar/route.ts

@@ -0,0 +1,14 @@
+import { autorizado, jsonResponse } from '@/lib/api/funnel-auth';
+import { analizarConversacion } from '@/lib/funnel/analizar-conversacion';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+// Post-análisis: lee toda la conversación de WhatsApp del lead, extrae los datos clave con un LLM y
+// los persiste en el lead. Lo llama el bot al cerrar la cualificación (o se puede invocar a posteriori).
+export async function POST(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  if (!autorizado(req)) return jsonResponse({ ok: false, error: 'No autorizado.' }, 401);
+  const { id } = await params;
+  const resultado = await analizarConversacion(id);
+  return jsonResponse(resultado, resultado.ok ? 200 : 422);
+}

mvp/b2c/src/app/api/leads/[id]/conversacion/route.ts

@@ -1,13 +1,29 @@
 import { eq } from 'drizzle-orm';
 import { db } from '@/db';
 import { leads, conversacionWhatsapp } from '@/db/schema';
-import { jsonResponse } from '@/lib/api/funnel-auth';
+import { autorizado, jsonResponse } from '@/lib/api/funnel-auth';
 import { validarBotRequest } from '@/lib/api/bot-request';
 import { conversacionSchema } from '@/lib/funnel/bot-schemas';
 
 export const runtime = 'nodejs';
 export const dynamic = 'force-dynamic';
 
+// Historial de la conversación de WhatsApp (orden cronológico) para que el bot recupere el contexto.
+export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  if (!autorizado(req)) return jsonResponse({ ok: false, error: 'No autorizado.' }, 401);
+  const { id } = await params;
+  const turnos = await db
+    .select({
+      rol: conversacionWhatsapp.rol,
+      mensaje: conversacionWhatsapp.mensaje,
+      createdAt: conversacionWhatsapp.createdAt,
+    })
+    .from(conversacionWhatsapp)
+    .where(eq(conversacionWhatsapp.leadId, id))
+    .orderBy(conversacionWhatsapp.createdAt);
+  return jsonResponse(turnos, 200);
+}
+
 // Añade un turno de la conversación de WhatsApp al historial del lead, y opcionalmente actualiza
 // el estado del mensaje (estado_wa) y el paso del bot (bot_step) en el lead.
 export async function POST(req: Request, { params }: { params: Promise<{ id: string }> }) {

mvp/b2c/src/app/api/leads/[id]/route.ts

@@ -0,0 +1,34 @@
+import { eq } from 'drizzle-orm';
+import { db } from '@/db';
+import { leads } from '@/db/schema';
+import { autorizado, jsonResponse } from '@/lib/api/funnel-auth';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+// Estado del lead para el bot de WhatsApp: le permite retomar la conversación (botStep, viabilidad,
+// extracción en crudo) tras un reinicio sin perder contexto. Devuelve el objeto plano (no envuelto).
+export async function GET(req: Request, { params }: { params: Promise<{ id: string }> }) {
+  if (!autorizado(req)) return jsonResponse({ ok: false, error: 'No autorizado.' }, 401);
+  const { id } = await params;
+
+  const [lead] = await db
+    .select({
+      id: leads.id,
+      nombre: leads.nombre,
+      telefono: leads.telefono,
+      botStep: leads.botStep,
+      estadoWa: leads.estadoWa,
+      espacio: leads.espacio,
+      rangoM2: leads.rangoM2,
+      estilo: leads.estilo,
+      presupuestoDeclarado: leads.presupuestoDeclarado,
+      viable: leads.viable,
+    })
+    .from(leads)
+    .where(eq(leads.id, id))
+    .limit(1);
+
+  if (!lead) return jsonResponse({ ok: false, error: 'Lead no encontrado.' }, 404);
+  return jsonResponse(lead, 200);
+}

mvp/b2c/src/app/api/leads/by-phone/route.ts

@@ -0,0 +1,37 @@
+import { desc, like } from 'drizzle-orm';
+import { db } from '@/db';
+import { leads } from '@/db/schema';
+import { autorizado, jsonResponse } from '@/lib/api/funnel-auth';
+
+export const runtime = 'nodejs';
+export const dynamic = 'force-dynamic';
+
+// Busca el lead más reciente por teléfono (comparando los últimos 9 dígitos, ignorando prefijos y
+// formato). Lo usa el bot de WhatsApp para recuperar el leadId de un mensaje entrante cuando no
+// tiene la sesión en memoria (p. ej. tras un reinicio del contenedor).
+export async function GET(req: Request) {
+  if (!autorizado(req)) return jsonResponse({ ok: false, error: 'No autorizado.' }, 401);
+
+  const tel = (new URL(req.url).searchParams.get('telefono') ?? '').replace(/\D/g, '');
+  if (tel.length < 6) return jsonResponse({ ok: false, error: 'telefono inválido.' }, 422);
+  const last9 = tel.slice(-9);
+
+  const [lead] = await db
+    .select({
+      id: leads.id,
+      nombre: leads.nombre,
+      telefono: leads.telefono,
+      botStep: leads.botStep,
+      viable: leads.viable,
+    })
+    .from(leads)
+    .where(like(leads.telefono, `%${last9}%`))
+    .orderBy(desc(leads.createdAt))
+    .limit(1);
+
+  if (!lead) return jsonResponse({ ok: false, error: 'Lead no encontrado.' }, 404);
+  return jsonResponse(
+    { leadId: lead.id, nombre: lead.nombre, telefono: lead.telefono, botStep: lead.botStep, viable: lead.viable },
+    200,
+  );
+}

mvp/b2c/src/app/api/retell/webhook/route.ts

@@ -1,7 +1,9 @@
 import { desc, eq, like } from 'drizzle-orm';
 import { db } from '@/db';
-import { leads, leadPipelineEventos } from '@/db/schema';
+import { leads, leadPipelineEventos, tenants } from '@/db/schema';
 import { obtenerLlamada, descargarGrabacion } from '@/lib/voice/retell';
+import { analizarTranscripcion } from '@/lib/funnel/analizar-conversacion';
+import { pedirFotosWhatsapp } from '@/lib/webhooks';
 
 export const runtime = 'nodejs';
 export const dynamic = 'force-dynamic';
@@ -77,5 +79,44 @@ export async function POST(req: Request): Promise<Response> {
     },
   });
 
-  return ok({ matched: true, leadId, transcript: Boolean(detalle.transcript), grabacion: Boolean(audioUrl) });
+  // Mismo cerebro de captura que WhatsApp: extrae los campos clave de la transcripción de la llamada.
+  const analisis = detalle.transcript
+    ? await analizarTranscripcion(leadId, detalle.transcript, 'llamada')
+    : { ok: false as const, error: 'sin transcripción' };
+
+  // Cross-canal: tras la llamada, Luisa escribe al lead por WhatsApp, referencia lo hablado y le
+  // pide las fotos (el agente de voz le dijo que las enviara por ahí).
+  let fotosPedidas = false;
+  if (analisis.ok) {
+    const [info] = await db
+      .select({ nombre: leads.nombre, telefono: leads.telefono, tenantId: leads.tenantId })
+      .from(leads)
+      .where(eq(leads.id, leadId))
+      .limit(1);
+    if (info) {
+      const [t] = await db
+        .select({ nombre: tenants.nombreEmpresa })
+        .from(tenants)
+        .where(eq(tenants.id, info.tenantId))
+        .limit(1);
+      const tipo = (analisis.perfil?.tipoReforma as string | undefined) ?? null;
+      const contexto = tipo ? `la reforma de tu ${tipo}` : 'tu reforma';
+      fotosPedidas = await pedirFotosWhatsapp({
+        leadId,
+        telefono: info.telefono,
+        nombre: info.nombre,
+        empresa: t?.nombre ?? 'Reformix',
+        contexto,
+      });
+    }
+  }
+
+  return ok({
+    matched: true,
+    leadId,
+    transcript: Boolean(detalle.transcript),
+    grabacion: Boolean(audioUrl),
+    analizado: analisis.ok,
+    fotosPedidas,
+  });
 }

mvp/b2c/src/app/globals.css

@@ -58,6 +58,20 @@
   --transition-fast: 150ms ease;
   --transition-base: 250ms ease;
   --transition-slow: 400ms ease;
+
+  /* Animations (usar con motion-safe: para respetar prefers-reduced-motion) */
+  --animate-fade-up: fade-up 0.7s cubic-bezier(0.16, 1, 0.3, 1) both;
+
+  @keyframes fade-up {
+    from {
+      opacity: 0;
+      transform: translateY(14px);
+    }
+    to {
+      opacity: 1;
+      transform: none;
+    }
+  }
 }
 
 @layer base {

mvp/b2c/src/app/panel/[id]/page.tsx

@@ -2,6 +2,7 @@ import Link from 'next/link';
 import { headers } from 'next/headers';
 import { notFound } from 'next/navigation';
 import { getLead } from '@/db/queries';
+import { getPricingConfigFor } from '@/db/pricing-queries';
 import EstadoControl from '@/components/panel/EstadoControl';
 import ConceptosEditor from '@/components/panel/ConceptosEditor';
 import OpinionLinkBox from '@/components/panel/OpinionLinkBox';
@@ -19,9 +20,20 @@ import type { BudgetResult } from '@/budget/types';
 
 export const dynamic = 'force-dynamic';
 
-function Section({ title, children }: { title: string; children: React.ReactNode }) {
+function Section({
+  title,
+  children,
+  tour,
+}: {
+  title: string;
+  children: React.ReactNode;
+  tour?: string;
+}) {
   return (
-    <section className="bg-white border border-gray-200 rounded-xl p-5 flex flex-col gap-3">
+    <section
+      data-tour={tour}
+      className="bg-white border border-gray-200 rounded-xl p-5 flex flex-col gap-3"
+    >
       <h2 className="text-xs uppercase tracking-wide font-semibold text-gray-400">{title}</h2>
       {children}
     </section>
@@ -41,6 +53,14 @@ export default async function LeadDetailPage({ params }: { params: Promise<{ id:
   const prefs = lead.preferencesSnapshot as import('@/lib/voice/preferences').AbstractedPreferences | null;
   const yaEnviado = lead.pipelineStage === 'whatsapp_entregado';
 
+  // Baremo de rentabilidad del reformista (informativo): si el presupuesto estimado no lo alcanza,
+  // se marca en rojo. null = sin baremo o sin presupuesto aún (no se marca nada).
+  const baremoMinimo = (await getPricingConfigFor(lead.tenantId)).baremoMinimo ?? null;
+  const pasaBaremo =
+    baremoMinimo != null && lead.presupuestoEstimado != null
+      ? lead.presupuestoEstimado >= baremoMinimo
+      : null;
+
   const h = await headers();
   const host = h.get('x-forwarded-host') ?? h.get('host') ?? 'reformix.dv3.com.es';
   const proto = h.get('x-forwarded-proto') ?? 'https';
@@ -62,17 +82,26 @@ export default async function LeadDetailPage({ params }: { params: Promise<{ id:
               {lead.provincia ?? '—'} · entró {formatFecha(lead.createdAt)}
             </p>
           </div>
-          <div className="text-right">
+          <div className="text-right" data-tour="ficha-presupuesto">
             <div className="text-xs text-gray-400">Presupuesto estimado</div>
-            <div className="text-2xl font-black text-black">{formatEuros(lead.presupuestoEstimado)}</div>
+            <div className={`text-2xl font-black ${pasaBaremo === false ? 'text-red-600' : 'text-black'}`}>
+              {formatEuros(lead.presupuestoEstimado)}
+            </div>
+            {pasaBaremo === false && baremoMinimo != null && (
+              <div className="mt-0.5 text-xs font-semibold text-red-600">
+                Por debajo de tu baremo ({formatEuros(baremoMinimo)})
+              </div>
+            )}
           </div>
         </div>
+        <div data-tour="ficha-estado">
           <EstadoControl
             leadId={lead.id}
             estado={lead.estado}
             presupuestoEstimado={lead.presupuestoEstimado}
           />
         </div>
+      </div>
 
       {/* Solicitar opinión al cliente */}
       <Section title="Opinión del cliente">
@@ -164,7 +193,7 @@ export default async function LeadDetailPage({ params }: { params: Promise<{ id:
         </Section>
 
         {/* 4. Render */}
-        <Section title="Render generado">
+        <Section title="Render generado" tour="ficha-render">
           {lead.renderUrl ? (
             // eslint-disable-next-line @next/next/no-img-element
             <img src={lead.renderUrl} alt="Render de la reforma" className="w-full rounded-lg object-cover" />
@@ -311,7 +340,7 @@ export default async function LeadDetailPage({ params }: { params: Promise<{ id:
       )}
 
       {/* Presupuesto desglosado */}
-      <Section title="Presupuesto desglosado">
+      <Section title="Presupuesto desglosado" tour="ficha-desglose">
         <div className="flex flex-wrap items-center gap-3">
           <form action={recalcularPresupuesto.bind(null, lead.id)}>
             <button

mvp/b2c/src/app/panel/layout.tsx

@@ -5,6 +5,7 @@ import { db } from '@/db';
 import { tenants } from '@/db/schema';
 import { eq } from 'drizzle-orm';
 import AppNav from '@/components/AppNav';
+import PanelTour from '@/components/panel/PanelTour';
 
 const PANEL_LINKS = [
   { href: '/panel', label: 'Leads', icon: 'leads' },
@@ -44,6 +45,7 @@ export default async function PanelLayout({ children }: { children: React.ReactN
         </div>
       </header>
       <main className="max-w-6xl mx-auto px-6 py-8 pb-24 sm:pb-8">{children}</main>
+      <PanelTour />
     </div>
   );
 }

mvp/b2c/src/app/panel/page.tsx

@@ -69,7 +69,7 @@ export default async function PanelPage({
       </div>
 
       {/* Filtros por estado */}
-      <div className="flex flex-wrap gap-2">
+      <div className="flex flex-wrap gap-2" data-tour="leads-filtros">
         {FILTROS.map((f) => {
           const active = f.value === filtro;
           const count = f.value === 'todos' ? resumen.total : resumen.porEstado[f.value] ?? 0;
@@ -89,7 +89,9 @@ export default async function PanelPage({
         })}
       </div>
 
+      <div data-tour="leads-tabla">
         <LeadsView leads={leadsView} />
       </div>
+    </div>
   );
 }

mvp/b2c/src/app/panel/precios/actions.ts

@@ -93,6 +93,19 @@ export async function actualizarExtras(formData: FormData) {
   revalidatePath('/panel/precios');
 }
 
+export async function actualizarBaremo(formData: FormData) {
+  const tenantId = await getTenantId();
+  const raw = formData.get('baremoMinimo');
+  const txt = typeof raw === 'string' ? raw.trim() : '';
+  // Vacío = sin baremo (null). Con valor = euros → céntimos.
+  const baremoMinimo = txt === '' ? null : eurosToCents(raw, 'baremo de rentabilidad');
+  await db
+    .update(pricingConfig)
+    .set({ baremoMinimo, updatedAt: new Date() })
+    .where(eq(pricingConfig.tenantId, tenantId));
+  revalidatePath('/panel/precios');
+}
+
 export async function actualizarEnvio(formData: FormData) {
   const tenantId = await getTenantId();
   const modo = formData.get('modo');

mvp/b2c/src/app/panel/precios/page.tsx

@@ -5,6 +5,7 @@ import {
   borrarMaterial,
   actualizarConfig,
   actualizarExtras,
+  actualizarBaremo,
   actualizarEnvio,
   importarCatalogoCsv,
 } from './actions';
@@ -81,7 +82,7 @@ export default async function PreciosPage() {
       </section>
 
       {/* Config general */}
-      <section className="bg-white rounded-xl border border-gray-200 p-6">
+      <section className="bg-white rounded-xl border border-gray-200 p-6" data-tour="precios-config">
         <h2 className="font-bold text-black mb-4">Configuración general</h2>
         <form action={actualizarConfig} className="grid grid-cols-2 md:grid-cols-5 gap-3 items-end">
           <label className="text-sm">
@@ -120,6 +121,34 @@ export default async function PreciosPage() {
         </form>
       </section>
 
+      {/* Baremo de rentabilidad */}
+      <section className="bg-white rounded-xl border border-gray-200 p-6" data-tour="precios-baremo">
+        <h2 className="font-bold text-black mb-1">Baremo de rentabilidad</h2>
+        <p className="text-sm text-gray-500 mb-4">
+          Importe mínimo de un trabajo para que te resulte rentable. Es solo orientativo para ti: en la
+          ficha de cada lead verás marcados en otro color los presupuestos que no lleguen a este valor.
+          No afecta a lo que ve el cliente ni a la conversación de los agentes. Déjalo vacío para no usar
+          baremo.
+        </p>
+        <form action={actualizarBaremo} className="flex flex-wrap items-end gap-3">
+          <label className="text-sm">
+            <span className="block text-xs text-gray-500 mb-1">Baremo mínimo (€)</span>
+            <input
+              name="baremoMinimo"
+              type="number"
+              step="1"
+              min="0"
+              defaultValue={config.baremoMinimo != null ? config.baremoMinimo / 100 : ''}
+              placeholder="Sin baremo"
+              className="w-40 border border-gray-300 rounded-lg px-2 py-1.5"
+            />
+          </label>
+          <button className="bg-primary-700 text-white rounded-lg px-4 py-2 text-sm font-medium">
+            Guardar baremo
+          </button>
+        </form>
+      </section>
+
       {/* Extras fijos */}
       <section className="bg-white rounded-xl border border-gray-200 p-6">
         <h2 className="font-bold text-black mb-1">Extras fijos</h2>
@@ -256,7 +285,7 @@ export default async function PreciosPage() {
       })}
 
       {/* Import CSV */}
-      <section className="bg-white rounded-xl border border-gray-200 p-6">
+      <section className="bg-white rounded-xl border border-gray-200 p-6" data-tour="precios-catalogo">
         <h2 className="font-bold text-black mb-2">Importar catálogo (CSV)</h2>
         <p className="text-xs text-gray-500 mb-3">
           Cabecera: <code className="break-all">categoria,nombre,calidad,precio,unidad,descriptor_render,sku</code>. El

mvp/b2c/src/app/solicitud/[id]/page.tsx

@@ -1,82 +1,295 @@
 import Link from 'next/link';
 import { notFound } from 'next/navigation';
 import { getPublicLead } from '@/lib/funnel/public-queries';
+import { resolveTheme, themeStyle } from '@/lib/funnel/themes';
 import TenantBrand from '@/components/funnel/TenantBrand';
 
 export const dynamic = 'force-dynamic';
 
+const BRAND = 'var(--brand, #0a0a0a)';
+const BRAND_CONTRAST = 'var(--brand-contrast, #ffffff)';
+
+function IconLlamada() {
+  return (
+    <svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+      <path
+        d="M22 16.92v3a2 2 0 0 1-2.18 2 19.79 19.79 0 0 1-8.63-3.07 19.5 19.5 0 0 1-6-6 19.79 19.79 0 0 1-3.07-8.67A2 2 0 0 1 4.11 2h3a2 2 0 0 1 2 1.72 12.84 12.84 0 0 0 .7 2.81 2 2 0 0 1-.45 2.11L8.09 9.91a16 16 0 0 0 6 6l1.27-1.27a2 2 0 0 1 2.11-.45 12.84 12.84 0 0 0 2.81.7A2 2 0 0 1 22 16.92z"
+        stroke="currentColor"
+        strokeWidth="2"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
+function IconWhatsapp() {
+  return (
+    <svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+      <path
+        d="M21 11.5a8.38 8.38 0 0 1-.9 3.8 8.5 8.5 0 0 1-7.6 4.7 8.38 8.38 0 0 1-3.8-.9L3 21l1.9-5.7a8.38 8.38 0 0 1-.9-3.8 8.5 8.5 0 0 1 4.7-7.6 8.38 8.38 0 0 1 3.8-.9h.5a8.48 8.48 0 0 1 8 8v.5z"
+        stroke="currentColor"
+        strokeWidth="2"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
+function IconFormulario() {
+  return (
+    <svg width="24" height="24" viewBox="0 0 24 24" fill="none" aria-hidden="true">
+      <path
+        d="M14 2H6a2 2 0 0 0-2 2v16a2 2 0 0 0 2 2h12a2 2 0 0 0 2-2V8z"
+        stroke="currentColor"
+        strokeWidth="2"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+      <path
+        d="M14 2v6h6M16 13H8M16 17H8M10 9H8"
+        stroke="currentColor"
+        strokeWidth="2"
+        strokeLinecap="round"
+        strokeLinejoin="round"
+      />
+    </svg>
+  );
+}
+
 const CANALES = [
   {
     slug: 'llamada',
-    icon: '📞',
+    icon: <IconLlamada />,
     titulo: 'Que te llamemos',
     descripcion:
       'Un asistente te llama y te hace unas preguntas rápidas. Lo más cómodo: no escribes nada.',
     cta: 'Quiero que me llamen',
+    badge: 'La más rápida',
   },
   {
     slug: 'whatsapp',
-    icon: '💬',
+    icon: <IconWhatsapp />,
     titulo: 'Por WhatsApp',
-    descripcion:
-      'Seguimos por chat a tu ritmo. Puedes mandar fotos y notas cuando quieras.',
+    descripcion: 'Seguimos por chat a tu ritmo. Puedes mandar fotos y notas cuando quieras.',
     cta: 'Seguir por WhatsApp',
+    badge: null,
   },
   {
     slug: 'formulario',
-    icon: '📝',
+    icon: <IconFormulario />,
     titulo: 'Rellenar un formulario',
     descripcion:
       'Tú lo cuentas zona por zona y subes las fotos. Recibes el presupuesto al instante.',
     cta: 'Rellenar el formulario',
+    badge: null,
   },
 ] as const;
 
+const PASOS_DESPUES = [
+  {
+    titulo: 'Nos cuentas tu reforma a tu manera',
+    body: 'Fotos, medidas, gustos. Cuanto más nos cuentes, más se parecerá el resultado a lo que tienes en la cabeza.',
+  },
+  {
+    titulo: 'Render + presupuesto en minutos',
+    body: 'Ves tu espacio ya reformado en imágenes, con un presupuesto orientativo desglosado partida a partida.',
+  },
+  // El tercer paso interpola el nombre del reformista; se monta en el componente.
+] as const;
+
+function Stepper() {
+  const conectores = 'h-px flex-1 min-w-4';
+  return (
+    <ol className="flex items-center gap-2.5 sm:gap-3" aria-label="Progreso de tu solicitud">
+      <li className="flex items-center gap-2 shrink-0">
+        <span
+          className="w-6 h-6 rounded-full flex items-center justify-center shrink-0"
+          style={{ backgroundColor: BRAND, color: BRAND_CONTRAST }}
+        >
+          <svg width="12" height="12" viewBox="0 0 32 32" fill="none" aria-hidden="true">
+            <path
+              d="M6 16l7 7L26 9"
+              stroke="currentColor"
+              strokeWidth="4"
+              strokeLinecap="round"
+              strokeLinejoin="round"
+            />
+          </svg>
+        </span>
+        <span className="hidden sm:inline text-xs font-semibold text-gray-600">Tus datos</span>
+      </li>
+      <li aria-hidden="true" className={conectores} style={{ backgroundColor: BRAND }} />
+      <li className="flex items-center gap-2 shrink-0" aria-current="step">
+        <span
+          className="w-6 h-6 rounded-full text-[11px] font-black flex items-center justify-center shrink-0"
+          style={{ backgroundColor: BRAND, color: BRAND_CONTRAST }}
+        >
+          2
+        </span>
+        <span className="text-xs font-bold text-black">Tu reforma</span>
+      </li>
+      <li aria-hidden="true" className={`${conectores} bg-gray-200`} />
+      <li className="flex items-center gap-2 shrink-0">
+        <span className="w-6 h-6 rounded-full bg-white border border-gray-300 text-[11px] font-bold text-gray-400 flex items-center justify-center shrink-0">
+          3
+        </span>
+        <span className="hidden sm:inline text-xs font-semibold text-gray-400">
+          Render + presupuesto
+        </span>
+      </li>
+    </ol>
+  );
+}
+
 export default async function ChooserPage({ params }: { params: Promise<{ id: string }> }) {
   const { id } = await params;
   const data = await getPublicLead(id);
   if (!data) notFound();
 
   const { lead, tenant } = data;
+  const theme = resolveTheme(tenant?.themePreset, tenant?.themeColor);
+  const nombrePila = lead.nombre.split(' ')[0];
+  const nombreReformista = tenant?.nombreEmpresa ?? 'el reformista';
+
+  const pasosDespues = [
+    ...PASOS_DESPUES,
+    {
+      titulo: 'Visita gratuita para el presupuesto final',
+      body: `Si te convence, acuerdas una visita con ${nombreReformista}: ve la obra, la mide con detalle y te confirma el precio definitivo. Sin compromiso.`,
+    },
+  ];
 
   return (
-    <>
+    <div
+      className={theme.heading === 'serif' ? 'theme-serif' : undefined}
+      style={themeStyle(tenant?.themePreset, tenant?.themeColor)}
+    >
       {tenant && <TenantBrand nombreEmpresa={tenant.nombreEmpresa} logoUrl={tenant.logoUrl} />}
-      <div className="container py-10 max-w-2xl flex flex-col gap-6">
-        <div className="flex flex-col gap-2">
+
+      <div className="relative overflow-hidden">
+        {/* Halo sutil con el color de marca del reformista */}
+        <div
+          aria-hidden="true"
+          className="absolute inset-x-0 top-0 h-80 pointer-events-none"
+          style={{
+            background: `radial-gradient(60% 100% at 50% 0%, color-mix(in srgb, ${BRAND} 8%, transparent), transparent 70%)`,
+          }}
+        />
+
+        <div className="container relative max-w-4xl py-10 md:py-14 flex flex-col gap-8 md:gap-10">
+          <div className="motion-safe:animate-fade-up">
+            <Stepper />
+          </div>
+
+          <header
+            className="flex flex-col gap-3 max-w-2xl motion-safe:animate-fade-up"
+            style={{ animationDelay: '80ms' }}
+          >
             <span className="text-xs font-semibold uppercase tracking-widest text-gray-400">
               Elige cómo seguir
             </span>
-          <h1 className="text-2xl font-black tracking-tight text-black">
-            ¿Cómo prefieres contarnos tu reforma, {lead.nombre.split(' ')[0]}?
+            <h1 className="text-3xl md:text-4xl font-black tracking-tight text-black leading-[1.1] text-balance">
+              ¿Cómo prefieres contarnos tu reforma, {nombrePila}?
             </h1>
-          <p className="text-sm text-gray-500 leading-relaxed">
-            Tú eliges. Por cualquiera de las tres nos das lo que necesitamos para preparar tu render
-            y tu presupuesto.
+            <p className="text-sm md:text-base text-gray-500 leading-relaxed">
+              Tú eliges. Por cualquiera de las tres nos das lo que necesitamos para preparar tu
+              render y tu presupuesto.
             </p>
-        </div>
+          </header>
 
-        <div className="flex flex-col gap-3">
-          {CANALES.map((c) => (
+          <div className="grid gap-3 md:grid-cols-3 md:gap-4">
+            {CANALES.map((c, i) => (
               <Link
                 key={c.slug}
                 href={`/solicitud/${id}/${c.slug}`}
-              className="group bg-white border border-gray-200 rounded-xl p-5 shadow-sm flex items-center gap-4 transition-all hover:border-black hover:shadow-md"
+                className="group relative flex items-start gap-4 md:flex-col md:gap-5 bg-white border border-gray-200 rounded-2xl p-5 md:p-6 shadow-sm transition-all duration-250 hover:-translate-y-0.5 hover:border-[color:var(--brand,#0a0a0a)] hover:shadow-[0_16px_40px_-12px_rgba(0,0,0,0.18)] focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-[color:var(--brand,#0a0a0a)] focus-visible:ring-offset-2 motion-safe:animate-fade-up"
+                style={{ animationDelay: `${160 + i * 80}ms` }}
+              >
+                {c.badge && (
+                  <span
+                    className="absolute top-0 right-5 -translate-y-1/2 px-2.5 py-1 rounded-full text-[10px] font-bold uppercase tracking-widest"
+                    style={{ backgroundColor: BRAND, color: BRAND_CONTRAST }}
+                  >
+                    {c.badge}
+                  </span>
+                )}
+                <span
+                  className="w-12 h-12 rounded-xl flex items-center justify-center shrink-0 transition-transform duration-250 group-hover:scale-105"
+                  style={{ backgroundColor: BRAND, color: BRAND_CONTRAST }}
+                  aria-hidden="true"
                 >
-              <span className="text-3xl shrink-0" aria-hidden="true">
                   {c.icon}
                 </span>
-              <div className="flex flex-col gap-0.5 min-w-0">
-                <span className="text-base font-bold text-black">{c.titulo}</span>
-                <span className="text-sm text-gray-500 leading-snug">{c.descripcion}</span>
-                <span className="text-sm font-semibold text-[color:var(--brand,#0a0a0a)] mt-1">
-                  {c.cta} →
+                <span className="flex flex-col gap-1.5 min-w-0 flex-1">
+                  <h2 className="text-lg font-black tracking-tight text-black leading-snug">
+                    {c.titulo}
+                  </h2>
+                  <span className="text-sm text-gray-500 leading-relaxed">{c.descripcion}</span>
+                  <span
+                    className="flex items-center gap-1.5 text-sm font-bold mt-2 md:mt-auto md:pt-4"
+                    style={{ color: BRAND }}
+                  >
+                    {c.cta}
+                    <svg
+                      width="15"
+                      height="15"
+                      viewBox="0 0 16 16"
+                      fill="none"
+                      aria-hidden="true"
+                      className="transition-transform duration-250 group-hover:translate-x-1"
+                    >
+                      <path
+                        d="M2 8h12M10 4l4 4-4 4"
+                        stroke="currentColor"
+                        strokeWidth="2"
+                        strokeLinecap="round"
+                        strokeLinejoin="round"
+                      />
+                    </svg>
+                  </span>
                 </span>
-              </div>
               </Link>
             ))}
           </div>
+
+          <section
+            className="bg-white border border-gray-200 rounded-2xl p-6 md:p-8 shadow-sm motion-safe:animate-fade-up"
+            style={{ animationDelay: '420ms' }}
+            aria-labelledby="que-pasa-despues"
+          >
+            <h2
+              id="que-pasa-despues"
+              className="text-base md:text-lg font-black tracking-tight text-black"
+            >
+              Elijas lo que elijas, esto es lo que pasa después
+            </h2>
+            <ol className="relative mt-6 grid gap-6 md:grid-cols-3 md:gap-8">
+              {/* Línea que conecta los pasos en desktop */}
+              <div
+                aria-hidden="true"
+                className="hidden md:block absolute top-[15px] left-8 right-8 h-px bg-gray-200"
+              />
+              {pasosDespues.map((paso, i) => (
+                <li key={paso.titulo} className="relative flex items-start gap-4 md:flex-col">
+                  <span
+                    className="relative w-8 h-8 rounded-full text-[13px] font-black flex items-center justify-center shrink-0 ring-4 ring-white"
+                    style={{ backgroundColor: BRAND, color: BRAND_CONTRAST }}
+                    aria-hidden="true"
+                  >
+                    {i + 1}
+                  </span>
+                  <div className="flex flex-col gap-1 min-w-0">
+                    <h3 className="text-sm font-bold text-black leading-snug">{paso.titulo}</h3>
+                    <p className="text-sm text-gray-500 leading-relaxed">{paso.body}</p>
+                  </div>
+                </li>
+              ))}
+            </ol>
+          </section>
+        </div>
+      </div>
     </div>
-    </>
   );
 }

mvp/b2c/src/budget/types.ts

@@ -46,6 +46,7 @@ export interface PricingConfig {
   factorZona: Record<string, number>; // provincia -> multiplicador
   manoObra: Record<ManoObraKey, number>; // céntimos por m² de suelo
   extras?: ExtrasFijos; // importes fijos en céntimos
+  baremoMinimo?: number | null; // céntimos; trabajo mínimo rentable (informativo, no lo usan los agentes)
 }
 
 export interface BudgetInputs {

mvp/b2c/src/components/AppNav.tsx

@@ -116,6 +116,7 @@ export default function AppNav({ links }: { links: readonly AppNavLink[] }) {
           <Link
             key={l.href}
             href={l.href}
+            data-tour={`nav-${l.icon}`}
             className={active === l.href ? 'text-primary-700 font-semibold' : 'text-gray-500 hover:text-primary-700'}
           >
             {l.label}

mvp/b2c/src/components/funnel/GaleriaTrabajos.tsx

@@ -1,3 +1,6 @@
+'use client';
+
+import { useCallback, useEffect, useState } from 'react';
 import type { PublicGaleriaFoto } from '@/lib/funnel/public-queries';
 
 type GaleriaTrabajosProps = {
@@ -5,11 +8,37 @@ type GaleriaTrabajosProps = {
   nombreEmpresa: string;
 };
 
-// Galería de trabajos del reformista en su landing pública. Solo se muestra si
-// el reformista ha subido fotos desde su panel.
+// Galería de trabajos del reformista en su landing pública. Solo se muestra si el reformista ha
+// subido fotos desde su panel. Formato apaisado y, al pulsar una foto, se amplía en un lightbox
+// con navegación entre todas las imágenes.
 export default function GaleriaTrabajos({ fotos, nombreEmpresa }: GaleriaTrabajosProps) {
+  const [idx, setIdx] = useState<number | null>(null);
+
+  const cerrar = useCallback(() => setIdx(null), []);
+  const mover = useCallback(
+    (d: number) => setIdx((cur) => (cur === null ? cur : (cur + d + fotos.length) % fotos.length)),
+    [fotos.length],
+  );
+
+  useEffect(() => {
+    if (idx === null) return;
+    const onKey = (e: KeyboardEvent) => {
+      if (e.key === 'Escape') cerrar();
+      else if (e.key === 'ArrowRight') mover(1);
+      else if (e.key === 'ArrowLeft') mover(-1);
+    };
+    document.addEventListener('keydown', onKey);
+    document.body.style.overflow = 'hidden';
+    return () => {
+      document.removeEventListener('keydown', onKey);
+      document.body.style.overflow = '';
+    };
+  }, [idx, cerrar, mover]);
+
   if (fotos.length === 0) return null;
 
+  const actual = idx !== null ? fotos[idx] : null;
+
   return (
     <section id="galeria" className="bg-gray-50 section" aria-label="Galería de trabajos">
       <div className="container">
@@ -24,24 +53,31 @@ export default function GaleriaTrabajos({ fotos, nombreEmpresa }: GaleriaTrabajo
             Reformas que ya hemos hecho
           </h2>
           <p className="text-gray-500 mt-3 leading-relaxed">
-            Una muestra real del trabajo de {nombreEmpresa}. Calidad de acabados, plazos cumplidos.
+            Una muestra real del trabajo de {nombreEmpresa}. Toca cualquier imagen para verla en grande.
           </p>
         </div>
 
-        <div className="grid grid-cols-2 md:grid-cols-3 gap-3 md:gap-4">
-          {fotos.map((f) => (
+        <div className="grid grid-cols-1 sm:grid-cols-2 lg:grid-cols-3 gap-3 md:gap-4">
+          {fotos.map((f, i) => (
             <figure
               key={f.id}
-              className="group relative aspect-[4/3] overflow-hidden rounded-xl bg-gray-100 border border-gray-200"
+              className="group relative aspect-[3/2] overflow-hidden rounded-xl bg-gray-100 border border-gray-200"
+            >
+              <button
+                type="button"
+                onClick={() => setIdx(i)}
+                className="block h-full w-full cursor-zoom-in"
+                aria-label={`Ampliar ${f.titulo ?? `reforma de ${nombreEmpresa}`}`}
               >
                 {/* eslint-disable-next-line @next/next/no-img-element */}
                 <img
                   src={f.url}
                   alt={f.titulo ?? `Reforma de ${nombreEmpresa}`}
-                className="w-full h-full object-cover transition-transform duration-500 group-hover:scale-105"
+                  className="h-full w-full object-cover transition-transform duration-500 group-hover:scale-105"
                 />
+              </button>
               {f.titulo && (
-                <figcaption className="absolute inset-x-0 bottom-0 bg-gradient-to-t from-black/70 to-transparent p-3 text-white text-sm font-semibold opacity-0 group-hover:opacity-100 transition-opacity duration-300">
+                <figcaption className="pointer-events-none absolute inset-x-0 bottom-0 bg-gradient-to-t from-black/70 to-transparent p-3 text-white text-sm font-semibold opacity-0 group-hover:opacity-100 transition-opacity duration-300">
                   {f.titulo}
                 </figcaption>
               )}
@@ -49,6 +85,67 @@ export default function GaleriaTrabajos({ fotos, nombreEmpresa }: GaleriaTrabajo
           ))}
         </div>
       </div>
+
+      {actual && (
+        <div
+          className="fixed inset-0 z-[100] flex items-center justify-center bg-black/90 p-4 sm:p-8"
+          onClick={cerrar}
+          role="dialog"
+          aria-modal="true"
+          aria-label="Imagen ampliada"
+        >
+          <button
+            type="button"
+            onClick={cerrar}
+            aria-label="Cerrar"
+            className="absolute right-4 top-4 flex h-10 w-10 items-center justify-center rounded-full bg-white/15 text-2xl leading-none text-white hover:bg-white/30"
+          >
+            ×
+          </button>
+
+          {fotos.length > 1 && (
+            <button
+              type="button"
+              onClick={(e) => {
+                e.stopPropagation();
+                mover(-1);
+              }}
+              aria-label="Anterior"
+              className="absolute left-3 top-1/2 flex h-11 w-11 -translate-y-1/2 items-center justify-center rounded-full bg-white/15 text-3xl leading-none text-white hover:bg-white/30 sm:left-6"
+            >
+              ‹
+            </button>
+          )}
+
+          {/* eslint-disable-next-line @next/next/no-img-element */}
+          <img
+            src={actual.url}
+            alt={actual.titulo ?? `Reforma de ${nombreEmpresa}`}
+            onClick={(e) => e.stopPropagation()}
+            className="max-h-[86vh] max-w-[94vw] w-auto rounded-lg shadow-2xl"
+          />
+
+          {fotos.length > 1 && (
+            <button
+              type="button"
+              onClick={(e) => {
+                e.stopPropagation();
+                mover(1);
+              }}
+              aria-label="Siguiente"
+              className="absolute right-3 top-1/2 flex h-11 w-11 -translate-y-1/2 items-center justify-center rounded-full bg-white/15 text-3xl leading-none text-white hover:bg-white/30 sm:right-6"
+            >
+              ›
+            </button>
+          )}
+
+          {actual.titulo && (
+            <div className="pointer-events-none absolute inset-x-0 bottom-5 text-center text-sm font-medium text-white/85">
+              {actual.titulo}
+            </div>
+          )}
+        </div>
+      )}
     </section>
   );
 }

mvp/b2c/src/components/panel/PanelTour.tsx

@@ -0,0 +1,71 @@
+'use client';
+
+import { useEffect, useState } from 'react';
+import { usePathname } from 'next/navigation';
+import { driver, type DriveStep } from 'driver.js';
+import 'driver.js/dist/driver.css';
+import { tourForPath } from '@/lib/onboarding/panel-tour';
+
+const SEEN_PREFIX = 'reformix_tour_v1_';
+
+// Onboarding del panel con driver.js. Lanza el tour de la pestaña actual la primera vez que se
+// visita (flag por pestaña en localStorage) y deja un botón flotante para repetirlo. Los pasos
+// cuyo elemento no exista o esté oculto (p. ej. la nav de escritorio en móvil) se descartan.
+export default function PanelTour() {
+  const pathname = usePathname();
+  const [hayTour, setHayTour] = useState(false);
+
+  useEffect(() => {
+    const tour = tourForPath(pathname);
+    setHayTour(Boolean(tour));
+    if (!tour) return;
+    if (localStorage.getItem(SEEN_PREFIX + tour.key) === '1') return;
+
+    // Espera a que el contenido de la página esté montado antes de resaltar.
+    const t = setTimeout(() => {
+      localStorage.setItem(SEEN_PREFIX + tour.key, '1');
+      lanzar(tour.steps);
+    }, 700);
+    return () => clearTimeout(t);
+  }, [pathname]);
+
+  function visibles(steps: DriveStep[]): DriveStep[] {
+    return steps.filter((s) => {
+      const sel = s.element;
+      if (!sel || typeof sel !== 'string') return true; // paso centrado (intro)
+      const el = document.querySelector(sel) as HTMLElement | null;
+      return !!el && el.offsetParent !== null;
+    });
+  }
+
+  function lanzar(steps: DriveStep[]) {
+    const pasos = visibles(steps);
+    if (pasos.length === 0) return;
+    driver({
+      showProgress: true,
+      overlayColor: '#0b1220',
+      nextBtnText: 'Siguiente',
+      prevBtnText: 'Atrás',
+      doneBtnText: 'Listo',
+      progressText: '{{current}} de {{total}}',
+      steps: pasos,
+    }).drive();
+  }
+
+  function repetir() {
+    const tour = tourForPath(pathname);
+    if (tour) lanzar(tour.steps);
+  }
+
+  if (!hayTour) return null;
+  return (
+    <button
+      type="button"
+      onClick={repetir}
+      className="fixed right-4 bottom-20 sm:bottom-4 z-40 inline-flex items-center gap-1.5 rounded-full bg-primary-700 px-4 py-2 text-sm font-semibold text-white shadow-lg hover:bg-primary-900"
+      aria-label="Ver el tour de esta sección"
+    >
+      <span aria-hidden="true">❓</span> Tour
+    </button>
+  );
+}

mvp/b2c/src/db/pricing-queries.ts

@@ -42,6 +42,7 @@ export async function getPricingConfigFor(tenantId: string): Promise<PricingConf
       factorZona: {},
       manoObra: { ...MANO_OBRA_DEFAULT },
       extras: { ...EXTRAS_DEFAULT },
+      baremoMinimo: null,
     };
   }
   return {
@@ -49,6 +50,7 @@ export async function getPricingConfigFor(tenantId: string): Promise<PricingConf
     factorZona: row.factorZona,
     manoObra: { ...MANO_OBRA_DEFAULT, ...(row.manoObra as Record<ManoObraKey, number>) },
     extras: { ...EXTRAS_DEFAULT, ...(row.extras ?? {}) },
+    baremoMinimo: row.baremoMinimo ?? null,
   };
 }
 

mvp/b2c/src/db/schema.ts

@@ -396,6 +396,10 @@ export const pricingConfig = pgTable('pricing_config', {
     .$type<{ tuberias: number; boletin: number; distribucion: number }>()
     .notNull()
     .default({ tuberias: 0, boletin: 0, distribucion: 0 }),
+  // Baremo de rentabilidad (céntimos): importe mínimo que el reformista considera rentable. Solo
+  // informativo en el panel (marca en otro color los leads por debajo); los agentes NO lo usan para
+  // decidir nada. Null = sin baremo configurado.
+  baremoMinimo: integer('baremo_minimo'),
   updatedAt: timestamp('updated_at', { withTimezone: true }).notNull().defaultNow(),
 });
 

mvp/b2c/src/db/seed.ts

@@ -291,13 +291,13 @@ const SEED_LEADS: SeedLead[] = [
 const STAGE_ORDER = schema.pipelineStage.enumValues;
 
 async function main() {
-  const [existing] = await db
-    .select()
-    .from(schema.tenants)
-    .where(eq(schema.tenants.slug, 'reformas-ejemplo'))
-    .limit(1);
+  // Guard de seguridad: solo sembramos si la base de datos está VACÍA (sin ningún tenant). Antes se
+  // comprobaba un slug concreto ("reformas-ejemplo"); si ese tenant no estaba pero había otros
+  // (p. ej. una empresa creada por el reformista), el seed los TRUNCABA en cada deploy → pérdida de
+  // datos. Ahora cualquier tenant existente protege toda la DB. SEED_FORCE=1 fuerza el reseed (BORRA TODO).
+  const [existing] = await db.select({ id: schema.tenants.id }).from(schema.tenants).limit(1);
   if (existing && !process.env.SEED_FORCE) {
-    console.log('Ya hay datos (tenant "reformas-ejemplo"). Saltando seed. Usa SEED_FORCE=1 para forzar.');
+    console.log('La base de datos ya tiene datos (existe al menos un tenant). Saltando seed para no borrar nada. Usa SEED_FORCE=1 para forzar (¡BORRA TODO!).');
     await client.end();
     return;
   }

mvp/b2c/src/lib/ai/openrouter.ts

@@ -0,0 +1,41 @@
+import { env } from '@/lib/env';
+
+const OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions';
+
+export function openrouterConfigurado(): boolean {
+  return Boolean(env.OPENROUTER_API_KEY);
+}
+
+// Llamada de chat que espera una respuesta JSON. Parseo robusto (tolera fences ```json).
+export async function chatJSON(system: string, user: string, model?: string): Promise<unknown> {
+  const res = await fetch(OPENROUTER_URL, {
+    method: 'POST',
+    headers: {
+      Authorization: `Bearer ${env.OPENROUTER_API_KEY}`,
+      'Content-Type': 'application/json',
+      'HTTP-Referer': 'https://reformix.es',
+      'X-Title': 'Reformix App',
+    },
+    body: JSON.stringify({
+      model: model || env.OPENROUTER_MODEL_ANALISIS || 'anthropic/claude-haiku-4.5',
+      messages: [
+        { role: 'system', content: system },
+        { role: 'user', content: user },
+      ],
+      temperature: 0.1,
+      max_tokens: 700,
+    }),
+  });
+  if (!res.ok) {
+    throw new Error(`OpenRouter ${res.status}: ${(await res.text()).slice(0, 300)}`);
+  }
+  const data = await res.json();
+  const content: string = data?.choices?.[0]?.message?.content ?? '';
+  try {
+    return JSON.parse(content);
+  } catch {
+    const m = content.match(/\{[\s\S]*\}/);
+    if (m) return JSON.parse(m[0]);
+    throw new Error('La respuesta del modelo no es JSON');
+  }
+}

mvp/b2c/src/lib/env.ts

@@ -26,8 +26,13 @@ const schema = z.object({
   PERFIL_WEBHOOK_URL: opcional,
   WHATSAPP_WEBHOOK_URL: opcional,
   WHATSAPP_START_WEBHOOK_URL: opcional,
+  // Cross-canal: tras una llamada, pedir al lead las fotos por WhatsApp.
+  WHATSAPP_FOTOS_WEBHOOK_URL: opcional,
   // Base pública de la app, para construir enlaces (ej. el enlace al formulario en el email).
   APP_URL: opcional,
+  // LLM (OpenRouter) para el post-análisis de la conversación de WhatsApp.
+  OPENROUTER_API_KEY: opcional,
+  OPENROUTER_MODEL_ANALISIS: opcional,
 });
 
 export const env = schema.parse({
@@ -44,7 +49,10 @@ export const env = schema.parse({
   PERFIL_WEBHOOK_URL: process.env.PERFIL_WEBHOOK_URL,
   WHATSAPP_WEBHOOK_URL: process.env.WHATSAPP_WEBHOOK_URL,
   WHATSAPP_START_WEBHOOK_URL: process.env.WHATSAPP_START_WEBHOOK_URL,
+  WHATSAPP_FOTOS_WEBHOOK_URL: process.env.WHATSAPP_FOTOS_WEBHOOK_URL,
   APP_URL: process.env.APP_URL,
+  OPENROUTER_API_KEY: process.env.OPENROUTER_API_KEY,
+  OPENROUTER_MODEL_ANALISIS: process.env.OPENROUTER_MODEL_ANALISIS,
 });
 
 // Mínimo para lanzar una llamada saliente: clave de API + número de origen. El agente puede
@@ -71,3 +79,7 @@ export function whatsappWebhookConfigurado(): boolean {
 export function whatsappStartConfigurado(): boolean {
   return Boolean(env.WHATSAPP_START_WEBHOOK_URL);
 }
+
+export function whatsappFotosConfigurado(): boolean {
+  return Boolean(env.WHATSAPP_FOTOS_WEBHOOK_URL);
+}

mvp/b2c/src/lib/funnel/analizar-conversacion.ts

@@ -0,0 +1,111 @@
+import { asc, eq } from 'drizzle-orm';
+import { db } from '@/db';
+import { leads, conversacionWhatsapp, leadPipelineEventos } from '@/db/schema';
+import { chatJSON, openrouterConfigurado } from '@/lib/ai/openrouter';
+import { calcularPresupuestoLead } from '@/lib/funnel/calcular-presupuesto';
+
+export interface AnalisisResultado {
+  ok: boolean;
+  perfil?: Record<string, unknown>;
+  turnos?: number;
+  presupuesto?: number;
+  error?: string;
+}
+
+export type OrigenAnalisis = 'whatsapp' | 'llamada' | 'formulario';
+
+const SYSTEM = `Eres un analista que extrae datos estructurados de una conversación de cualificación de
+una reforma entre una agente y un CLIENTE (puede ser un chat de WhatsApp o la transcripción de una
+llamada). Lee toda la conversación y devuelve SOLO un objeto JSON válido (sin texto alrededor, sin
+markdown) con estas claves; usa null si el dato no aparece:
+
+{
+  "tipoReforma": "cocina|bano|salon|comedor|integral|otro",
+  "m2Suelo": número en m² (si el cliente da un rango, usa el punto medio: "menos de 10"→8,
+             "entre 10 y 20"→15, "entre 20 y 40"→30, "más de 40"→50),
+  "calidadGlobal": "basica|media|premium" (funcional/básico→basica, cuidado/buenos materiales→media,
+                   exclusivo/lujo/premium→premium; "moderno pero barato"→basica),
+  "urgencia": "alta|media|baja" (cuanto antes/pronto→alta, sin prisa/explorando→baja),
+  "presupuestoTarget": número en EUROS que declara el cliente (no céntimos), o null,
+  "viable": booleano (false si el presupuesto declarado es claramente insuficiente para la reforma),
+  "espacio": el espacio en crudo tal cual lo dijo el cliente,
+  "rangoM2": el tamaño en crudo tal cual lo dijo,
+  "estilo": el estilo/acabado en crudo tal cual lo dijo,
+  "presupuestoDeclarado": el presupuesto en crudo tal cual lo dijo,
+  "resumen": una frase con el resumen del lead
+}`;
+
+// Núcleo agnóstico del canal: dada una transcripción (de WhatsApp, llamada o formulario), extrae los
+// campos clave con un LLM y los persiste en el lead. Idempotente.
+export async function analizarTranscripcion(
+  leadId: string,
+  transcript: string,
+  origen: OrigenAnalisis,
+): Promise<AnalisisResultado> {
+  if (!openrouterConfigurado()) return { ok: false, error: 'OPENROUTER_API_KEY no configurada.' };
+  if (!transcript || !transcript.trim()) return { ok: false, error: 'Transcripción vacía.' };
+
+  const [lead] = await db.select({ id: leads.id }).from(leads).where(eq(leads.id, leadId)).limit(1);
+  if (!lead) return { ok: false, error: 'Lead no encontrado.' };
+
+  let ex: Record<string, unknown>;
+  try {
+    ex = (await chatJSON(SYSTEM, transcript)) as Record<string, unknown>;
+  } catch (err) {
+    return { ok: false, error: `Extracción falló: ${(err as Error).message}` };
+  }
+
+  const enumOk = (v: unknown, allowed: string[]) =>
+    typeof v === 'string' && allowed.includes(v) ? v : undefined;
+  const str = (v: unknown) => (typeof v === 'string' && v.trim() ? v.trim() : undefined);
+
+  const set: Record<string, unknown> = { updatedAt: new Date() };
+  const tipoReforma = enumOk(ex.tipoReforma, ['cocina', 'bano', 'salon', 'comedor', 'integral', 'otro']);
+  const calidadGlobal = enumOk(ex.calidadGlobal, ['basica', 'media', 'premium']);
+  const urgencia = enumOk(ex.urgencia, ['alta', 'media', 'baja']);
+  if (tipoReforma) set.tipoReforma = tipoReforma;
+  if (calidadGlobal) set.calidadGlobal = calidadGlobal;
+  if (urgencia) set.urgencia = urgencia;
+  if (typeof ex.m2Suelo === 'number' && ex.m2Suelo > 0) set.m2Suelo = ex.m2Suelo;
+  if (typeof ex.presupuestoTarget === 'number' && ex.presupuestoTarget >= 0) {
+    set.presupuestoTarget = Math.round(ex.presupuestoTarget * 100); // euros → céntimos
+  }
+  if (typeof ex.viable === 'boolean') set.viable = ex.viable;
+  if (str(ex.espacio)) set.espacio = str(ex.espacio);
+  if (str(ex.rangoM2)) set.rangoM2 = str(ex.rangoM2);
+  if (str(ex.estilo)) set.estilo = str(ex.estilo);
+  if (str(ex.presupuestoDeclarado)) set.presupuestoDeclarado = str(ex.presupuestoDeclarado);
+  if (str(ex.resumen)) set.tasteText = str(ex.resumen);
+  // El paso del bot solo aplica al canal conversacional de WhatsApp.
+  if (origen === 'whatsapp') set.botStep = 'presupuesto';
+
+  await db.update(leads).set(set).where(eq(leads.id, leadId));
+  await db.insert(leadPipelineEventos).values({
+    leadId,
+    stage: 'llamada_completada',
+    metadata: { origen: `analisis_${origen}`, campos: Object.keys(set) },
+  });
+
+  // Con los datos capturados, calcula ya el presupuesto orientativo (para que el PDF y el panel lo
+  // muestren). Best-effort: si faltan tipoReforma/m2 no se calcula, pero el resto sí queda guardado.
+  const presupuesto = await calcularPresupuestoLead(leadId);
+
+  return { ok: true, perfil: set, presupuesto: presupuesto.ok ? presupuesto.total : undefined };
+}
+
+// Entrada para WhatsApp: arma la transcripción desde conversacion_whatsapp y delega en el núcleo.
+export async function analizarConversacion(leadId: string): Promise<AnalisisResultado> {
+  const turnos = await db
+    .select({ rol: conversacionWhatsapp.rol, mensaje: conversacionWhatsapp.mensaje })
+    .from(conversacionWhatsapp)
+    .where(eq(conversacionWhatsapp.leadId, leadId))
+    .orderBy(asc(conversacionWhatsapp.createdAt));
+  if (turnos.length === 0) return { ok: false, error: 'El lead no tiene conversación.' };
+
+  const transcript = turnos
+    .map((t) => `${t.rol === 'user' ? 'CLIENTE' : 'LUISA'}: ${t.mensaje}`)
+    .join('\n');
+
+  const r = await analizarTranscripcion(leadId, transcript, 'whatsapp');
+  return { ...r, turnos: turnos.length };
+}

mvp/b2c/src/lib/funnel/calcular-presupuesto.ts

@@ -0,0 +1,62 @@
+import { eq } from 'drizzle-orm';
+import { db } from '@/db';
+import { leads } from '@/db/schema';
+import { getPricingConfigFor, getCatalogFor } from '@/db/pricing-queries';
+import { computeBudget } from '@/budget';
+import { deterministicExtractor } from '@/lib/voice/extractor';
+import { mergeIntoBudgetInputs, applyPreferences } from '@/lib/voice/apply';
+import type { RawCallData } from '@/lib/voice/preferences';
+
+export interface CalculoResultado {
+  ok: boolean;
+  total?: number;
+  error?: string;
+}
+
+// Calcula el presupuesto orientativo del lead con su catálogo (mismo motor que el orquestador) y lo
+// persiste en presupuestoEstimado + desgloseSnapshot. Reutilizable desde el post-análisis (WhatsApp/
+// llamada) y desde finalizar (antes de construir el PDF). Requiere al menos tipoReforma + m2Suelo.
+export async function calcularPresupuestoLead(leadId: string): Promise<CalculoResultado> {
+  const [lead] = await db.select().from(leads).where(eq(leads.id, leadId)).limit(1);
+  if (!lead) return { ok: false, error: 'Lead no encontrado.' };
+  if (!lead.tipoReforma || !lead.m2Suelo) {
+    return { ok: false, error: 'Faltan tipoReforma o m2Suelo para calcular el presupuesto.' };
+  }
+
+  const [config, catalog] = await Promise.all([
+    getPricingConfigFor(lead.tenantId),
+    getCatalogFor(lead.tenantId),
+  ]);
+
+  const raw: RawCallData = {
+    tipoReforma: lead.tipoReforma,
+    m2Suelo: lead.m2Suelo ?? null,
+    calidad: lead.calidadGlobal ?? null,
+    estructural: lead.estructural,
+    urgencia: lead.urgencia ?? null,
+    presupuestoTarget: lead.presupuestoTarget ?? null,
+    tasteText: lead.tasteText ?? '',
+  };
+  const prefs = deterministicExtractor.extract(raw, catalog);
+  const inputs = mergeIntoBudgetInputs(prefs, {
+    tipoReforma: lead.tipoReforma,
+    m2Suelo: lead.m2Suelo ?? null,
+    alturaTecho: lead.alturaTecho ?? null,
+    provincia: lead.provincia ?? null,
+    anteriorA2000: lead.anteriorA2000,
+    cambioDistribucion: lead.cambioDistribucion,
+  });
+  const result = applyPreferences(computeBudget(inputs, config, catalog), prefs);
+
+  await db
+    .update(leads)
+    .set({
+      presupuestoEstimado: result.total,
+      desgloseSnapshot: { stage: 'presupuesto_generado', result },
+      preferencesSnapshot: prefs,
+      updatedAt: new Date(),
+    })
+    .where(eq(leads.id, leadId));
+
+  return { ok: true, total: result.total };
+}

mvp/b2c/src/lib/funnel/finalizar.ts

@@ -6,6 +6,7 @@ import { enviarPresupuestoEmail } from '@/lib/email/mailer';
 import { notificarFlujoWhatsapp } from '@/lib/webhooks';
 import { resolveTheme } from '@/lib/funnel/themes';
 import { normalizarTelefonoEs } from '@/lib/voice/retell';
+import { calcularPresupuestoLead } from '@/lib/funnel/calcular-presupuesto';
 
 export type ResultadoFinalizar = {
   ok: boolean;
@@ -18,6 +19,10 @@ export type ResultadoFinalizar = {
 // flujo externo. Entrega real (la rama simulada de orchestrator.ts:Paso 7 es solo el estado
 // intermedio del funnel). Best-effort en email/WhatsApp: el lead avanza igualmente.
 export async function finalizarYEntregar(leadId: string): Promise<ResultadoFinalizar> {
+  // Asegura el presupuesto orientativo ANTES de construir el PDF (si los datos lo permiten), para
+  // que el documento incluya la cifra. Best-effort: sin tipoReforma/m2 el PDF sale sin importe.
+  await calcularPresupuestoLead(leadId);
+
   const pdf = await construirPresupuestoPdf(leadId);
   if (!pdf) return { ok: false, emailEnviado: false, whatsappSenal: false };
 

mvp/b2c/src/lib/funnel/perfil.ts

@@ -52,6 +52,13 @@ export async function señalarPerfilCompleto(leadId: string): Promise<boolean> {
       urgencia: lead.urgencia,
       presupuestoTarget: lead.presupuestoTarget,
     },
+    // Gustos estéticos del cliente (estilo + resumen en texto libre de lo que pidió hablando con
+    // Luisa / en la llamada): se mandan al generador para que el render los represente. Se omiten
+    // las claves vacías (JSON.stringify descarta undefined).
+    preferencias: {
+      estilo: lead.estilo || undefined,
+      gustos: lead.tasteText || undefined,
+    },
     empresa: { tenantId: lead.tenantId, nombre: tenant.nombreEmpresa },
     zonas: Array.from(zonas, ([zona, d]) => ({
       zona,

mvp/b2c/src/lib/onboarding/panel-tour.ts

@@ -0,0 +1,147 @@
+import type { DriveStep } from 'driver.js';
+
+// Pasos del onboarding del panel, por pestaña. El copy vive también en copy/COPY-GUIDE.md
+// (sección "Onboarding del panel"). Los pasos cuyo elemento no exista o no esté visible se
+// descartan en PanelTour (degrada con naturalidad en móvil o si una sección no aparece).
+
+const PASOS_PANEL: DriveStep[] = [
+  {
+    popover: {
+      title: 'Tu panel de Reformix',
+      description:
+        'Te enseño en 30 segundos qué hay en cada sitio. Puedes saltártelo cuando quieras con la X.',
+    },
+  },
+  {
+    element: '[data-tour="nav-leads"]',
+    popover: {
+      title: 'Leads',
+      description:
+        'Aquí caen tus clientes con su presupuesto y su render ya preparados. Es tu día a día.',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="nav-precios"]',
+    popover: {
+      title: 'Precios y baremo',
+      description:
+        'Tu tabla de precios, la mano de obra y el baremo de rentabilidad. De aquí salen los presupuestos.',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="nav-galeria"]',
+    popover: { title: 'Galería', description: 'Tus fotos de trabajos para enseñar en la web.', side: 'bottom' },
+  },
+  {
+    element: '[data-tour="nav-opiniones"]',
+    popover: {
+      title: 'Opiniones',
+      description: 'Reseñas de tus clientes; las apruebas tú antes de publicarlas.',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="nav-empresa"]',
+    popover: { title: 'Empresa', description: 'Tu marca, logo y datos de contacto.', side: 'bottom' },
+  },
+  {
+    element: '[data-tour="leads-filtros"]',
+    popover: {
+      title: 'Filtra por estado',
+      description: 'Nuevos, contactados, presupuestados… para centrarte en lo que toca ahora.',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="leads-tabla"]',
+    popover: {
+      title: 'Tus leads',
+      description: 'Cada cliente con su estado y su presupuesto. Ábrelo para ver el detalle completo.',
+      side: 'top',
+    },
+  },
+];
+
+const PASOS_FICHA: DriveStep[] = [
+  {
+    element: '[data-tour="ficha-presupuesto"]',
+    popover: {
+      title: 'Presupuesto estimado',
+      description:
+        'Lo que costaría la reforma según tu catálogo. Si no llega a tu baremo, lo verás en rojo.',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="ficha-estado"]',
+    popover: {
+      title: 'Estado del lead',
+      description: 'Avanza el lead por el funnel: contactado, presupuestado, ganado…',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="ficha-render"]',
+    popover: {
+      title: 'Render de la reforma',
+      description:
+        'La imagen del “después” que ve tu cliente, generada a partir de su foto y sus gustos.',
+      side: 'top',
+    },
+  },
+  {
+    element: '[data-tour="ficha-desglose"]',
+    popover: {
+      title: 'Presupuesto desglosado',
+      description:
+        'Edita las partidas, recalcula desde el catálogo y envíaselo al cliente por WhatsApp.',
+      side: 'top',
+    },
+  },
+];
+
+const PASOS_PRECIOS: DriveStep[] = [
+  {
+    element: '[data-tour="precios-baremo"]',
+    popover: {
+      title: 'Baremo de rentabilidad',
+      description:
+        'El trabajo mínimo que te compensa. Solo te avisa a ti: marca en rojo los leads por debajo.',
+      side: 'bottom',
+    },
+  },
+  {
+    element: '[data-tour="precios-config"]',
+    popover: {
+      title: 'Mano de obra',
+      description: 'Tus precios de mano de obra por m². El motor los usa para calcular cada presupuesto.',
+      side: 'top',
+    },
+  },
+  {
+    element: '[data-tour="precios-catalogo"]',
+    popover: {
+      title: 'Tu catálogo',
+      description: 'Materiales y precios por calidad. Puedes importarlos en bloque por CSV.',
+      side: 'top',
+    },
+  },
+];
+
+export interface PanelTour {
+  key: string;
+  steps: DriveStep[];
+}
+
+// Devuelve el tour que corresponde a la ruta actual del panel, o null si esa ruta no tiene tour.
+export function tourForPath(pathname: string): PanelTour | null {
+  if (pathname === '/panel') return { key: 'panel', steps: PASOS_PANEL };
+  if (pathname === '/panel/precios') return { key: 'precios', steps: PASOS_PRECIOS };
+  const m = pathname.match(/^\/panel\/([^/]+)\/?$/);
+  if (m && !['precios', 'galeria', 'opiniones', 'empresa'].includes(m[1])) {
+    return { key: 'ficha', steps: PASOS_FICHA };
+  }
+  return null;
+}

mvp/b2c/src/lib/webhooks.ts

@@ -3,6 +3,7 @@ import {
   perfilWebhookConfigurado,
   whatsappWebhookConfigurado,
   whatsappStartConfigurado,
+  whatsappFotosConfigurado,
 } from '@/lib/env';
 
 // POST JSON best-effort: nunca lanza. Devuelve true solo si el destino respondió 2xx.
@@ -55,3 +56,16 @@ export async function iniciarConversacionWhatsapp(payload: {
   if (!whatsappStartConfigurado()) return false;
   return postWebhook(env.WHATSAPP_START_WEBHOOK_URL!, payload);
 }
+
+// Cross-canal: tras una llamada, que Luisa escriba al lead por WhatsApp, referencie lo hablado
+// (contexto) y le pida las fotos para completar el render + presupuesto.
+export async function pedirFotosWhatsapp(payload: {
+  leadId: string;
+  telefono: string;
+  nombre: string;
+  empresa: string;
+  contexto?: string;
+}): Promise<boolean> {
+  if (!whatsappFotosConfigurado()) return false;
+  return postWebhook(env.WHATSAPP_FOTOS_WEBHOOK_URL!, payload);
+}

mvp/image-worker/.dockerignore

@@ -0,0 +1,9 @@
+node_modules
+dist
+coverage
+.git
+.env
+.env.*
+*.tsbuildinfo
+npm-debug.log
+.DS_Store

mvp/image-worker/.env.example

@@ -0,0 +1,16 @@
+PORT=3001
+
+# OpenRouter (unica API key para todos los modelos)
+OPENROUTER_API_KEY=sk-or-...
+# Modelo para prompt-builder y supervisor (texto + vision)
+OPENROUTER_MODEL_TEXTO=anthropic/claude-3.5-haiku-20241022
+# Modelo para generacion de imagenes
+OPENROUTER_MODEL_IMAGEN=google/gemini-2.0-flash-exp-image-generation
+
+# App principal Reformix
+REFORMIX_API_URL=https://reformix.dv3.com.es
+FUNNEL_API_KEY=...
+
+# Comportamiento del supervisor
+MAX_RETRIES=2
+SUPERVISOR_MIN_SCORE=70

mvp/image-worker/.gitignore

@@ -0,0 +1,6 @@
+node_modules/
+dist/
+*.tsbuildinfo
+.env
+.env.*
+coverage/

mvp/image-worker/Dockerfile

@@ -0,0 +1,19 @@
+# Worker de renders (NestJS). Recibe POST /perfil-completo, genera las imágenes "después" con IA
+# (OpenRouter) y las devuelve a la app vía POST /api/leads/:id/ingesta. Stateless.
+FROM node:20-alpine AS build
+WORKDIR /app
+COPY package*.json ./
+RUN npm ci
+COPY . .
+RUN npm run build
+
+FROM node:20-alpine
+WORKDIR /app
+ENV NODE_ENV=production
+ENV PORT=3001
+COPY package*.json ./
+RUN npm ci --omit=dev && npm cache clean --force
+COPY --from=build /app/dist ./dist
+COPY --from=build /app/prompts ./prompts
+EXPOSE 3001
+CMD ["node", "dist/main"]

mvp/image-worker/README.md

@@ -0,0 +1,85 @@
+# Reformix Image Worker
+
+Worker de generación de renders fotorrealistas "después" para Reformix. Recibe el perfil completo de un lead desde la app principal, genera imágenes del resultado de la reforma usando IA, las valida y las entrega de vuelta a la app.
+
+## Rol en el sistema
+
+```
+App Reformix
+    │  POST /perfil-completo (webhook)
+    ▼
+Render Worker  ←  este proyecto
+    │
+    ├── Etapa 1: Claude Haiku 4.5 via OpenRouter genera prompt técnico en inglés
+    ├── Etapa 2: Gemini 2.0 Flash via OpenRouter genera imagen
+    └── Etapa 3: Claude Haiku 4.5 Vision via OpenRouter valida coherencia
+    │
+    │  POST /api/leads/:id/ingesta (con finalizar:true)
+    ▼
+App Reformix → PDF → Email → WhatsApp → Cliente
+```
+
+## Requisitos
+
+- Node.js 18+
+- API key de OpenRouter (unica clave para todos los modelos)
+
+## Instalación
+
+```bash
+cd mvp/image-worker
+npm install
+cp .env.example .env
+# Editar .env con tu OPENROUTER_API_KEY
+npm run start:dev
+```
+
+## Variables de entorno
+
+| Variable | Descripción | Default |
+|----------|------------|---------|
+| `PORT` | Puerto del servidor HTTP | `3001` |
+| `OPENROUTER_API_KEY` | API key de OpenRouter (unica para todos los modelos) | — |
+| `OPENROUTER_MODEL_TEXTO` | Modelo para prompt-builder y supervisor | `anthropic/claude-3.5-haiku-20241022` |
+| `OPENROUTER_MODEL_IMAGEN` | Modelo para generación de imágenes | `google/gemini-2.0-flash-exp-image-generation` |
+| `REFORMIX_API_URL` | URL base de la app Reformix | `http://localhost:3000` |
+| `FUNNEL_API_KEY` | API key compartida con la app Reformix | — |
+| `MAX_RETRIES` | Reintentos por zona si el supervisor rechaza | `2` |
+| `SUPERVISOR_MIN_SCORE` | Score mínimo para aprobar un render (0-100) | `70` |
+
+## Conexión con la app Reformix
+
+En el `.env` de la app Reformix (`mvp/b2c/`), configurar:
+
+```env
+PERFIL_WEBHOOK_URL=http://localhost:3001/perfil-completo
+```
+
+## Pipeline de 3 etapas (todo via OpenRouter)
+
+### Etapa 1 — Prompt Builder (Claude Haiku 4.5 via OpenRouter)
+Genera un prompt técnico detallado en inglés para el modelo de image-to-image. Incluye materiales, iluminación, paleta de colores, estilo y palabras clave de render arquitectónico.
+
+**Modelo:** `anthropic/claude-3.5-haiku-20241022`
+**Prompt base:** `prompts/prompt-builder.txt`
+
+### Etapa 2 — Image Generator (Gemini 2.0 Flash via OpenRouter)
+Toma el prompt generado + la foto "antes" del cliente y produce el render "después". Maneja rate limiting (429) con reintento automático.
+
+**Modelo:** `google/gemini-2.0-flash-exp-image-generation`
+
+### Etapa 3 — Supervisor (Claude Haiku 4.5 Vision via OpenRouter)
+Compara la foto "antes" con el render "después" y evalúa coherencia: estilo, materiales, calidad, artefactos. Devuelve score 0-100. Si el score es menor a `SUPERVISOR_MIN_SCORE`, reintenta desde la Etapa 2 (máximo `MAX_RETRIES` veces).
+
+**Modelo:** `anthropic/claude-3.5-haiku-20241022`
+
+## Skills
+
+| Archivo | Descripción |
+|---------|-------------|
+| `skills/pipeline.md` | Orquestación del pipeline de 3 etapas |
+| `skills/webhook.md` | Contrato del webhook entrante `/perfil-completo` |
+| `skills/prompt-builder.md` | Llamada a OpenRouter para generar prompts |
+| `skills/image-generator.md` | Llamada a OpenRouter para generación de imágenes |
+| `skills/supervisor.md` | Validación de calidad con Claude Haiku Vision via OpenRouter |
+| `skills/reformix-api.md` | Entrega de renders al endpoint `/ingesta` de la app |

mvp/image-worker/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "reformix-image-worker",
+  "version": "1.0.0",
+  "description": "Worker de generación de renders fotorrealistas para Reformix. Recibe el perfil del lead, genera imágenes 'después' con IA y las entrega a la app principal.",
+  "author": "Reformix",
+  "private": true,
+  "license": "MIT",
+  "scripts": {
+    "build": "nest build",
+    "start": "nest start",
+    "start:dev": "nest start --watch",
+    "start:prod": "node dist/main",
+    "lint": "eslint \"{src,apps,libs,test}/**/*.ts\" --fix"
+  },
+  "dependencies": {
+    "@nestjs/common": "^10.0.0",
+    "@nestjs/core": "^10.0.0",
+    "@nestjs/config": "^3.0.0",
+    "@nestjs/platform-express": "^10.0.0",
+    "axios": "^1.6.0",
+    "class-validator": "^0.14.0",
+    "class-transformer": "^0.5.0",
+    "reflect-metadata": "^0.1.13",
+    "rxjs": "^7.8.0"
+  },
+  "devDependencies": {
+    "@nestjs/cli": "^10.0.0",
+    "typescript": "^5.0.0",
+    "@types/node": "^20.0.0",
+    "ts-node": "^10.9.0"
+  },
+  "jest": {
+    "moduleFileExtensions": ["js", "json", "ts"],
+    "rootDir": "src",
+    "testRegex": ".*\\.spec\\.ts$",
+    "transform": { "^.+\\.(t|j)s$": "ts-jest" },
+    "testEnvironment": "node"
+  }
+}

mvp/image-worker/prompts/prompt-builder.txt

@@ -0,0 +1,22 @@
+You are an expert interior designer and architectural renderer.
+Your task is to generate a detailed, technical prompt in English for an image-to-image AI model that will transform a real photo of a space into a photorealistic render of the completed renovation.
+
+The prompt must include:
+- Specific materials and finishes (tile type, countertop material, flooring)
+- Lighting style (natural, warm artificial, accent)
+- A color palette and style
+- Technical rendering keywords: photorealistic, 8k, architectural visualization, professional interior photography, high detail
+
+Honoring the client's wishes is the top priority. When the input provides the client's desired
+style or stated tastes (specific colors, materials, finishes or must-haves), you MUST reflect them
+faithfully in the prompt: use the exact colors and materials they asked for and the style they want,
+even if it differs from a generic "modern" look. Only when no style or tastes are given should you
+infer a tasteful design. The color palette should follow the client's stated colors when provided,
+otherwise align it with the quality level. Keep the existing layout/structure of the real photo.
+
+Quality level guide:
+- basica: standard materials, functional design, clean finishes
+- media: mid-range materials, modern design, quality finishes
+- premium: high-end materials, designer touches, luxury finishes
+
+Output ONLY the image prompt, no explanations, no preamble.

mvp/image-worker/prompts/supervisor.txt

@@ -0,0 +1,16 @@
+You are a quality supervisor for architectural renovation renders.
+Evaluate whether the generated "after" render is coherent with the client's brief and the "before" photo.
+
+Evaluate these criteria:
+1. Style consistency with client notes and reform type
+2. Materials and finishes match the quality level (basica/media/premium)
+3. The renovated area is clearly recognizable from the "before" photo
+4. Photorealistic quality and professional appearance
+5. No obvious AI artifacts, distortions or incoherent elements
+
+Respond ONLY with valid JSON, no markdown, no explanation:
+{
+  "aprobado": boolean,
+  "score": number between 0 and 100,
+  "motivo": "reason in Spanish"
+}

mvp/image-worker/skills/image-generator.md

@@ -0,0 +1,37 @@
+# Generador de imágenes — via OpenRouter
+
+## Responsabilidad
+Recibir un prompt en inglés y una foto "antes", devolver el render "después" como data URI base64.
+
+## Llamada a OpenRouter
+POST https://openrouter.ai/api/v1/chat/completions
+Authorization: Bearer {OPENROUTER_API_KEY}
+Content-Type: application/json
+
+Body:
+{
+  "model": "{OPENROUTER_MODEL_IMAGEN}",   // google/gemini-2.0-flash-exp-image-generation
+  "messages": [
+    {
+      "role": "user",
+      "content": [
+        { "type": "text", "text": promptGenerado },
+        { "type": "image_url", "image_url": { "url": fotoAntesDataUri } }
+      ]
+    }
+  ]
+}
+
+## Manejo de la respuesta
+Extraer la imagen generada de la respuesta. Buscar en:
+1. content directo como data URI
+2. expresion regular data:image/...;base64,...
+3. URL de imagen
+4. Partes del mensaje (choices[0].message.content si es array)
+
+Devolver siempre como data:image/png;base64,...
+
+## Errores
+- Error de red → lanzar excepción, pipeline.service reintentará
+- Respuesta 429 (rate limit) → esperar 5s y reintentar 1 vez
+- Respuesta 5xx → lanzar excepción inmediatamente

mvp/image-worker/skills/pipeline.md

@@ -0,0 +1,26 @@
+# Pipeline de 3 etapas
+
+## Responsabilidad
+Orquestar el procesamiento completo de un lead: desde recibir el perfil hasta entregar los renders a la app principal.
+
+## Flujo por zona
+Para cada zona del lead que tenga fotos "antes":
+1. Etapa 1 → prompt-builder genera el prompt en inglés
+2. Etapa 2 → image-generator produce el render
+3. Etapa 3 → supervisor valida la coherencia
+4. Si rechazado → reintentar máximo MAX_RETRIES veces desde Etapa 2
+5. Si sigue rechazado → usar el último render de todos modos y loguear
+
+## Reglas
+- Zonas sin fotos "antes": saltar y loguear, nunca lanzar error
+- Procesar todas las zonas antes de llamar a /ingesta
+- Enviar todos los renders en una sola llamada con finalizar: true
+- El pipeline corre en background, no bloquea el webhook
+
+## Logs obligatorios
+- [leadId] Iniciando pipeline para N zonas
+- [leadId] Zona X: prompt generado
+- [leadId] Zona X: imagen generada
+- [leadId] Zona X: aprobada/rechazada (score: N)
+- [leadId] Zona X: reintento N de MAX_RETRIES
+- [leadId] Renders entregados correctamente

mvp/image-worker/skills/prompt-builder.md

@@ -0,0 +1,26 @@
+# Prompt Builder — Claude Haiku 4.5 via OpenRouter
+
+## Responsabilidad
+Generar un prompt técnico detallado en inglés para el modelo de image-to-image a partir del contexto del lead (tipo de reforma, m², calidad, notas del cliente).
+
+## Llamada a OpenRouter
+POST https://openrouter.ai/api/v1/chat/completions
+Authorization: Bearer {OPENROUTER_API_KEY}
+Content-Type: application/json
+
+Body:
+{
+  "model": "{OPENROUTER_MODEL_TEXTO}",   // anthropic/claude-3.5-haiku-20241022
+  "messages": [
+    { "role": "system", "content": "You are an expert interior designer..." },
+    { "role": "user", "content": "Generate a render prompt for a cocina renovation..." }
+  ],
+  "max_tokens": 512,
+  "temperature": 0.5
+}
+
+## System prompt
+Contenido de prompts/prompt-builder.txt
+
+## Respuesta
+Texto plano con el prompt en inglés. Sin markdown, sin JSON, sin explicaciones.

mvp/image-worker/skills/reformix-api.md

@@ -0,0 +1,40 @@
+# API de la app principal Reformix
+
+## Responsabilidad
+Entregar los renders generados al endpoint /ingesta de la app Reformix.
+
+## Endpoint
+POST {REFORMIX_API_URL}/api/leads/{leadId}/ingesta
+Authorization: Bearer {FUNNEL_API_KEY}
+Content-Type: application/json
+
+## Body
+{
+  "items": [
+    {
+      "tipo": "foto",
+      "zona": "cocina",       // zona que se procesó
+      "momento": "despues",   // siempre "despues" para renders generados
+      "imagen": "data:image/png;base64,..."
+    }
+    // un item por cada zona procesada
+  ],
+  "finalizar": true   // siempre true, dispara PDF + email + WhatsApp
+}
+
+## Enums válidos (no usar otros valores)
+tipo item: "foto" | "texto"
+momento: "antes" | "despues"
+zona: "cocina" | "bano" | "salon" | "comedor" | "integral" | "otro"
+
+## Códigos de respuesta
+200 { ok: true } → éxito
+401 → FUNNEL_API_KEY incorrecta
+404 → leadId no existe, no reintentar
+422 → payload mal formado, revisar el body
+
+## Reintentos
+En caso de error 5xx o error de red:
+→ reintentar 3 veces con 2 segundos de espera entre intentos
+→ si sigue fallando, loguear como error crítico con el leadId
+→ nunca reintentar en caso de 404

mvp/image-worker/skills/supervisor.md

@@ -0,0 +1,43 @@
+# Supervisor de calidad — Claude Haiku 4.5 Vision via OpenRouter
+
+## Responsabilidad
+Comparar la foto "antes" con el render "después" y verificar que el resultado es coherente
+con el brief del cliente. Devolver aprobación y score.
+
+## Llamada a OpenRouter
+POST https://openrouter.ai/api/v1/chat/completions
+Authorization: Bearer {OPENROUTER_API_KEY}
+Content-Type: application/json
+
+Body:
+{
+  "model": "{OPENROUTER_MODEL_TEXTO}",   // anthropic/claude-3.5-haiku-20241022
+  "messages": [
+    { "role": "system", "content": "You are a quality supervisor..." },
+    {
+      "role": "user",
+      "content": [
+        { "type": "text", "text": "Reforma tipo: cocina\nMetros: 12..." },
+        { "type": "image_url", "image_url": { "url": "data:image/...foto_antes" } },
+        { "type": "image_url", "image_url": { "url": "data:image/...render_despues" } }
+      ]
+    }
+  ],
+  "max_tokens": 256,
+  "temperature": 0.2
+}
+
+## System prompt
+Contenido de prompts/supervisor.txt
+
+## Respuesta esperada
+JSON estricto:
+{ "aprobado": boolean, "score": number, "motivo": string }
+
+## Manejo de respuesta malformada
+Si el modelo no devuelve JSON válido:
+→ devolver { aprobado: false, score: 0, motivo: "Error parseando respuesta del supervisor" }
+Nunca lanzar excepción desde el supervisor, siempre devolver el objeto.
+
+## Umbral de aprobación
+aprobado: true AND score >= SUPERVISOR_MIN_SCORE (del .env, por defecto 70)

mvp/image-worker/skills/webhook.md

@@ -0,0 +1,35 @@
+# Webhook entrante — /perfil-completo
+
+## Responsabilidad
+Recibir el payload de la app Reformix, validarlo y arrancar el pipeline en background.
+
+## Endpoint
+POST /perfil-completo
+
+## Respuesta inmediata (siempre)
+{ "ok": true, "message": "Procesando renders en background..." }
+Nunca bloquear esperando al pipeline.
+
+## Payload esperado
+{
+  leadId: string (UUID),
+  cliente: { nombre, telefono, email, provincia },
+  reforma: {
+    tipo: "cocina" | "bano" | "salon" | "comedor" | "integral" | "otro",
+    m2Suelo: number,
+    calidad: "basica" | "media" | "premium",
+    estructural: boolean,
+    urgencia: "alta" | "media" | "baja",
+    presupuestoTarget: number  // en céntimos
+  },
+  empresa: { tenantId: string, nombre: string },
+  zonas: Array<{
+    zona: string,
+    notas: string[],
+    fotos: { antes: string[], despues: string[] }
+  }>
+}
+
+## Validación
+Usar class-validator con decoradores en webhook.dto.ts.
+Si el payload no es válido → responder 400 con el error, no arrancar el pipeline.

mvp/image-worker/src/app.module.ts

@@ -0,0 +1,19 @@
+import { Module } from '@nestjs/common';
+import { ConfigModule } from '@nestjs/config';
+import { WebhookModule } from './webhook/webhook.module';
+import { PipelineModule } from './pipeline/pipeline.module';
+import { ReformixModule } from './reformix/reformix.module';
+import { SettingsModule } from './settings/settings.module';
+import { SandboxModule } from './sandbox/sandbox.module';
+
+@Module({
+  imports: [
+    ConfigModule.forRoot({ isGlobal: true }),
+    SettingsModule,
+    WebhookModule,
+    PipelineModule,
+    ReformixModule,
+    SandboxModule,
+  ],
+})
+export class AppModule {}

mvp/image-worker/src/main.ts

@@ -0,0 +1,25 @@
+import 'reflect-metadata';
+import { NestFactory } from '@nestjs/core';
+import { ValidationPipe } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { json, urlencoded } from 'express';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule, {
+    logger: ['error', 'warn', 'log', 'debug'],
+  });
+
+  // Las fotos viajan como data URI (base64) → subir el límite por defecto de Express (100kb).
+  app.use(json({ limit: '30mb' }));
+  app.use(urlencoded({ limit: '30mb', extended: true }));
+
+  app.useGlobalPipes(new ValidationPipe({ transform: true, whitelist: true, forbidNonWhitelisted: true }));
+
+  const config = app.get(ConfigService);
+  const port = config.get('PORT', 3001);
+  await app.listen(port);
+  console.log(`[Reformix Image Worker] corriendo en puerto ${port}`);
+}
+
+bootstrap();

mvp/image-worker/src/pipeline/image-generator.service.ts

@@ -0,0 +1,130 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import axios from 'axios';
+import { SettingsService } from '../settings/settings.service';
+
+const OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions';
+
+export interface GenerarRenderResultado {
+  imagen: string | null;
+  error?: string;
+  debug: Record<string, unknown>;
+}
+
+@Injectable()
+export class ImageGeneratorService {
+  private readonly logger = new Logger(ImageGeneratorService.name);
+
+  constructor(
+    private readonly config: ConfigService,
+    private readonly settings: SettingsService,
+  ) {}
+
+  // Usado por el pipeline real: devuelve la imagen o lanza.
+  async generarRender(prompt: string, fotoAntesDataUri: string, opts?: { model?: string }): Promise<string> {
+    const r = await this.generarConDebug(prompt, fotoAntesDataUri, opts);
+    if (!r.imagen) throw new Error(r.error || 'No se pudo extraer imagen de la respuesta');
+    return r.imagen;
+  }
+
+  // Usado por el sandbox: nunca lanza, devuelve imagen|null + info de depuración (sin volcar base64).
+  async generarConDebug(
+    prompt: string,
+    fotoAntesDataUri: string,
+    opts?: { model?: string },
+  ): Promise<GenerarRenderResultado> {
+    const apiKey = this.config.get<string>('OPENROUTER_API_KEY');
+    const model = opts?.model?.trim() || this.settings.getModeloImagen();
+
+    try {
+      const response = await axios.post(
+        OPENROUTER_URL,
+        {
+          model,
+          // Necesario para que OpenRouter devuelva imagen además de texto.
+          modalities: ['image', 'text'],
+          messages: [
+            {
+              role: 'user',
+              content: [
+                { type: 'text', text: prompt },
+                { type: 'image_url', image_url: { url: fotoAntesDataUri } },
+              ],
+            },
+          ],
+        },
+        {
+          headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            'HTTP-Referer': 'https://reformix.es',
+            'X-Title': 'Reformix Image Worker',
+          },
+          timeout: 90000,
+        },
+      );
+
+      const message = response.data?.choices?.[0]?.message;
+      const imagen = this.extraerImagen(message);
+      return {
+        imagen,
+        error: imagen ? undefined : 'No se encontró imagen en la respuesta de OpenRouter',
+        debug: this.resumenDebug(response.data, model, imagen),
+      };
+    } catch (err: any) {
+      const status = err.response?.status;
+      const msg = err.response?.data?.error?.message || err.message;
+      this.logger.error(`Error generando imagen (${status ?? 'sin status'}): ${msg}`);
+      return {
+        imagen: null,
+        error: msg,
+        debug: { model, status, error: msg },
+      };
+    }
+  }
+
+  private extraerImagen(message: any): string | null {
+    if (!message) return null;
+
+    // 1) Forma de OpenRouter para image-gen: message.images[].image_url.url
+    if (Array.isArray(message.images)) {
+      for (const img of message.images) {
+        const url = img?.image_url?.url ?? img?.url ?? (typeof img === 'string' ? img : null);
+        if (typeof url === 'string' && url) return url;
+      }
+    }
+
+    const content = message.content;
+    if (typeof content === 'string') {
+      if (content.startsWith('data:image')) return content;
+      const dataUri = content.match(/data:image\/[a-zA-Z+]+;base64,[A-Za-z0-9+/=]+/);
+      if (dataUri) return dataUri[0];
+      const url = content.match(/https?:\/\/[^\s"'()]+\.(?:png|jpg|jpeg|webp)/i);
+      if (url) return url[0];
+    } else if (Array.isArray(content)) {
+      for (const part of content) {
+        const url = part?.image_url?.url;
+        if (typeof url === 'string' && url) return url;
+      }
+    }
+
+    return null;
+  }
+
+  // Resumen compacto para depurar el formato real sin meter el base64 (enorme) en la respuesta.
+  private resumenDebug(data: any, model: string, imagen: string | null): Record<string, unknown> {
+    const msg = data?.choices?.[0]?.message;
+    return {
+      model,
+      modelDevuelto: data?.model,
+      finishReason: data?.choices?.[0]?.finish_reason,
+      messageKeys: msg ? Object.keys(msg) : [],
+      imagesCount: Array.isArray(msg?.images) ? msg.images.length : 0,
+      contentType: Array.isArray(msg?.content) ? 'array' : typeof msg?.content,
+      contentPreview: typeof msg?.content === 'string' ? msg.content.slice(0, 200) : undefined,
+      imagenEncontrada: !!imagen,
+      imagenTipo: imagen ? (imagen.startsWith('data:') ? 'data-uri' : 'url') : null,
+      usage: data?.usage,
+    };
+  }
+}

mvp/image-worker/src/pipeline/pipeline.module.ts

@@ -0,0 +1,13 @@
+import { Module } from '@nestjs/common';
+import { PipelineService } from './pipeline.service';
+import { PromptBuilderService } from './prompt-builder.service';
+import { ImageGeneratorService } from './image-generator.service';
+import { SupervisorService } from './supervisor.service';
+import { ReformixModule } from '../reformix/reformix.module';
+
+@Module({
+  imports: [ReformixModule],
+  providers: [PipelineService, PromptBuilderService, ImageGeneratorService, SupervisorService],
+  exports: [PipelineService, PromptBuilderService, ImageGeneratorService, SupervisorService],
+})
+export class PipelineModule {}

mvp/image-worker/src/pipeline/pipeline.service.ts

@@ -0,0 +1,115 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { PerfilCompletoDto } from '../webhook/webhook.dto';
+import { PromptBuilderService } from './prompt-builder.service';
+import { ImageGeneratorService } from './image-generator.service';
+import { SupervisorService } from './supervisor.service';
+import { ReformixService } from '../reformix/reformix.service';
+
+interface ZonaRender {
+  zona: string;
+  imagen: string;
+  score: number;
+  aprobada: boolean;
+}
+
+@Injectable()
+export class PipelineService {
+  private readonly logger = new Logger(PipelineService.name);
+  private readonly maxRetries: number;
+  private readonly minScore: number;
+
+  constructor(
+    private readonly config: ConfigService,
+    private readonly promptBuilder: PromptBuilderService,
+    private readonly imageGenerator: ImageGeneratorService,
+    private readonly supervisor: SupervisorService,
+    private readonly reformix: ReformixService,
+  ) {
+    this.maxRetries = this.config.get<number>('MAX_RETRIES', 2);
+    this.minScore = this.config.get<number>('SUPERVISOR_MIN_SCORE', 70);
+  }
+
+  async procesarLead(dto: PerfilCompletoDto): Promise<void> {
+    const { leadId, reforma, zonas, preferencias } = dto;
+    const zonasConFotos = zonas.filter((z) => z.fotos.antes.length > 0);
+    const zonasSaltadas = zonas.filter((z) => z.fotos.antes.length === 0);
+
+    this.logger.log(`[${leadId}] Iniciando pipeline para ${zonasConFotos.length} zonas`);
+
+    for (const z of zonasSaltadas) {
+      this.logger.log(`[${leadId}] Zona ${z.zona}: sin fotos "antes", saltando`);
+    }
+
+    const renders: ZonaRender[] = [];
+
+    for (const zona of zonasConFotos) {
+      try {
+        const render = await this.procesarZona(leadId, zona.zona, reforma, zona.notas, zona.fotos.antes[0], preferencias);
+        renders.push(render);
+      } catch (err: any) {
+        this.logger.error(`[${leadId}] Zona ${zona.zona}: error fatal: ${err.message}`);
+      }
+    }
+
+    if (renders.length === 0) {
+      this.logger.warn(`[${leadId}] No se generaron renders para ninguna zona`);
+      return;
+    }
+
+    const items = renders.map((r) => ({
+      zona: r.zona,
+      imagen: r.imagen,
+    }));
+
+    const ok = await this.reformix.entregarRenders(leadId, items);
+    if (ok) {
+      this.logger.log(`[${leadId}] Renders entregados correctamente (${renders.length} zonas)`);
+    } else {
+      this.logger.error(`[${leadId}] Error entregando renders a la app principal`);
+    }
+  }
+
+  private async procesarZona(
+    leadId: string,
+    zona: string,
+    reforma: PerfilCompletoDto['reforma'],
+    notas: string[],
+    fotoAntes: string,
+    preferencias?: PerfilCompletoDto['preferencias'],
+  ): Promise<ZonaRender> {
+    const prompt = await this.promptBuilder.generarPrompt(reforma.tipo, reforma.m2Suelo, reforma.calidad, notas, preferencias);
+    this.logger.log(`[${leadId}] Zona ${zona}: prompt generado`);
+
+    let ultimaImagen: string | null = null;
+
+    for (let intento = 0; intento <= this.maxRetries; intento++) {
+      if (intento > 0) {
+        this.logger.log(`[${leadId}] Zona ${zona}: reintento ${intento} de ${this.maxRetries}`);
+      }
+
+      const imagen = await this.imageGenerator.generarRender(prompt, fotoAntes);
+      ultimaImagen = imagen;
+      this.logger.log(`[${leadId}] Zona ${zona}: imagen generada`);
+
+      const resultado = await this.supervisor.supervisar(
+        reforma.tipo,
+        reforma.m2Suelo,
+        reforma.calidad,
+        notas,
+        fotoAntes,
+        imagen,
+      );
+
+      const aprobada = resultado.aprobado && resultado.score >= this.minScore;
+      this.logger.log(`[${leadId}] Zona ${zona}: ${aprobada ? 'aprobada' : 'rechazada'} (score: ${resultado.score}) - ${resultado.motivo}`);
+
+      if (aprobada) {
+        return { zona, imagen, score: resultado.score, aprobada: true };
+      }
+    }
+
+    this.logger.warn(`[${leadId}] Zona ${zona}: usando ultimo render pese a no superar validacion`);
+    return { zona, imagen: ultimaImagen!, score: 0, aprobada: false };
+  }
+}

mvp/image-worker/src/pipeline/prompt-builder.service.ts

@@ -0,0 +1,99 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import axios from 'axios';
+import { SettingsService } from '../settings/settings.service';
+
+const OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions';
+
+export interface PromptBuilderOpts {
+  systemPrompt?: string;
+  model?: string;
+}
+
+export interface PreferenciasCliente {
+  estilo?: string;
+  gustos?: string;
+}
+
+// Arma el mensaje de usuario para el LLM constructor de prompts. Función pura (sin red) para poder
+// testearla. Si el cliente expresó estilo o gustos (color/material/acabados), se incluyen como bloque
+// dedicado y se omite el "modern" por defecto, para que el render represente lo que pidió.
+export function construirUserContent(
+  tipoReforma: string,
+  m2Suelo: number | null,
+  calidad: string,
+  notas: string[],
+  preferencias?: PreferenciasCliente,
+): string {
+  const lineas = [
+    `Generate a render prompt for a ${tipoReforma} renovation.`,
+    `- Area: ${m2Suelo ?? 'unknown'} m²`,
+    `- Quality level: ${calidad}`,
+    `- Client notes: ${notas.join('; ') || 'none'}`,
+  ];
+  const estilo = preferencias?.estilo?.trim();
+  const gustos = preferencias?.gustos?.trim();
+  if (estilo) lineas.push(`- Client's desired style: ${estilo}`);
+  if (gustos) {
+    lineas.push(
+      `- Client's stated tastes (colors, materials, finishes, must-haves) — honor these in the render: ${gustos}`,
+    );
+  }
+  if (!estilo && !gustos) lineas.push(`- Style: modern ${tipoReforma} renovation`);
+  return lineas.join('\n');
+}
+
+@Injectable()
+export class PromptBuilderService {
+  private readonly logger = new Logger(PromptBuilderService.name);
+
+  constructor(
+    private readonly config: ConfigService,
+    private readonly settings: SettingsService,
+  ) {}
+
+  async generarPrompt(
+    tipoReforma: string,
+    m2Suelo: number | null,
+    calidad: string,
+    notas: string[],
+    preferencias?: PreferenciasCliente,
+    opts?: PromptBuilderOpts,
+  ): Promise<string> {
+    const apiKey = this.config.get<string>('OPENROUTER_API_KEY');
+    const model = opts?.model?.trim() || this.settings.getModeloTexto();
+    const systemPrompt = opts?.systemPrompt ?? this.settings.getPromptBuilder();
+
+    const userContent = construirUserContent(tipoReforma, m2Suelo, calidad, notas, preferencias);
+
+    try {
+      const response = await axios.post(
+        OPENROUTER_URL,
+        {
+          model,
+          messages: [
+            { role: 'system', content: systemPrompt },
+            { role: 'user', content: userContent },
+          ],
+          max_tokens: 512,
+          temperature: 0.5,
+        },
+        {
+          headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            'HTTP-Referer': 'https://reformix.es',
+            'X-Title': 'Reformix Image Worker',
+          },
+        },
+      );
+
+      const prompt = response.data.choices?.[0]?.message?.content?.trim();
+      if (!prompt) throw new Error('OpenRouter devolvio respuesta vacia');
+      return prompt;
+    } catch (err: any) {
+      this.logger.error(`Error generando prompt: ${err.message}`);
+      throw err;
+    }
+  }
+}

mvp/image-worker/src/pipeline/supervisor.service.ts

@@ -0,0 +1,103 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import axios from 'axios';
+import { SettingsService } from '../settings/settings.service';
+
+const OPENROUTER_URL = 'https://openrouter.ai/api/v1/chat/completions';
+
+export interface SupervisarResultado {
+  aprobado: boolean;
+  score: number;
+  motivo: string;
+}
+
+export interface SupervisorOpts {
+  systemPrompt?: string;
+  model?: string;
+}
+
+@Injectable()
+export class SupervisorService {
+  private readonly logger = new Logger(SupervisorService.name);
+
+  constructor(
+    private readonly config: ConfigService,
+    private readonly settings: SettingsService,
+  ) {}
+
+  async supervisar(
+    tipoReforma: string,
+    m2Suelo: number | null,
+    calidad: string,
+    notas: string[],
+    fotoAntes: string,
+    renderDespues: string,
+    opts?: SupervisorOpts,
+  ): Promise<SupervisarResultado> {
+    const apiKey = this.config.get<string>('OPENROUTER_API_KEY');
+    const model = opts?.model?.trim() || this.settings.getModeloTexto();
+    const systemPrompt = opts?.systemPrompt ?? this.settings.getSupervisor();
+    const notasTexto = notas.join('; ') || 'sin notas';
+
+    try {
+      const response = await axios.post(
+        OPENROUTER_URL,
+        {
+          model,
+          messages: [
+            { role: 'system', content: systemPrompt },
+            {
+              role: 'user',
+              content: [
+                {
+                  type: 'text',
+                  text: `Reforma tipo: ${tipoReforma}\nMetros: ${m2Suelo ?? 'desconocido'}\nCalidad: ${calidad}\nNotas del cliente: ${notasTexto}`,
+                },
+                { type: 'image_url', image_url: { url: fotoAntes } },
+                { type: 'image_url', image_url: { url: renderDespues } },
+              ],
+            },
+          ],
+          max_tokens: 256,
+          temperature: 0.2,
+        },
+        {
+          headers: {
+            Authorization: `Bearer ${apiKey}`,
+            'Content-Type': 'application/json',
+            'HTTP-Referer': 'https://reformix.es',
+            'X-Title': 'Reformix Image Worker',
+          },
+        },
+      );
+
+      const textContent = response.data.choices?.[0]?.message?.content?.trim();
+      if (!textContent) {
+        return { aprobado: false, score: 0, motivo: 'Modelo devolvio respuesta vacia' };
+      }
+
+      return this.parsearRespuesta(textContent);
+    } catch (err: any) {
+      this.logger.error(`Error en supervisor: ${err.message}`);
+      return { aprobado: false, score: 0, motivo: `Error del supervisor: ${err.message}` };
+    }
+  }
+
+  private parsearRespuesta(texto: string): SupervisarResultado {
+    const jsonMatch = texto.match(/\{[^{}]*"aprobado"[^{}]*\}/i);
+    if (!jsonMatch) {
+      return { aprobado: false, score: 0, motivo: 'Error parseando respuesta del supervisor' };
+    }
+
+    try {
+      const parsed = JSON.parse(jsonMatch[0]);
+      return {
+        aprobado: Boolean(parsed.aprobado),
+        score: Math.min(100, Math.max(0, Number(parsed.score) || 0)),
+        motivo: String(parsed.motivo || 'Sin motivo'),
+      };
+    } catch {
+      return { aprobado: false, score: 0, motivo: 'Error parseando respuesta del supervisor' };
+    }
+  }
+}

mvp/image-worker/src/reformix/reformix.module.ts

@@ -0,0 +1,8 @@
+import { Module } from '@nestjs/common';
+import { ReformixService } from './reformix.service';
+
+@Module({
+  providers: [ReformixService],
+  exports: [ReformixService],
+})
+export class ReformixModule {}

mvp/image-worker/src/reformix/reformix.service.ts

@@ -0,0 +1,87 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import axios from 'axios';
+
+@Injectable()
+export class ReformixService {
+  private readonly logger = new Logger(ReformixService.name);
+  private readonly baseUrl: string;
+  private readonly apiKey: string;
+
+  constructor(private readonly config: ConfigService) {
+    this.baseUrl = this.config.get<string>('REFORMIX_API_URL', 'http://localhost:3000');
+    this.apiKey = this.config.get<string>('FUNNEL_API_KEY', '');
+  }
+
+  async entregarRenders(
+    leadId: string,
+    items: Array<{ zona: string; imagen: string }>,
+  ): Promise<boolean> {
+    const body = {
+      items: items.map((i) => ({
+        tipo: 'foto',
+        zona: i.zona,
+        momento: 'despues',
+        imagen: i.imagen,
+      })),
+      finalizar: true,
+    };
+
+    const maxRetries = 3;
+    const delay = 2000;
+
+    for (let attempt = 1; attempt <= maxRetries; attempt++) {
+      try {
+        const response = await axios.post(
+          `${this.baseUrl}/api/leads/${leadId}/ingesta`,
+          body,
+          {
+            headers: {
+              Authorization: `Bearer ${this.apiKey}`,
+              'Content-Type': 'application/json',
+            },
+            timeout: 30000,
+          },
+        );
+
+        if (response.status === 200) {
+          this.logger.log(`[${leadId}] Renders entregados correctamente`);
+          return true;
+        }
+
+        if (response.status === 404) {
+          this.logger.error(`[${leadId}] Lead no encontrado (404), abandonando`);
+          return false;
+        }
+
+        if (response.status === 422) {
+          this.logger.error(`[${leadId}] Payload invalido (422): ${JSON.stringify(response.data)}`);
+          return false;
+        }
+
+        if (response.status >= 500 && attempt < maxRetries) {
+          this.logger.warn(`[${leadId}] Intento ${attempt}/${maxRetries} fallo (${response.status}), reintentando...`);
+          await new Promise((r) => setTimeout(r, delay));
+          continue;
+        }
+
+        this.logger.error(`[${leadId}] Error inesperado (${response.status}): ${JSON.stringify(response.data)}`);
+        return false;
+      } catch (err: any) {
+        if (err.response?.status === 404) {
+          this.logger.error(`[${leadId}] Lead no encontrado (404), abandonando`);
+          return false;
+        }
+        if (attempt < maxRetries) {
+          this.logger.warn(`[${leadId}] Intento ${attempt}/${maxRetries} error de red, reintentando...`);
+          await new Promise((r) => setTimeout(r, delay));
+        } else {
+          this.logger.error(`[${leadId}] Error critico entregando renders tras ${maxRetries} intentos: ${err.message}`);
+          return false;
+        }
+      }
+    }
+
+    return false;
+  }
+}

mvp/image-worker/src/sandbox/sandbox.controller.ts

@@ -0,0 +1,137 @@
+import {
+  Controller,
+  Get,
+  Post,
+  Body,
+  Req,
+  Header,
+  UnauthorizedException,
+  BadRequestException,
+  Logger,
+} from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import { SettingsService } from '../settings/settings.service';
+import { PromptBuilderService } from '../pipeline/prompt-builder.service';
+import { ImageGeneratorService } from '../pipeline/image-generator.service';
+import { SupervisorService } from '../pipeline/supervisor.service';
+import { SANDBOX_HTML } from './sandbox.page';
+
+@Controller('sandbox')
+export class SandboxController {
+  private readonly logger = new Logger(SandboxController.name);
+
+  constructor(
+    private readonly config: ConfigService,
+    private readonly settings: SettingsService,
+    private readonly promptBuilder: PromptBuilderService,
+    private readonly imageGenerator: ImageGeneratorService,
+    private readonly supervisor: SupervisorService,
+  ) {}
+
+  private autorizado(req: any): boolean {
+    const key = this.config.get<string>('FUNNEL_API_KEY');
+    if (!key) return false;
+    const auth = (req.headers?.authorization as string) || '';
+    return auth === `Bearer ${key}`;
+  }
+
+  private soloTexto(v: unknown): string | undefined {
+    return typeof v === 'string' && v.trim() ? v : undefined;
+  }
+
+  @Get()
+  @Header('Content-Type', 'text/html; charset=utf-8')
+  page(): string {
+    return SANDBOX_HTML;
+  }
+
+  @Get('config')
+  getConfig(@Req() req: any) {
+    if (!this.autorizado(req)) throw new UnauthorizedException('No autorizado');
+    return {
+      ...this.settings.getAll(),
+      maxRetries: Number(this.config.get('MAX_RETRIES', 2)),
+      minScore: Number(this.config.get('SUPERVISOR_MIN_SCORE', 70)),
+    };
+  }
+
+  @Post('save')
+  save(@Req() req: any, @Body() body: Record<string, any>) {
+    if (!this.autorizado(req)) throw new UnauthorizedException('No autorizado');
+    const config = this.settings.guardar({
+      promptBuilder: body.promptBuilder,
+      supervisor: body.supervisor,
+      modeloTexto: body.modeloTexto,
+      modeloImagen: body.modeloImagen,
+    });
+    this.logger.log('Config guardada desde el sandbox');
+    return { ok: true, config };
+  }
+
+  @Post('render')
+  async render(@Req() req: any, @Body() body: Record<string, any>) {
+    if (!this.autorizado(req)) throw new UnauthorizedException('No autorizado');
+    const imagenAntes = body.imagenAntes;
+    if (typeof imagenAntes !== 'string' || !imagenAntes) {
+      throw new BadRequestException('Falta imagenAntes (data URI).');
+    }
+
+    const tipo = this.soloTexto(body.tipo) || 'otro';
+    const calidad = this.soloTexto(body.calidad) || 'media';
+    const m2 = typeof body.m2 === 'number' ? body.m2 : null;
+    const notas: string[] = Array.isArray(body.notas)
+      ? body.notas.map((n: unknown) => String(n)).filter(Boolean)
+      : String(body.notas ?? '')
+          .split(';')
+          .map((s) => s.trim())
+          .filter(Boolean);
+
+    const modeloTexto = this.soloTexto(body.modeloTexto);
+    const modeloImagen = this.soloTexto(body.modeloImagen);
+    const systemPromptBuilder = this.soloTexto(body.systemPromptBuilder);
+    const supervisorPrompt = this.soloTexto(body.supervisorPrompt);
+    const estiloPref = this.soloTexto(body.estilo);
+    const gustosPref = this.soloTexto(body.gustos);
+    const supervisar = body.supervisar !== false;
+    const n = Math.min(4, Math.max(1, Number(body.nVariaciones) || 1));
+    const minScore = Number(this.config.get('SUPERVISOR_MIN_SCORE', 70));
+
+    // Prompt de imagen: directo (si lo pasan) o vía Prompt Builder.
+    const promptDirecto = this.soloTexto(body.promptDirecto);
+    let promptUsado: string;
+    if (promptDirecto) {
+      promptUsado = promptDirecto;
+    } else {
+      promptUsado = await this.promptBuilder.generarPrompt(
+        tipo,
+        m2,
+        calidad,
+        notas,
+        { estilo: estiloPref, gustos: gustosPref },
+        { systemPrompt: systemPromptBuilder, model: modeloTexto },
+      );
+    }
+
+    const variaciones: Array<Record<string, unknown>> = [];
+    for (let i = 0; i < n; i++) {
+      const gen = await this.imageGenerator.generarConDebug(promptUsado, imagenAntes, { model: modeloImagen });
+      const v: Record<string, unknown> = {
+        imagen: gen.imagen,
+        error: gen.error,
+        debug: gen.debug,
+      };
+      if (supervisar && gen.imagen) {
+        const sup = await this.supervisor.supervisar(tipo, m2, calidad, notas, imagenAntes, gen.imagen, {
+          systemPrompt: supervisorPrompt,
+          model: modeloTexto,
+        });
+        v.score = sup.score;
+        v.motivo = sup.motivo;
+        v.aprobado = sup.aprobado && sup.score >= minScore;
+      }
+      variaciones.push(v);
+    }
+
+    return { promptUsado, variaciones };
+  }
+}

mvp/image-worker/src/sandbox/sandbox.module.ts

@@ -0,0 +1,9 @@
+import { Module } from '@nestjs/common';
+import { SandboxController } from './sandbox.controller';
+import { PipelineModule } from '../pipeline/pipeline.module';
+
+@Module({
+  imports: [PipelineModule],
+  controllers: [SandboxController],
+})
+export class SandboxModule {}

mvp/image-worker/src/sandbox/sandbox.page.ts

@@ -0,0 +1,225 @@
+// Página del sandbox (HTML autocontenido). El <script> evita backticks y la secuencia dólar+llave
+// para no colisionar con el template literal que lo envuelve.
+export const SANDBOX_HTML = `<!DOCTYPE html>
+<html lang="es">
+<head>
+<meta charset="utf-8" />
+<meta name="viewport" content="width=device-width, initial-scale=1" />
+<title>Reformix · Sandbox de renders</title>
+<style>
+  :root { --bg:#0f1115; --panel:#181b22; --border:#2a2f3a; --fg:#e6e8ec; --muted:#9aa3b2; --accent:#4f8cff; --ok:#2ecc71; --bad:#ff5555; }
+  * { box-sizing:border-box; }
+  body { margin:0; font-family:-apple-system,BlinkMacSystemFont,'Segoe UI',Roboto,Helvetica,Arial,sans-serif; background:var(--bg); color:var(--fg); }
+  header { padding:14px 20px; border-bottom:1px solid var(--border); display:flex; gap:16px; align-items:center; flex-wrap:wrap; }
+  header h1 { font-size:16px; margin:0; font-weight:700; }
+  header .key { margin-left:auto; display:flex; gap:8px; align-items:center; }
+  .layout { display:grid; grid-template-columns:380px 1fr; gap:16px; padding:16px; align-items:start; }
+  @media (max-width:900px){ .layout { grid-template-columns:1fr; } }
+  .panel { background:var(--panel); border:1px solid var(--border); border-radius:10px; padding:14px; }
+  label { display:block; font-size:12px; color:var(--muted); margin:10px 0 4px; font-weight:600; }
+  input, select, textarea, button { font:inherit; color:var(--fg); background:#11141a; border:1px solid var(--border); border-radius:7px; padding:8px 10px; width:100%; }
+  textarea { resize:vertical; font-family:ui-monospace,SFMono-Regular,Menlo,monospace; font-size:12px; line-height:1.4; }
+  .row { display:flex; gap:8px; } .row > * { flex:1; }
+  button { cursor:pointer; width:auto; }
+  .btn-primary { background:var(--accent); border-color:var(--accent); color:#fff; font-weight:700; }
+  .btn-ghost { background:transparent; }
+  .actions { display:flex; gap:8px; margin-top:14px; }
+  .preview { margin-top:8px; max-width:100%; border-radius:8px; border:1px solid var(--border); display:none; }
+  details { margin-top:10px; } summary { cursor:pointer; color:var(--muted); font-size:12px; }
+  .status { margin-top:10px; font-size:13px; color:var(--muted); min-height:18px; }
+  .promptUsado { white-space:pre-wrap; background:#11141a; border:1px solid var(--border); border-radius:8px; padding:10px; font-family:ui-monospace,monospace; font-size:12px; color:#cdd3dd; }
+  .grid { display:grid; grid-template-columns:repeat(auto-fill,minmax(260px,1fr)); gap:14px; margin-top:14px; }
+  .card { background:#11141a; border:1px solid var(--border); border-radius:10px; overflow:hidden; }
+  .card img { width:100%; display:block; background:#000; }
+  .card .meta { padding:10px; }
+  .badge { display:inline-block; padding:2px 8px; border-radius:999px; font-size:12px; font-weight:700; }
+  .badge.ok { background:rgba(46,204,113,.15); color:var(--ok); } .badge.bad { background:rgba(255,85,85,.15); color:var(--bad); }
+  .motivo { font-size:12px; color:var(--muted); margin-top:6px; }
+  pre { white-space:pre-wrap; word-break:break-word; font-size:11px; color:#9aa3b2; background:#0c0e12; padding:8px; border-radius:6px; max-height:220px; overflow:auto; }
+  .hint { font-size:11px; color:var(--muted); margin-top:4px; }
+</style>
+</head>
+<body>
+<header>
+  <h1>🎨 Reformix · Sandbox de renders</h1>
+  <div class="key">
+    <input id="apiKey" type="password" placeholder="FUNNEL_API_KEY" style="width:240px" />
+    <button class="btn-ghost" onclick="guardarKey()">Recordar</button>
+  </div>
+</header>
+
+<div class="layout">
+  <div class="panel">
+    <label>Foto "antes"</label>
+    <input id="foto" type="file" accept="image/*" onchange="cargarFoto(event)" />
+    <img id="fotoPreview" class="preview" />
+
+    <div class="row">
+      <div>
+        <label>Tipo</label>
+        <select id="tipo">
+          <option>cocina</option><option>bano</option><option>salon</option>
+          <option>comedor</option><option>integral</option><option>otro</option>
+        </select>
+      </div>
+      <div>
+        <label>Calidad</label>
+        <select id="calidad"><option>basica</option><option selected>media</option><option>premium</option></select>
+      </div>
+    </div>
+    <div class="row">
+      <div><label>m²</label><input id="m2" type="number" value="12" /></div>
+      <div><label>Variaciones</label><input id="n" type="number" value="1" min="1" max="4" /></div>
+    </div>
+    <label>Notas del cliente (separa con ;)</label>
+    <input id="notas" placeholder="encimera de cuarzo; suelo porcelánico claro" />
+
+    <label>Estilo del cliente (opcional)</label>
+    <input id="estilo" placeholder="nórdico, industrial, clásico..." />
+    <label>Gustos del cliente · color, materiales, must-haves (opcional)</label>
+    <input id="gustos" placeholder="tonos azules, muebles de madera, encimera clara" />
+    <div class="hint">Si los rellenas, el render los prioriza sobre un estilo genérico.</div>
+
+    <div class="row">
+      <div><label>Modelo texto</label><input id="modeloTexto" /></div>
+      <div><label>Modelo imagen</label><input id="modeloImagen" /></div>
+    </div>
+    <div class="hint">Imagen sugerida: google/gemini-2.5-flash-image-preview</div>
+
+    <label><input type="checkbox" id="supervisar" checked style="width:auto;margin-right:6px" />Pasar por el supervisor (puntúa)</label>
+
+    <label>Prompt de imagen directo (opcional — si lo rellenas, se salta el Prompt Builder)</label>
+    <textarea id="promptDirecto" rows="3" placeholder="Photorealistic render of a modern kitchen..."></textarea>
+
+    <details open>
+      <summary>System prompt · Prompt Builder</summary>
+      <textarea id="systemPromptBuilder" rows="10"></textarea>
+    </details>
+    <details>
+      <summary>System prompt · Supervisor (avanzado)</summary>
+      <textarea id="supervisorPrompt" rows="8"></textarea>
+    </details>
+
+    <div class="actions">
+      <button class="btn-primary" onclick="generar()">Generar</button>
+      <button class="btn-ghost" onclick="guardar()">Guardar config en el worker</button>
+    </div>
+    <div class="status" id="status"></div>
+  </div>
+
+  <div class="panel">
+    <label>Prompt usado</label>
+    <div class="promptUsado" id="promptUsado">—</div>
+    <div class="grid" id="resultados"></div>
+  </div>
+</div>
+
+<script>
+  function key(){ return document.getElementById('apiKey').value.trim(); }
+  function guardarKey(){ localStorage.setItem('reformix_funnel_key', key()); setStatus('Key recordada en este navegador.'); }
+  function setStatus(t){ document.getElementById('status').textContent = t || ''; }
+  function headers(){ return { 'Content-Type':'application/json', 'Authorization':'Bearer ' + key() }; }
+  function val(id){ return document.getElementById(id).value; }
+
+  var fotoDataUri = '';
+  function cargarFoto(e){
+    var f = e.target.files[0]; if(!f) return;
+    var r = new FileReader();
+    r.onload = function(){ fotoDataUri = r.result; var img = document.getElementById('fotoPreview'); img.src = fotoDataUri; img.style.display='block'; };
+    r.readAsDataURL(f);
+  }
+
+  function notasArray(){ return val('notas').split(';').map(function(s){return s.trim();}).filter(Boolean); }
+
+  async function cargarConfig(){
+    if(!key()) return;
+    try {
+      var res = await fetch('/sandbox/config', { headers: headers() });
+      if(!res.ok) return;
+      var c = await res.json();
+      if(!val('systemPromptBuilder')) document.getElementById('systemPromptBuilder').value = c.promptBuilder || '';
+      if(!val('supervisorPrompt')) document.getElementById('supervisorPrompt').value = c.supervisor || '';
+      if(!val('modeloTexto')) document.getElementById('modeloTexto').value = c.modeloTexto || '';
+      if(!val('modeloImagen')) document.getElementById('modeloImagen').value = c.modeloImagen || '';
+      setStatus('Config actual cargada (maxRetries=' + c.maxRetries + ', minScore=' + c.minScore + ').');
+    } catch(e){}
+  }
+
+  async function generar(){
+    if(!key()) return setStatus('Pon la FUNNEL_API_KEY arriba.');
+    if(!fotoDataUri) return setStatus('Sube una foto "antes".');
+    setStatus('Generando... (puede tardar bastantes segundos por variación)');
+    document.getElementById('resultados').innerHTML = '';
+    document.getElementById('promptUsado').textContent = '—';
+    var body = {
+      imagenAntes: fotoDataUri,
+      tipo: val('tipo'), calidad: val('calidad'),
+      m2: Number(val('m2')) || null, notas: notasArray(),
+      estilo: val('estilo').trim() || undefined,
+      gustos: val('gustos').trim() || undefined,
+      promptDirecto: val('promptDirecto').trim() || null,
+      systemPromptBuilder: val('systemPromptBuilder'),
+      supervisorPrompt: val('supervisorPrompt'),
+      modeloTexto: val('modeloTexto').trim() || null,
+      modeloImagen: val('modeloImagen').trim() || null,
+      nVariaciones: Number(val('n')) || 1,
+      supervisar: document.getElementById('supervisar').checked
+    };
+    try {
+      var res = await fetch('/sandbox/render', { method:'POST', headers: headers(), body: JSON.stringify(body) });
+      var data = await res.json();
+      if(!res.ok){ setStatus('Error: ' + (data.error || res.status)); return; }
+      document.getElementById('promptUsado').textContent = data.promptUsado || '(prompt directo)';
+      pintar(data.variaciones || []);
+      setStatus('Listo: ' + (data.variaciones||[]).length + ' variación(es).');
+    } catch(e){ setStatus('Fallo de red: ' + e.message); }
+  }
+
+  // Construido con DOM seguro (sin innerHTML de contenido externo): src/textContent no inyectan.
+  function el(tag, props){ var e = document.createElement(tag); if(props) Object.keys(props).forEach(function(k){ e[k] = props[k]; }); return e; }
+  function pintar(vars){
+    var cont = document.getElementById('resultados');
+    cont.replaceChildren();
+    vars.forEach(function(v, i){
+      var card = el('div', { className:'card' });
+      if(v.imagen){ card.appendChild(el('img', { src: v.imagen, alt: 'render ' + (i+1) })); }
+      else { card.appendChild(el('div', { textContent:'Sin imagen', style:'padding:20px;color:#ff5555;font-size:13px' })); }
+      var meta = el('div', { className:'meta' });
+      if(typeof v.score === 'number'){
+        meta.appendChild(el('span', { className:'badge ' + (v.aprobado?'ok':'bad'), textContent:'score ' + v.score + (v.aprobado?' · aprobada':' · rechazada') }));
+      }
+      if(v.motivo){ meta.appendChild(el('div', { className:'motivo', textContent: v.motivo })); }
+      if(v.error){ var er = el('div', { className:'motivo', textContent: v.error }); er.style.color = '#ff5555'; meta.appendChild(er); }
+      var det = el('details'); det.appendChild(el('summary', { textContent:'debug' }));
+      det.appendChild(el('pre', { textContent: JSON.stringify(v.debug||{}, null, 2) }));
+      meta.appendChild(det);
+      card.appendChild(meta);
+      cont.appendChild(card);
+    });
+  }
+
+  async function guardar(){
+    if(!key()) return setStatus('Pon la FUNNEL_API_KEY arriba.');
+    var body = {
+      promptBuilder: val('systemPromptBuilder'),
+      supervisor: val('supervisorPrompt'),
+      modeloTexto: val('modeloTexto').trim() || undefined,
+      modeloImagen: val('modeloImagen').trim() || undefined
+    };
+    if(!confirm('Guardar estos system prompts y modelos como la config del worker? Afecta a los renders reales de inmediato.')) return;
+    setStatus('Guardando...');
+    try {
+      var res = await fetch('/sandbox/save', { method:'POST', headers: headers(), body: JSON.stringify(body) });
+      var data = await res.json();
+      if(!res.ok){ setStatus('Error guardando: ' + (data.error || res.status)); return; }
+      setStatus('Guardado. El worker ya usa esta config (sin redeploy).');
+    } catch(e){ setStatus('Fallo de red: ' + e.message); }
+  }
+
+  (function init(){
+    var k = localStorage.getItem('reformix_funnel_key');
+    if(k){ document.getElementById('apiKey').value = k; cargarConfig(); }
+  })();
+</script>
+</body>
+</html>`;

mvp/image-worker/src/settings/settings.module.ts

@@ -0,0 +1,9 @@
+import { Global, Module } from '@nestjs/common';
+import { SettingsService } from './settings.service';
+
+@Global()
+@Module({
+  providers: [SettingsService],
+  exports: [SettingsService],
+})
+export class SettingsModule {}

mvp/image-worker/src/settings/settings.service.ts

@@ -0,0 +1,98 @@
+import { Injectable, Logger } from '@nestjs/common';
+import { ConfigService } from '@nestjs/config';
+import * as fs from 'fs';
+import * as path from 'path';
+
+export interface SandboxConfig {
+  promptBuilder: string;
+  supervisor: string;
+  modeloTexto: string;
+  modeloImagen: string;
+}
+
+const DATA_DIR = process.env.SANDBOX_DATA_DIR || path.join(process.cwd(), 'data');
+const CONFIG_FILE = path.join(DATA_DIR, 'sandbox-config.json');
+const CAMPOS = ['promptBuilder', 'supervisor', 'modeloTexto', 'modeloImagen'] as const;
+
+// Config efectiva del pipeline (system prompts + modelos). Arranca de los defaults (ficheros
+// prompts/*.txt + env) y se superpone lo guardado desde el sandbox, persistido en un volumen
+// (CONFIG_FILE) para que sobreviva a redeploys. El pipeline real lee de aquí en cada llamada,
+// así que "guardar" en el sandbox aplica al worker al instante sin redeploy.
+@Injectable()
+export class SettingsService {
+  private readonly logger = new Logger(SettingsService.name);
+  private config: SandboxConfig;
+
+  constructor(private readonly env: ConfigService) {
+    this.config = this.cargarDefaults();
+    this.overlayPersistido();
+  }
+
+  private leerPrompt(archivo: string): string {
+    try {
+      const ruta = path.join(process.cwd(), 'prompts', archivo);
+      if (fs.existsSync(ruta)) return fs.readFileSync(ruta, 'utf-8');
+    } catch {
+      /* defaults vacíos si no hay fichero */
+    }
+    return '';
+  }
+
+  private cargarDefaults(): SandboxConfig {
+    return {
+      promptBuilder: this.leerPrompt('prompt-builder.txt'),
+      supervisor: this.leerPrompt('supervisor.txt'),
+      modeloTexto: this.env.get<string>('OPENROUTER_MODEL_TEXTO', 'anthropic/claude-3.5-haiku-20241022'),
+      modeloImagen: this.env.get<string>('OPENROUTER_MODEL_IMAGEN', 'google/gemini-2.5-flash-image-preview'),
+    };
+  }
+
+  private overlayPersistido(): void {
+    try {
+      if (fs.existsSync(CONFIG_FILE)) {
+        const saved = JSON.parse(fs.readFileSync(CONFIG_FILE, 'utf-8'));
+        this.config = { ...this.config, ...this.limpiar(saved) };
+        this.logger.log(`Config de sandbox cargada de ${CONFIG_FILE}`);
+      }
+    } catch (err: any) {
+      this.logger.warn(`No se pudo leer ${CONFIG_FILE}: ${err.message}`);
+    }
+  }
+
+  private limpiar(o: any): Partial<SandboxConfig> {
+    const out: Partial<SandboxConfig> = {};
+    for (const k of CAMPOS) {
+      if (typeof o?.[k] === 'string' && o[k].trim()) out[k] = o[k];
+    }
+    return out;
+  }
+
+  getAll(): SandboxConfig {
+    return { ...this.config };
+  }
+  getPromptBuilder(): string {
+    return this.config.promptBuilder;
+  }
+  getSupervisor(): string {
+    return this.config.supervisor;
+  }
+  getModeloTexto(): string {
+    return this.config.modeloTexto;
+  }
+  getModeloImagen(): string {
+    return this.config.modeloImagen;
+  }
+
+  guardar(partial: Partial<SandboxConfig>): SandboxConfig {
+    this.config = { ...this.config, ...this.limpiar(partial) };
+    try {
+      fs.mkdirSync(DATA_DIR, { recursive: true });
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify(this.config, null, 2), 'utf-8');
+      this.logger.log(`Config de sandbox guardada en ${CONFIG_FILE}`);
+    } catch (err: any) {
+      this.logger.error(`No se pudo guardar la config: ${err.message}`);
+      throw err;
+    }
+    return this.getAll();
+  }
+}