SigmaFlow
SIGMAFLOWGastronomia e Sistemas
ManualPara gestores

Central de suporte

Manual do usuário

Guia completo organizado por tipo de usuário — gestores (assinatura, equipe, produtos, relatórios) e equipe (sala, cozinha, bar, caixa e delivery). Navegue pelo índice lateral ou baixe o PDF completo.

1

Para gestores

Visão geral do fluxo

Entenda a ordem completa do ciclo operacional antes de operar.

O Sigma Flow organiza a operação de restaurantes em um ciclo contínuo: da abertura da mesa até o fechamento e liberação. Cada etapa envolve um papel específico da equipe e ocorre em tempo real — todas as telas são sincronizadas via WebSocket sem necessidade de recarregar a página.

Passo a passo

  1. 1Garçom abre a mesa e o sistema gera um PIN de acesso.
  2. 2Cliente escaneia o QR Code da mesa e acessa a comanda no celular.
  3. 3Cliente monta o carrinho e envia os pedidos — itens entram como pendentes.
  4. 4Garçom aprova os itens e eles são roteados para cozinha ou bar.
  5. 5Cozinha e bar acompanham a fila no KDS e marcam os itens prontos.
  6. 6Garçom entrega os itens na mesa e confirma a entrega.
  7. 7Caixa fecha a conta, registra o pagamento e libera a mesa.

Pontos importantes

  • Todas as telas se atualizam em tempo real — sem F5.
  • O garçom pode lançar pedidos diretamente pelo totem, sem aguardar o cliente.
  • Mesa só é liberada quando todas as comandas estiverem encerradas.
  • O histórico de pedidos e eventos fica registrado para auditoria.

Perfis e responsabilidades

Cada papel da equipe cobre uma etapa específica da operação.

O sistema usa controle de acesso baseado em papéis (RBAC). Cada membro da equipe tem acesso somente às funcionalidades do seu papel. Isso evita erros operacionais e garante rastreabilidade de cada ação.

Pontos importantes

  • MASTER — proprietário; acesso total incluindo configurações financeiras e do sistema.
  • ADMIN — gerente administrativo; gerencia equipe, produtos e configurações.
  • GERENTE — supervisão operacional; vê todas as mesas, aprova itens e resolve problemas.
  • GARÇOM — atendimento de sala; abre mesas, lança pedidos, aprova itens, entrega prontos.
  • COZINHEIRO — prepara itens do setor de cozinha no KDS.
  • BARTENDER / ATENDENTE — prepara itens do setor de bar no KDS.
  • CAIXEIRO — registra pagamentos e fecha comandas.
  • ENTREGADOR — realiza entregas do módulo delivery.

✓ Dica

Um mesmo usuário pode ter apenas um papel. Para operações mistas, crie usuários separados.

Primeira configuração

Defina o tipo de estabelecimento, identidade visual e equipe inicial.

Após concluir a assinatura, o MASTER recebe o link de onboarding por e-mail e cria a unidade. A partir daí, a primeira configuração define o módulo (tipo de estabelecimento), a identidade visual e a equipe. O módulo escolhido adapta o menu lateral e as funcionalidades disponíveis.

Passo a passo

  1. 1Acesse o link de onboarding enviado por e-mail e crie a senha do MASTER.
  2. 2Confirme o tipo de estabelecimento (Bar, Restaurante, Pizzaria, Cafeteria, Lanchonete, Bistrôt ou Padaria).
  3. 3Em Configurações → Estabelecimento, preencha nome, documento e envie o logo.
  4. 4Em Configurações → Aparência, ajuste tema, cores e densidade do menu.
  5. 5Em Configurações → Equipe, convide os primeiros colaboradores com seus papéis.

Pontos importantes

  • O módulo define quais telas e setores de KDS ficam ativos.
  • Produtos de demonstração são carregados automaticamente ao ativar o módulo.
  • O logo e o nome aparecem na sidebar e na tela do cliente (comanda pública).
  • Mesas iniciais podem ser geradas em lote no onboarding.

Equipe e perfis

Cadastre a equipe com o papel operacional correto.

A tela de Equipe permite criar, editar e desativar usuários. Cada usuário recebe um papel único que define quais telas e ações estão disponíveis. O convite é enviado por e-mail e o usuário define sua própria senha.

Passo a passo

  1. 1Acesse Configurações → Equipe.
  2. 2Clique em "Convidar membro".
  3. 3Informe o e-mail e selecione o papel (role).
  4. 4O sistema envia o convite — o usuário tem 72h para aceitar.
  5. 5Após aceitar, o membro aparece na lista e pode fazer login.

Pontos importantes

  • COZINHEIRO → acessa apenas o KDS da cozinha.
  • BARTENDER → acessa apenas o KDS do bar.
  • CAIXEIRO → acessa apenas a tela de caixa e fechamento.
  • GARÇOM → acessa mesas, totem e pedidos.
  • Usuários desativados não conseguem fazer login.

✓ Dica

Crie um usuário de teste para demonstrar o sistema sem usar o login do gerente.

