HandyCafe Docs
owner it-admin

Como Configurar a Cafeteria

Este guia mostra a configuração inicial completa do módulo Cafeteria. Ao final, você terá um menu do cliente publicado em handy.cafe/{your-slug}, uma planta de mesas com pelo menos uma mesa funcionando, um menu com produtos e um pedido de teste realizado com sucesso.

O que você vai precisar

  • Uma licença ativa do HandyCafe. A autenticação da Cafeteria usa a licença automaticamente; você não precisa colar nenhuma chave manualmente.
  • Conectividade com a internet no servidor. A Cafeteria é cloud-first, então o provisionamento, a sincronização do menu e a consulta periódica de pedidos exigem acesso de saída à API da nuvem.
  • Um slug que você queira usar na URL pública do menu. Os caracteres permitidos são letras minúsculas, números e hifens. O comprimento deve ficar entre 3 e 62 caracteres.
  • Opcional: logo e imagem de cabeçalho. O formato recomendado é WebP, com até 2 MB.
  • Opcional: uma impressora de recibos TCP na rede local.

Passo 1: Ative a Cafeteria

  1. Abra o HandyCafe Server.
  2. Navegue até Configurações na barra lateral.
  3. Abra a aba Cafeteria.
  4. Ative Habilitar Cafeteria.
  5. O servidor entra em contato com a API da nuvem usando sua licença como token de autorização. Se tudo der certo, o Assistente de Provisionamento é aberto.

Resultado esperado: A tela do Assistente de Provisionamento aparece. Se surgir um erro de licença ou conectividade, verifique sua conexão com a internet e confirme que a licença do HandyCafe está ativa.

Passo 2: Provisione sua cafeteria

O assistente solicita quatro campos.

  1. Slug. Digite o sufixo desejado da URL. O indicador de disponibilidade é atualizado em menos de um segundo. Se o slug estiver em uso ou reservado, escolha outro.
  2. Nome de exibição. O nome legível mostrado no topo do menu do cliente, por exemplo "Atilla's Gaming Lounge".
  3. País e moeda. Escolha o país onde a cafeteria funciona. A moeda padrão é definida com base no país e pode ser alterada.
  4. Fuso horário. Escolha o fuso para os carimbos de data e hora dos pedidos e das liquidações.
  5. Clique em Criar Cafeteria.

Resultado esperado: O assistente fecha e o espaço de trabalho da Cafeteria é aberto. Sua URL pública handy.cafe/{slug} passa a funcionar, embora o menu ainda esteja vazio.

Passo 3: Preencha o perfil do negócio

  1. Ainda em Configurações > Cafeteria, role até a seção Perfil do Negócio.
  2. Envie um Logo (imagem quadrada).
  3. Envie uma Imagem de Cabeçalho (banner largo).
  4. Informe Endereço e Telefone para exibir no rodapé do menu do cliente.
  5. Ative ou desative Mostrar tempo de preparo no menu conforme queira que os clientes vejam estimativas de preparo.
  6. Clique em Salvar.

Resultado esperado: O logo e o cabeçalho aparecem na pré-visualização. Ao visitar handy.cafe/{slug} no navegador, você vê o cabeçalho com a marca, mas o conteúdo continua vazio.

Passo 4: Crie andares

  1. Em Configurações > Cafeteria, encontre a seção Andares.
  2. Clique em Adicionar Andar e dê um nome a ele (por exemplo, "Sala Principal").
  3. Adicione andares extras se o seu estabelecimento tiver várias áreas (por exemplo, "Mezanino" ou "Área Externa").
  4. Reordene os andares com os botões de mover para cima e mover para baixo. O andar do topo vira o padrão no editor de Planta de Mesas.

Resultado esperado: Seus andares aparecem na lista. A aba Cafeteria > Planta de Mesas agora mostra as opções de andar no topo.

Passo 5: Monte a planta de mesas

  1. Abra Cafeteria > Planta de Mesas.
  2. Selecione o primeiro andar nas opções no topo.
  3. Clique em Adicionar Mesa. Uma mesa quadrada aparece na origem da tela.
  4. Arraste a mesa para a posição desejada. Solte para salvar.
  5. Clique na mesa para abrir o painel de propriedades. Configure:
    • Código (por exemplo, "T1" ou "Janela 3").
    • Nome de exibição (rótulo mais longo, opcional).
    • Quantidade de assentos (número de lugares).
    • Formato (quadrado, retângulo horizontal, retângulo vertical ou redondo).
    • Tamanho (1 a 10).
  6. Repita para cada mesa do andar.
  7. Se quiser, alterne para a visão 3D para revisar o layout com uma perspectiva mais arquitetônica.

Resultado esperado: A planta mostra todas as mesas nas posições reais. O arraste fica desativado na visão 3D; volte para o modo 2D para mover as mesas.

