Reordenando ficheros y subida de documentacion
This commit is contained in:
Carlos Narro
153
docs/Equipo 1 - Hackaton _ SIH _ 05-06_2026 - v2 Reformix.md
Normal file
153
docs/Equipo 1 - Hackaton _ SIH _ 05-06_2026 - v2 Reformix.md
Normal file
@@ -0,0 +1,153 @@
|
||||
# **🚀 Blueprint: Reformix — Presupuestos de reforma con IA + Agente de voz**
|
||||
|
||||
**Equipo:**
|
||||
|
||||
- **Goyo** [[Perfil Skool]](https://www.skool.com/@goyo-cancio-6085) — Dev fullstack con ~5 años en una startup del sector espacial. Creador de contenido y mentor de programadores. Aporta los contactos del sector reformas y datos reales de precios por partida y zona en España.
|
||||
- **Antonio** [[Perfil Skool]](https://www.skool.com/@antonio-rodriguez-9773) — UI/UX y diseño visual, creativos de campaña.
|
||||
- **Carlos** [[Perfil Skool]](https://www.skool.com/@carlos-narro-4556) — Producto, fullstack (20 años web, 10 fullstack), especialización en funnels, **experiencia amplia en agentes de voz** y **automatizaciones de WhatsApp**.
|
||||
- **Simon** [[Perfil Skool]](https://www.skool.com/@simon-alexander-5402) — Fullstack senior con 5+ años, especialista en SEO técnico, **automatizaciones de WhatsApp** y orquestación de IA.
|
||||
|
||||
📅 **Fecha límite de entrega:** 21 de mayo de 2026
|
||||
|
||||
**Instrucciones:** Este documento es la "fuente de la verdad" asíncrona del Equipo 1. Se utilizará para acelerar la Landing (Entregable 28-may) y el MVP (Entregable 11-jun).
|
||||
|
||||
---
|
||||
|
||||
### **1. El Negocio (El "Porqué")**
|
||||
|
||||
- **Problema a resolver:**
|
||||
Las empresas pequeñas y medianas de reformas en España (1-10 empleados) pierden horas cada semana respondiendo consultas repetitivas de clientes que aún no saben si van a contratar. Cada presupuesto requiere visita presencial, llamadas de ida y vuelta y tiempo de un técnico cualificado — para leads que muchas veces no convierten. En paralelo, el cliente final tiene un freno emocional clave — **no se imagina cómo va a quedar su reforma**, y sin esa visualización pospone la decisión indefinidamente. Y cuando un cliente sí pide presupuesto detallado, el sector sufre el problema del *showrooming*: el cliente se va a la competencia con tu trabajo en la mano para que se lo dejen más barato, destruyendo los márgenes de los profesionales serios.
|
||||
|
||||
- **Objetivo del Hackathon:**
|
||||
Demostrar el flujo punta a punta: el cliente final del reformista deja sus datos en una landing, sube fotos de su cocina o baño, recibe en menos de 2 minutos una **llamada de un agente de voz IA desde un número de su provincia** que le cualifica conversacionalmente y personaliza el presupuesto, y al colgar recibe automáticamente **por WhatsApp** un render IA del espacio reformado y un presupuesto orientativo desglosado con el branding del reformista. El reformista recibe en su panel el lead pre-cualificado con la transcripción de la llamada, los assets y los datos completos.
|
||||
|
||||
---
|
||||
|
||||
### **2. El Usuario (El "Quién")**
|
||||
|
||||
- **Usuario Objetivo (cliente que paga):**
|
||||
Empresas pequeñas y medianas de reformas en España (1-10 empleados) que reciben consultas por web o WhatsApp pero no tienen capacidad de responder a todos rápido. Su cliente final es el propietario de vivienda que quiere reformar cocina o baño.
|
||||
|
||||
- **El "Camino Feliz" (Paso a paso):**
|
||||
|
||||
1. **El reformista** accede a la plataforma y configura su perfil: nombre de empresa, zona geográfica, tipos de reforma que hace, opciones disponibles por tipo (calidades, materiales, extras), tabla de precios por m² y zona. **Esta configuración genera automáticamente el script del agente de voz** — el agente "aprende" su catálogo y su forma de cualificar.
|
||||
|
||||
2. **El cliente potencial** llega a la landing (vía web del reformista, ads, o link de WhatsApp). **Paso 1 — captura inmediata del lead:** rellena nombre, teléfono móvil y email. Acepta opt-in explícito de llamada y RGPD. **Esto asegura que el lead se captura aunque abandone después.**
|
||||
|
||||
3. **Paso 2 — Subida de fotos:** sube 2-4 fotos del espacio actual (cocina o baño). Opcionalmente puede incluir un **folio DIN-A4 visible** en una foto para que la IA aproxime mejor las medidas reales en metros.
|
||||
|
||||
4. **Paso 3 — Llamada del agente de voz:** en menos de 2 minutos el cliente recibe **WhatsApp + llamada desde un número fijo de su provincia** (psicológicamente local, no comercial sospechoso). El agente de voz IA (Retell + ElevenLabs, voz natural en español) le hace una cualificación conversacional de 3-5 minutos: tipo de reforma, m² aproximados, calidad de materiales preferida, presupuesto target, urgencia, si se cambian sanitarios o se tocan muros (detecta automáticamente necesidad de licencia urbanística), preferencias estéticas. Toda la llamada se transcribe y se extraen entidades estructuradas.
|
||||
|
||||
5. **Paso 4 — Generación de imagen y documentos:** al colgar, el sistema combina foto + transcripción + configuración del reformista para generar (a) render IA antes/después con Replicate + ControlNet, (b) presupuesto desglosado por partidas con motor de cálculo + tabla del reformista, (c) PDF con branding del reformista listo para enviar.
|
||||
|
||||
6. **Paso 5 — Entrega al cliente + envío al reformista:** el cliente recibe en su WhatsApp el render + presupuesto + PDF en menos de 60 segundos tras la llamada, junto con un CTA *"Quiero presupuesto definitivo con visita gratuita"*. El reformista recibe en su panel el lead completo (datos + foto + transcripción + render + presupuesto generado) + notificación por email. **Opcional v1.5:** validación del reformista antes de que el cliente reciba el presupuesto.
|
||||
|
||||
7. **Pasos siguientes (v1.5):** seguimiento automático del lead por WhatsApp (recordatorios, agenda visita), confirmación de cita, y entrega del presupuesto final firmado tras la visita.
|
||||
|
||||
---
|
||||
|
||||
### **3. Requisitos del MVP (El "Qué")**
|
||||
|
||||
*Tres funciones esenciales para que el demo final del 11 de junio funcione.*
|
||||
|
||||
- **Funcionalidad 1: Captura del lead + subida de fotos + disparo de llamada de voz.**
|
||||
Landing pública minimalista con 2 pasos: (1) formulario de captura (nombre + teléfono + email + opt-in LSSI-CE + RGPD) y (2) subida de 2-4 fotos. Al completar se dispara una llamada saliente del agente de voz desde un número fijo provincial en menos de 2 minutos. Mensaje SMS/WhatsApp de aviso pre-llamada para subir la tasa de respuesta a ~70 %. (Owners: Carlos lead capture + Simon trigger + Antonio UI)
|
||||
|
||||
- **Funcionalidad 2: Agente de voz IA con script generado desde configuración + extracción de entidades.**
|
||||
Agente de voz construido con **Retell + ElevenLabs (voces premium en español)** + número fijo provincial vía Twilio España. Script generado automáticamente desde la configuración del reformista ("Reformas Ejemplo" hardcoded en MVP). El agente cualifica: tipo de reforma, m², calidad, presupuesto target, urgencia, cambios estructurales (detecta licencia urbanística), preferencias estéticas. Al colgar, transcripción completa y extracción de entidades en JSON estructurado vía GPT-4o. Tope de duración: 8 minutos. (Owners: Carlos voice agent + Simon orquestación)
|
||||
|
||||
- **Funcionalidad 3: Generación automática de render + presupuesto + entrega por WhatsApp + panel reformista.**
|
||||
Pipeline post-llamada: GPT-4o Vision analiza las fotos + extracción de la transcripción → Replicate (SDXL + ControlNet interior) genera render antes/después → motor de cálculo determinista construye presupuesto desglosado con la tabla validada de Goyo + factor zona + extras + licencia si aplica → PDF generado con branding del reformista → envío automático al cliente vía **WhatsApp Business API** + email al reformista + lead visible en panel mínimo protegido por token. (Owners: Simon pipeline IA + Goyo motor presupuesto + Carlos WhatsApp + Antonio panel)
|
||||
|
||||
---
|
||||
|
||||
### **4. Conexión con los Siguientes Entregables**
|
||||
|
||||
*Alineación con el cronograma oficial del Hackathon.*
|
||||
|
||||
- **Para la Landing Page (Entrega: 28 de mayo):**
|
||||
Gancho principal: ***"Recibe tu presupuesto de reforma en 5 minutos. Te llamamos en menos de 2 minutos."*** Subhead: *"Deja tu teléfono, sube una foto de tu cocina o baño, y te llamará nuestro asesor para personalizar tu presupuesto. Al colgar recibirás por WhatsApp el render de tu nueva reforma + presupuesto desglosado. Con la marca de [Tu reformista de confianza]."* La landing irá dirigida en formato split: una versión para **reformistas** (compra de SaaS, CTA "Empieza gratis 14 días") y otra versión embebible que **el reformista pone en su web** (cliente final completa los 2 pasos). CTA principal del reformista: prueba gratuita. CTA principal del cliente final: *"Llámame en 2 minutos"*.
|
||||
|
||||
- **Para el MVP Técnico (Entrega: 11 de junio):**
|
||||
|
||||
- **Frontend + Backend:** Next.js 14 (App Router + Server Actions + API Routes en un único proyecto y deploy en Vercel). Se descarta el backend Nest.js separado para ahorrar tiempo en 3 semanas.
|
||||
- **UI:** Tailwind + shadcn/ui.
|
||||
- **Agente de voz:** **Retell.ai** (latencia ~500-800 ms, function calling, integraciones limpias) + **ElevenLabs** voces premium en español (las más naturales del mercado actual).
|
||||
- **Telefonía:** **Zadarma** para números fijos provinciales (proveedor español/europeo, más barato y específico ES que Twilio).
|
||||
- **WhatsApp:** **WhatsApp Business API o Evolution API** (Evolution self-hosted más económico). Mensajes de aviso pre-llamada, entrega del render + PDF post-llamada, y nurturing en v1.5.
|
||||
- **IA Visual:** **Nano Banana 2 o Image 2** (Google Gemini). Rápidos, económicos y con buena edición image-to-image.
|
||||
- **IA Texto:** GPT-4o (Vision para foto + chat para presupuesto + extracción de entidades de la transcripción).
|
||||
- **DB + Storage:** **Postgres + S3** (stack agnóstico, sin lock-in de proveedor).
|
||||
- **Email transaccional:** **SMTP** (genérico, sin lock-in).
|
||||
- **Analytics:** PostHog (funnel completo + grabación de sesión).
|
||||
|
||||
---
|
||||
|
||||
### **5. Alcance Estricto (Regla de Oro)**
|
||||
|
||||
- **QUEDA DENTRO:**
|
||||
|
||||
- Landing con formulario de captura (paso 1) y subida de fotos (paso 2).
|
||||
- Opt-in LSSI-CE explícito para llamada + RGPD + aviso de grabación.
|
||||
- **Aviso SMS/WhatsApp pre-llamada** ("En 2 minutos te llama Reformas Ejemplo").
|
||||
- **Llamada saliente del agente de voz** desde número fijo provincial en <2 min tras completar landing.
|
||||
- **Cualificación conversacional** de 3-5 min con extracción estructurada (tipo reforma, m², calidad, presupuesto target, urgencia, cambios estructurales, preferencias).
|
||||
- Detección de necesidad de licencia urbanística desde la conversación (sin sub-flujo UI dedicado, lo razona el agente).
|
||||
- Generación automática post-llamada: render IA antes/después + presupuesto desglosado por partidas con la tabla validada de Goyo + factor zona + extras.
|
||||
- **Entrega por WhatsApp** al cliente final con render + PDF presupuesto + CTA visita gratuita.
|
||||
- Email + notificación al panel del reformista con lead completo (transcripción + entidades + render + presupuesto).
|
||||
- Panel mínimo del reformista protegido por token con lista de leads y todos sus artefactos.
|
||||
- Branding básico "Reformas Ejemplo" hardcoded como demo agnóstica.
|
||||
- Plan B para demo: vídeo grabado de una llamada real + presupuesto generado el día previo, por si la demo en vivo falla.
|
||||
|
||||
- **QUEDA FUERA (v1.5 o posterior):**
|
||||
|
||||
- **Configurador multi-tenant** del reformista (en MVP usamos "Reformas Ejemplo" hardcoded).
|
||||
- **Validación opcional del reformista** antes de que el cliente reciba el presupuesto (workflow de aprobación).
|
||||
- **Nurturing y seguimiento del lead** por WhatsApp hasta concertar cita.
|
||||
- 3 versiones simultáneas Básico/Medio/Premium con selección granular por elemento.
|
||||
- Slider de presupuesto target con auto-ajuste.
|
||||
- **Doble nomenclatura** asistida por IA (feature killer B2B, v2).
|
||||
- **"Valora tu presupuesto justo"** (feature killer Fase 2 marketplace B2C).
|
||||
- **Sello "Precio Justo Certificado"** (puente Fase 1 ↔ Fase 2).
|
||||
- App móvil nativa, PDF con membrete custom (en MVP es un PDF genérico con branding básico), integraciones CRM, renders 3D fotorrealistas, pasarela de pago activa (recogemos waitlist), asignación automática de leads en marketplace (Fase 2).
|
||||
|
||||
---
|
||||
|
||||
### **Anexo — Visión de producto a 18 meses**
|
||||
|
||||
- **Fase 1 — B2B SaaS (mes 0-9, foco del hackathon):** widget+landing embebida en webs de reformistas, agente de voz con script generado por configuración, suscripción mensual 29-79-199 € por tier. Esta fase construye paralelamente la base de reformistas con histórico de precisión para el sello "Precio Justo Certificado".
|
||||
|
||||
- **Fase 2 — Marketplace B2C + Valorador (mes 9-18):** landing pública con *"Valora tu presupuesto justo"* — el propietario sube el presupuesto que le dio otro reformista, la IA lo evalúa en banda vs mercado (sin nombrar al emisor). Si está fuera de banda, ofrecemos *"segunda opinión gratuita con un certificado de tu zona"* → lead caliente canalizado a reformistas con sello. Comisión 50-150 €/lead.
|
||||
|
||||
---
|
||||
|
||||
### **Anexo — Validación de mercado (datos)**
|
||||
|
||||
- **78 %** de clientes acepta el primer presupuesto rápido que recibe, por encima incluso del precio final en obras < 15.000 € *(NexoraSuite)*.
|
||||
- Ticket medio de reforma en España: **10.000 – 50.000 €** (Madrid/Barcelona 700-1.100 €/m²).
|
||||
- **80 %** de clientes prefiere presupuestos con imágenes a presupuestos en texto plano *(Plan Reforma)*.
|
||||
- Hueco real verificado: **nadie en España combina captura de lead + llamada de agente de voz + render + presupuesto + branding + entrega por WhatsApp**. Tractable (chapa y pintura automoción, ~2.000M $/año procesados) demuestra que el modelo foto-IA-presupuesto con pagador B2B funciona industrialmente.
|
||||
|
||||
---
|
||||
|
||||
### **Anexo — Validación del insight crítico (entrevista a perfil dual B2C+B2B)**
|
||||
|
||||
1. **Falta de visualización es el mayor freno emocional** del cliente final. Una imagen rápida y creíble *"hace que tome la decisión así, rápido"*.
|
||||
2. **Showrooming es el dolor #1 del sector B2B.** Doble nomenclatura asistida por IA es el feature killer — irá en v2.
|
||||
3. **El cliente paga más por tranquilidad y buen asesoramiento.** La llamada del agente con voz natural y conocimiento del negocio del reformista entrega esa sensación de "atención profesional inmediata" que justifica el ticket alto y diferencia frente a marketplaces fríos como Habitissimo.
|
||||
|
||||
---
|
||||
|
||||
### **Anexo — Por qué este equipo entrega el MVP en 3 semanas**
|
||||
|
||||
- **Carlos** tiene experiencia amplia construyendo agentes de voz IA en producción y automatizaciones de WhatsApp.
|
||||
- **Simon** domina las automatizaciones de WhatsApp y orquestación de IA — el ecosistema completo lo conocemos in-house.
|
||||
- **Goyo** tiene los datos reales del sector de su contacto y aporta el contexto de dominio para que el script del agente sea creíble desde la primera llamada.
|
||||
- **Antonio** ejecuta UI y creativos sin bloqueos de comunicación con el equipo dev.
|
||||
|
||||
Voice agents son típicamente el bottleneck en MVPs de este tipo (3-4 semanas solo para que funcione decentemente). Como tenemos el conocimiento dentro del equipo, este eje **se convierte en ventaja competitiva**, no en riesgo. El stack Retell + ElevenLabs + Zadarma + Nano Banana 2 o Image 2 + GPT-4o + Evolution API / WhatsApp Business está validado y operativo en producción en otros proyectos del equipo.
|
||||
|
||||
---
|
||||
|
||||
*Documento elaborado el 21 de mayo de 2026 por el Equipo 1 (Reformix). Versión consolidada con arquitectura de agente de voz, captura inmediata del lead, entrega por WhatsApp, y narrativa de producto en dos fases.*
|
||||
Reference in New Issue
Block a user