Produtos e cardápio

Configure produtos com setor correto para roteamento no KDS.

O cardápio é gerenciado na tela de Produtos. Cada produto deve ter uma categoria e um setor de cozinha (KitchenSector) configurado corretamente — isso define para qual KDS o item será roteado após aprovação.

Pontos importantes

  • KitchenSector KITCHEN → roteado para o KDS da cozinha.
  • KitchenSector BAR → roteado para o KDS do bar/balcão.
  • KitchenSector DESSERTS → roteado para a seção de sobremesas.
  • KitchenSector CAFE → roteado para a cafeteria.
  • Ao ativar um módulo, produtos de demonstração são carregados automaticamente.
  • Edite ou remova os produtos de demonstração a qualquer momento.
  • Produtos inativos não aparecem no cardápio do cliente.

⚠ Atenção

Produto sem setor definido pode não aparecer no KDS correto. Sempre configure o KitchenSector.

Configurações e aparência

Personalize a identidade visual e os ajustes do estabelecimento.

As configurações de aparência (tema, cores, densidade de menu) e de estabelecimento (nome, documento, logo, taxa de serviço) são acessíveis somente para MASTER, ADMIN e GERENTE. As mudanças refletem imediatamente na operação e na tela do cliente.

Pontos importantes

  • Tema visual: presets iOS/Windows, dark mode, cores de sidebar e superfície.
  • Densidade de menu e estilo de painel ajustáveis por preferência.
  • Logo e nome do estabelecimento aparecem na sidebar e na comanda do cliente.
  • Taxa de serviço configurável, aplicada no fechamento.
  • Configurações ficam ocultas para GARÇOM, COZINHEIRO e BARTENDER.

KPIs e relatórios

Acompanhe o desempenho operacional e financeiro em tempo real.

A tela de KPIs consolida métricas de desempenho: faturamento, ticket médio, tempo de preparo, ranking de produtos e eficiência por garçom. Os dados são calculados a partir das comandas CLOSED — comandas abertas ou canceladas não entram nos totais.

Pontos importantes

  • Disponível para MASTER, ADMIN e GERENTE.
  • Rankings de produtos mais vendidos por período.
  • Eficiência por garçom: mesas atendidas, ticket médio, tempo.
  • Análise por período: dia, semana, mês.
  • Pagamentos por operador para conferência de caixa.
  • Relatórios avançados requerem o add-on "Relatórios" no plano.

ℹ Info

Se o dashboard mostrar valores zerados, verifique se há comandas com status CLOSED. Comandas órfãs (OPEN em mesa AVAILABLE) não entram nos totais.

Financeiro: visão geral

Acompanhe contas a pagar, a receber e o fluxo de caixa do período.

O módulo financeiro consolida todas as movimentações financeiras do estabelecimento em um só lugar. A visão geral exibe o saldo atual, total de contas a pagar e a receber, vencimentos do período e um extrato das últimas movimentações. É o ponto de partida para a gestão financeira diária.

Passo a passo

  1. 1Acesse a seção Financeiro na sidebar.
  2. 2A visão geral mostra o saldo (entradas − saídas), totais pendentes e últimos lançamentos.
  3. 3Use os filtros de período para ajustar o intervalo exibido.
  4. 4Navegue pelas abas laterais para detalhamento: Contas a Pagar, Contas a Receber, Fluxo de Caixa.

Pontos importantes

  • Disponível para MASTER, ADMIN e GERENTE.
  • CAIXEIRO vê apenas Fluxo de Caixa e Contas a Receber.
  • O saldo é calculado automaticamente a partir dos lançamentos do período.
  • Toda movimentação gera registro de auditoria.

ℹ Info

Os valores do financeiro são independentes do fechamento de caixa das comandas — registre contas fixas (aluguel, fornecedores) manualmente.

Contas a pagar

Registre e acompanhe contas de fornecedores, despesas fixas e custos operacionais.

A tela de Contas a Pagar permite registrar todas as obrigações financeiras do estabelecimento: fornecedores, aluguel, contas de consumo, impostos e qualquer outra despesa. Cada conta tem vencimento, valor, categoria e status — e pode ser marcada como paga individualmente.

Passo a passo

  1. 1Acesse Financeiro → Contas a Pagar.
  2. 2Clique em "Nova conta" e preencha: descrição, valor, data de vencimento e categoria.
  3. 3Selecione o fornecedor (ou crie um novo diretamente do formulário).
  4. 4A conta aparece na lista com status PENDING e vencimento destacado.
  5. 5Ao pagar, clique no toggle "Pago" — o status muda para PAID e o valor reflete no fluxo de caixa.

Pontos importantes

  • Status: PENDING, PAID, OVERDUE (vencida), PARTIAL, CANCELLED.
  • Contas vencidas (OVERDUE) aparecem com destaque em vermelho.
  • Categorias de despesa ajudam a organizar por centro de custo.
  • O total pendente e o total vencido são exibidos em cards de resumo.

Contas a receber

Controle recebimentos de clientes, pedidos delivery e outras entradas.

