michangarrito/docs/01-epicas/MCH-012-chat-llm-dueno.md

MCH-012: Chat LLM Dueno

Metadata

• Codigo: MCH-012
• Fase: 3 - Asistente IA
• Prioridad: P1
• Estado: Pendiente
• Fecha estimada: Sprint 7-8

Descripcion

Asistente IA conversacional para duenos de negocio: consultas de ventas, inventario, clientes; generacion de reportes; sugerencias de negocio; todo via chat en la app o WhatsApp.

Objetivos

1. Chat conversacional en app/WhatsApp
2. Consultas de ventas y metricas
3. Gestion de inventario via chat
4. Alertas y sugerencias proactivas
5. Generacion de reportes por voz

Alcance

Incluido

• "¿Cuanto vendi hoy/esta semana?"
• "¿Cuantas Cocas me quedan?"
• "Sube el precio de las Sabritas a $20"
• "¿Quien me debe mas?"
• "Dame el reporte de la semana"
• Alertas: stock bajo, pagos pendientes

Excluido

• Operaciones bancarias
• Gestion de empleados avanzada
• Analisis financiero complejo

Casos de Uso

Consulta de Ventas

Dueno: "¿Cuanto vendi hoy?"
Bot: "Hoy llevas $3,450 en 23 ventas.
      Top productos: Coca-Cola (15), Sabritas (12).
      Comparado con ayer: +15% 📈"

Consulta de Inventario

Dueno: "¿Tengo Coca de 600?"
Bot: "Te quedan 8 Coca-Cola 600ml.
      Al ritmo actual, duraran ~2 dias.
      ¿Quieres que te recuerde hacer pedido?"

Modificar Precio

Dueno: "Sube las Sabritas a 20 pesos"
Bot: "Actualizo precio de Sabritas Original
      de $18 a $20. ¿Confirmas?"
Dueno: "Si"
Bot: "Listo, precio actualizado ✓"

Consulta de Fiados

Dueno: "¿Quien me debe mas?"
Bot: "Tus clientes con mayor adeudo:
      1. Juan Perez: $850 (15 dias)
      2. Maria Lopez: $420 (7 dias)
      3. Pedro Garcia: $380 (3 dias)
      ¿Quieres enviar recordatorio?"

Reporte Semanal

Dueno: "Dame el reporte de la semana"
Bot: "📊 Reporte Semanal (Ene 1-7)

      💰 Ventas: $24,350 (+8% vs anterior)
      📦 Transacciones: 156
      🎫 Ticket promedio: $156

      Top 5 productos:
      1. Coca-Cola 600ml - 89 unidades
      2. Sabritas - 67 unidades
      ...

      ⚠️ 3 productos con stock bajo
      💳 Cartera por cobrar: $2,150"

Flujo Tecnico

1. Dueno envia mensaje (app o WhatsApp)
2. WhatsApp Service recibe
3. Identifica como chat de dueno
4. Envia a MCP Server con contexto:
   - tenant_id
   - user_role: "owner"
   - tools: todos disponibles
5. MCP procesa con LLM
6. LLM decide tool calls necesarios
7. Ejecuta tools (consultas/acciones)
8. Genera respuesta natural
9. Envia respuesta al dueno

Tools Especificos

// Tools habilitados para dueno
const ownerTools = [
  'search_products',
  'get_product_stock',
  'update_product_price',
  'get_daily_sales',
  'get_sales_report',
  'get_low_stock_products',
  'search_customers',
  'get_customer_balance',
  'send_payment_reminder',
  'get_top_products',
  'get_business_metrics'
];

Alertas Proactivas

Stock Bajo

Enviado: 9:00 AM
"🔔 Alerta de inventario
 3 productos estan por agotarse:
 - Coca-Cola 600ml (5 unidades)
 - Pan Bimbo (3 unidades)
 - Leche (4 unidades)

 ¿Quieres ver sugerencia de pedido?"

Recordatorio de Cobro

Enviado: 10:00 AM Lunes
"💰 Tienes $2,150 en fiados pendientes.
 5 clientes deben desde hace +7 dias.
 ¿Envio recordatorios automaticos?"

Entregables

Entregable	Estado	Archivo
Owner chat flow	Pendiente	whatsapp-service/flows/owner.flow.ts
MCP tools completos	Pendiente	mcp-server/tools/
Alert scheduler	Pendiente	backend/jobs/alerts.job.ts
App chat UI	Pendiente	mobile/screens/Chat.tsx

Dependencias

Depende de

• MCH-010 (MCP Server)
• MCH-011 (WhatsApp Service)
• MCH-003, 004, 008, 009 (datos)

Bloquea a

• Ninguno (mejora de UX)

Criterios de Aceptacion

• Consultas de venta funcionan
• Consultas de inventario funcionan
• Modificacion de precios funciona
• Consultas de fiados funcionan
• Alertas proactivas se envian
• Reportes se generan correctamente

Limites de Tokens

Plan	Tokens/mes	Interacciones aprox
Changarrito	500	~100 conversaciones
Tiendita	2000	~400 conversaciones

---

Ultima actualizacion: 2026-01-07