# SPEC — Simulação de Operação (Demo)

| Campo | Valor |
|-------|--------|
| **Versão** | 0.1.0 |
| **Data** | 2026-10-22 |
| **Rota UI** | `/sim` (menu · só gestor) |
| **API** | `/api/sim/*` |
| **Marca pedido** | `inboundKey` prefixo `sim:` · notes `[SIM-OPS]` |

---

## 0. Objetivo

Rotina automática que **demonstra o ciclo completo** da pizzaria em Joinville:

entrada (Aplicativo / WhatsApp / Telefone) → Central → KDS (pizzaiolos) → estufa → despacho → motoboy → entrega.

Liga / desliga no menu. Limpa dados de teste em tempo real.

---

## 1. Parâmetros

| Parâmetro | Valor |
|-----------|--------|
| Cidade | Joinville / SC (bairros do mapa) |
| Intervalo entrada | 2–6 min (mantém fila visível; almoço/jantar mais curto) |
| Cap ops/dia | 2000 (create/claim/bump/estufa/rota/entrega) |
| Prep máximo | **165 min** — só força se travar |
| Confecção | **14–18 min** simples · **18–25 min** complexa (média pizzaria) |
| Estufa | 4–7 min · Entrega 14–25 min · ciclo ~35–55 min |
| Motoboys | 15 com **nomes reais** (Steve Rogers, Ricardo Alves…) |
| Pizzaiolos | 8 KDS com nomes (Cláudio, Gil, Cristiane…) |
| Pizza | simples / complexa · até 4 sabores · **sempre** com complemento (borda/extra) |
| Pedidos | 1–N itens; múltiplos por “onda” |
| ETA entrega | 8–18 min após despacho (distância); então `entregue` |

Faixas busy (America/Sao_Paulo): **11:30–14:00** e **18:00–22:30**.

---

## 2. API

| Método | Path | Efeito |
|--------|------|--------|
| GET | `/api/sim/status` | ligado?, stats, nextIngressAt |
| POST | `/api/sim/start` | seed frota/pizzaiolos · liga tick · burst inicial |
| POST | `/api/sim/stop` | para tick (dados ficam) |
| POST | `/api/sim/purge` | apaga pedidos/rotas/drivers SIM · zera stats |

---

## 3. App Motoboy (decisão)

- **Agora:** `/motoboy` PWA continua o app do entregador; a simulação alimenta as mesmas rotas/API e conclui entregas com ETA (você vê pins sumirem no despacho).
- **Depois (não bloqueia demo):** PIN do motoboy, offline queue, deep-link Waze/Google configurável, push — SPEC-DESPACHO E.

---

## 4. Aceite

1. Gestor liga em `/sim` → pedidos entram sozinhos nos canais.  
2. KDS mostra pizzaiolos pegando tasks.  
3. Despacho: verdes → rotas → mapa.  
4. Entregas fecham sozinhas no ETA.  
5. Desliga para o tick.  
6. Limpar remove só dados `sim:` sem derrubar cardápio/seed real.