A tela de Contas a Receber registra valores a serem recebidos, como vendas parceladas, pedidos delivery pendentes de pagamento ou combinados com clientes. Diferente do fluxo de caixa das comandas (que é automático), aqui você registra recebimentos avulsos ou programados.

Passo a passo

  1. 1Acesse Financeiro → Contas a Receber.
  2. 2Clique em "Novo recebimento" e informe descrição, valor, vencimento e dados do cliente.
  3. 3Opcionalmente, vincule a um pedido existente (delivery ou comanda).
  4. 4Ao receber, clique no toggle "Recebido" — o valor entra no fluxo de caixa.

Pontos importantes

  • Status: PENDING, RECEIVED, OVERDUE, PARTIAL, CANCELLED.
  • Pode ser vinculada a um pedido (orderId) para rastreio.
  • CAIXEIRO também pode criar e marcar recebimentos.
  • O resumo mostra total pendente, vencido e lançamentos do período.

Fluxo de caixa

Visualize entradas, saídas e saldo consolidado por período.

O Fluxo de Caixa consolida automaticamente todas as contas a pagar e a receber em uma visão única. Com filtro por período, você acompanha o saldo inicial, total de entradas, total de saídas e o saldo final. Ideal para conferência diária, semanal ou mensal.

Passo a passo

  1. 1Acesse Financeiro → Fluxo de Caixa.
  2. 2Use o filtro de período para selecionar o intervalo desejado.
  3. 3Visualize os cards de resumo: Saldo, Entradas, Saídas e Pendentes/Vencidos.
  4. 4Abaixo, a listagem detalhada mostra cada lançamento com data, descrição e valor.

Pontos importantes

  • Disponível para MASTER, ADMIN, GERENTE e CAIXEIRO.
  • Entradas = contas a receber com status RECEIVED.
  • Saídas = contas a pagar com status PAID.
  • O saldo é calculado como total de entradas − total de saídas no período.

Estoque e movimentação

Controle itens, quantidades, custos e movimentações de insumos.

A tela de Estoque gerencia todos os insumos do estabelecimento: alimentos, bebidas, embalagens e materiais de limpeza. Cada item tem quantidade atual, estoque mínimo, custo médio e consumo médio diário. As movimentações registram entradas (compras), saídas (consumo/produção) e ajustes manuais.

Passo a passo

  1. 1Acesse Financeiro → Estoque.
  2. 2Cadastre itens com nome, unidade, quantidade inicial, custo e estoque mínimo.
  3. 3Registre movimentações: clique em "Entrada" para receber mercadoria ou "Saída" para consumo.
  4. 4O sistema atualiza a quantidade atual automaticamente a cada movimentação.
  5. 5Itens abaixo do estoque mínimo aparecem na seção "Itens críticos".

Pontos importantes

  • Campos de previsão: idealQuantity, averageConsumptionPerDay, leadTimeDays.
  • Custo médio é atualizado a cada entrada (custo médio ponderado).
  • Movimentações geram registro de auditoria com tipo, quantidade e referência.
  • O relatório de estoque exibe total de itens, quantidade total e lista de baixo estoque.

✓ Dica

Configure o consumo médio e lead time para ativar a sugestão automática de compra.

Compras e reposição

Crie pedidos de compra e receba sugestões automáticas de reposição.

Com base no estoque mínimo, consumo médio e lead time dos fornecedores, o sistema sugere automaticamente quais itens comprar e em qual quantidade. Você pode gerar pedidos de compra individuais ou em lote, e ao receber a mercadoria, o estoque é atualizado automaticamente.

Passo a passo

  1. 1Acesse Financeiro → Compras.
  2. 2A seção "Sugestões de compra" lista itens com estoque baixo e a quantidade sugerida.
  3. 3Clique em "Gerar pedido" para criar um pedido de compra com os itens sugeridos.
  4. 4Alternativamente, crie um pedido manual clicando em "Novo pedido".
  5. 5Ao receber a mercadoria, clique em "Receber" — o estoque é atualizado e uma movimentação de entrada é gerada.

Pontos importantes

  • Sugestão considera: estoque atual, mínimo, consumo médio diário e lead time.
  • Pedidos de compra têm status: DRAFT, OPEN, RECEIVED, CANCELLED.
  • Fornecedores são cadastrados em Financeiro ou diretamente no formulário do pedido.
  • O recebimento do pedido gera movimentação de entrada no estoque automaticamente.

Ficha técnica e custo de preparo

Calcule o custo real de cada prato com base nos insumos do estoque.

A ficha técnica (recipe) vincula cada produto do cardápio aos insumos do estoque. Ao definir os ingredientes e quantidades, o sistema calcula automaticamente o custo base, o preço sugerido (com margem) e a margem bruta. Você também pode "consumir" a receita para dar baixa no estoque.

