# Proyecto Pizzería — CRM + Agente WhatsApp IA

Esqueleto del proyecto: una **pizzería con CRM completo** que toma pedidos por WhatsApp con un agente IA. Reusa el stack/conocimiento del agente Herrajes San José, adaptado al rubro gastronómico.

## Decisiones tomadas

| Punto | Decisión |
|---|---|
| Entrega | **Delivery propio + retiro en local** (cliente elige) |
| CRM | **Completo**: segmentación, scores, recordatorios, campañas WhatsApp masivas, métricas |
| Pago | **Efectivo / transferencia / link MercadoPago** (cliente elige) |
| Stack | **PHP + MySQL + Twilio + Claude Sonnet 4** (mismo que Herrajes) |

## Diferencias clave vs el proyecto Herrajes

| Aspecto | Herrajes (B2B distribuidora) | Pizzería (B2C consumo) |
|---|---|---|
| Catálogo | 10k+ SKUs ferretería | ~50-100 ítems (pizzas, empanadas, bebidas, combos) |
| Cliente | Comercios identificados con cod | Consumidor final identificado por número WA |
| Precios | Categorías (gremio_a, gremio_b, público) | Precios únicos pero promos por horario / cliente VIP |
| Entrega | Reparto / urgente / retiro | Delivery con zonas o retiro |
| Pago | Cuenta corriente | Cash / transferencia / link MP |
| Horario | Comercial estándar | Restringido (noches + fines de semana) |
| Frecuencia cliente | 1-2 pedidos/mes | 1-2 pedidos/semana → CRM crítico |
| CRM | Mínimo | **Centro del negocio** |

## Estructura del proyecto

```
_proyecto-pizzeria/
├── README.md                           ← este archivo
├── docs/
│   ├── 00-vision-y-mvp.md              ← qué es MVP, qué es V1
│   ├── 01-flujo-pedido.md              ← paso a paso del pedido por WA
│   ├── 02-crm.md                       ← segmentación, scores, campañas
│   ├── 03-mercadopago.md               ← integración pagos
│   ├── 04-roadmap.md                   ← fases del producto
│   ├── 05-stock-y-recetas.md           ← cómo se descuenta stock al vender + costo de prod
│   └── 06-compras-y-proveedores.md     ← ciclo OC → recepción → factura → pago
├── sql/
│   ├── 01-catalogo.sql                 ← pizzas, tamaños, ingredientes, combos, cupones
│   ├── 02-clientes.sql                 ← clientes + direcciones + segmentación
│   ├── 03-pedidos.sql                  ← pedidos + items + estados + zonas + repartidores
│   ├── 04-pagos.sql                    ← pagos + MercadoPago
│   ├── 05-whatsapp.sql                 ← conversaciones + slots + carrito + templates
│   ├── 06-crm-engagement.sql           ← campañas + scores + recordatorios + eventos
│   ├── 07-stock-recetas.sql            ← INSUMOS + recetas + kardex + alertas + mermas
│   ├── 08-proveedores.sql              ← proveedores + contactos + precios actuales + histórico
│   ├── 09-compras.sql                  ← OC + recepciones + facturas prov + pagos prov + ctas ctes
│   ├── 10-caja-finanzas.sql            ← cajas + aperturas + movimientos + gastos + reportes diarios
│   └── 11-empleados-turnos.sql         ← empleados + turnos + asistencias + comisiones + liquidaciones
├── prompts/
│   └── system-prompt.md                ← system prompt completo del agente
├── tools/
│   └── tools-definicion.json           ← schema JSON de las tools del agente
└── webhook/
    └── README.md                       ← cómo armar el webhook usando el kit base
```

## Orden recomendado para arrancar

1. Leer todo este README + **`docs/00-vision-y-mvp.md`** primero.
2. Ver el **MVP** en `docs/04-roadmap.md` — 4-6 semanas para tener algo vendible.
3. Crear las tablas SQL en orden (`01` → `11`). Las 1-6 son **front** (cliente, pedidos, pagos), 7-11 son **back office** (stock, compras, finanzas, RRHH).
4. Adaptar el `webhook-base.php` del kit con el `system-prompt.md` y `tools-definicion.json`.
5. Configurar el panel admin para que el restaurante vea pedidos en vivo + alertas de stock.
6. Pre-crear templates WhatsApp (saludo, opciones de pizza, tipo entrega, forma de pago, confirmación).
7. Cargar datos iniciales: insumos (~50-100), proveedores, recetas, stock inicial.

## Stack en una línea

```
Cliente WhatsApp ↔ Twilio ↔ webhook PHP ↔ Claude (con tools) ↔ MySQL
                              ↘ Whisper (audios)
                              ↘ MercadoPago (links pago)
                              ↘ Mapas (Google/OSM) para validar zonas delivery
```

## Estimación de tiempo de implementación

| Etapa | Tiempo |
|---|---|
| MVP funcional (1 pizzería piloto) | 3-4 semanas |
| V1 con CRM + métricas | 6-8 semanas |
| V2 multi-tenant (varias pizzerías) | 12-16 semanas |

## Modelo de negocio rápido

- Cobrar **suscripción mensual** al restaurante: $80-200 USD/mes según volumen.
- Setup inicial: $300-800 USD (alta + onboarding + templates).
- Plus por pedido: $0.10 USD por pedido cerrado (o incluido en plan).
- Diferencial: el CRM con campañas masivas (WhatsApp marketing) es lo que cierra ventas.

Ver `docs/02-crm.md` para detalles del CRM como diferencial competitivo.