Manual do Painel

Menu Lateral

Barra de navegação fixa à esquerda. Header com a marca DelyGo no topo, links agrupados por uso no centro e card de identidade da loja + usuário no rodapé.

Topo: marca e botão de compactar

• Selo "D" + DelyGo identifica o painel. Abaixo, o rótulo Painel Administrativo.
• Botão chevron () compacta o menu em uma coluna estreita só com ícones — útil para liberar espaço em telas pequenas. Clique de novo para expandir.
• Em mobile, o menu vira gaveta lateral que abre pelo botão no topo da página e fecha pelo X.

Grupos de navegação

Os links são organizados por frequência de uso. Itens com gate de feature/plano não aparecem quando indisponíveis:

Modo compacto (apenas ícones)

• Ao clicar no chevron, o menu colapsa em uma coluna estreita. Cada ícone exibe tooltip com o nome do item ao passar o mouse.
• O rótulo dos grupos vira um traço divisor; o subtítulo "Painel Administrativo" e o card de identidade somem para liberar espaço.
• O selo do plano fica oculto, mas o avatar do usuário continua centralizado no rodapé.

Rodapé: identidade da loja e usuário

Logo acima do botão Sair, um card agrupa em um bloco único:

• Nome da loja (truncado se muito longo, com tooltip do nome completo).
• Selo do plano colorido com ícone de estrela: Start (cinza), Pro (azul) ou Plus (roxo).
• Linha do usuário logado: avatar com a inicial do nome, nome completo em maiúsculas e e-mail abaixo. Clicar no card abre a página Perfil, onde é possível trocar e-mail e senha.

Início (Operação)

Página inicial do painel: um cockpit operacional ao vivo para conduzir o dia. Atualiza sozinha por polling (a cada 15s) e pausa quando a aba fica oculta, retomando ao voltar. Não confunda com a Visão Geral (relatório executivo do período) — o Início cuida do agora.

Cabeçalho e status da loja

No topo: saudação ao usuário, relógio com data e o card de status da loja.

• Status: Loja aberta (verde), Loja fechada (vermelho) ou Pausado (âmbar, com o horário em que retoma). Fechada, clientes não conseguem fazer novos pedidos.
• Abrir / Fechar: botão direto no card — abrir é imediato; fechar exige confirmação.
• Pausar / Retomar: com a loja aberta, pausa temporariamente o aceite de novos pedidos por uma janela definida, retomando automaticamente (ou manualmente em "Retomar").

Banners de alerta

• Trial expirando: conforme o trial se aproxima do fim, um banner progressivo (azul → amarelo → vermelho) aparece no topo com o número de dias restantes e link para assinar.
• Alertas operacionais: um card unificado reúne avisos do momento. Nos planos PRO e PLUS, inclui o estoque (produtos esgotados/críticos) com link direto para o Balanço de Estoque.

Faixa "Ao vivo"

Indicadores em tempo real do dia. Cada chip com contagem é clicável e rola a tela até a fila correspondente. À direita: botão de som (alerta de pedido novo), modo quiosque (tela cheia), atalhos de teclado e o link Gerenciar pedidos, que abre o kanban completo em Pedidos.

Torre de filas

Abaixo da faixa, filas de trabalho que aparecem apenas quando têm itens — some sozinha quando esvazia:

• Aguardando aceite: pedidos pendentes. Aceitar é ação exclusiva daqui: abre um modal de conferência (endereço, telefone, pagamento, itens) para Aprovar, Aprovar e imprimir (com plano de impressão) ou Cancelar.
• Em produção: pedidos na cozinha, em visão só-leitura com cronômetro e urgência. O avanço de status acontece no board da cozinha / kanban.
• Prontos para despachar: pedidos delivery prontos — escolha o entregador e despache aqui.
• Aguardando retirada: rede de segurança — pedidos despachados cujo entregador ainda não confirmou a retirada acima do SLA.
• Retirada no balcão e Servir: filas de conclusão para pedidos de retirada e de mesa.

Mesas abertas e entregadores

Na lateral, blocos preenchidos por polling: Mesas abertas (comandas dine-in em aberto — clique numa mesa para ver os pedidos da comanda) e Entregadores com a carga atual de cada um.

Alertas de SLA

Um botão flutuante abre o painel lateral de Alertas SLA, listando os pedidos que estouraram (ou estão perto de estourar) o prazo de cada etapa. Vazio, mostra "Todos os pedidos dentro do SLA".

Pedidos

Central de gerenciamento de pedidos recebidos pela loja. Atualiza em tempo real (poll a cada 5s, pausando quando a aba fica oculta) com beep e toast quando novos pedidos chegam.

KPIs do topo

Quatro indicadores acima dos filtros: Pedidos hoje, Pendentes (em laranja quando > 0), Entregues e Faturamento hoje. Atualizam a cada recarga.

Filtros rápidos (chips)

Acima da barra de filtros, 5 chips com contador permitem filtrar com 1 clique, sem mexer no formulário:

Filtros avançados (formulário)

Visões: Lista e Kanban

No topo direito do título da página há um toggle Lista | Kanban que muda o modo de visualização. A escolha vale durante a navegação (clicar em filtros/chips/paginação preserva a view), mas não persiste entre visitas — toda nova abertura começa em Lista.

• Lista (padrão): tabela com uma linha por pedido. Mostra todos os campos (número, cliente, valor, pagamento, status, ações) e suporta seleção em lote.
• Kanban: 6 colunas agrupadas por etapa do fluxo — Pendente · Aceito · Em produção · Saindo/Pronto · Entregue · Cancelado. Cada pedido vira um card compacto. Em telas estreitas, as colunas rolam horizontalmente.

Status do pedido

Indicador de urgência (pedidos pendentes)

Pedidos com status Pendente ganham realce visual conforme o tempo passa, ajudando a priorizar quem está esperando há mais tempo:

• Até 10 min: aparência normal (borda esquerda na cor do status).
• 10 a 20 min: borda esquerda vermelho-clara e tempo destacado.
• Acima de 20 min: borda vermelha grossa + fundo vermelho-claro com pulso animado.

As classes são reavaliadas a cada 30 segundos sem precisar recarregar a página. Usuários com prefers-reduced-motion ativado têm a animação desabilitada automaticamente.

Tempo do pedido

A coluna de pedido mostra tempo decorrido ("há 5 min", "há 2h") em vez de data fixa. Passe o mouse sobre o tempo para ver a data e hora completas no tooltip. O texto se atualiza sozinho a cada 30 segundos.

Ações por pedido

• Alterar status (dropdown): selecione o novo status no select. O envio é automático ao mudar a opção.
• Avançar status (botão ): seta verde ao lado do select. Em 1 clique, avança o pedido para a próxima etapa lógica do fluxo (varia por modalidade — delivery, retirada ou mesa). Some quando o pedido já está em Entregue ou Cancelado.
• Auto-WhatsApp em transições críticas: ao mudar o status para Saiu para entrega ou Pronto para retirada, o sistema abre automaticamente o WhatsApp em uma nova aba com a mensagem do template pré-preenchida — você só clica "Enviar". Funciona apenas se o cliente tem WhatsApp cadastrado.
• Atribuir entregador (delivery): dropdown abaixo do status lista os entregadores ativos com vaga. Por padrão cada entregador leva um pedido por vez, mas você pode aumentar o limite em Configurações → Operação ("Máx. pedidos simultâneos por entregador", até 10). Quem atingiu o limite de pedidos em rota não aparece como opção para novos despachos, mas continua visível nos pedidos onde já está atribuído. Obrigatório antes de mover para "Saiu para entrega". Cadastre em Entregadores.
• Alterar pagamento: chip "Pago/Pendente" — clique para alternar. Útil quando o pagamento é confirmado fisicamente (Dinheiro/Pix presencial).
• Enviar WhatsApp (botão verde): abre conversa direta com o cliente, com a mensagem do template pré-preenchida.
• Ver detalhes (botão azul): abre um modal com itens, totais, endereço e dados do cliente.
• Imprimir cupom (botão escuro): envia o pedido para a impressora térmica (se pareada) ou abre o cupom em nova aba (planos PRO/PLUS).

Ações em lote (seleção múltipla)

Disponível na visão Lista. Cada pedido tem um checkbox no canto esquerdo, e o cabeçalho da lista oferece "selecionar todos visíveis".