Passo a passo

  1. 1Acesse Financeiro → Ficha Técnica.
  2. 2Clique em "Nova receita" e selecione o produto do cardápio.
  3. 3Adicione os ingredientes: escolha o item do estoque, informe a quantidade necessária.
  4. 4O sistema calcula o custo base automaticamente com base no custo médio do insumo.
  5. 5Defina o markup (%) — o preço sugerido e a margem bruta são calculados na hora.
  6. 6Use "Recalcular custo" para atualizar com os preços mais recentes do estoque.
  7. 7Use "Consumir" para dar baixa nos insumos ao produzir o prato.

Pontos importantes

  • Disponível para MASTER, ADMIN, GERENTE, COZINHEIRO e BARTENDER.
  • Custo base = soma de (quantidade × custo unitário) de cada ingrediente.
  • Margem bruta = (preço de venda − custo base) / preço de venda × 100%.
  • A baixa de estoque via "Consumir" gera movimentação de saída para cada insumo.

⚠ Atenção

Mantenha os custos do estoque atualizados — o cálculo da ficha técnica reflete o custo médio real de cada insumo.

Folha de pagamento

Gerencie funcionários, salários e períodos de folha.

A tela de Folha permite cadastrar funcionários com salário base, cargo e taxa de comissão. Os períodos de folha registram os custos por mês/período e consolidam salários, comissões e encargos para visão gerencial do custo de pessoal.

Passo a passo

  1. 1Acesse Financeiro → Folha.
  2. 2Cadastre funcionários com nome, cargo, salário base, taxa de comissão e data de contratação.
  3. 3Crie um período de folha (ex: "Junho/2026") com data de início e fim.
  4. 4A lista exibe todos os funcionários ativos, salário total e taxa média de comissão.
  5. 5O card de resumo mostra o custo potencial total da folha no período.

Pontos importantes

  • Funcionários têm: nome, cargo, documento, salário base, taxa de comissão, departamento.
  • Períodos de folha têm status que controla o fechamento contábil.
  • O custo total considera salários base + comissões estimadas.
  • MASTER, ADMIN e GERENTE têm acesso à folha completa.

✓ Dica

Use as Comissões (próximo tópico) para calcular valores reais por período antes de fechar a folha.

Comissões

Configure regras e calcule comissões por período para a equipe.

O módulo de Comissões permite criar regras percentuais por cargo ou função e calcular automaticamente o valor devido em cada período. O cálculo considera o total de vendas do período e aplica a taxa de cada regra ativa, gerando lançamentos individuais por funcionário.

Passo a passo

  1. 1Acesse Financeiro → Comissões.
  2. 2Crie regras de comissão: nome, escopo (ex: "Garçons"), cargo de aplicação e percentual.
  3. 3Selecione um período de folha existente ou informe um período manual.
  4. 4Informe o valor total de vendas do período.
  5. 5Clique em "Calcular" — o sistema aplica as regras e exibe o preview por funcionário.
  6. 6Confirme para registrar os valores nos lançamentos do período.

Pontos importantes

  • Regras podem ser ativadas/desativadas individualmente.
  • O cálculo considera apenas funcionários com cargo compatível com a regra.
  • Múltiplas regras podem se aplicar ao mesmo funcionário (somadas).
  • O resultado do cálculo pode ser revisto antes da confirmação final.
  • Comissões calculadas são registradas nos lançamentos do período de folha.

ℹ Info

As comissões calculadas aparecem automaticamente como referência na tela de Folha.

Assinatura: pacote e ciclo

Escolha o pacote por tipo de estabelecimento e o ciclo de cobrança.

A contratação é feita em /assinatura, no modelo "module-first": você escolhe o tipo de estabelecimento (que já vem pré-configurado para a sua operação) e o ciclo de cobrança (mensal ou anual). O pagamento é processado de forma segura pelo Stripe (checkout hospedado). A ativação ocorre somente após a confirmação do pagamento, quando o link de onboarding é enviado por e-mail.

Passo a passo

  1. 1Acesse /assinatura e selecione o tipo de estabelecimento.
  2. 2Revise o que está incluído no pacote e os add-ons opcionais.
  3. 3Escolha o ciclo: mensal ou anual (anual com desconto).
  4. 4Informe o e-mail responsável pela assinatura e finalize no Stripe.
  5. 5Após o pagamento, abra o link de onboarding enviado por e-mail e crie a unidade.

Pontos importantes

  • Pacotes: Cafeteria, Padaria, Lanchonete, Bar, Bistrôt, Pizzaria e Restaurante.
  • Cada pacote já inclui add-ons relevantes (ex.: Delivery em Lanchonete/Pizzaria/Restaurante).
  • Pagamento por cartão na recorrência; cobrança em BRL.
  • A renovação é automática até que a assinatura seja cancelada.

ℹ Info

O acesso ao sistema fica liberado enquanto a assinatura estiver ATIVA. A gestão da assinatura fica em Configurações → Assinatura.

Add-ons: adicionar e remover

Contrate módulos extras com cobrança proporcional ao período.

Em Configurações → Assinatura, o MASTER/ADMIN gerencia os add-ons disponíveis para o seu pacote. A adição e a remoção são imediatas e a cobrança é proporcional ao período em curso (proration automática do Stripe). O entitlement do recurso é liberado ou bloqueado na hora.

