# Roadmap de Prompts — Claude Code > Cada item abaixo é um prompt de granularidade **média** (1 sub-feature). > Execute em ordem. Cada prompt assume que CLAUDE.md, architecture.md e specs já estão no repo. > Antes de cada prompt, faça checkpoint Git: `git checkout -b feature/{nome-do-prompt}`. ## Como usar este roadmap 1. Antes do primeiro prompt: `git init`, copie `CLAUDE.md`, `docs/architecture.md` e `docs/specs/*` para a raiz. 2. Para cada prompt: - Crie branch nova - Cole o prompt no Claude Code - Revise o diff antes de aceitar - Rode testes (`php artisan test`) - Commit - Merge para main quando passar 3. Não pule prompts. A ordem importa porque há dependências. --- ## FASE 0 — FUNDAÇÃO ### Prompt 0.1 — Bootstrap do projeto Setup inicial Laravel 11 + Inertia + Vue 3 + TS + Tailwind + Docker. ### Prompt 0.2 — Multi-tenancy com Stancl Instalar e configurar Stancl/Tenancy v3 single-DB. Trait `BelongsToTenant`. Middleware de resolução de tenant por subdomínio. ### Prompt 0.3 — Modelo central (tenants, plans, subscriptions, super-admin) Painel central separado para o dono do SaaS gerenciar tenants e planos. ### Prompt 0.4 — Multi-loja (stores) e seleção de loja ativa CRUD de lojas, pivô store_user, seletor de loja na topbar, escopo automático por loja ativa. ### Prompt 0.5 — Auth (Sanctum SPA + Forgot password + 2FA opcional) Login, logout, reset de senha, 2FA com TOTP via google2fa. ### Prompt 0.6 — RBAC com Spatie Permission Papéis padrão: super-admin, owner, manager, cashier, waiter, kitchen, delivery. Seeder de permissões. ### Prompt 0.7 — Layout admin base AppLayout Vue: sidebar colapsável, topbar com seletor de loja e usuário, breadcrumbs, dark mode, toast system. ### Prompt 0.8 — DataTable e FormBuilder reutilizáveis Componentes Vue genéricos para listagem com filtros/paginação/ordenação e formulários declarativos. ### Prompt 0.9 — Auditoria e activity log Spatie ActivityLog configurado, observers nos models críticos, tela de visualização do log. ### Prompt 0.10 — Filas (Horizon) e Broadcasting (Reverb) Configuração de Horizon com filas nomeadas (default, fiscal, printing, integrations, broadcast). Reverb rodando. --- ## FASE 1 — CADASTROS ### Prompt 1.1 — Categorias e subcategorias Árvore hierárquica (nested-set ou closure-table), CRUD, drag-drop de ordenação. ### Prompt 1.2 — Produtos (modelo base + CRUD simples) Tabela `products` com campos fiscais completos, CRUD admin, upload de múltiplas imagens via Media Library, disponibilidade por horário, preços por canal/loja. ### Prompt 1.3 — Insumos (cadastro básico para ficha técnica) Tabela `ingredients` (ou `products` com tipo `ingredient`), unidades de medida, custo unitário. ### Prompt 1.4 — Fichas técnicas Vínculo produto ↔ insumos, cálculo de CMV, fichas aninhadas, versionamento, baixa automática. ### Prompt 1.5 — Pacotes (combos) Produto-pai com grupos de itens (fixos ou de escolha), regras de min/max, preço fixo ou somatório. ### Prompt 1.6 — Pizza multi-sabor Configuração de tamanhos, sabores, regra de cálculo (maior/média/proporcional), bordas, massas. ### Prompt 1.7 — Adicionais e grupos de adicionais CRUD de grupos, vinculação a produtos ou categorias, regras de min/max/obrigatoriedade. ### Prompt 1.8 — Importação de catálogo do iFood Cliente HTTP do Merchant API, OAuth2 client_credentials, sync de categorias e itens, mapping com produtos existentes. ### Prompt 1.9 — Tabelas de preço CRUD de price_lists, vinculação a canal/loja, override por produto. --- ## FASE 2 — VENDAS ### Prompt 2.1 — Caixa (cash registers) Abertura, fechamento, sangria, suprimento, conferência cega vs declarada. Por usuário e turno. ### Prompt 2.2 — PDV / Venda balcão Tela única com busca rápida, carrinho, multi-pagamento, desconto com permissão, atalhos de teclado. ### Prompt 2.3 — Cadastro de mesas e mapa do salão CRUD de mesas, editor visual drag-drop do salão, status em tempo real via Reverb. ### Prompt 2.4 — Comandas Comandas físicas com código de barras/RFID, abertura/fechamento, bloqueio de comanda perdida. ### Prompt 2.5 — Lançamento de pedido em mesa Adicionar/remover itens, observações, envio para produção (impressora ou KDS), histórico. ### Prompt 2.6 — Pré-conta, conta parcial, divisão Extrato sem fechar, divisão por pessoa, divisão por item, transferência de mesa, junção. ### Prompt 2.7 — Self-service por peso Driver de balança (Toledo/Filizola via TCP ou serial), captura de peso, cálculo automático. ### Prompt 2.8 — Self-service à vontade Modo preço fechado por pessoa, controle de quantidade, modo misto. ### Prompt 2.9 — Impressão térmica Driver ESC/POS, fila de impressão, templates de cupom/comanda/produção, suporte 58/80mm USB e rede. ### Prompt 2.10 — KDS (Kitchen Display System) Tela web realtime via Reverb, estações configuráveis, alertas de tempo, marcação de pronto. ### Prompt 2.11 — App garçom PWA App Vue 3 standalone, login PIN, mesas, lançamento, offline-first com IndexedDB, push notifications. ### Prompt 2.12 — Cardápio digital QR-code na mesa Cliente scaneia, vê cardápio, pede direto. Aprovação opcional do garçom. --- ## FASE 3 — FISCAL ### Prompt 3.1 — Cadastro de certificado A1 Upload, validação de validade, criptografia em repouso, alerta de vencimento por email. ### Prompt 3.2 — Configuração fiscal por loja Regime tributário, séries, números iniciais, CSC NFC-e, ambiente (homologação/produção). ### Prompt 3.3 — Emissão de NFC-e Job assíncrono com sped-nfe, contingência offline, retransmissão, persistência de XML e protocolo. ### Prompt 3.4 — DANFE NFC-e térmica Geração de cupom fiscal em ESC/POS, QR code, dados da SEFAZ. ### Prompt 3.5 — Cancelamento e inutilização NFC-e Fluxo completo com prazo legal (30min para cancelar), interface admin. ### Prompt 3.6 — NF-e modelo 55 (entrada/saída B2B) Emissão para venda B2B, recebimento de mercadoria via importação de XML do fornecedor. ### Prompt 3.7 — SAT-CF-e (SP) Integração com equipamento SAT para SP. Opcional via flag de configuração. --- ## FASE 4 — DELIVERY E INTEGRAÇÕES ### Prompt 4.1 — Modelo de delivery (orders, addresses, delivery_zones) Tabelas, status, máquina de estados, eventos. ### Prompt 4.2 — Site delivery white-label App Vue 3 standalone, multi-tenant via subdomínio, cardápio público, carrinho, checkout, cadastro/login do consumidor. ### Prompt 4.3 — Cálculo de frete Por bairro, por raio (Distance Matrix ou OSRM), fixo, gratuito acima de X. ### Prompt 4.4 — Pagamento online no delivery Integração com Asaas (Pix dinâmico, cartão), webhook de confirmação. ### Prompt 4.5 — Painel delivery (gestão de pedidos recebidos) Tela com colunas Kanban (recebido → em produção → pronto → saiu → entregue), realtime. ### Prompt 4.6 — App entregador PWA Login, lista de entregas, aceitar, status, foto/assinatura, mapa. ### Prompt 4.7 — Integração iFood (Order API) Webhook de polling, ack, despacho, status, cancelamento. Tem que rodar 24/7. ### Prompt 4.8 — Integração genérica via webhook (CardápioWeb, etc.) Endpoint padrão para integrações de marketplaces, schema documentado. --- ## FASE 5 — FINANCEIRO E CLIENTES ### Prompt 5.1 — Cadastro de clientes (PF/PJ) CRUD com validação de CPF/CNPJ, múltiplos endereços, múltiplos contatos, LGPD (consent log). ### Prompt 5.2 — Plano de contas hierárquico CRUD com árvore, classificação (receita/despesa), DRE. ### Prompt 5.3 — Contas a pagar Lançamento manual, recorrência, parcelamento, baixa, integração com plano de contas. ### Prompt 5.4 — Contas a receber Lançamento manual + automático (vendas fiado caem aqui), baixa, conciliação. ### Prompt 5.5 — Crédito do cliente (fiado) Limite, saldo em tempo real, bloqueio com override, extrato, fechamento mensal. ### Prompt 5.6 — Boletos e Pix via Asaas Geração, baixa via webhook, conciliação automática. ### Prompt 5.7 — Conciliação bancária OFX Importação de OFX, matching com lançamentos, regras automáticas. ### Prompt 5.8 — Fluxo de caixa Realizado, projetado, gráficos, exportação. --- ## FASE 6 — ESTOQUE E COMPRAS ### Prompt 6.1 — Movimentação de estoque Entrada, saída, transferência, ajuste, perda. Custo médio ponderado em tempo real. ### Prompt 6.2 — Inventário cíclico Contagem por categoria/local, divergência, ajuste em massa. ### Prompt 6.3 — Cadastro de fornecedores CRUD, vinculação com plano de contas, condições de pagamento. ### Prompt 6.4 — Pedido de compra Cotação 3 fornecedores, aprovação, geração de pedido, tracking de recebimento. ### Prompt 6.5 — Recebimento de mercadoria Importação XML NF-e do fornecedor, conferência item a item, geração de contas a pagar. ### Prompt 6.6 — Lote e validade Para perecíveis. FEFO (first-expire-first-out), alerta de vencimento. ### Prompt 6.7 — Curva ABC e relatórios de estoque Análise, relatórios, exportação. --- ## FASE 7 — INTELIGÊNCIA ### Prompt 7.1 — Dashboard gerencial KPIs em tempo real via Reverb, comparativos, gráficos, drill-down. ### Prompt 7.2 — Relatórios exportáveis com agendamento PDF/Excel, agendamento por email, templates customizáveis. ### Prompt 7.3 — Programa de fidelidade Pontos, cashback, cartão fidelidade digital, resgate. ### Prompt 7.4 — CRM e segmentação Tags, segmentos dinâmicos, automações (cliente inativo X dias → cupom). ### Prompt 7.5 — Campanhas WhatsApp Integração Z-API ou Meta Cloud API, templates HSM, opt-in/opt-out. ### Prompt 7.6 — Aniversariantes e brindes automáticos Job diário, geração de cupom, envio. --- ## Total **8 fases. ~70 prompts.** No ritmo de 2-3 prompts/dia em time pequeno (1-2 devs), MVP completo em **5-7 meses**. Ritmo 5+ prompts/dia (3-4 devs, dev sênior) em **3-4 meses**.