• Marque um ou mais pedidos para que apareça uma barra preta flutuante no rodapé com o contador e três ações em lote.
• Marcar Pago: aplica payment_status = pago em todos os selecionados.
• Marcar Entregue: aplica status = Entregue em todos os selecionados.
• Cancelar: aplica status = Cancelado em todos. Restaura o estoque dos itens automaticamente quando aplicável.
• Limpar seleção: desmarca tudo sem aplicar.

Cada ação pede confirmação antes de aplicar. Pedidos que já estão no status alvo são ignorados (e contabilizados na mensagem de retorno). Limite de 100 pedidos por operação. Cada mudança é registrada em Auditoria com a flag bulk: true.

Comandas abertas (mesa / dine-in)

Quando a feature de Mesa está habilitada (PLUS), um card "Comandas abertas" aparece acima da lista listando mesas com pedidos pendentes. Cada linha mostra o total acumulado e o tempo desde o primeiro pedido. Ver detalhes em Mesas.

Cozinha (tablet)

Página dedicada para um tablet pendurado na cozinha (ou no balcão de produção). Layout otimizado para visualização a distância, toque com mãos sujas/molhadas, e operação contínua sem ficar logando ou recarregando.

Vincular um tablet (pareamento por código)

A cozinha não usa o login admin — cada tablet é vinculado uma vez por um código de 6 dígitos e fica autorizado por 90 dias. Isso evita ter a senha do dono num tablet compartilhado e dá rastreabilidade no audit log.

