rckrdmrd 3bba4ce6d7 feat: Add complete epic documentation and orchestration inventories

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>

2026-01-07 05:40:13 -06:00

3.4 KiB

Raw Blame History

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

Onboarding conversacional via WhatsApp
Carga de productos via fotos
Precios via notas de voz
Templates de proveedores comunes
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

3.4 KiB Raw Blame History