Manual do Painel

Menu Lateral

Barra de navegação fixa a esquerda com acesso a todas as páginas do painel, além de um indicador visual do plano ativo.

Indicador de Plano

Logo acima do rodape do menu, um selo exibe o plano atual da loja com cor distinta para cada nivel:

Dashboard

Visão geral do desempenho da loja. Todos os dados são carregados em tempo real ao abrir a página.

Status da Loja

Card fixo no topo do dashboard exibindo se a loja está Aberta (verde) ou Fechada (vermelho). Quando fechada, clientes não podem fazer novos pedidos.

• Abrir / Fechar Loja: botão direto no card — abre imediatamente; fechar exige confirmação.
• Alertas de estoque (planos PRO e PLUS): se houver produtos esgotados ou críticos, um card de alerta aparece ao lado com os totais e link direto para o Balanço de Estoque.

KPIs Principais

Gráfico: Faturamento dos Últimos 7 Dias

Barras verticais com o valor faturado por dia nos últimos 7 dias. Útil para identificar dias de pico e queda de movimento.

Produtos Mais Vendidos (30 dias)

Lista os 5 produtos com maior número de unidades vendidas no último mes, junto ao valor total gerado por cada um.

Pedidos Recentes

Tabela com os 5 últimos pedidos: número, cliente, valor e status. Clique em qualquer pedido na página Pedidos para ver os detalhes completos.

Pedidos

Central de gerenciamento de pedidos recebidos pela loja. Atualiza em tempo real (poll a cada poucos segundos) 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 da seção de pedidos há um toggle Lista | Kanban que muda o modo de visualização. A escolha persiste com os filtros (volta ao mesmo modo na próxima visita).

• 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. Ideal para tablets de cozinha ou monitoramento em tempo real. 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. 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.

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.

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, va em Entregadores (grupo Interacao).
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.

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.

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 comecar a receber pedidos. Pode ser revisitado a qualquer momento pelo 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: 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.
• O dashboard exibe o KPI Desconto concedido hoje com a soma do dia.

Disponibilidade por plano

Relatorios Avancados

Página Relatorios exclusiva do plano PLUS, com cinco analises principais para qualquer período escolhido. Cada bloco tem botao de exportar CSV (separador ; + BOM UTF-8, abre direto no Excel).

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).
• O sistema mostra automaticamente o período anterior de mesmo tamanho para comparacao (ex: últimos 30 dias vs 30 dias anteriores).
• 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.
• Cada KPI tras a variacao percentual contra o período anterior (verde = crescimento, vermelho = queda).
• 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 painel admin em "Novo na mesa", anotando pelo tablet/celular do salão.

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 em "Novo na mesa"

No menu lateral, abaixo de "Mesas", aparece o link "Novo na mesa" (gating PLUS + dine_in).

1. Garçom (owner ou gerente) acessa Novo na mesa pelo painel admin.
2. 1. Mesa — escolhe a mesa no select (só mesas ativas aparecem). O nome do cliente fica opcional, com placeholder padrão "Mesa <nome>". WhatsApp também é opcional.
3. 2. Itens — clica nos produtos pra adicionar ao carrinho lateral. Pode buscar pelo nome, ajustar quantidade com +/− e escrever observação por item (ex: "sem cebola"). Estoque controlado é respeitado em tempo real.
4. 3. Pagamento — escolhe a forma: padrão "Pagar no caixa", ou Pix/dinheiro/débito/crédito se o cliente quiser pagar na hora. Pode adicionar uma observação geral (ex: alergia, mesa no canto) — vai junto na comanda impressa.
5. Confirmar — pedido aparece na página Pedidos com tag verde "Mesa <nome>" e modalidade "Mesa", e pode ser impresso pelo botão 🖨 normalmente.

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" e "Novo na mesa" 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". Tentar acessar novo-pedido-mesa.php direto pela URL redireciona ao dashboard com aviso "feature PLUS".
• 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).

Equipe (Multiplos Admins)

Recurso de multiplos administradores exclusivo do plano PLUS. Permite ao dono da loja convidar gerentes para operar o painel sem compartilhar a senha, com login próprio para cada um e desativacao a qualquer momento.

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. Os dados e o histórico são preservados.
• 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 (3 admins ativos).
• Se o número de gerentes pausados for maior que as vagas disponiveis no upgrade, os excedentes ficam Inativos e podem ser reativados manualmente quando houver espaco.

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. Acessivel pelo menu lateral em 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