SigmaFlow
SIGMAFLOWGastronomia e Sistemas
ManualInício rápido

Central de suporte

Manual de utilização

Guia técnico completo — sala, cozinha, bar, caixa e administração. Navegue pelo índice lateral ou baixe o PDF completo.

1

Início rápido

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.

2

Sala e Mesas

Abrir mesa

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.

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.

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.

3

Pedidos e Produção

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.

Triagem e aprovação pelo 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.
  • Pedidos de urgência ou itens atrasados são destacados visualmente.
  • 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.
4

Caixa e Fechamento

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

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, PIX ou Voucher.
  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.
  • GARÇOM pode acompanhar, mas somente CAIXEIRO conclui o fechamento.

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.

5

Administração

Usuários 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 48h 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 módulo

Personalize a aparência e ative funcionalidades do seu plano.

As configurações de aparência (tema, cores, densidade de menu) e de módulo (tipo de estabelecimento, add-ons) são acessíveis somente para MASTER, ADMIN e GERENTE. As mudanças de módulo afetam o menu lateral e as funcionalidades disponíveis.

Pontos importantes

  • Tema visual: dark mode, glassmorphism e densidade de menu.
  • Módulo: define o tipo do estabelecimento (Bar, Restaurante, Pizzaria, etc.).
  • Add-ons: Delivery, Relatórios avançados e Multi-unidade.
  • Logo e nome do estabelecimento aparecem na sidebar e na tela do cliente.
  • 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.
  • Relatórios avançados requerem 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.

6

Ajuda rápida

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.

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.

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).
  • Itens antigos (antes de atualização do sistema) podem estar em PENDING_APPROVAL — aprovar manualmente.
  • 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).

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.

ℹ Info

Este problema ocorre principalmente em ambientes que tiveram dados inconsistentes antes da versão atual do sistema.

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.