68 lines
2.4 KiB
Markdown
68 lines
2.4 KiB
Markdown
# 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.
|