rckrdmrd
3bba4ce6d7
Sprint 3-4 deliverables: - 28 epics documented (MCH-001 to MCH-028) - 7 development phases fully documented - DATABASE_INVENTORY.yml, BACKEND_INVENTORY.yml, FRONTEND_INVENTORY.yml - Task traces for database and frontend 🤖 Generated with [Claude Code](https://claude.com/claude-code) Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
145 lines
3.4 KiB
Markdown
145 lines
3.4 KiB
Markdown
# MCH-006: Onboarding Inteligente
|
|
|
|
## Metadata
|
|
- **Codigo:** MCH-006
|
|
- **Fase:** 2 - Inteligencia
|
|
- **Prioridad:** P1
|
|
- **Estado:** Pendiente
|
|
- **Fecha estimada:** Sprint 5-6
|
|
|
|
## 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-07
|