• No menu lateral (em outro dispositivo, geralmente o computador do dono), clique em Cozinha no grupo Operação. Abre a tela de Displays de cozinha.
• Clique em Vincular novo display, dê um nome (ex.: iPad Cozinha, Display Balcão) e gere o código.
• O código de 6 dígitos aparece grande na tela e expira em 5 minutos. A tela já fica polling — assim que o tablet pareia, a lista atualiza sozinha.
• No tablet, abra /cozinha/parear (ex.: https://seu-dominio.com.br/cozinha/parear) e digite o código. Pronto — cai direto no board.
• Quiser revogar? Na mesma tela de Displays, clique em Revogar ao lado do tablet. No próximo refresh do tablet ele cai automaticamente na tela de pareamento.

Tela cheia + tela sempre acesa (iPad / Android)

• iPad / iPhone: abra /cozinha no Safari → toque em Compartilhar → Adicionar à Tela de Início. Depois disso, abra pelo ícone — vira app standalone (sem barra do Safari), com Wake Lock estável e mais espaço útil.
• Android / Chrome / Edge: clique no botão no header. O navegador segura a tela acesa via Wake Lock API.
• Mantenha o tablet na tomada. Tela sempre acesa consome bateria rápido.

Layout: 3 colunas

Pedidos Cancelados nunca aparecem. A cozinha não pode cancelar — atendimento decide cancelamento no painel principal.

Card do pedido

Cada card mostra, em fonte grande:

• Número do pedido (#1234) e tempo decorrido (ex: há 7 min) — atualiza sozinho a cada 30s
• Tag de modalidade colorida: 🛵 Delivery (azul) · 🛍 Retirada (roxo) · 🍽 Mesa N (verde)
• Lista de itens em destaque (fonte 18px), com quantidade em amber e observações abaixo do produto. Itens que não precisam de cozinha (bebidas/balcão, conforme marcado no Cardápio) saem dessa lista e aparecem num bloco separado "🥤 Bar / balcão — pode servir já", para não poluir nem travar a percepção de pronto do prato
• Botão verde de avançar (full-width, alvo de toque grande) — label muda conforme o status atual e a modalidade:
  • Começar (Aceito → Em produção)
  • Preparado (Em produção delivery → Pronto para despacho — a cozinha não atribui entregador; o painel Pedidos cuida disso)
  • Marcar pronto (Em produção retirada → Pronto para retirada · Em produção mesa → Pronto para servir)

  A cozinha não aceita pedidos (Pendente → Aceito é exclusivo do painel Pedidos) e não conclui a etapa final — despacho, retirada, servir e entrega são feitos na torre de Operação/Pedidos. Por isso, depois de "Pronto", o card só exibe o selo "✓ Pronto".

Indicadores de urgência

• Aceito (parado, sem começar) ≥10 min: borda vermelha + tempo destacado
• Aceito (parado) ≥20 min: borda + fundo vermelho-claro com pulso animado
• O relógio conta desde a criação do pedido (espera total do cliente), não desde o aceite.
• Botão "✓ Vi" aparece em aceitos urgentes — silencia a urgência por 10 min sem mudar status (útil para "estou de olho, mas ainda não comecei")

Som de aviso

• Padrão tipo sirene (4 tons alternados) com escala separada por categoria. O som só para quando o pedido sai da cozinha (Pronto para despacho, Saiu para entrega, Pronto para retirada, Pronto para servir, Entregue ou Cancelado)
• Aguardando começar (Aceito parado) — gate curto, cobra que a cozinha inicie o preparo logo:
  • ≥ 1 min — 1 ciclo a cada 60s
  • ≥ 2 min — 2 ciclos a cada 45s
  • ≥ 3 min — 3 ciclos a cada 30s
• Em produção — gate longo, só alarma se passou do tempo razoável de cocção:
  • ≥ 8 min — 1 ciclo a cada 60s
  • ≥ 12 min — 2 ciclos a cada 45s
  • ≥ 18 min — 3 ciclos a cada 30s
• O nível usado é o maior entre as duas categorias (ex: pedido aguardando aceite há 3 min + outro cozinhando há 5 min → toca 3 ciclos)
• Botão Silenciar no header dá snooze de 5 min (fica em amber enquanto ativo)
• O navegador exige um clique inicial na página para liberar áudio — ao abrir a Cozinha pela primeira vez, dê um toque qualquer

Sincronização e atualização

• Quando a cozinha avança um status, a tela de Pedidos dos outros operadores atualiza sozinha em até 5s (sem reload, sem perder modal/seleção)
• O inverso também vale: se o atendente muda status pelo painel principal, a Cozinha atualiza sozinha em até 5s
• O refresh é silencioso e não sai da tela cheia (usa AJAX em vez de reload)

Limites e segurança

• Sem login admin no tablet: o cozinheiro nunca vê senha do dono. O tablet só consegue listar pedidos e avançar status — não acessa cardápio, financeiro, clientes ou configurações.
• Escopo do token: 256 bits aleatórios, armazenado como SHA-256 no servidor (o servidor nunca vê o plaintext em log/DB). Cookie httpOnly + Secure (em produção) + SameSite=Lax. Backup em localStorage para sobreviver a iOS PWA descartar cookie entre lançamentos.
• Rolling de 90 dias: cada acesso renova o cookie. Sem atividade por 90 dias, expira e exige re-pareamento.
• Revogação imediata: em Displays de cozinha, clique Revogar — no próximo refresh do tablet (até 5s) ele cai para a tela de pareamento. Útil se o tablet sumir ou for substituído.
• Rastreabilidade no audit log: cada avanço de status registra qual display fez a ação (não fica creditado como "admin X"). Veja em Análise → Auditoria.
• A página em si não tem links para outras áreas do sistema — única saída é o botão "Sair", que limpa o cookie local e volta ao pareamento (não revoga o device — admin pode re-vincular).
• Não é possível cancelar pedido pela Cozinha — proteção contra toque acidental. Cancelamento fica reservado ao painel principal.
• Pedidos delivery em Em produção avançam para Pronto para despacho via botão "Preparado" — a cozinha não atribui entregador nem despacha. O painel de pedidos é quem atribui o entregador e move para Saiu para entrega.

Impressora Térmica

Imprimir o cupom do pedido direto na impressora térmica da loja (80mm ou 58mm). Disponível nos planos PRO e PLUS.

Duas formas de imprimir

• Impressao silenciosa (USB direta) — recomendada. Em Chrome ou Edge, o cupom sai na impressora com um clique (ou automaticamente em pedidos novos). Sem software instalado na loja, sem caixa de dialogo.
• Impressao via navegador — fallback. Em Safari, Firefox ou sem impressora pareada, uma aba abre com o cupom e a caixa de dialogo de impressao do sistema.

Modelos homologados

Impressoras fora desta lista também funcionam desde que compativeis com ESC/POS e CP850. O popup do Chrome ja lista todos os dispositivos USB conectados.

Windows: preparar driver WinUSB (uma vez por impressora)

1. Baixe o Zadig em https://zadig.akeo.ie/ (executavel único, ~5MB, não precisa instalar).
2. Conecte a impressora via USB e deixe ligada.
3. Execute o Zadig como Administrador (botao direito → Executar como administrador).
4. No menu, ative Options → List All Devices.
5. No dropdown principal, selecione a impressora (para a POS-5811DD aparece como 0416 5011).
6. No campo da direita, escolha WinUSB (use as setas se vier outro driver pre-selecionado).
7. Clique em Replace Driver (ou "Install WinUSB Driver") e aguarde ~30 segundos.
8. Pronto. Feche o Zadig e siga para o pareamento.

Efeito colateral: apos a troca, a impressora não aparece mais em "Dispositivos e Impressoras" do Windows — ela deixa de ser uma impressora do sistema e vira um dispositivo USB generico usado exclusivamente pelo DelyGO. Consequencia em Safari/Firefox: nestes navegadores o sistema abre o cupom em nova aba com o dialogo de impressao, mas a impressora térmica não vai aparecer na lista (sem driver OS apos o Zadig). Em outras palavras: use Chrome ou Edge para imprimir. Safari/Firefox so servem como visualizacao do cupom. Para reverter: Gerenciador de Dispositivos → encontre a impressora → Desinstalar dispositivo marcando "Excluir software de driver" → desconecte e reconecte o cabo USB.

Parear a impressora (primeira vez)

1. Conecte a impressora no computador via cabo USB e ligue o equipamento.
2. Abra o painel admin no Chrome ou Edge (requer HTTPS — não funciona em http://192.168.x.y).
3. Va em Configurações → Impressora.
4. Ligue Habilitar impressora térmica e escolha a largura do papel (80mm ou 58mm).
5. Clique em Conectar impressora USB. Uma caixa nativa do Chrome abre listando os dispositivos.
6. Selecione a impressora na lista e clique em Conectar.
7. O status atualiza para Conectada. Clique em Testar impressao para validar.
8. Se quiser auto-impressao em pedidos novos, marque Imprimir automaticamente pedidos novos e salve.

Como imprimir um pedido

• Com impressora pareada, clique no ícone ao lado do pedido — o cupom imprime sem abrir aba.
• Com auto-impressao ligada, pedidos recem-chegados imprimem sozinhos assim que aparecem na tela.
• Sem pareamento ou em Safari/Firefox, o sistema abre o cupom em nova aba para impressao pela caixa de dialogo do navegador.

Impressora não aparece no popup?

• Confira o cabo USB e teste outra porta do computador, de preferencia USB 2.0 direta na placa.
• Instale o driver do fabricante (Bematech, Epson, Elgin, Daruma) se o Windows não reconheceu a impressora.
• No Linux, pode ser preciso uma regra udev para acesso sem sudo.
• Se voce bloqueou a permissao por engano, revogue em chrome://settings/content/usbDevices e tente parear novamente.

Erro "USBDevice access denied" ao imprimir?

• No Windows, quase sempre indica que o driver nativo de impressora do Windows esta segurando a porta USB. Rode o Zadig e troque o driver para WinUSB (ver seção Windows: preparar driver WinUSB acima).
• Feche qualquer outro app ou aba que possa estar usando a impressora (caixas de dialogo de impressao abertas, outros sistemas de PDV).
• Desconecte e reconecte o cabo USB — em alguns casos basta um ciclo para liberar a interface.

Cardápio

Gestao completa dos itens do cardápio: categorias, produtos e adicionais.

Categorias

• Crie categorias para organizar os produtos (ex: Lanches, Bebidas, Sobremesas).
• A categoria chamada Destaques (ou Destaque) tem tratamento especial: seus produtos aparecem na seção de destaques no topo do cardápio público.
• A ordem das categorias no cardápio público segue a ordem de cadastro.

Produtos

• Nome e descrição: Exibidos no cardápio público e nos pedidos.
• Preco: Valor base do produto. Adicionais somam ao preco final.
• Imagem: Foto do produto exibida no cardápio. Formatos aceitos: JPG, PNG, WEBP.
• Destaque: Marca o produto para aparecer também na seção de Destaques do cardápio.
• Ativo / Inativo: Produtos inativos não aparecem no cardápio público.
• Controle de estoque: Disponível nos planos PRO e PLUS. Quando ativado, define uma quantidade máxima. Ao zerar, o produto aparece como "Esgotado" no cardápio e não pode ser adicionado ao carrinho. O estoque e debitado automaticamente a cada pedido confirmado e restaurado se o pedido for cancelado. Para visualizar o balanço de todos os produtos controlados, acesse Balanço de Estoque.

Preparo na cozinha (bebidas e itens de balcão)

Marque o que não passa pela cozinha (bebidas, itens prontos de balcão) para que esses itens deixem de ficar reféns do ciclo de preparo. Por padrão, tudo precisa de preparo — nada muda até você marcar o contrário.

• Na categoria (modal de criar/editar categoria) há o toggle "Precisa de preparo na cozinha", marcado por padrão. Desmarque uma categoria inteira (ex.: Bebidas) para que todos os seus produtos sejam tratados como "servir direto".
• No produto (modal de criar/editar produto) há o seletor "Preparo na cozinha" com três opções:
  • Herdar da categoria (padrão) — segue o toggle da categoria.
  • Precisa de preparo (cozinha) — força a ida à cozinha mesmo numa categoria de balcão (ex.: suco natural dentro de Bebidas).
  • Servir direto (bar/balcão) — força "servir já" mesmo numa categoria de cozinha.

O que muda na operação:

• Na Cozinha, os itens de balcão saem da lista de preparo e aparecem num bloco separado "🥤 Bar / balcão — pode servir já", sem poluir nem "travar" a percepção de pronto do card.
• No painel Pedidos e no board do garçom, esses itens ganham o selo "servir já" / "pode servir já".
• Pedido só de bebida (mesa ou retirada, sem nenhum item de preparo) pula a cozinha no aceite: vai direto para Pronto para servir (mesa) ou Pronto para retirada (retirada), em vez de Aceito. Delivery nunca pula — a sacola continua unificada; ali a flag só evita que a bebida conte como preparo.

Exportar cardápio em PDF (para impressão gráfica)

O botão Salvar em PDF, no topo da página, abre uma versão impressa do cardápio — bonita e profissional, pronta para levar à gráfica.

• Layout A4 retrato na cor da sua marca, com logo, categorias e produtos com foto (apenas itens ativos entram).
• Rodapé com QR code do delivery: se a loja tem link público, uma faixa final convida o cliente a pedir pelo celular — basta apontar a câmera para o QR code.
• Para gerar o arquivo: na aba que abre, clique em Imprimir e, no destino, escolha "Salvar como PDF". O resultado é vetorial (texto nítido em qualquer tamanho), ideal para impressão gráfica.

Adicionais (Extras)

• Cada produto pode ter adicionais vinculados (ex: Bacon Extra, Queijo Extra).
• Cada adicional tem nome e preco próprio, somado ao total do pedido.
• Adicionais inativos não aparecem no cardápio público.

Limites por plano

Clientes

Lista de todos os clientes que ja realizaram pedidos na loja.

KPIs

Busca

Filtra por nome, telefone (WhatsApp) ou endereco do cliente. A busca e case-insensitive e retorna correspondencias parciais.

Card do cliente

• Nome, telefone e endereco: Dados informados pelo cliente no último pedido.
• Último pedido: Data e hora do pedido mais recente.
• Total de pedidos e valor gasto: Histórico acumulado do cliente.
• Botao WhatsApp: Abre conversa direta com o cliente.
• Ver histórico: Redireciona para a página de Pedidos filtrada pelo WhatsApp do cliente.

Entregadores

Cadastre quem leva os pedidos da loja. Toda vez que voce despacha um pedido de delivery (status "Saiu para entrega"), o sistema pede que voce escolha um entregador da lista — assim cada entrega fica registrada para fechamento e relatorio. Disponível em todos os planos.

Cadastrar entregador

1. No menu lateral, vá em Entregadores (grupo Operação).
2. No formulario de cadastro, informe nome (obrigatório), telefone (opcional) e tipo de veiculo (Moto, Bicicleta, Carro, A pe ou Outro).
3. Clique em Cadastrar. O entregador aparece na tabela acima como Ativo e ja fica disponível no select de despacho da página Pedidos.

Editar, desativar e reativar

• Editar: Botao na linha. O formulario de cima vira "Editar entregador" preenchido com os dados atuais — ajuste e clique em Salvar.
• Desativar: Tira o entregador do select de novos despachos sem apagar o cadastro. Pedidos historicos continuam exibindo o nome dele normalmente.
• Reativar: Volta a aparecer no select. Útil para entregadores temporarios (ferias, afastamento).

Atribuir entregador a um pedido

1. Em Pedidos, localize um pedido de delivery em andamento.
2. Na coluna de Status, abaixo do select de status, ha um segundo select "— sem entregador —" com a lista dos entregadores ativos.
3. Escolha o entregador. A atribuicao e salva imediatamente (auto-submit).
4. Mude o status para Saiu para entrega. Se voce esquecer de atribuir antes, o sistema exibe um aviso e não salva a mudanca de status — basta escolher um entregador e tentar de novo.

Quantos pedidos por entregador

Por padrão, cada entregador leva um pedido por vez: enquanto ele está em "Saiu para entrega", some das opções de novos despachos e volta à lista assim que conclui a entrega. Você pode aumentar esse limite para o entregador acumular corridas na mesma saída.

• Ajuste em Configurações → Operação, no campo "Máx. pedidos simultâneos por entregador" (de 1 a 10).
• O sistema sempre sugere o entregador com menos pedidos em rota no momento (com desempate pelo último que você usou).
• Quem atinge o limite some das opções de despacho até liberar uma vaga, mas continua visível nos pedidos onde já está atribuído.
• Na torre de operação, o entregador aparece com a contagem de pedidos em rota (ex.: "🛵 João · 3 pedidos"); passe o mouse para ver os números.
• O próprio entregador vê todas as entregas no app dele e decide a ordem — o sistema não impõe rota.

Onde o entregador aparece depois

• Lista de Pedidos: uma etiqueta verde com o nome do entregador aparece na linha do pedido apos ele ser despachado.
• Detalhe do pedido (modal): linha "Entregador: Nome" abaixo do endereco.
• Cupom termico: na impressao do pedido, o nome do entregador aparece junto aos dados de entrega — útil para conferencia rápida na cozinha.
• WhatsApp: use a variavel {entregador} no template de Atualizacao de Status para enviar o primeiro nome do entregador na mensagem do cliente (ex: "Pedido saiu com Carlos. Acompanhe pelo WhatsApp."). Ver WhatsApp.

Relatorio de entregas (PLUS)

Em Relatorios, o card "Entregas por entregador" resume o período selecionado:

• Entregas: quantidade de pedidos concluidos (status Entregue) atribuidos ao entregador.
• Faturamento: soma do valor total dos pedidos.
• Taxas: soma das taxas de entrega — base usual para calcular comissao.
• Ticket medio: valor medio por pedido entregue.
• Tempo medio: tempo entre "Saiu para entrega" e "Entregue", em minutos. Pedidos sem essas duas marcacoes não entram na media.

Se houver entregas concluidas no período sem entregador atribuido, um aviso amarelo aparece no card alertando para atribuir antes do despacho nas proximas entregas. Tudo isso pode ser exportado em CSV.

Shell do entregador (PWA /entregador/*)

Cada entregador pode usar o próprio celular para ver os pedidos em rota e marcar entrega — sem precisar de WhatsApp manual. Disponível em todos os planos.

1. Cadastrar entregador com PIN

1. Cadastre o entregador normalmente (nome, telefone, veículo).
2. Ao salvar, um PIN de 4 dígitos é gerado automaticamente e mostrado 1 vez só no card laranja. Anote ou envie pro entregador na hora.
3. Se o PIN for perdido, clique em Novo PIN na linha do entregador — um novo é gerado e o antigo para de funcionar imediatamente.
4. Imprimir o PIN (térmica 58mm): no card laranja que mostra o PIN, há o botão Imprimir PIN. Se a loja tem o recurso Impressora Térmica habilitado e uma POS-58 pareada, o cupom sai direto via WebUSB com o PIN em fonte grande + QR code apontando pra tela de login do entregador. Sem impressora térmica disponível, abre um popup A4 imprimível pelo navegador. Útil pra entregar o PIN ao novo entregador sem precisar ditar números.

2. Parear o celular do entregador

1. Na página Entregadores, no card Celulares vinculados, dê um nome opcional (ex: "Celular João") e clique em Gerar código de pareamento.
2. Um código de 6 dígitos aparece em card verde — válido por 5 minutos.
3. No celular do entregador, abra a URL https://seudominio.com.br/entregador/parear e digite os 6 dígitos.
4. O cookie de pareamento vale 90 dias (renovado a cada uso). Não precisa parear de novo a menos que o entregador limpe os cookies ou você desvincule o celular.

3. Login com PIN e uso diário

1. Após parear, o celular mostra a lista de entregadores ativos com PIN.
2. O entregador toca no próprio nome → digita o PIN no teclado → entra no board.
3. O board lista os pedidos atribuídos a ele em status Saiu para entrega (com um contador no topo separando a retirar de a caminho quando ele leva mais de um). Cada card sempre tem Mapa (Google Maps no endereço) e Ligar (chama o cliente), e o botão principal muda conforme a etapa da retirada — separada em duas confirmações para não dar pedido como retirado sem a sacola na mão:
   • 1. Confirmo que vou retirar — o entregador avisa a loja que está a caminho do balcão. Grava courier_ack_at, não muda o status nem move o pedido.
   • 2. Avisado · retire a sacola no balcão — faixa azul, sem botão. A retirada de fato é confirmada pelo atendente no balcão (botão "Entreguei ao entregador" na torre de Operação), que grava picked_up_at ao passar a sacola.
   • 3. Marcar entregue — liberado só depois que a loja confirmou a retirada. Conclui a entrega ao cliente.
4. Ao marcar entregue: o status do pedido vira Entregue, delivered_at é gravado (entra no tempo médio do relatório), o pagamento recebe baixa automática e o pedido some do board do entregador. A torre de Operação também consegue fechar a entrega pela fila Em rota, caso o entregador não marque.
5. O board recarrega sozinho a cada 15 segundos pra refletir novos despachos sem precisar dar refresh.

4. Pausar vs Sair (no celular)

No header do PWA do entregador há dois botões — escolha conforme a situação:

5. Segurança

• Lockout de PIN: 3 tentativas erradas trancam o login por 5 minutos. Resolve um ataque de força-bruta no celular roubado/perdido.
• Sessão de turno: dura até 12h, ou expira por 30 min de inatividade — o que vier primeiro.
• Single-session: se o entregador logar no celular B, a sessão do celular A é encerrada automaticamente (modelo WhatsApp Web).
• Status online/offline (sidebar de Operação): o ponto verde só aparece enquanto o app envia heartbeat (a cada 60s com a tela visível). Sem heartbeat por 3 minutos — celular bloqueado, app fechado, sem internet ou botão Pausar — o entregador fica cinza e sai automaticamente da lista de elegíveis pra novos despachos.
• Desvincular celular: no card Celulares vinculados, botão Desvincular. A sessão ativa é encerrada e o próximo acesso volta pra tela de pareamento. Útil quando o entregador sai da equipe ou perde o aparelho.

WhatsApp

Configuração dos templates de mensagem enviados automaticamente via WhatsApp.

Templates disponiveis

Variaveis dos templates

Preview

Abaixo de cada template, ha um preview em tempo real mostrando como a mensagem ficara com dados ficticios. Use para validar a formatacao antes de salvar.

Primeiros Passos

Wizard guiado para configurar a loja antes de começar a receber pedidos. Aparece automaticamente para lojas com onboarding incompleto e fica acessível em /admin/onboarding.php (não há mais entrada no menu lateral — foi removida em 2026-05-18 junto com a reorganização do menu).

Etapas

O número e a ordem das etapas variam conforme as features liberadas pelo plano. As etapas fixas são Estabelecimento e Formas de Pagamento; Modalidades e Bairros Atendidos aparecem apenas para planos PRO e PLUS.

Etapa Bairros Atendidos

• Formulario para adicionar bairros com nome, cidade e taxa. Cada bairro cadastrado vira uma opção de entrega no checkout do cliente.
• Lista dos bairros ja cadastrados, com botao para remover.
• Não e obrigatório cadastrar bairros aqui — a etapa pode ser finalizada vazia, e a loja continuara usando a taxa de entrega padrão informada na etapa 1.
• Apos a conclusao, novos bairros podem ser adicionados, editados e desativados em Configurações → Bairros Atendidos.

Configurações

Ajustes gerais da conta e da loja, organizados em secoes.

Seção: Estabelecimento

• Nome: Nome da loja exibido no cardápio público e no painel.
• WhatsApp: Número para contato e recebimento de mensagens de pedidos.
• Endereco: Exibido no cardápio público abaixo do nome da loja.
• Cor do tema: Cor primária usada em botões e destaques no cardápio público. Aceita apenas hex de 6 dígitos (ex: #08B357).
• Taxa de entrega: Valor cobrado por pedido de delivery. Exibido no checkout.
• Logo e capa: Imagens exibidas no cabeçalho do cardápio público.

Seção: Pagamentos

• Habilite ou desabilite Dinheiro, Pix, Cartão de Débito e Cartão de Crédito.
• Ao menos uma forma de pagamento deve estar ativa.
• A chave Pix e obrigatória quando Pix esta habilitado.

Seção: Modalidades

• Disponível apenas para planos PRO e PLUS (feature pickup).
• Define se a loja aceita Delivery, Retirada ou ambos. Ao menos uma modalidade deve estar ativa.
• Quando a Retirada está ativa, é possível configurar o tempo estimado de preparo em minutos.

Seção: Bairros Atendidos

• Aba disponível apenas para planos PRO e PLUS (feature neighborhood_delivery).
• Permite cadastrar, editar e remover bairros com nome, cidade, taxa própria e ordem de exibição.
• Cada bairro pode ser marcado como ativo ou inativo. Inativos não aparecem para o cliente no checkout.
• A combinacao de nome + cidade e única por loja — não é possível cadastrar dois bairros iguais.
• Quando existir pelo menos um bairro ativo, o cliente escolhe o bairro no checkout e a taxa correspondente e aplicada ao pedido.
• Se nenhum bairro estiver cadastrado (ou todos estiverem inativos), o sistema aplica a taxa de entrega padrão definida na seção Estabelecimento como fallback.

Seção: Operação

• Tempo de produção esperado (atenção / atraso crítico): dois limiares em minutos que definem quando um pedido passa a sinalizar atraso no painel — borda amarela (atenção) e vermelha (crítico). O crítico precisa ser maior que o de atenção.
• SLA de retirada do entregador: minutos após o despacho para o entregador avisar que vai retirar ("Confirmo que vou retirar") no app. Ao estourar, o card é destacado para ele e o pedido aparece em "Aguardando retirada" na torre de operação — lembrando que a retirada de fato é confirmada pelo atendente no balcão ("Entreguei ao entregador").
• Máx. pedidos simultâneos por entregador: de 1 a 10. Define quantas entregas um mesmo entregador pode levar ao mesmo tempo. 1 = um pedido por vez (padrão); aumente para permitir que ele acumule corridas na mesma saída. Detalhes em Entregadores.
• Aceite rápido (1 clique) na torre de operação: mostra um botão Aceitar direto na fila "Aguardando aceite", sem abrir a conferência, apenas para pedidos de baixo risco (pagos e — no delivery — com endereço).

Seção: Conta

• Alteracao de senha do administrador. Requer a senha atual para confirmacao.

Bairros Atendidos

Recurso de entrega por bairro para planos PRO e PLUS. Permite definir uma taxa de entrega específica para cada bairro atendido, ao inves de usar uma taxa única para toda a cidade.

Como funciona

• Cada bairro cadastrado possui nome, cidade e taxa própria.
• No checkout do cardápio público, o cliente seleciona o bairro em uma lista suspensa e a taxa correspondente e somada ao total do pedido.
• Se a loja não tiver bairros cadastrados (ou estiverem todos inativos), o sistema usa a taxa de entrega padrão definida em Configurações → Estabelecimento como fallback (retrocompatibilidade).
• A ordem de exibição no checkout segue o campo ordem definido no cadastro, com desempate alfabetico por cidade e nome.

Onde gerenciar

• Durante o onboarding: uma etapa dedicada permite cadastrar os primeiros bairros antes de concluir a configuração inicial.
• Apos o onboarding: acesse Configurações → Bairros Atendidos para adicionar, editar, ativar/desativar ou remover bairros.

Disponibilidade por plano

Cupons de Desconto

Recurso de cupons promocionais para planos PRO e PLUS. Permite criar códigos que o cliente aplica no carrinho e recebe desconto automaticamente.

Tipos de cupom

Campos do cupom

• Código: até 30 caracteres, apenas letras, números, hifen ou underline. Normalizado automaticamente para caixa alta.
• Pedido minimo: valor minimo do subtotal para o cupom valer (opcional, 0 = sem minimo).
• Limite de usos totais: quantas vezes o cupom pode ser usado no total (em branco = ilimitado).
• Usos por cliente: quantas vezes o mesmo cliente (identificado por WhatsApp) pode usar o cupom (em branco = ilimitado).
• Apenas primeiro pedido: restringe o cupom a clientes que ainda não fizeram pedido na loja.
• Validade de / até: janela em que o cupom está ativo. Selecione apenas a data — o sistema considera 00:00 do dia inicial até 23:59 do dia final.
• Ativo: liga/desliga o cupom sem precisar excluir.

Status do cupom

Ver resgates

No ícone do relogio (próximo as ações), abra o painel de resgates para ver todos os pedidos que usaram o cupom, com cliente, valor descontado, ticket médio e receita gerada.

Excluir cupom

• Cupom sem nenhum uso: removido permanentemente.
• Cupom com resgates registrados: virado em inativo automaticamente (preserva o histórico de pedidos passados).

No carrinho do cliente

• Bloco "Tem um cupom?" aparece no resumo do carrinho.
• Ao aplicar com sucesso, a linha "Desconto" aparece no resumo e o total e ajustado.
• Se o cliente reduzir o carrinho abaixo do pedido minimo, o cupom e removido automaticamente com aviso.
• O cupom e re-validado em todas as etapas (carrinho, entrega, pagamento, confirmacao). Cupons expirados/esgotados durante a sessao são bloqueados antes de virar pedido.

No pedido finalizado

• O detalhe do pedido (em Pedidos) mostra a linha "Desconto (CODIGO) -R$ X,XX" no totalizador.
• A Visão Geral e os Relatórios contabilizam os descontos concedidos no período selecionado.

Disponibilidade por plano

Visão Geral

Painel executivo em Análise → Visão Geral (exclusivo PLUS, feature advanced_reports). Responde "como o negócio está indo?" num relance, com comparação contra o período anterior e alertas acionáveis. Complementa as outras telas sem repetir: a Operação/Pedidos mostra o agora ao vivo; os Relatórios trazem tabelas detalhadas + CSV. A Visão Geral é o resumo do meio-termo.

Seletor de período

• Atalhos rápidos: Hoje, 7 dias, 30 dias (padrão) e Este mês. Ou escolha um intervalo livre em De / Até.
• O período sempre é comparado com o intervalo anterior de mesmo tamanho (ex.: 30 dias vs os 30 dias anteriores) — é daí que saem as variações nos KPIs.
• Os dados ficam em cache leve (~90s) por loja e período. A barra mostra "atualizado agora / há Xs"; o botão força recarga imediata.

Faixa de KPIs (com variação vs período anterior)

Seis indicadores com seta verde/vermelha comparando ao período anterior (quando há base):

• Faturamento, Pedidos e Ticket médio — variação em %.
• Cancelamento — variação em pontos percentuais; aqui subir é ruim (a seta de alta fica vermelha).
• Clientes novos no período (com a contagem de recorrentes ao lado).
• Descontos concedidos no período.

Tendência e saúde operacional

• Faturamento por dia: gráfico de barras com linha tracejada da média diária.
• Saúde operacional / SLA: percentual de pedidos no prazo (verde ≥90%, âmbar ≥70%, vermelho abaixo) + tempos médios de aceite, preparo e entrega. A entrega fica destacada em vermelho se passar do limiar de urgência. "No prazo" = pedido entregue dentro do limiar de urgência configurado em Configurações.

Mix, tops e pico

• Mix de canais (delivery / retirada / salão) e Formas de pagamento (pix / crédito / débito / dinheiro) em gráficos de rosca com % e valor.
• Top produtos e Top bairros (5 cada) e Horário de pico (dia + hora de maior volume).
• Cada um traz o link "detalhar →" que abre o card completo nos Relatórios com o mesmo período e botão de CSV.

Alertas acionáveis e Equipe

• Alertas: aparecem só quando "acesos" — estoque esgotado/acabando (gate stock_control), clientes sem pedir há 60+ dias, cupons no limite de uso ou vencendo em 7 dias (gate coupons), e avisos de assinatura (trial acabando / expirada). Cada alerta tem link "resolver".
• Equipe: tabela de aceites e cancelamentos por usuário no período (cancelamentos em vermelho). Ações de sistema sem usuário não entram.

Relatorios Avancados

Página Relatorios exclusiva do plano PLUS, focada em tabelas detalhadas e exportação CSV para qualquer período escolhido. Cada bloco tem botao de exportar CSV (separador ; + BOM UTF-8, abre direto no Excel). Para o resumo executivo com comparação vs o período anterior e alertas, use a Visão Geral — há um link "Ver resumo na Visão Geral" no topo desta página.

Filtro de período

• Selecione De, Até e (opcional) Dormente apos (dias); clique em Aplicar. Tudo nos cards abaixo recalcula.
• Período padrão: últimos 30 dias. Cutoff de dormentes padrão: 60 dias (intervalo aceito: 7 a 365).
• Pedidos cancelados são ignorados em todos os cálculos.

Card 1 — Faturamento

• KPIs: faturamento, pedidos, ticket médio e descontos concedidos no período (totais; a comparação vs período anterior fica na Visão Geral).
• Tabela diaria: faturamento por dia com barra de distribuicao para identificar picos e quedas.
• CSV inclui linha-a-linha do período + linhas de totais ao final.

Card 2 — Top produtos

• Até 20 produtos com maior quantidade vendida no período.
• Colunas: produto, quantidade, receita gerada, número de pedidos que tinham o produto.
• CSV exporta até 200 produtos para analises mais profundas.

Card 3 — Clientes

• Recorrencia no período: quantos clientes pediram 1 vez, 2 a 5 vezes ou 6+ vezes. Indicador rápido de retencao.
• Top 10 clientes do período: nome, WhatsApp, pedidos, total gasto, ticket médio e último pedido.
• Clientes dormindo: até 50 clientes sem pedido ha N+ dias, com N configuravel no filtro (campo Dormente apos (dias); aceita 7 a 365, padrão 60). A lista e independente do filtro de período dos demais cards. Útil para campanhas de reativacao via WhatsApp.
• O dormente conta o tempo desde o último pedido não-cancelado, em dias corridos.
• CSVs separados: Exportar top (top clientes do período, até 100) e Exportar dormentes (até 500, respeita o cutoff escolhido).

Card 4 — Quando os clientes pedem (heatmap)

• Mapa de calor 7 dias × 24 horas com a contagem de pedidos do período, sombreado em verde (mais escuro = mais pedidos).
• Indica automaticamente o pico (dia da semana + hora com maior volume) — use para escalar cozinha/entregadores.
• Passe o mouse sobre uma celula para ver pedidos e faturamento daquele slot.
• Fuso horario America/Sao_Paulo. Pedidos cancelados não contam.
• CSV exporta a matriz completa (24 colunas de hora + total da linha).

Card 5 — Modalidade & bairro

• Por modalidade: até tres cards (Delivery, Retirada no balcão e Mesa / consumo no local) com faturamento, pedidos, ticket médio e participacao percentual no período. O card de Mesa so aparece com pedidos quando a feature dine_in está ativa e ao menos um pedido foi aberto pelo garçom em "Novo na mesa".
• Por bairro: ranking dos bairros que mais faturaram. Inclui pedidos, faturamento, ticket médio e barra de distribuicao.
• O bairro e capturado no momento do pedido (snapshot no banco), entao renomear/excluir bairros depois não afeta os historicos.
• Pedidos de retirada caem em "(retirada no balcão)"; pedidos de mesa caem em "(consumo no local)"; pedidos delivery sem bairro identificavel (texto livre vazio ou pedidos anteriores ao deploy desta versao) caem em "(não informado)".
• CSVs separados para modalidade (3 linhas) e bairro (até 500 buckets).

Disponibilidade por plano

Balanço de Estoque

Relatorio de posicao atual de estoque para todos os produtos com controle ativado. Disponível nos planos PRO e PLUS. Acessivel pelo menu lateral em Relatorios → Balanço de Estoque.

O que a página exibe

• Cards de resumo: total de produtos controlados, quantos estao em estoque (OK), quantos estao criticos (5 ou menos unidades) e quantos estao esgotados (0 unidades).
• Tabela de produtos: nome, categoria, estoque atual, vendido no período, media diaria de venda e estimativa de dias restantes com base no consumo medio.
• Status visual por linha:
  • OK — estoque acima de 5 unidades.
  • Crítico — 1 a 5 unidades restantes. Reposicao urgente.
  • Esgotado — zero unidades. Produto ja aparece como indisponivel no cardápio.

Filtro de período

• Selecione De e Até e clique em Filtrar. Padrão: últimos 30 dias.
• O período afeta apenas as colunas Vendido, Media/dia e Dias Restantes — o estoque atual e sempre o valor real em tempo real.
• Pedidos cancelados são ignorados no cálculo de vendas.

Como os cálculos funcionam

Exportar e imprimir

• Exportar CSV: gera um arquivo com separador ; e BOM UTF-8 (abre direto no Excel) com todas as colunas da tabela.
• Imprimir (Navegador): abre uma aba com o cupom formatado para papel termico (58mm ou 80mm, conforme configurado em Configurações → Impressora). Funciona em qualquer navegador.
• Imprimir (Térmica): envia o balanço direto para a impressora USB pareada (Chrome/Edge), sem abrir caixa de dialogo. O cupom mostra o status [OK], [!!] (crítico) ou [XX] (esgotado) ao lado de cada produto, com colunas QTD / VND / DIA. Se não houver impressora pareada ou o navegador não suportar WebUSB, abre automaticamente no modo Navegador. O botao de impressao térmica aparece apenas para planos com a feature thermal_printer ativa (PRO e PLUS).

Disponibilidade por plano

Pedido pela mesa (QR code e garçom)

Recurso dine-in exclusivo do plano PLUS. Cada mesa do salão tem um QR code próprio. Funciona em um fluxo único:

• Cliente escaneia o QR e consulta o cardápio pelo celular — sem botão de pedir, sem carrinho. Vê foto, descrição, preço e adicionais de cada produto.
• Garçom abre o pedido pelo shell dedicado em /waiter/*, num tablet/celular pareado ao salão. Cada garçom tem PIN próprio. Veja Garçons (PIN + tablet).

O que o cliente vê ao escanear o QR

1. Cliente senta na mesa e escaneia o QR code com a câmera do celular.
2. Abre o cardápio do estabelecimento marcado como "Mesa <nome>" com aviso "Você está vendo o cardápio. Para fazer o pedido, chame o garçom".
3. Pode navegar pelas categorias e abrir cada produto (foto, descrição, preço, adicionais). Sem botão "Adicionar ao carrinho", sem ícone de carrinho na tela.
4. Ao decidir o que quer, chama o garçom, que registra o pedido pelo painel admin.

Fluxo do garçom no salão

O pedido na mesa é aberto no shell /waiter/* — uma área separada do painel admin, otimizada pra tablet. Em resumo:

1. Garçom abre o tablet pareado ao salão (cookie de dispositivo dura 90 dias).
2. Toca no próprio nome na lista e digita o PIN de 4 dígitos — assume o turno (sessão de 12h, ou 30min ocioso).
3. Toca na mesa, monta o carrinho (mesma busca de produtos, observação por item, estoque respeitado em tempo real) e confirma a forma de pagamento (padrão "Pagar no caixa", ou Pix/dinheiro/débito/crédito).
4. O pedido aparece na página Pedidos com a tag verde "Mesa <nome>" e o chip 🧑‍🍳 Garçom: <nome> (kanban e tabela). O botão 🖨 imprime normalmente.

Detalhes de cadastro, pareamento, PIN, lockout e auditoria estão em Garçons (PIN + tablet).

Como criar e imprimir as mesas

1. Acesse o menu Mesas (aparece quando o plano é PLUS).
2. Clique em "Adicionar mesa". O sistema sugere "Mesa 01", "Mesa 02"... mas você pode usar qualquer rótulo (ex: "Varanda 1", "Reservado").
3. Cada mesa ganha um token único de 16 caracteres — ele identifica a mesa no QR e é diferente em cada estabelecimento (não há risco de cliente da loja A cair no cardápio da loja B).
4. Use o botão "Imprimir QR" para gerar uma página A4 com o QR de uma mesa específica, ou "Imprimir todos" para um grid com todas as mesas ativas (uma por página com page-break automático). A URL não é exibida na impressão — apenas o QR code.
5. Imprima, recorte e cole na mesa (ou imprima em adesivo). Sugestão: plastifique para resistir a derramamentos.

Comandas abertas — agrupando pedidos da mesa

Na página Pedidos, quando há ao menos um pedido pendente em mesa, aparece um card "Comandas abertas" no topo. Cada linha mostra:

• Nome da mesa.
• Quantidade de pedidos pendentes na comanda (cliente pode ter feito 1 só pedido grande ou vários ao longo da refeição).
• Valor acumulado (soma de todos os pedidos não-pagos da mesa).
• Hora do primeiro pedido (útil para saber há quanto tempo a mesa está ocupada).
• Botão "Fechar comanda" (ver abaixo).

Fechar comanda

Quando o cliente paga no caixa, clique em "Fechar comanda". O sistema:

• Marca todos os pedidos pendentes daquela mesa como pago em uma única transação atômica (não há risco de "metade pago, metade pendente" se algo der errado no meio).
• Não altera o status dos pedidos (Aceito, Em produção, etc.) — você ajusta o status separadamente, conforme servir os pratos. Isso evita marcar como "Entregue" um pedido que ainda está na cozinha.
• Grava no log de auditoria (TABLE_COMMAND_CLOSED) o nome da mesa, quantidade de pedidos pagos e quem fechou.
• Pede confirmação antes de executar (ação irreversível — se você fechou por engano, terá que reabrir cada pedido manualmente em Pedido → Pagamento).

Visualização dos pedidos de mesa

• Na lista de pedidos, pedidos de mesa aparecem com a tag verde Mesa <nome> (em vez de "Delivery" ou "Retirada").
• O filtro de modalidade ganha a opção "Mesa", permitindo ver só pedidos de salão.
• Toast em tempo real: quando chega pedido novo de mesa, o som e a notificação destacam o nome da mesa (até 3 mesas de uma vez, depois "+N").
• O modal de detalhes mostra "Mesa: <nome>" no lugar de endereço de entrega.

Templates WhatsApp para mesa (opcional)

Em WhatsApp → Templates, você verá campos extras para "Pedido na Mesa" e "Status na Mesa". Eles ficam vazios por padrão — recomendado, já que o cliente está no salão e geralmente não precisa de WhatsApp. Preencha apenas se você quiser usar para casos específicos (ex: enviar resumo da comanda ao final por iniciativa do garçom).

Limites e gating

• Plano START e PRO: os menus "Mesas", "Garçons" e "Dispositivos" não aparecem, opção "Mesa" no filtro de pedidos é oculta, e QR code escaneado retorna "Pedido por mesa não está disponível neste estabelecimento". O shell /waiter/* também é bloqueado.
• Plano PLUS: até 50 mesas por loja (limite ajustável caso necessário). Acima disso, o botão "Adicionar mesa" mostra um aviso e o limite é validado server-side.
• Downgrade PLUS → PRO: mesas existentes ficam no banco (não são apagadas), mas QR codes deixam de funcionar — cliente vê "Mesa indisponível" ao escanear. Pedidos antigos com snapshot de mesa continuam visíveis no histórico. Voltando para PLUS, tudo retoma sem reconfigurar.

Edge cases comuns

• Cliente sai sem pagar: a comanda fica aberta indefinidamente. Você pode fechá-la mesmo assim (registra como pago) e tomar a perda — ou marcar os pedidos como "Cancelado" individualmente em Pedido → Status.
• Dois clientes na mesma mesa: cada celular gera pedidos independentes (cart separado por dispositivo). A comanda agrupa tudo pelo table_id — fechar comanda paga todos juntos. Dividir conta entre os clientes não está suportado nesta versão.
• Mesma mesa por engano em 2 dispositivos do mesmo cliente: sem problema. Cada aba é uma sessão; quando o cliente fechar uma e abrir outra escaneando o mesmo QR, a sessão é renovada (mas o carrinho prévio é descartado para evitar duplicação).
• Cliente já tinha carrinho de delivery e escaneou o QR: o carrinho de delivery é preservado. Como o QR só serve para consulta na mesa, o cliente pode voltar pro pedido de delivery depois (basta abrir o cardápio sem o link da mesa).

Garçons (PIN + tablet)

Funcionalidade exclusiva do plano PLUS (com dine_in habilitado). Garçons abrem pedidos pelo shell dedicado /waiter/*, sem acessar o painel admin. Cada garçom tem PIN próprio, e cada tablet do salão é pareado uma única vez (cookie de 90 dias).

Quando usar

• Restaurante com salão onde o garçom anota o pedido pela mesa.
• Substitui o antigo atalho admin "Novo na mesa" (removido em 2026-05-17). Quem precisa abrir pedido no salão é o garçom, não um admin.
• O dono não precisa mais compartilhar a senha de admin com a equipe de salão.

Pré-requisitos

• Plano PLUS ativo com dine_in habilitado.
• Mesas cadastradas em Mesas.
• Produtos cadastrados no Cardápio.

Setup inicial (1× por loja)

1. Cadastrar o garçom em Garçons (menu lateral, grupo Salão — só o dono vê o item). Preencha o nome. O sistema gera um PIN de 4 dígitos automaticamente (recomendado) ou aceita um PIN escolhido (rejeita sequências como 1234, 0000, 1111). O PIN é exibido uma única vez — anote, imprima (botão Imprimir gera papel com nome, PIN e QR de login) ou mostre direto ao garçom; depois ele desaparece (hash bcrypt no banco).
2. Parear o celular/tablet em Dispositivos (mesmo grupo, owner-only). Clique em "Gerar código" — o sistema mostra um código de 6 dígitos com validade de 5 minutos. No dispositivo do salão, abra /waiter/parear.php e digite o código (ou escaneie o QR mostrado ao lado). O dispositivo fica pareado por 90 dias (rolling — cada uso renova).
3. Pronto. A partir daí o dispositivo cai direto na tela de login de garçom; nenhuma senha de admin é necessária no salão.

Fluxo diário do garçom

1. Garçom abre o tablet pareado. Cai na lista de garçons da loja (com inicial colorida em vez de foto).
2. Toca no próprio nome → digita o PIN → assume o turno. A sessão dura 12 horas, ou expira após 30 minutos ocioso.
3. No board, vê só os pedidos que ele mesmo abriu. Toca em "Novo pedido", escolhe a mesa, monta o carrinho (busca por nome, +/− por item, observação por item) e confirma o pagamento.
4. No fim do turno, toca em "Trocar" (passa o tablet pro próximo garçom sem destravar o dispositivo) ou "Sair" (encerra a sessão; tablet continua pareado).

Lockout por PIN errado

• 3 PINs errados consecutivos bloqueiam o garçom por 5 minutos.
• O dono pode desbloquear na hora pelo botão "Desbloquear" na lista de Garçons.
• Após o tempo de lockout, o contador zera automaticamente no próximo PIN correto.

Gestão pelo dono

Onde o pedido do garçom aparece

• Na página Pedidos, com a tag verde "Mesa <nome>" e o chip 🧑‍🍳 Garçom: <nome> (visível no kanban e na tabela).
• No modal de detalhes do pedido, linha "Garçom: <nome>" abaixo de "Mesa".
• Na impressora térmica, linha "Garçom: <nome>" no cupom.

Sessão única por garçom

Cada garçom pode ter apenas um dispositivo logado por vez (modelo "último login vence", como WhatsApp Web).

• Se o garçom logar num segundo celular/tablet, a sessão do primeiro é encerrada automaticamente. O primeiro dispositivo cai na tela de login com a mensagem "Você entrou em outro celular ou tablet. A sessão deste dispositivo foi encerrada."
• Detecção de PIN compartilhado: se um garçom passou o PIN pra outra pessoa, no momento que ela logar o primeiro cai e percebe na hora.
• Sessões antigas encerradas por esse mecanismo aparecem na auditoria com end_reason='superseded' e o evento WAITER_SESSION_STARTED registra quantas sessões foram derrubadas no campo superseded_count.

Boas práticas

• PIN é privado. Cada garçom usa o próprio; nunca anote em local visível. Se um garçom sair do restaurante, desative a conta dele (não precisa trocar a senha do admin).
• 1 sessão por garçom em toda a loja. Pra revezamento de turno no mesmo dispositivo, use o botão "Trocar" (encerra a sessão atual sem desparear o dispositivo).
• O garçom só enxerga os pedidos dele no board — não há interferência entre turnos.
• Use "Dispositivos" pra revogar celulares/tablets perdidos ou que não pertencem mais ao salão. Pareamento é gratuito e pode ser refeito a qualquer momento.

Auditoria

Toda ação relevante fica registrada em Auditoria e pode ser filtrada por ação. Eventos disponíveis:

• WAITER_CREATED, WAITER_DEACTIVATED, WAITER_REACTIVATED — ciclo de vida do cadastro.
• WAITER_PIN_RESET, WAITER_UNLOCKED — operações de segurança.
• WAITER_DEVICE_PAIRING_CREATED, WAITER_DEVICE_REVOKED — gestão de tablets.
• WAITER_SESSION_STARTED, WAITER_SESSION_ENDED — turnos de cada garçom.
• ORDER_CREATED_BY_WAITER — todo pedido aberto pelo shell. A coluna created_by_waiter_id em orders identifica o garçom; pedidos legados anteriores à migração mantêm created_by_admin_id (mutuamente exclusivos).

Fora do escopo (MVP atual)

• Sem comissão por garçom ou rateio automático de gorjeta.
• Sem dividir conta entre clientes da mesma mesa.
• Sem chamada de garçom pela mesa (cliente sinaliza presencialmente).
• Sem modo offline (o tablet precisa de internet pra abrir pedido).
• Sem foto de perfil (mostra inicial colorida automaticamente).
• Sem reimprimir cupom direto pelo shell (use a página Pedidos do admin).

Equipe (Multiplos Admins)

Convide a equipe para operar o painel sem compartilhar a senha do dono — cada um com login próprio e desativacao a qualquer momento. No plano PRO, você convida até 2 atendentes (acesso restrito a Pedidos e Clientes). No plano PLUS, até 2 gerentes (acesso amplo).

Funcoes (roles)

Limite de admins por plano

Convidar um gerente

1. No menu lateral, abra Equipe.
2. Em Convidar novo admin, preencha nome e e-mail e clique em Enviar convite.
3. O convidado recebe um e-mail com link para criar a própria senha. O link expira em 7 dias.
4. Se o e-mail não puder ser enviado (servidor de email indisponivel), o sistema mostra o link na tela para voce copiar e enviar pelo WhatsApp ou outro canal.
5. Enquanto o convite estiver pendente, ele aparece na tabela Convites pendentes e pode ser revogado.

Status do admin

Desativar, reativar e revogar

• Desativar gerente: botao Desativar na tabela de admins. O gerente perde acesso na proxima requisicao. O histórico de ações dele permanece na auditoria.
• Reativar gerente: botao Reativar. Funciona apenas se houver vaga no limite do plano. Caso contrario, desative ou revogue alguem antes.
• Revogar convite pendente: botao Revogar na tabela de convites pendentes. O link enviado deixa de funcionar imediatamente.
• O dono não pode desativar a si mesmo, e o botao Desativar não aparece para a própria linha nem para o dono.

Transferir titularidade

Permite passar a titularidade da empresa para um gerente ativo. Use quando o socio sair, na troca de responsavel da loja, ou quando outra pessoa assumir a operação.

1. Na página Equipe, na linha do gerente que vai virar dono, clique em Tornar dono.
2. Confirme digitando sua senha atual no dialogo. Sem isso a transferência não acontece.
3. Apos confirmar:
   • O gerente escolhido passa a ser o novo dono.
   • Voce vira gerente e perde acesso imediato a Configurações, Auditoria e Equipe.
   • So o novo dono pode reverter a transferência (clicando em "Tornar dono" no seu nome de volta).

• O botao so aparece para gerentes ativos. Convites pendentes precisam ser aceitos antes.
• Officers em modo de impersonacao não podem transferir titularidade — a ação e bloqueada por seguranca.
• A operação e atomica: não existe momento intermediario com dois donos. A ação fica registrada na auditoria como ownership_transferred.

Comportamento em downgrade e upgrade

• Downgrade PLUS → PRO/START: todos os gerentes são automaticamente movidos para o status Pausado (downgrade). Apenas o dono mantem acesso.
• Upgrade de volta para PLUS: os gerentes pausados são reativados sozinhos, na ordem do convite mais antigo para o mais recente, até atingir o limite do plano.
• Downgrade PRO → START: todos os atendentes são movidos para Pausado (downgrade). Apenas o dono mantem acesso.
• Upgrade START → PRO: atendentes pausados retornam sozinhos, na ordem do convite mais antigo, até o limite de 2.
• Se houver mais pessoas pausadas do que vagas, as excedentes ficam Inativas e podem ser reativadas manualmente.

Auditoria das ações de equipe

Todas as operações da página Equipe ficam registradas e podem ser consultadas pelo dono. As ações gravadas são:

• admin_invited — convite enviado (com nome, e-mail e se o e-mail saiu).
• admin_invite_revoked — convite pendente revogado.
• admin_invite_accepted — convidado criou a senha e virou gerente ativo.
• admin_deactivated — gerente desativado manualmente.
• admin_activated — gerente reativado manualmente.
• ownership_transferred — titularidade transferida (com IDs de origem e destino).

Disponibilidade por plano

Auditoria

Histórico de alteracoes realizadas nos pedidos da loja: mudancas de status e pagamento.

O que e registrado

• Toda alteracao de status de um pedido (ex: Pendente → Aceito).
• Toda alteracao de status de pagamento (ex: pendente → pago).
• Alteracoes simultaneas de status e pagamento aparecem com o tipo Status + Pagamento.

Colunas do log

Filtros disponiveis

• Número do pedido: Busca por um pedido específico.
• Status: Filtra por etapa (ex: apenas alteracoes para "Cancelado").
• Período: Data inicial e final para recorte temporal.

Suporte

Canal oficial de atendimento. Acessível pelo menu lateral em Ajuda → Suporte. Funciona em todos os planos com SLA diferenciado.

SLA por plano (1a resposta)

Avisos da plataforma

De vez em quando aparece um banner colorido no topo do painel com avisos da DelyGO — manutencao programada, lancamento de feature, mudanca de pricing. São mensagens da plataforma, não da sua loja.

O que cada cor significa

• Azul (informativo): comunicado neutro — uma feature nova, um lembrete.
• Verde (sucesso): algo bom — feature entregue, ativação confirmada.
• Amarelo (atencao): algo que merece sua atencao — manutencao agendada, mudanca em politica.
• Vermelho (crítico): aviso urgente — agir hoje. Pode vir sem botao de fechar quando o tema e obrigatório.

Como dispensar um aviso

Clique no X no canto direito do banner. O aviso some so para voce — outros admins da sua loja continuam vendo até fecharem por conta própria. Avisos vermelhos sem o X não podem ser fechados (são casos criticos onde a plataforma exige confirmacao).

Modo Demo

O modo demo permite visualizar o painel com dados ficticios sem afetar nenhuma informacao real. E ativado adicionando ?demo=1 na URL ou via link do officer.

O que e bloqueado no modo demo

• Todas as operações de escrita: salvar produtos, alterar pedidos, mudar configurações, atualizar templates.
• Ao tentar qualquer ação de modificacao, o sistema exibe uma mensagem de erro informando que a operação não e permitida.

O que funciona no modo demo

• Navegação completa entre todas as páginas do painel.
• Visualizacao de pedidos, clientes, cardápio e configurações com dados de exemplo.
• Preview de templates WhatsApp.

Glossário