# 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

- [x] Flujo WhatsApp funciona end-to-end
- [x] OCR detecta productos con >80% precision
- [x] Audio se transcribe correctamente
- [x] Templates se cargan rapidamente
- [x] 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