Reordenando ficheros y subida de documentacion

2026-05-27 10:27:27 +02:00
parent 6388fcaba1
commit a9ad2d7e31
52 changed files with 4707 additions and 79 deletions
--- a/docs/funnel.md
+++ b/docs/funnel.md
@@ -0,0 +1,293 @@
+# Reformix — Funnel completo (v2, sync con blueprint del 22-may)
+
+Documento del funnel punta a punta para compartir con el equipo y/o reconstruir en Miro/FigJam.
+Stack actualizado: **Retell + ElevenLabs + Zadarma + Evolution API/WhatsApp Business + Nano Banana 2/Image 2 + GPT-4o + Postgres + S3 + SMTP**.
+
+---
+
+## 1. Vista global (ASCII — pegable en WhatsApp/Slack)
+
+```
+═══════════════════════════════════════════════════════════════════════
+  FUNNEL B2B (REFORMISTA)         ──►  FUNNEL B2C (CLIENTE FINAL)
+═══════════════════════════════════════════════════════════════════════
+
+  Ad / Outreach / Referido
+       │
+       ▼
+  Landing B2B Reformix             Ads / SEO / Web reformista
+  "Vende más reformas con IA"             │
+       │                                  ▼
+       ▼                          ┌─────────────────────┐
+  Demo del widget en landing      │ 1. Landing reformista│
+       │                          │  "Presu en 5 min"   │
+       ▼                          │  + imagen           │
+  Signup trial 14d                │  antes/después      │
+       │                          └─────────┬───────────┘
+       ▼                                    │ ~40% completa
+  Configura perfil + catálogo               ▼
+  (genera script del agente)      ┌─────────────────────┐
+       │                          │ 2. FORM: nombre +   │
+       ▼                          │    tel + email +    │
+  Embebe widget en su web         │    opt-in LSSI+RGPD │
+       │ ─────────────────┐       └─────────┬───────────┘
+       │                  │                 │ ~85% sube
+       ▼                  │                 ▼
+  PAGA Pro 79€/mes        │       ┌─────────────────────┐
+  (15 leads incl +        │       │ 3. Sube 2-4 fotos   │
+   2,5€/lead extra)       │       │   (opcional DIN-A4) │
+       │                  │       └─────────┬───────────┘
+       │                  │                 │
+       │                  │                 ▼
+       │                  │       ┌─────────────────────┐
+       │                  │       │ 4. SMS + WhatsApp   │
+       │                  │       │    pre-llamada      │
+       │                  │       │ (Evolution API o    │
+       │                  │       │  WA Business API)   │
+       │                  │       └─────────┬───────────┘
+       │                  │                 │ ~70% descuelga
+       │                  │                 ▼
+       │                  │       ┌─────────────────────┐
+       │                  │       │ 5. LLAMADA AGENTE IA│
+       │  configuración   │       │  Retell+ElevenLabs  │
+       │  genera el ──────┼──────►│  Núm fijo provincial│
+       │  script          │       │  vía ZADARMA        │
+       │                  │       │  3-5 min cualif.    │
+       │                  │       │  Detecta licencia   │
+       │                  │       └─────────┬───────────┘
+       │                  │                 │ ~85% completa
+       │                  │                 ▼
+       │                  │       ┌─────────────────────┐
+       │                  │       │ 6. Pipeline (60s):  │
+       │                  │       │  • GPT-4o Vision    │
+       │                  │       │  • Nano Banana 2 /  │
+       │                  │       │    Image 2 render   │
+       │                  │       │  • Motor presupuesto│
+       │                  │       │  • PDF branding     │
+       │                  │       └─────────┬───────────┘
+       │                  │                 │
+       │                  │                 ├──────┐
+       │                  │                 ▼      ▼
+       │  Email + ┌───────┴───┐    ┌──────────┐  ┌──────────┐
+       │  panel ◄─┤ 8. LEAD   │    │ 7a.Whats │  │7b.Cliente│
+       │  reform. │ caliente  │    │ App al   │  │ recibe   │
+       │ (SMTP)   │ al panel  │    │ cliente  │  │ render+  │
+       │          │ (transcr+ │    │  render+ │  │ PDF en   │
+       │          │ entidades │    │  PDF +   │  │ <60s tras│
+       │          │ +render+  │    │  CTA     │  │ colgar   │
+       │          │ presu+    │    │ "visita  │  └────┬─────┘
+       │          │ datos)    │    │  gratis" │       │ ~25%
+       │          └─────┬─────┘    └──────────┘       ▼
+       │                │                       ┌──────────┐
+       │                │                       │ Cliente  │
+       │                ▼                       │ pide     │
+       │          Reformista ◄──────────────────┤ visita   │
+       │          hace visita                   └──────────┘
+       │                │ ~30% cierra
+       │                ▼
+       │          Cliente firma contrato + obra
+       │                │
+       │                ▼
+       │          Reformista introduce PRECIO FINAL en panel
+       │                │
+       │                ▼
+       │          [alimenta métrica precisión →
+       │           sello "Precio Justo Certificado"]
+       │
+       ▼
+  Recurrencia mensual / Churn / Sello / Overage 2,5€/lead
+
+═══════════════════════════════════════════════════════════════════════
+  UPSELL                                                              
+═══════════════════════════════════════════════════════════════════════
+La persona recibe una llamada con peticiones y pasa directamente al
+sistema de presupuestos (skip wizard, callback inmediato).
+
+═══════════════════════════════════════════════════════════════════════
+  FASE 2 (mes 9+) — VALORADOR + MARKETPLACE B2C
+═══════════════════════════════════════════════════════════════════════
+
+  Propietario con presupuesto recibido de otro reformista
+       │
+       ▼
+  Sube presupuesto al valorador "Precio Justo"
+       │
+       ▼
+  IA evalúa vs base de datos histórica de Fase 1
+       │
+       ▼
+  ┌────────────────────┬─────────────────────┐
+  │ Dentro banda ±15%  │ Fuera de banda      │
+  │ "razonable"        │ "pide 2ª opinión"   │
+  │ CTA suave          │ CTA fuerte          │
+  └────────────────────┴──────────┬──────────┘
+                                  │ ~12-18%
+                                  ▼
+                       Lead caliente → Reformista
+                       certificado de su zona
+                                  │
+                                  ▼
+                       Comisión 50-150€/lead
+```
+
+---
+
+## 2. Mermaid (renderiza en GitHub, Notion, VSCode con extensión, Obsidian)
+
+```mermaid
+flowchart TD
+    %% B2B Reformista
+    subgraph B2B["🏢 FUNNEL B2B — Reformista"]
+        A1[Ad / Outreach / Referido] --> A2[Landing B2B Reformix]
+        A2 --> A3[Demo widget en landing]
+        A3 --> A4[Signup trial 14d]
+        A4 --> A5[Configura perfil + catálogo]
+        A5 --> A6[Sistema genera<br/>script del agente]
+        A6 --> A7[Embebe widget en su web]
+        A7 --> A8[💰 Paga Pro 79€/mes<br/>15 leads incl + 2,5€/lead extra]
+    end
+
+    %% B2C Cliente final
+    subgraph B2C["🏠 FUNNEL B2C — Cliente final del reformista"]
+        C1[Ads / SEO / Web del reformista]
+        C1 --> C2[1. Landing del reformista<br/>+ imagen antes/después]
+        C2 -->|~40% completa form| C3[2. Form: nombre + tel + email<br/>opt-in LSSI + RGPD]
+        C3 -->|~85%| C4[3. Sube 2-4 fotos<br/>opcional DIN-A4]
+        C4 --> C5[4. SMS + WhatsApp pre-llamada<br/>Evolution API / WA Business]
+        C5 -->|~70% descuelga| C6[5. Llamada agente IA<br/>Retell + ElevenLabs<br/>Núm fijo provincial vía ZADARMA<br/>3-5 min cualificación<br/>Detecta licencia urbanística]
+        C6 -->|~85% completa| C7[6. Pipeline post-llamada 60s<br/>GPT-4o Vision +<br/>Nano Banana 2 / Image 2 render +<br/>Motor presupuesto +<br/>PDF con branding]
+        C7 --> C8a[7a. Cliente recibe por WhatsApp:<br/>render + PDF + CTA visita]
+        C7 --> C8b[7b. Lead caliente al panel<br/>del reformista + email SMTP]
+        C8a -->|~25% pide visita| C9[Cliente solicita visita gratuita]
+    end
+
+    %% Conexiones
+    A7 -.widget activo en su web.-> C1
+    A6 -.configuración aprende el script.-> C6
+    C8b --> R1[Reformista hace visita]
+    C9 --> R1
+    R1 -->|~30% cierra| R2[Cliente firma contrato y obra]
+    R2 --> R3[Precio final en panel<br/>→ sello Precio Justo]
+    R3 --> A8
+
+    %% Upsell
+    C2 -.upsell.-> US[Persona recibe llamada con peticiones<br/>y pasa directamente al sistema de presupuestos]
+    US --> C7
+
+    %% Fase 2
+    R3 -.alimenta dataset.-> F1
+    subgraph F2["🔮 FASE 2 (mes 9+) — Valorador + Marketplace"]
+        F1[Propietario con<br/>presupuesto de otro reformista]
+        F1 --> F2a[Sube presupuesto al valorador]
+        F2a --> F3[IA evalúa vs base histórica]
+        F3 --> F4{Veredicto}
+        F4 -->|Dentro ±15%| F5[Razonable]
+        F4 -->|Fuera de banda| F6[CTA segunda opinión gratuita]
+        F6 -->|~12-18%| F7[Lead → reformista certificado de zona]
+        F7 --> F8[Comisión 50-150€]
+    end
+
+    style A8 fill:#10b981,color:#fff
+    style C6 fill:#f59e0b,color:#000
+    style C7 fill:#8b5cf6,color:#fff
+    style C8a fill:#22d3ee,color:#000
+    style F7 fill:#10b981,color:#fff
+    style US fill:#fbbf24,color:#000
+```
+
+---
+
+## 3. Para reconstruir en Miro / FigJam (5 min)
+
+Crea **3 swimlanes verticales** (carriles) de izquierda a derecha:
+
+### Carril 1 — REFORMISTA (B2B SaaS) — color azul
+
+1. Ad / Outreach / Referido
+2. Landing B2B "Vende más reformas con IA"
+3. Demo widget en landing
+4. Signup trial 14 días
+5. Configura perfil + catálogo (genera script del agente)
+6. Embebe widget en su web (→ conecta con cliente final)
+7. **PAGA Pro 79 €/mes** (15 leads incluidos + 2,5 €/lead extra) — verde grande
+8. Recurrencia / Churn / Sello "Precio Justo"
+
+### Carril 2 — CLIENTE FINAL del reformista — color naranja
+
+Bloque "Acquisition":
+- Ads / SEO / Web del reformista (3 burbujas convergiendo)
+
+Bloque "Captura":
+1. Landing del reformista — *"Presupuesto en 5 minutos"* + **imagen antes/después** *"Envíanos tu foto y ve cómo quedará tu reforma en 5 minutos"*
+2. **FORM** — nombre + tel + email + opt-in LSSI/RGPD ← **40 % drop**
+3. Sube 2-4 fotos (opcional DIN-A4) ← **15 % drop**
+4. **SMS + WhatsApp pre-llamada** (Evolution API / WhatsApp Business API)
+5. **LLAMADA AGENTE IA** (caja grande amarilla) — núm fijo provincial vía **Zadarma** / **Retell + ElevenLabs** / 3-5 min ← **30 % drop**
+6. **Pipeline post-llamada 60 s** — GPT-4o Vision + **Nano Banana 2 / Image 2** + Motor presupuesto + PDF
+7. **DOBLE OUTPUT** (dos cajas en paralelo):
+   - 7a: **WhatsApp** al cliente con render + PDF + CTA "visita gratuita"
+   - 7b: Email **SMTP** + lead caliente al panel del reformista
+
+Bloque "Conversión real":
+8. Cliente pide visita gratuita ← **75 % drop**
+9. Reformista hace visita
+10. Cliente firma contrato ← **70 % drop**
+11. **PRECIO FINAL en panel** (alimenta sello)
+
+**Upsell extra (caja amarilla flotante):** *"La persona recibe una llamada con peticiones y pasa directamente al sistema de presupuestos"* — skip wizard, callback inmediato.
+
+### Carril 3 — FASE 2 (mes 9+) — color púrpura, marcado "futuro"
+
+1. Propietario con presupuesto recibido (de otro reformista)
+2. Sube al valorador "Precio Justo"
+3. IA evalúa vs base histórica
+4. **Decisión (rombo)**: dentro banda ±15 % → "razonable" / fuera de banda → CTA segunda opinión
+5. Lead canalizado a reformista certificado de su zona
+6. **Comisión 50-150 €**
+
+### Conexiones cruzadas (flechas punteadas)
+
+- Carril 1 paso 5 (configuración) ⇢ Carril 2 paso 5 (llamada agente) — *"El agente conoce su catálogo"*
+- Carril 1 paso 6 (embebe widget) ⇢ Carril 2 paso 1 (landing) — *"Widget activo en su web"*
+- Carril 2 paso 11 (precio final) ⇢ Carril 3 paso 3 (base histórica) — *"Alimenta el dataset"*
+- Carril 3 paso 5 (lead certificado) ⇢ Carril 1 paso 8 (recurrencia) — *"Cierra el círculo"*
+
+### Métricas clave en cada paso (post-its)
+
+| Step | Métrica objetivo |
+|---|---|
+| Landing → form | > 40 % |
+| Form → fotos | > 85 % |
+| Fotos → llamada descolgada | > 70 % |
+| Llamada → completada | > 85 % |
+| Completada → recepción WhatsApp | > 95 % |
+| WhatsApp → solicita visita | > 25 % |
+| Visita → firma | > 30 % |
+| Tiempo total cliente (form → WhatsApp con render) | **< 7 min** |
+| Touchless rate (sin retoque del reformista) | **> 80 %** |
+| Precisión presupuesto (estimado vs final firmado) | **±15 % en > 70 % casos** |
+
+---
+
+## 4. Stack técnico actualizado (sync con blueprint del 22-may)
+
+| Capa | Servicio |
+|---|---|
+| Frontend + Backend | Next.js 14 (App Router + Server Actions + API Routes) → Vercel |
+| UI | Tailwind + shadcn/ui |
+| Agente de voz | **Retell.ai** + **ElevenLabs** voces premium ES |
+| Telefonía | **Zadarma** (números fijos provinciales) |
+| WhatsApp | **WhatsApp Business API o Evolution API** |
+| Render IA | **Nano Banana 2 o Image 2** (Google Gemini) |
+| Análisis foto + presupuesto + extracción entidades | GPT-4o (Vision + Chat) |
+| Base de datos | **Postgres** |
+| Storage | **S3** (AWS / R2 / MinIO) |
+| Email transaccional | **SMTP** |
+| PDF | react-pdf o Puppeteer |
+| Analytics | PostHog |
+
+---
+
+## 5. Tagline para colocar arriba del Miro
+
+> *"Un mercado de reformas más justo. El cliente final recibe en 5 minutos lo que antes le costaba 2 visitas y 2 semanas. El reformista honesto se diferencia automáticamente."*