michangarrito/backups/docs-backup-2026-01-10/docs/01-epicas/MCH-006-onboarding-inteligente.md

MCH-006: Onboarding Inteligente

Metadata

• Codigo: MCH-006
• Fase: 2 - Inteligencia
• Prioridad: P1
• Estado: Completado
• Fecha completado: 2026-01-10

Descripcion

Sistema de onboarding conversacional via WhatsApp que permite a los duenos configurar su negocio enviando fotos de productos, notas de voz con precios, y seleccionando templates pre-cargados de proveedores comunes.

Objetivos

1. Onboarding conversacional via WhatsApp
2. Carga de productos via fotos
3. Precios via notas de voz
4. Templates de proveedores comunes
5. Setup guiado paso a paso

Alcance

Incluido

• Flujo conversacional en WhatsApp
• OCR de etiquetas de precio
• Transcripcion de audio (precios)
• Templates de productos (Sabritas, Coca-Cola, etc.)
• Wizard web alternativo

Excluido

• Onboarding via app movil (fase posterior)
• Importacion masiva CSV
• Integracion con mayoristas

Flujos de Usuario

Onboarding via WhatsApp

1. Dueno recibe mensaje de bienvenida
2. Bot pregunta nombre del negocio
3. Bot pregunta giro (abarrotes, papeleria, etc.)
4. Bot sugiere template de productos
5. Dueno confirma o ajusta
6. Bot pide foto de productos adicionales
7. OCR extrae nombre/precio
8. Dueno confirma/corrige via audio
9. Productos agregados al catalogo

Carga de Producto por Foto

1. Dueno envia foto de producto
2. OCR detecta:
   - Nombre del producto
   - Codigo de barras
   - Precio en etiqueta
3. Bot muestra: "Coca-Cola 600ml - $18?"
4. Dueno responde "Si" o corrige
5. Producto creado

Carga de Precio por Audio

1. Dueno envia nota de voz
2. Whisper transcribe: "Sabritas a 15, Coca a 18"
3. Bot interpreta y confirma
4. Productos actualizados

Componentes Tecnicos

OCR Pipeline

• Google Vision API / Tesseract
• Deteccion de codigos de barras
• Extraccion de texto de etiquetas
• Matching con catalogo de productos conocidos

Transcripcion

• Whisper API
• NLU para extraer entidades (producto, precio)
• Confirmacion interactiva

Templates

• Catalogos pre-cargados de:
  • Sabritas (snacks)
  • Coca-Cola/Pepsi (bebidas)
  • Bimbo (pan)
  • Marinela (galletas)
  • Productos genericos por giro

Modelo de Datos

Tablas Adicionales

onboarding_sessions

• id, tenant_id, status, current_step
• started_at, completed_at, metadata

product_templates

• id, giro, provider, name, sku
• default_price, image_url, barcode

Entregables

Entregable	Estado	Archivo
onboarding.module	Pendiente	modules/onboarding/
OCR service	Pendiente	services/ocr.service.ts
Whisper service	Pendiente	services/whisper.service.ts
Templates seed	Pendiente	seeds/product-templates/
WhatsApp flows	Pendiente	whatsapp-service/flows/

Dependencias

Depende de

• MCH-002 (Auth)
• MCH-003 (Productos)
• MCH-007 (Templates)
• MCH-011 (WhatsApp Service)

Bloquea a

• Ninguno (mejora de UX)

Criterios de Aceptacion

• Flujo WhatsApp funciona end-to-end
• OCR detecta productos con >80% precision
• Audio se transcribe correctamente
• Templates se cargan rapidamente
• Dueno puede completar setup en <10 min

Metricas de Exito

Metrica	Objetivo
Tiempo de onboarding	< 10 minutos
Productos cargados	> 20 en primera sesion
Precision OCR	> 80%
Abandono	< 20%

---

Ultima actualizacion: 2026-01-10