# 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

```typescript
// 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