Passo a passo

  1. 1Acesse Configurações → Assinatura.
  2. 2Na seção "Add-ons do seu pacote", veja os disponíveis para o módulo atual.
  3. 3Clique em "Adicionar" para contratar — a cobrança é proporcional.
  4. 4Clique em "Remover" para cancelar um add-on que não usa mais.

Pontos importantes

  • Delivery — pedidos por telefone/WhatsApp, painel de entregas e role ENTREGADOR.
  • Relatórios avançados — rankings, eficiência e análises por período.
  • Multi-unidade — gestão de múltiplas unidades.
  • Add-ons já inclusos no pacote aparecem como "Grátis" e não podem ser removidos.

✓ Dica

A cobrança proporcional credita/debita a diferença na próxima fatura — você só paga pelo tempo de uso.

Cancelar e reativar a assinatura

Cancele a qualquer momento — o acesso continua até o fim do período pago.

O MASTER (ou ADMIN) pode cancelar a assinatura a qualquer momento em Configurações → Assinatura. O cancelamento é agendado para o fim do período: o serviço continua funcionando normalmente até a data de expiração e só então é encerrado. Enquanto não expirar, é possível desfazer o cancelamento com um clique.

Passo a passo

  1. 1Acesse Configurações → Assinatura.
  2. 2Clique em "Cancelar" e confirme — o sistema agenda o cancelamento.
  3. 3A tela passa a exibir "Cancelamento agendado — acesso ativo até DD/MM".
  4. 4Mudou de ideia? Clique em "Reativar" antes da data para desfazer.

Pontos importantes

  • Nada é encerrado na hora — você usa todo o período já pago.
  • Na data de expiração, a assinatura encerra e o acesso é bloqueado.
  • Reativar antes da expiração mantém a renovação normal.
  • Disponível para MASTER e ADMIN.

ℹ Info

O mesmo princípio vale para troca de pacote: ao reduzir para um pacote menor, o maior continua até expirar e só depois passa para o menor.

Portal de cobrança

Faturas, método de pagamento e dados de cobrança em um só lugar.

Em Configurações → Assinatura, o botão "Abrir portal" leva ao portal de cobrança seguro do Stripe. Lá o gestor consulta o histórico de faturas, atualiza o cartão e os dados de cobrança, e pode cancelar a assinatura — tudo de forma autônoma.

Pontos importantes

  • Histórico e download de faturas.
  • Atualização do método de pagamento (cartão).
  • Atualização de dados do cliente (e-mail, endereço, documento).
  • Cancelamento de assinatura também disponível pelo portal.

Desistência de mesa

Limpa a mesa quando o cliente desistiu antes de pedir qualquer item.

Quando uma mesa foi aberta e o cliente desistiu antes de realizar qualquer pedido, o gerente pode usar "Desistência" para limpar as comandas vazias e liberar a mesa imediatamente. Esta ação é irreversível e não gera registro de auditoria — diferente do encerramento por manutenção.

Passo a passo

  1. 1Acesse o painel de Mesas.
  2. 2Na mesa OCCUPIED com comanda(s) sem itens, clique em "Desistência".
  3. 3Confirme a ação no diálogo — o sistema valida que não há itens lançados.
  4. 4As comandas são removidas e a mesa volta para AVAILABLE.

Pontos importantes

  • Disponível para MASTER, ADMIN e GERENTE.
  • Bloqueada se qualquer comanda tiver itens (mesmo que cancelados).
  • Diferente de "Encerrar por manutenção" — não exige motivo nem gera auditoria.
  • Adequada para cancelamentos imediatos antes do início do atendimento.

⚠ Atenção

Use "Encerrar por manutenção" se houver itens lançados — isso preserva o histórico.

Encerramento por manutenção

Força o fechamento de uma comanda com registro de auditoria.

Quando uma comanda precisa ser encerrada de forma forçada — por desistência com itens lançados, problema operacional ou mudança de mesa — o gerente usa o encerramento por manutenção. Esse fluxo exige um motivo e registra tudo em auditoria.

Pontos importantes

  • Disponível para GERENTE, ADMIN e MASTER.
  • Exige informação do motivo — fica registrado no log de auditoria.
  • A comanda é encerrada com status CANCELLED.
  • Diferente da Desistência — esta ação funciona mesmo com itens lançados.
  • Use quando há itens mas a comanda não pode ser fechada normalmente.

⚠ Atenção

O encerramento por manutenção não registra pagamento — use apenas para situações excepcionais.

Mesa presa ou sem retorno

Mesa não libera após o fechamento.

Quando uma mesa não volta para AVAILABLE após o fechamento, normalmente há uma comanda ainda em status OPEN ou REQUESTING_BILL. Isso pode ocorrer se o fechamento foi interrompido ou se uma comanda ficou "órfã" (mesa foi liberada manualmente sem fechar a comanda).

