# 🚀 Inicio rápido — primer paso

Estás acá porque copiaste el proyecto a una carpeta nueva y querés arrancar. Esto te lleva del 0 al "tengo la BD lista y puedo leer todo".

## 1. Estructura esperada en tu disco

Después de copiar `_proyecto-pizzeria/` y `_kit-agentes-whatsapp/`:

```
C:\dev\pizzeria\
├── _kit-base/                   (era _kit-agentes-whatsapp, renombralo)
│   ├── README.md
│   ├── 01-arquitectura.md
│   ├── 02-onboarding-cliente.md
│   ├── 03-templates-whatsapp-realidad.md   ⭐ leer primero
│   ├── 04-agente-claude-loop.md
│   ├── 05-voz-y-imagenes.md
│   ├── 06-troubleshooting.md
│   ├── 07-modelo-negocio.md
│   └── ejemplos/
├── INICIO-RAPIDO.md             (este archivo)
├── README.md
├── docs/                        (7 archivos)
├── sql/                         (12 archivos)
├── prompts/
├── tools/
└── webhook/
```

## 2. Abrir el proyecto en Cursor/VS Code

```powershell
cd C:\dev\pizzeria
cursor .
# o si tenés VS Code:
code .
```

Cuando abre, en el panel izquierdo vas a ver toda la estructura.

## 3. Leer en este orden (recomendado, ~2 horas total)

1. **`README.md`** (5 min) — qué es el proyecto, decisiones tomadas
2. **`docs/00-vision-y-mvp.md`** (10 min) — qué hacés en 4 semanas para llegar al MVP
3. **`_kit-base/03-templates-whatsapp-realidad.md`** (15 min) — ⭐ **las trampas de Meta que te ahorran días**
4. **`docs/01-flujo-pedido.md`** (15 min) — paso a paso de un pedido
5. **`docs/02-crm.md`** (10 min) — el diferencial para vender
6. **`docs/05-stock-y-recetas.md`** (15 min) — el back office crítico
7. **`docs/07-diagrama-esquema.md`** (10 min) — mapa visual de las tablas
8. **`docs/04-roadmap.md`** (10 min) — plan de 7 meses
9. **`_kit-base/02-onboarding-cliente.md`** (15 min) — cómo dar de alta una pizzería
10. **`_kit-base/07-modelo-negocio.md`** (15 min) — pricing y pitch

**Tip**: en Cursor/VS Code, con un `.md` abierto, apretá `Ctrl+Shift+V` para ver el preview renderizado con tablas, código y diagramas.

## 4. Levantar la base de datos local

Necesitás **MySQL 8+** o **MariaDB 10.5+** instalado.

### Si NO tenés MySQL instalado

Para Windows: instalar XAMPP o WAMP (incluyen MySQL + PHP + Apache).

```powershell
# XAMPP: https://www.apachefriends.org/
# Después de instalar, levantar Apache y MySQL desde el panel de XAMPP.
```

### Crear la base con todas las tablas + datos de ejemplo

```powershell
cd C:\dev\pizzeria\sql

# Si usás XAMPP:
C:\xampp\mysql\bin\mysql.exe -u root < 00-crear-todo.sql

# Después cargar datos de ejemplo:
C:\xampp\mysql\bin\mysql.exe -u root pizzeria < 99-datos-ejemplo.sql
```

Si todo OK, vas a ver:

```
+------------------------------------------------+
| estado                                         |
+------------------------------------------------+
| Todas las tablas creadas correctamente.        |
+------------------------------------------------+

+--------------------------------------------+---------+-----------+---------+----------+-------------+
| estado                                     | insumos | productos | recetas | clientes | proveedores |
+--------------------------------------------+---------+-----------+---------+----------+-------------+
| Datos de ejemplo insertados correctamente. |      19 |         9 |       2 |        4 |           4 |
+--------------------------------------------+---------+-----------+---------+----------+-------------+
```

## 5. Explorar los datos con phpMyAdmin

Si XAMPP está corriendo, abrir en el navegador:

```
http://localhost/phpmyadmin
```

Seleccionar la BD `pizzeria` en el panel izquierdo. Vas a ver las ~62 tablas con datos cargados.

Probar queries útiles:

```sql
-- Ver productos con precio por tamaño
SELECT p.nombre AS producto, t.nombre AS tamanio, pp.precio
FROM productos p
LEFT JOIN precios_productos pp ON p.id = pp.id_producto
LEFT JOIN tamanios t ON pp.id_tamanio = t.id
WHERE pp.precio IS NOT NULL
ORDER BY p.nombre, t.orden;

-- Ver stock actual de insumos críticos
SELECT i.nombre, sa.cantidad, sa.cantidad_minima,
       CASE WHEN sa.cantidad < sa.cantidad_minima THEN '⚠️ BAJO' ELSE 'OK' END AS estado
FROM stock_actual sa
JOIN insumos i ON sa.id_insumo = i.id
ORDER BY sa.cantidad / sa.cantidad_minima ASC;

-- Ver receta completa de pizza muzza grande
SELECT i.nombre AS insumo, ri.cantidad, um.codigo AS unidad
FROM recetas r
JOIN recetas_items ri ON r.id = ri.id_receta
JOIN insumos i ON ri.id_insumo = i.id
JOIN unidades_medida um ON i.id_unidad_uso = um.id
WHERE r.id_producto = (SELECT id FROM productos WHERE nombre = 'Muzzarella')
  AND r.id_tamanio = (SELECT id FROM tamanios WHERE nombre = 'Grande');
```

## 6. Próximos pasos (cuando estés con el cerebro fresco)

### Si querés arrancar a programar el webhook

1. Setear cuenta de Twilio + número de prueba (ver `_kit-base/02-onboarding-cliente.md`).
2. Adaptar el esqueleto `_kit-base/ejemplos/webhook-base.php` con:
   - `prompts/system-prompt.md` como system prompt
   - `tools/tools-definicion.json` como definición de tools
3. Implementar tool por tool (empezar por `buscar_productos` que es la más simple).

### Si querés arrancar por el panel admin

1. Decidir framework PHP (Laravel, plain PHP con templates Twig, etc.)
2. Empezar por:
   - Login + lista de pedidos en vivo (websocket o polling)
   - CRUD básico de productos y precios
   - CRUD de insumos + stock
   - Apertura/cierre de caja

### Si todavía no decidiste

Empezá leyendo y entendiendo. **No codeés sin tener claro el panorama.** El producto se ve simple por fuera pero por dentro tiene 60 tablas que se interconectan. Una semana leyendo te ahorra meses de refactor.

## 7. Si te trabás con algo

- Mandame el archivo + la pregunta concreta
- O abrí un issue tipo "esto no entiendo" en tu repo y lo vamos resolviendo

---

**Última cosa**: este proyecto está pensado para que cuando tengas el MVP, salgas a vender a **pizzerías pyme de barrio** (no cadenas grandes). El pitch lo tenés en `_kit-base/07-modelo-negocio.md`. Suerte. 🍕