michangarrito/docs/01-epicas/MCH-006-onboarding-inteligente.md

id	type	title	code	status	status_real	status_nota	phase	priority	created_at	updated_at	simco_version	story_points	sprint_completado	dependencies
EPIC-MCH-006	Epic	MCH-006: Onboarding Inteligente	MCH-006	Completado	Completado	Modulo onboarding implementado con OCR, Whisper y flujos	2	P1	2026-01-10	2026-01-18	4.0.1	13	Sprint 5	blocks depends_on MCH-002 MCH-003 MCH-007 MCH-011

MCH-006: Onboarding Inteligente

Metadata

• Codigo: MCH-006
• Fase: 2 - Inteligencia
• Prioridad: P1
• Estado: Completado
• Estado Real: Modulo onboarding implementado con OCR, Whisper y flujos
• Sprint Completado: Sprint 5
• Story Points: 13

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	Completado	backend/src/modules/onboarding/
OnboardingSession entity	Completado	entities/onboarding-session.entity.ts
ProductScan entity	Completado	entities/product-scan.entity.ts
OnboardingService	Completado	onboarding.service.ts
OnboardingController	Completado	onboarding.controller.ts
OCR service	Completado	services/ocr.service.ts
Whisper service	Completado	services/whisper.service.ts
Schema SQL onboarding	Completado	database/schemas/onboarding.sql

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%

---

Historias de Usuario

MCH-US-050: Flujo WhatsApp Onboarding

Story Points: 5

Como dueno nuevo de negocio Quiero configurar mi negocio completamente via WhatsApp Para tener mi tienda lista sin necesidad de usar computadora

Criterios de Aceptacion

• [CA-050-1] El bot envia mensaje de bienvenida al registrar numero
• [CA-050-2] El flujo pregunta nombre del negocio y giro
• [CA-050-3] El bot sugiere templates segun el giro seleccionado
• [CA-050-4] El dueno puede completar setup en menos de 10 minutos
• [CA-050-5] Al finalizar, el negocio queda activo con catalogo inicial

Tareas

ID	Tarea	Estimacion
MCH-TT-050-01	Crear flujo de bienvenida en WhatsApp	4h
MCH-TT-050-02	Implementar recoleccion de datos del negocio	4h
MCH-TT-050-03	Integrar sugerencia de templates por giro	3h
MCH-TT-050-04	Crear onboarding_sessions table y modelo	2h
MCH-TT-050-05	Implementar tracking de progreso	2h
MCH-TT-050-06	Testing end-to-end del flujo	3h

---

MCH-US-051: Carga de Producto por Foto

Story Points: 3

Como dueno de negocio Quiero enviar fotos de productos para que se agreguen automaticamente Para cargar mi inventario rapidamente sin escribir cada producto

Criterios de Aceptacion

• [CA-051-1] El sistema detecta nombre del producto en la foto
• [CA-051-2] El sistema extrae codigo de barras si es visible
• [CA-051-3] El sistema detecta precio en etiqueta con >80% precision
• [CA-051-4] El bot confirma los datos extraidos antes de guardar
• [CA-051-5] El dueno puede corregir datos incorrectos

Tareas

ID	Tarea	Estimacion
MCH-TT-051-01	Integrar Google Vision API / Tesseract	4h
MCH-TT-051-02	Implementar deteccion de codigos de barras	3h
MCH-TT-051-03	Crear pipeline de extraccion de texto	3h
MCH-TT-051-04	Implementar matching con catalogo conocido	2h
MCH-TT-051-05	Crear flujo de confirmacion/correccion	2h

---

MCH-US-052: Precio por Audio

Story Points: 3

Como dueno de negocio Quiero dictar precios por voz Para actualizar multiples productos rapidamente mientras atiendo

Criterios de Aceptacion

• [CA-052-1] El sistema transcribe notas de voz correctamente
• [CA-052-2] El NLU extrae entidades producto-precio del audio
• [CA-052-3] El bot confirma interpretacion antes de aplicar
• [CA-052-4] Se pueden actualizar multiples productos en un audio
• [CA-052-5] El dueno puede corregir interpretaciones incorrectas

Tareas

ID	Tarea	Estimacion
MCH-TT-052-01	Integrar Whisper API para transcripcion	3h
MCH-TT-052-02	Implementar NLU para extraer producto-precio	4h
MCH-TT-052-03	Crear flujo de confirmacion interactiva	2h
MCH-TT-052-04	Implementar actualizacion batch de precios	2h
MCH-TT-052-05	Testing con diferentes acentos/ruido	2h

---

MCH-US-053: Seleccion de Templates

Story Points: 2

Como dueno de negocio Quiero elegir templates pre-cargados segun mi giro Para tener productos comunes listos sin cargarlos manualmente

Criterios de Aceptacion

• [CA-053-1] Existen templates para abarrotes, papeleria, y giros comunes
• [CA-053-2] Templates incluyen productos de Sabritas, Coca-Cola, Bimbo, Marinela
• [CA-053-3] El dueno puede seleccionar uno o mas templates
• [CA-053-4] Los productos del template se agregan al catalogo con precios sugeridos
• [CA-053-5] El dueno puede ajustar precios despues de cargar

Tareas

ID	Tarea	Estimacion
MCH-TT-053-01	Crear tabla product_templates	2h
MCH-TT-053-02	Crear seeds de templates por proveedor	4h
MCH-TT-053-03	Implementar seleccion multiple de templates	2h
MCH-TT-053-04	Crear servicio de clonado a catalogo tenant	2h
MCH-TT-053-05	Implementar ajuste de precios post-carga	2h

---

Resumen de Story Points

Historia	Descripcion	SP
MCH-US-050	Flujo WhatsApp Onboarding	5
MCH-US-051	Carga de Producto por Foto	3
MCH-US-052	Precio por Audio	3
MCH-US-053	Seleccion de Templates	2
TOTAL		13

---

Ultima actualizacion: 2026-01-17