Passo a passo

  1. 1Acesse Pedidos → selecione a mesa que está presa.
  2. 2Verifique se há comandas com status OPEN ou REQUESTING_BILL.
  3. 3Use "Encerrar por manutenção" para fechar a comanda informando o motivo.
  4. 4Após fechar todas as comandas, a mesa voltará para AVAILABLE.

Pontos importantes

  • Comandas OPEN em mesa AVAILABLE são comandas órfãs — visíveis no dropdown de Pedidos.
  • O dropdown de Pedidos exibe mesas OCCUPIED e mesas com comandas ativas.
  • GERENTE, ADMIN e MASTER podem fechar comandas por manutenção.
  • Após fechar as comandas órfãs, os totais do dashboard normalizam.

Dashboard com dados incorretos

Totais e KPIs não refletem o movimento real.

Os indicadores do dashboard são calculados a partir de comandas CLOSED. Se há comandas em estado OPEN em mesas disponíveis (órfãs), elas não entram nos totais. A solução é localizar e fechar essas comandas manualmente.

Passo a passo

  1. 1Acesse Pedidos — o dropdown lista mesas OCCUPIED e mesas com comandas ativas.
  2. 2Localize comandas em status OPEN em mesas que já estão AVAILABLE.
  3. 3Use "Encerrar por manutenção" para fechar cada comanda órfã.
  4. 4Após o fechamento, os totais do dashboard serão recalculados automaticamente.

Pontos importantes

  • Comandas CANCELLED também não entram nos totais financeiros.
  • Use relatórios por período para cruzar os dados com o movimento do dia.
  • SUPERADMIN pode acessar logs de auditoria para rastrear inconsistências.
2

Para a equipe

Abrir mesa (garçom)

Inicia a sessão do cliente com PIN dinâmico e vínculo de garçom.

Ao abrir uma mesa, o sistema gera um PIN único de 6 dígitos vinculado à sessão. Esse PIN expira em 12 horas ou quando a mesa for liberada. O QR Code impresso na mesa sempre aponta para a URL de acesso — o PIN muda a cada nova sessão.

Passo a passo

  1. 1Acesse o painel de Mesas.
  2. 2Clique em "Abrir mesa" na mesa desejada.
  3. 3Informe o nome ou alias do cliente (opcional).
  4. 4Escolha o modo: Comanda única (SINGLE) ou Múltiplas comandas (MULTI).
  5. 5Confirme — o sistema gera o PIN e exibe o QR Code da sessão.

Pontos importantes

  • GARÇOM pode abrir apenas mesas sem garçom vinculado.
  • GERENTE, ADMIN e MASTER podem abrir qualquer mesa.
  • O QR Code da mesa aponta para /comanda/{PIN} — basta o cliente escanear.
  • A mesa fica com status OCCUPIED até ser liberada ou encerrada.

⚠ Atenção

Mesas com débito pendente bloqueiam nova abertura até regularização.

Múltiplas comandas por mesa

Modo MULTI — cada convidado tem sua própria comanda com PIN individual.

No modo MULTI, cada comanda criada recebe seu próprio PIN de 6 dígitos. O garçom cria uma comanda por convidado ou grupo, e cada um acessa a sua comanda de forma independente via QR/PIN. Os pedidos, totais e fechamentos são separados por comanda.

Passo a passo

  1. 1Abra a mesa com o modo "Múltiplas comandas" marcado.
  2. 2No painel de Mesas ou no Totem, clique em "Nova comanda".
  3. 3Informe o nome do convidado (ex: "João", "Casal A").
  4. 4O sistema gera a comanda com um PIN exclusivo.
  5. 5Compartilhe o PIN com o cliente — ele acessa /comanda/{PIN} no celular.
  6. 6Repita para cada convidado ou grupo da mesa.

Pontos importantes

  • Cada comanda tem PIN próprio — clientes acessam apenas a própria comanda.
  • O Totem exibe o PIN imediatamente após criar a comanda para o garçom copiar.
  • O card da mesa exibe todos os PINs ativos lado a lado.
  • A mesa só pode ser liberada quando todas as comandas estiverem fechadas.
  • É possível misturar: alguns convidados com PIN, outros sem (garçom lança).

ℹ Info

PINs de comandas MULTI são diferentes do PIN da mesa. Cada comanda tem seu PIN.

Pedido via QR pelo cliente

Cliente monta o carrinho e envia — itens entram como pendentes de aprovação.

O cliente acessa a comanda pelo QR Code ou PIN e vê o cardápio em tempo real. Ao enviar o pedido, os itens entram com status PENDING_APPROVAL e o garçom recebe uma notificação. Apenas após aprovação os itens são roteados para cozinha ou bar.

Passo a passo

  1. 1Cliente escaneia o QR Code da mesa.
  2. 2A página /comanda carrega o cardápio do restaurante.
  3. 3Cliente seleciona produtos e monta o carrinho.
  4. 4Ao clicar em "Enviar pedido", os itens entram em PENDING_APPROVAL.
  5. 5Garçom vê os itens pendentes em Pedidos e aprova.
  6. 6Itens aprovados seguem para produção (cozinha ou bar).

