rckrdmrd
928eb795e6
- HERENCIA-SIMCO.md actualizado con directivas v3.7 y v3.8 - Cambios en backend y frontend Co-Authored-By: Claude Opus 4.5 <noreply@anthropic.com>
188 lines
4.2 KiB
Markdown
188 lines
4.2 KiB
Markdown
# 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
|