Brasa — cardápio e gestão
Aplicação construída a partir de PRODUCT.md, TELAS-E-DESIGN.md, ARQUITETURA.md e das quatro referências. Os documentos originais foram preservados.
Executar
Requisito: Node.js LTS compatível (desenvolvido com Node 24.13.0).
npm ci
npm run dev
/ encaminha para a gestão: visitantes entram em /login e usuários autenticados seguem para seu restaurante. O cardápio público fica em /r/[slug] e não contém atalhos para a gestão. A antiga gestão de demonstração também valida a sessão no servidor antes de renderizar. Use o mesmo navegador e duas abas para experimentar pedido e gestão. Os dados ficam no localStorage, no namespace brasa:demo:v1. O checkout é um teste local, não um pedido real. Use dados fictícios. Limpar os dados do site reinicia a demonstração. Outro navegador possui outra demonstração, sem sincronização entre dispositivos.
O que está utilizável
- Cardápio imersivo: mídia ocupa toda a altura da tela, sem barras de compra ou sacola aberta. Nome/preço e ícones ficam sobrepostos. Deslize vertical troca produto; lateral troca categoria. Detalhes, compra, sacola e busca abrem em painéis. Lista tradicional continua disponível pelo ícone superior.
- Fotos locais, detalhe de ingredientes/alergênicos, observação e quantidade. No modo imersivo, o vídeo ativo inicia sem som (respeitando movimento reduzido e bloqueios do navegador); pausa fora da tela/aba ou ao abrir painéis. Pausa e áudio continuam controláveis. Na lista/prévia, a reprodução é manual.
- Sacola persistente; checkout com mesa, nome, telefone e marketing opcional/desmarcado. Revalidação de preço, disponibilidade e pausa da operação.
- Pedido de demonstração salvo antes da confirmação; acompanhamento pelo identificador de sessão local, sem acesso por telefone.
- Gestão com visão geral, quadro de pedidos, transições explícitas, cancelamento com motivo e estimativa manual.
- Produtos com edição, seletor único de foto ou vídeo do dispositivo, prévia, publicação/rascunho, disponibilidade, cópia e arquivamento. Categorias com nome, ordem, visibilidade e realocação.
- Contatos com registro da escolha e revogação. Um novo pedido não reativa consentimento nem substitui o nome de um contato existente.
- Métricas locais de vídeos com visualizações qualificadas, tempo médio assistido, conclusão e filtros por produto/período. Atualizam entre abas e persistem no navegador por até 30 dias (máximo 10.000 registros). Fotos e prévias do cadastro não contam; dados da demo não são enviados ao Supabase.
- Perfil, mesas, links e download de QR. O link pode ser gravado em NFC por equipamento externo.
- Prévia de papéis dono/operação. A troca de perfil da demo não é um mecanismo de segurança.
Modo conectado ao Supabase
Acesse /login para criar sua conta e depois /gestao para cadastrar o restaurante. O endereço público é /r/seu-endereco. Esse ambiente usa dados reais do Supabase; a demonstração continua isolada em /r/demo e /demo/gestao.
O painel conectado inclui produtos, upload de fotos no Storage, categorias, pedidos por etapa, contatos, configurações, horários e QR das mesas. Donos gerenciam o restaurante; operações acessam os pedidos. O painel usa Realtime e reconciliação a cada 15 segundos; o cliente consulta seu pedido a cada 5 segundos enquanto a aba está visível. O acesso é restrito ao cookie de sessão, nunca ao telefone informado.
O restaurante nasce pausado. Cadastre produtos publicados, mesas, horários e o contato de privacidade, depois habilite os pedidos. O pagamento acontece no estabelecimento.
O cardápio conectado consulta alterações a cada 15 segundos enquanto está visível e ao voltar para a aba. Produtos, preços e vídeos prontos são atualizados sem recarregar a página e sem apagar a sacola. Compartilhe /r/seu-endereco: /r/demo contém somente a demonstração local, que não compartilha dados entre localhost, Vercel ou outros navegadores.
As migrations 001 a 004 foram aplicadas no projeto fornecido. Verificação no painel: 14 tabelas públicas, todas com RLS habilitado. As APIs pública e de servidor responderam 200. Não execute novamente essas migrations nesse projeto.
Supabase
- Crie um projeto próprio para homologação. Copie
.env.example para .env.local.
- Preencha
NEXT_PUBLIC_SUPABASE_URL, NEXT_PUBLIC_SUPABASE_ANON_KEY, SUPABASE_SERVICE_ROLE_KEY e NEXT_PUBLIC_APP_URL com a origem exata do app.
- Para um NOVO projeto vazio, execute os arquivos de
supabase/migrations em ordem numérica. No projeto fornecido, as migrations já foram aplicadas.
- Configure a URL do site e os redirecionamentos de Auth para
/auth/confirm. Ative confirmação de e-mail e configure SMTP para entrega confiável. Nenhum login/senha é fornecido ou embutido.
- As entidades têm
restaurant_id, chaves compostas e RLS. Dono gerencia catálogo; operação pode consultar pedidos e usar a função de transição. Contatos e métricas são restritos ao dono.
onboard_restaurant cria restaurante fechado e categorias para o usuário autenticado. Preencha horários estruturados, mesas e produtos. Horários são intervalos dentro do mesmo dia; para atravessar meia-noite, cadastre dois intervalos em dias adjacentes.- A suíte
npm run test:database executa 37 verificações transacionais e de RLS em PostgreSQL embarcado. Ela representa Auth/Storage localmente e não substitui a validação hospedada. supabase/tests/isolation.sql é opcional para homologação descartável com pgTAP. Execute também ACEITE-E-PILOTO.md antes de um piloto.
Contratos de pedido
| Endpoint | Comportamento |
|---|
POST /api/restaurants/:id/session | Reutiliza sessão válida ou cria token aleatório; guarda somente hash no banco; cookie HttpOnly/SameSite Strict, Secure em produção, expira em 12 horas. |
POST /api/restaurants/:id/orders | Valida origem e entrada Zod; RPC transacional revalida restaurante, horário, mesa, catálogo, preço e quantidades; congela os itens e registra status/consentimento. |
GET /api/restaurants/:id/orders/:orderId | Filtra restaurante, pedido e sessão do cookie; respostas privadas sem cache. |
PATCH /api/restaurants/:id/orders/:orderId | Valida associação e transição, bloqueia a linha e exige status esperado para detectar concorrência. |
place_guest_order serializa tentativas da mesma sessão, compara hash do payload por chave e limita pedidos por sessão. Ainda é obrigatório configurar limite por IP/origem e proteção da criação de sessões no provedor de hospedagem; múltiplas sessões podem contornar o limite por sessão. A persistência de demonstração não oferece transações/distribuição de banco e não deve ser usada para operação real.
Vídeos do piloto no Supabase Storage
- Novos vídeos usam
restaurant-videos, sem depender de assinatura Cloudflare. O seletor aceita MP4 (H.264) ou WebM de até 45 segundos e 20 MB. Não há conversão automática de codecs nem streaming adaptativo; exporte MOV/HEVC para MP4 H.264 antes de enviar.
- Configure o bucket com a migration
005_video_storage.sql ou node scripts/setup-video-storage.mjs (somente cria se ausente e verifica os limites). No projeto fornecido, o bucket foi criado pela API em 14/10/2026. As migrations 001–004 não devem ser reaplicadas.
POST /api/restaurants/:id/media exige dono e produto do mesmo restaurante. Emite URL assinada para um caminho exclusivo, sem sobrescrita. O arquivo vai direto do navegador ao Storage, sem passar pela Vercel. Não há políticas de escrita direta para usuários nesse bucket.PATCH verifica no servidor a existência, tamanho e MIME do objeto antes de publicar sua URL. A duração é medida no navegador e validada na API; este piloto não faz análise independente da duração/codecs no servidor. Os estados não podem ser declarados diretamente pelo cliente.- Reprodução pública, como as fotos do cardápio. Evite documentos e dados pessoais. A gestão reconcilia envios pendentes, e o cardápio aberto consulta novidades a cada 15 segundos. O teste conectado faz upload e reprodução reais, sem simular o provedor.
- O limite por arquivo é aplicado no bucket e na API. A franquia total e o tráfego continuam sujeitos ao plano Supabase; não há garantia de uso ilimitado ou custo zero. Substituições mantêm versões anteriores para métricas; revisar armazenamento e limpar versões sem uso antes de ampliar o piloto.
- Mídias legadas do Cloudflare ainda podem ser reproduzidas e sincronizadas se houver assinatura e credenciais válidas. As variáveis Cloudflare são opcionais para novos uploads. Nenhum plano Cloudflare foi contratado.
- Fotos usam
restaurant-media: JPEG/PNG/WebP até 5 MB, escrita por dono e reprodução pública. Na demo, fotos de até 1 MB e vídeos de até 20 MB ficam somente no navegador; use a gestão real para compartilhar entre dispositivos.
- Chaves privilegiadas permanecem apenas no servidor.
.env.local é ignorado pelo Git.
Limites atuais
Métricas de fotos
-
A migration 006_photo_observations.sql foi aplicada ao projeto em 15/10/2026. Mantém observações de fotos separadas das reproduções de vídeo, com leitura restrita ao dono do restaurante.
-
Uma foto carregada conta após 1 segundo com pelo menos 50% visível e a aba ativa. Prévias, placeholders e acessos de membros autenticados não contam. Cada visita ao painel da foto é uma observação, não uma pessoa única. Trocar a foto preserva o histórico anterior pelo endereço do arquivo.
-
A gestão mostra visualizações qualificadas, tempo visível total/médio e sessões com o mesmo produto na sacola ou em um pedido. O período é de 7 ou 30 dias; atualização a cada 15 segundos. Associações não significam causalidade e incluem pedidos cancelados.
-
O servidor valida sessão, produto e foto publicada, elimina reenvios pela sequência e limita intervalos e frequência. O tempo visível continua sendo uma estimativa do navegador, sujeita a perdas e bloqueios. As métricas começam com novas visitas, sem preenchimento retroativo.
-
Convites da equipe são administrados no Supabase; não há envio de convites no app. Usuários de operação precisam de associação em restaurant_members.
-
Recuperação/cadastro de senha têm rotas implementadas; entrega de e-mail depende das configurações Auth/SMTP do projeto.
-
O prazo de revisão de dados nas configurações é informativo. Não existe exclusão automática por retenção.
-
Métricas observam versão, reprodução visível, tempo e cobertura. A associação mostra sessões que viram o vídeo e também adicionaram ou pediram o mesmo produto no período; não indica causalidade, ordem dos eventos ou pagamento. Pedidos cancelados também entram nessa associação.
-
Configure limite por IP na hospedagem, backup/restauração e procedimento de privacidade antes de uso público.
Verificações
npm run typecheck
npm run lint
npm run build
npm test
npm run test:database
npm run check:connections
Os testes Playwright usam um navegador instalado via npx playwright install chromium. Se já houver Chromium no ambiente, defina PLAYWRIGHT_CHROMIUM_EXECUTABLE com o caminho completo. PLAYWRIGHT_BASE_URL permite testar outra porta/instância. Capturas ficam em .impeccable/review/. Os testes usam contextos isolados e dados fictícios.
Em 14/10/2026, build e lint passaram. O cenário conectado passou contra a versão compilada local com Supabase real: upload assinado de vídeo, reprodução automática no Reels já aberto, preservação da sacola, pedido e isolamento entre restaurantes. Os dados e arquivos temporários são removidos ao terminar. Esse teste também verifica rejeição de tipo, tamanho e duração inválidos e de escrita direta no bucket.
Na validação de 12/10/2026, os 16 cenários passaram em lotes: 15 na rodada completa e um após corrigir a inicialização do seletor de perfil da demonstração. O teste real confirmou login, onboarding, foto no Storage, sacola, consulta de associações, pedido, acompanhamento e isolamento. Ele exige RUN_CONNECTED_LIVE=1 e autorização explícita para criar e remover duas contas e restaurantes temporários, uma foto e um pedido. Sem essa opção, o cenário hospedado é ignorado. Não execute dois processos Playwright simultaneamente.
Auditoria de dependências nesta entrega: npm audit --omit=dev sem vulnerabilidades. O audit completo reportou cinco ocorrências altas na cadeia de desenvolvimento eslint-config-next → fast-glob → micromatch → braces (GHSA-vfj7-8cjw-p6xm). Não foi aplicado audit fix --force, pois a sugestão envolve downgrade incompatível da configuração Next. Não alimentar o lint com padrões glob não confiáveis; acompanhar atualização upstream.
Deploy e recuperação
- Vercel ou ambiente Node compatível:
npm ci, npm run build, npm start. Configure variáveis e a URL HTTPS, depois confira cookies, origens e redirects.
- Publicação:
https://cardap-io-lilac.vercel.app. Em 13/10/2026, foram configuradas as seis variáveis de produção na Vercel, com as credenciais de servidor salvas como Secret e NEXT_PUBLIC_APP_URL=https://cardap-io-lilac.vercel.app. O redeploy do commit 705cd45 ficou Ready e o login foi ativado. Entrega de e-mail e redirects Auth no Supabase continuam precisando de validação. A demo mantém seu aviso; os slugs reais carregam apenas dados reais.
- Supabase, Stream, hospedagem, domínio e SMTP podem ter custos; planos, volume e orçamento não foram contratados nesta entrega.
- Antes do piloto, configure backups/retention no plano Supabase, exportações protegidas e um teste real de restauração em ambiente separado. Defina retenção/exclusão dos contatos, imagens e vídeos com o restaurante.
- Não há backup remoto dos dados de demonstração. Um reset do navegador elimina os testes locais.
- Defina alternativa operacional com a equipe em queda de conexão. Nenhum pedido deve ser tratado como recebido sem confirmação persistida do backend conectado.
Fontes de implementação: Next.js, Supabase SSR, Cloudflare Stream.
Testes da área autenticada
Os testes da interface de gestão da demonstração exigem PLAYWRIGHT_ADMIN_STORAGE_STATE, apontando para um storage state de uma conta de teste autenticada no mesmo ambiente. Guarde o arquivo em playwright/.auth/ (ignorado pelo Git). Sem essa sessão, somente esses cenários são ignorados; os testes públicos e de bloqueio de acesso seguem ativos. Não há senha fixa nem bypass de autenticação para testes. O fluxo conectado completo continua opt-in via RUN_CONNECTED_LIVE=1.
Ingredientes e opcionais
- Em Produtos → Editar produto, informe os ingredientes que podem ser retirados, um por linha. Eles aparecem marcados no detalhe do prato; desmarcar não reduz o preço. A descrição completa de ingredientes e os alérgenos continuam separados.
- Em Opcionais, cadastre nome, preço por unidade (zero para grátis), disponibilidade e os produtos vinculados. A lista mostra onde cada opcional é usado; pausar o opcional retira-o das novas escolhas.
- O cliente escolhe adicionais antes de adicionar à sacola. O custo de cada adicional é multiplicado pela quantidade do produto. Versões diferentes do mesmo prato ficam em linhas separadas.
- Sacola, revisão, acompanhamento e cozinha exibem retiradas e adicionais. O servidor valida os vínculos e preços e salva as escolhas no pedido; alterações futuras não modificam pedidos anteriores.
- A migration 007_product_options.sql foi aplicada no projeto fornecido em 15/10/2026. Em outro projeto, execute as migrations em ordem antes de publicar esta versão.
- Teste hospedado específico: RUN_CONNECTED_LIVE=1 com npm test -- tests/options-live.spec.ts. Cria duas contas temporárias, verifica cadastro, sacola persistida, pedidos e isolamento, e limpa apenas seus dados ao terminar.