Pontos importantes

  • Apenas itens de clientes entram em PENDING_APPROVAL.
  • Itens lançados pelo garçom ou totem vão direto para APPROVED.
  • O cliente acompanha o status de cada item na própria página.
  • REQUESTING_BILL bloqueia novos pedidos do cliente.

✓ Dica

O garçom pode lançar pedidos pelo Totem sem depender do celular do cliente.

Retomar comanda pelo QR

Cliente acessa a comanda a qualquer momento pelo PIN ou QR da sessão.

O acesso à comanda é stateless: o cliente pode fechar o navegador e voltar a qualquer momento enquanto a sessão estiver ativa. A página exibe pedidos enviados, status de produção, total acumulado e menu para novos pedidos.

Pontos importantes

  • O PIN válido por 12 horas — suficiente para qualquer refeição.
  • Em modo SINGLE: escanear o QR da mesa retoma a mesma comanda.
  • Em modo MULTI: cada cliente usa seu PIN individual para acessar sua comanda.
  • A página pública /comanda atualiza o status automaticamente a cada 5 segundos.
  • Se a comanda estiver em REQUESTING_BILL, novos pedidos ficam bloqueados.

Triagem e aprovação (garçom)

Garçom revisa pedidos pendentes antes de enviar para produção.

A tela de Pedidos exibe todos os itens em PENDING_APPROVAL agrupados por mesa. O garçom pode aprovar em lote ou individualmente. Aprovação roteia o item para o KDS do setor correto (cozinha ou bar) com o timestamp de envio.

Pontos importantes

  • Acesse Pedidos → selecione a mesa → seção "Aguardando aprovação".
  • Aprove itens individualmente ou todos de uma vez.
  • Itens aprovados aparecem imediatamente no KDS do setor correspondente.
  • GERENTE, ADMIN e MASTER também podem aprovar e cancelar itens.
  • Itens em produção (APPROVED/PREPARING) aparecem na seção "Em produção".

KDS — Cozinha e Bar

Fila operacional por setor com atualização contínua em tempo real.

O KDS (Kitchen Display System) exibe a fila de produção filtrada por setor. Cozinheiros veem apenas itens do setor KITCHEN; bartenders veem itens do setor BAR. O status avança de APPROVED → PREPARING → READY conforme o item é processado.

Passo a passo

  1. 1Faça login com o perfil de COZINHEIRO ou BARTENDER.
  2. 2Acesse a tela de KDS — a fila carrega automaticamente.
  3. 3Clique em um item para marcar como "Preparando" (PREPARING).
  4. 4Ao finalizar o preparo, clique em "Pronto" (READY).
  5. 5O garçom recebe o aviso e faz a entrega na mesa.

Pontos importantes

  • Filtro de setor separa KITCHEN de BAR automaticamente por papel.
  • Contador de tempo mostra há quanto tempo cada item está na fila.
  • Urgência visual: itens destacam-se conforme o tempo de espera aumenta.
  • A fila atualiza em tempo real via WebSocket — sem recarregar.

ℹ Info

Produtos devem ter kitchenSector correto (KITCHEN ou BAR) para aparecer no setor certo.

Entrega de itens na mesa

Garçom confirma a entrega — item vai de READY para DELIVERED.

Quando o KDS marca um item como READY, o garçom recebe o aviso e realiza a entrega. Ao confirmar, o item passa para DELIVERED e o rastreio é encerrado. Esse ciclo garante controle total do fluxo e evita retrabalho.

Pontos importantes

  • Acesse Pedidos → selecione a mesa → seção "Prontos para entrega".
  • Clique em "Entregar" para cada item entregue.
  • O status DELIVERED encerra o rastreio do item.
  • O cliente vê o status atualizado na página da comanda.
  • Apenas itens em READY aparecem na seção de entrega.

Solicitar conta

Inicia o fechamento — bloqueia novos pedidos e sinaliza o caixa.

Quando o cliente pede a conta, o garçom ou o próprio cliente (via comanda pública) muda o status da comanda para REQUESTING_BILL. A partir daí, novos pedidos ficam bloqueados e o caixa pode iniciar o fechamento.

Passo a passo

  1. 1Na comanda pública, o cliente clica em "Solicitar conta".
  2. 2Alternativamente, o garçom pode acionar em Pedidos → "Solicitar conta".
  3. 3A comanda muda para REQUESTING_BILL — pedidos novos ficam bloqueados.
  4. 4O caixa vê a comanda na fila de fechamento.

Pontos importantes

  • O status REQUESTING_BILL é visível para toda a equipe.
  • Itens já lançados continuam em produção normalmente.
  • O card da mesa fica com destaque vermelho indicando conta solicitada.
  • É possível reverter o status se necessário (apenas GERENTE/ADMIN/MASTER).

Fechamento e pagamento (caixa)

Caixeiro processa o pagamento e libera a mesa para novo uso.

O fechamento confirma o recebimento total ou parcial (split payment) e encerra a comanda. A mesa volta para AVAILABLE somente quando todas as comandas associadas estiverem fechadas. O histórico de pagamento fica registrado para auditoria.