Passo 6: Monte o menu

  1. Abra Cafeteria > Menu.
  2. Clique em Adicionar Categoria. Digite um nome e escolha um ícone MDI no seletor de ícones. Clique em Salvar.
  3. Repita para cada categoria (por exemplo, "Bebidas Quentes", "Bebidas Frias", "Hambúrgueres", "Sobremesas").
  4. Dentro de uma categoria, clique em Adicionar Produto. Informe:
    • Nome.
    • Descrição (suporta Markdown).
    • Linha de ingredientes.
    • Preço base.
    • Taxa de IVA.
    • Tempo de preparo (reserva fixa).
    • Opcional: rótulo de unidade, indicador Controlar estoque e quantidade Em estoque.
  5. Envie uma Foto do produto. Aceita qualquer formato; WebP de até 2 MB é o recomendado.
  6. Clique em Salvar.
  7. Se o produto tiver escolhas, role até a seção Variações e clique em Adicionar Variação. Crie uma linha para cada opção com sua diferença de preço. Ative Obrigatória se o cliente precisar escolher uma.
  8. Repita para cada produto do menu.

Resultado esperado: O menu do cliente em handy.cafe/{slug} agora mostra suas categorias e produtos. Abra no navegador para conferir.

Passo 7: Configure a impressora (opcional)

  1. Ainda em Configurações > Cafeteria, role até Configurações da Impressora.
  2. Defina Tipo como TCP.
  3. Informe o IP e a Porta da impressora. A maioria das impressoras TCP ESC POS escuta na porta 9100.
  4. Ative Corte automático se a impressora suportar esse recurso.
  5. Ative Impressão automática em novo pedido para disparar uma impressão a cada pedido recebido.
  6. Ative Notificação sonora para tocar um alerta junto com a notificação de desktop.
  7. Clique em Impressão de teste. Um recibo de exemplo deve sair em poucos segundos.

Resultado esperado: O recibo de teste é impresso com sucesso. Se nada sair, verifique o IP, a porta e se a impressora está na mesma rede local do servidor.

Passo 8: Acomode uma mesa e faça um pedido de teste

  1. Abra Cafeteria > Mesas (ou use o menu de ações da Planta de Mesas).
  2. Escolha uma mesa e clique em Acomodar Cliente (também rotulado como "Abrir Mesa").
  3. Anote o código de segurança de 6 dígitos exibido. Escreva-o ou deixe a janela aberta.
  4. Em um telefone, acesse handy.cafe/{slug}/{table-code}. Você também pode escanear o QR se tiver um adesivo impresso.
  5. Digite o código de 6 dígitos.
  6. Navegue pelo menu e adicione um item ao carrinho.
  7. Prossiga para o pagamento. Escolha Dinheiro como método de pagamento (a configuração do Stripe é opcional e pode ser adicionada depois).
  8. Envie o pedido.
  9. No servidor, mude para Cafeteria > Pedidos.

Resultado esperado: Em até 3 segundos, um novo cartão de pedido aparece no painel de Pedidos. Uma notificação de desktop é disparada. Um alerta sonoro toca se as notificações sonoras estiverem ativadas. O indicador de pendências da aba Pedidos aumenta.

Passo 9: Avance e liquide o pedido de teste

  1. No cartão do pedido, clique no próximo botão de status. O pedido muda de placed para confirmed.
  2. Continue clicando para avançar por preparing, ready e served.
  3. Na página Mesas, abra a mesma mesa e clique em Acertar Conta.
  4. Escolha Dinheiro como método de pagamento e confirme.

Resultado esperado: A mesa volta para idle. O código de segurança expira. Um registro de liquidação é criado e pode ser auditado depois.

Erros comuns para evitar

  • Pular o perfil do negócio. Os clientes veem o nome padrão e uma área de logo quebrada se você publicar antes de salvar o perfil.
  • Não reimprimir os QR codes depois de mudar o slug. Alterar o slug invalida todos os QR existentes. Imprima novos adesivos e troque em cada mesa.
  • Publicar categorias demais no lançamento. Mire em 6 a 10 categorias de nível superior. Os clientes navegam mais rápido quando o menu cabe na tela.
  • Esquecer de configurar a impressora antes do primeiro turno real. Sem Impressão automática em novo pedido, a equipe pode perder pedidos em horário movimentado. Sempre faça pelo menos uma impressão de teste.
  • Manter a opção padrão de Mostrar tempo de preparo no menu ativada sem histórico dinâmico. Nos primeiros 30 dias, o valor estático é o que os clientes veem. Defina tempos estáticos realistas ou desative o indicador até a estimativa dinâmica aprender.
  • Usar o mesmo dispositivo para testes da equipe e do cliente. A sessão do cliente dura 24 horas; se o dispositivo de teste depois for entregue a um cliente, ele já estará no menu sem verificação. Limpe o dispositivo ou use um perfil de navegador limpo para os testes.