Passo a passo

  1. 1CAIXEIRO acessa a tela de Caixa e seleciona a comanda a fechar.
  2. 2Confere os itens, taxas de serviço e desconto aplicado.
  3. 3Seleciona a forma de pagamento: Dinheiro, Cartão (crédito/débito) ou PIX.
  4. 4Confirma o pagamento — a comanda passa para CLOSED.
  5. 5Se todas as comandas da mesa estiverem fechadas, a mesa volta para AVAILABLE.

Pontos importantes

  • Split payment permite dividir o pagamento em múltiplas formas.
  • Taxa de serviço é configurável por ADMIN/MASTER.
  • O comprovante fica disponível no histórico da comanda.
  • Cada pagamento registra quem o recebeu (operador) para conferência.

Receber pagamento na mesa (garçom)

O garçom pode registrar o pagamento direto na comanda, sem ir ao caixa.

Além do caixa, o GARÇOM pode registrar o pagamento na própria mesa através de um modal contextual em Pedidos. Isso agiliza o atendimento em operações de balcão ou mesa. O pagamento fica vinculado ao garçom que o registrou para conferência no relatório por operador.

Passo a passo

  1. 1Em Pedidos, selecione a comanda a receber.
  2. 2Abra o modal de pagamento na comanda.
  3. 3Escolha a forma: PIX, Crédito ou Débito (o saldo restante vem pré-preenchido).
  4. 4Confirme — o pagamento é registrado com seu nome como operador.

Pontos importantes

  • GARÇOM registra pagamento pelo modal em /orders (não acessa o caixa completo).
  • CAIXEIRO acessa a tela de Caixa completa.
  • Todo pagamento guarda o operador que o registrou.
  • O relatório "Por operador" (gestores) consolida os recebimentos por pessoa.

Delivery e entregador

Pedidos por telefone/WhatsApp, painel de entregas e coleta de pagamento.

Com o add-on Delivery, a operação ganha pedidos externos por telefone (TEL-NNN) e WhatsApp (WAP-NNN), cadastro de cliente, painel /delivery e o papel ENTREGADOR. O entregador despacha, entrega e coleta o pagamento, com eventos em tempo real e guia de entrega para impressão.

Passo a passo

  1. 1Receba o pedido por telefone ou WhatsApp e cadastre/identifique o cliente.
  2. 2Lance os itens — o pedido recebe numeração sequencial (TEL/WAP).
  3. 3A cozinha/bar prepara os itens no KDS normalmente.
  4. 4Com os itens prontos, o pedido vai para despacho no painel /delivery.
  5. 5O ENTREGADOR é atribuído, despacha (IN_TRANSIT) e marca como entregue, coletando o pagamento.

Pontos importantes

  • Numeração sequencial separada para telefone e WhatsApp.
  • Guia de entrega imprimível em /impressao/delivery.
  • Botão "Notificar cliente" via WhatsApp e repetição do último pedido.
  • Disponível em pacotes com Delivery incluso (Lanchonete, Pizzaria, Restaurante) ou via add-on.

ℹ Info

O papel ENTREGADOR exige foto de perfil cadastrada.

QR Code abre "Forbidden"

Problema de configuração de domínio ou PIN expirado.

O erro Forbidden no acesso via QR Code indica que o link gerado aponta para um domínio incorreto, ou que o PIN expirou. Verifique a variável de ambiente FRONTEND_URL no backend — ela define a base do URL gerado no QR.

Pontos importantes

  • Confirme que FRONTEND_URL está definida com o domínio público correto.
  • Verifique se o PIN da mesa ainda está ativo (expira em 12h ou ao liberar).
  • QR Codes físicos impressos apontam para a URL do PIN atual — ao liberar a mesa, o QR da sessão anterior expira.
  • Se o problema persistir, re-abra a mesa para gerar um novo PIN e QR.

✓ Dica

O QR Code dinâmico na tela do sistema sempre reflete o PIN atual da sessão.

Itens não aparecem no KDS

Itens lançados não chegam à fila de produção.

O KDS exibe apenas itens com status APPROVED ou PREPARING. Se os itens foram adicionados pelo cliente (via QR), eles entram em PENDING_APPROVAL e precisam ser aprovados pelo garçom antes de aparecer no KDS.

Pontos importantes

  • Itens de clientes entram em PENDING_APPROVAL — precisam de aprovação do garçom.
  • Itens lançados pelo garçom ou totem vão direto para APPROVED (aparecem no KDS).
  • Verifique se o produto tem o KitchenSector correto para aparecer no setor certo.
  • Confirme que o KDS está filtrado para o setor correto (KITCHEN ou BAR).

Onde cada equipe atua

Resumo por área

Ir para operação

Sala

Garçom abre mesas, aprova pedidos, entrega itens prontos e libera mesa ao final.

Cozinha e Bar

KDS separa a fila por setor — KITCHEN e BAR — com atualização em tempo real.

Caixa

Caixeiro fecha a conta, registra o pagamento e libera a mesa para próximo uso.