Cafeteria
Cafeteria é o módulo integrado de serviço de alimentos e bebidas do HandyCafe. Ele permite criar uma planta digital das mesas, publicar um menu de autoatendimento com a marca do estabelecimento na web em handy.cafe/{your-slug} e acompanhar cada pedido recebido em tempo real pelo painel do servidor.
Os clientes escaneiam o código QR da mesa, informam um código de segurança de 6 dígitos, navegam pelo menu no próprio idioma e fazem o pedido. O pedido aparece na tela de Pedidos da Cafeteria em poucos segundos. A equipe confirma cada etapa de preparo e, quando o atendimento termina, a ação de "Acertar Conta" encerra a comanda em um único passo.
Para quem é
A Cafeteria foi pensada para lan houses, centros de jogos e arenas de esports que também servem alimentos e bebidas na mesa do cliente. Ela substitui papéis de pedido e solicitações verbais ao balcão. Funciona em conjunto com o sistema padrão de sessões e preços do HandyCafe; os pedidos da cafeteria são acompanhados separadamente, mas na mesma licença do café.
Recursos principais
| Recurso | Resumo |
|---|---|
| Planta de mesas | Editor visual para vários andares. Arraste as mesas para a posição desejada, alterne para a visão 3D e marque mesas fora de serviço. |
| Mesas | Configure por mesa a quantidade de assentos, o formato, o tamanho (1 a 10) e o código exibido. Gere códigos QR e gire-os quando quiser. |
| Menu | Categorias com ícones MDI, produtos com fotos, descrições em Markdown, listas de ingredientes e grupos de variações (por exemplo, Tamanho e Coberturas). |
| Pedidos | Painel ao vivo com verificação a cada 3 segundos, indicador de pendências, notificações de desktop e áudio, e status por pedido e por item. |
| Liquidação | Ação de fechamento com um clique que liquida todos os pedidos abertos de uma mesa com o método de pagamento escolhido. |
| Menu do cliente | Menu web com a marca do estabelecimento em 24 idiomas no handy.cafe/{slug}, com tema claro e escuro e idioma padrão sensível ao dispositivo. |
| Pagamento online | Integração opcional com Stripe Checkout para pagamento no pedido, com fallback para pagamento em dinheiro na mesa. |
| Impressora | Impressora de recibos TCP opcional com corte automático e impressão automática em novos pedidos. |
Onde a Cafeteria fica na interface do servidor
A Cafeteria tem dois pontos de entrada:
- Seção Cafeteria na barra lateral. Este é o espaço operacional para uso diário. Ele contém cinco abas: Mesas, Planta de Mesas, Menu, Pedidos e Agenda. A aba Pedidos mostra um indicador de pendências sempre que há novos pedidos aguardando.
- Configurações > Cafeteria. Esta é a área de configuração. Ela concentra o perfil do negócio (slug, nome de exibição, logo, imagem de cabeçalho, endereço, moeda e fuso horário), as configurações da impressora, o gerenciamento de andares e as opções de recurso.
Provisionamento de uma cafeteria
Quando você ativa a Cafeteria pela primeira vez, o servidor usa automaticamente a licença do HandyCafe como token de autorização. Nada precisa ser colado manualmente. O assistente de provisionamento pede quatro informações:
- Slug. Este passa a ser a URL pública em
handy.cafe/{slug}. Os caracteres permitidos são letras minúsculas, números e hifens. O slug deve ter entre 3 e 62 caracteres. O sistema verifica a disponibilidade em tempo real e rejeita slugs reservados como "admin", "api" ou "dashboard". - Nome de exibição. O nome legível mostrado no topo do menu do cliente.
- País e moeda. A moeda padrão para os preços do menu. Os preços são armazenados em unidades menores (por exemplo, centavos) e exibidos com o símbolo da moeda configurada.
- Fuso horário. Usado para cálculos dinâmicos de tempo de preparo, carimbos de data e hora nos pedidos e registros de liquidação.
Depois que o provisionamento termina, a cafeteria é criada no banco de dados na nuvem e o espaço de trabalho da Cafeteria é aberto. Em seguida, você pode adicionar andares, mesas e itens do menu.
Perfil do negócio
O perfil do negócio pode ser editado a qualquer momento em Configurações > Cafeteria. Campos principais:
| Campo | Finalidade |
|---|---|
| Slug | Trecho da URL pública. Alterar o slug invalida os códigos QR existentes até que sejam gerados novamente. |
| Nome de exibição | Mostrado no topo do menu do cliente. |
| Logo | Imagem quadrada. WebP recomendado, até 2 MB. |
| Imagem de cabeçalho | Banner largo no topo do menu do cliente. WebP recomendado, até 2 MB. |
| Endereço e telefone | Opcionais. Exibidos no rodapé do menu. |
| Moeda | Aplicada a cada preço de produto no menu. |
| País | Usado para impostos e padrões regionais. |
| Fuso horário | Aplicado aos carimbos de hora dos pedidos e das liquidações. |
| Mostrar tempo de preparo no menu | Alternador. Quando ativado, cada produto exibe um indicador com o tempo estimado de preparo. |
Configurações da impressora
A seção da impressora aceita a seguinte configuração:
- Tipo. Desativado ou TCP. Impressão direta por USB não é suportada nesta versão.
- IP e porta. O endereço de rede da impressora de recibos. A maioria das impressoras TCP ESC POS escuta na porta 9100.
- Corte automático. Adiciona o comando de corte de papel após cada recibo impresso.
- Impressão automática em novo pedido. Quando ativada, cada pedido recebido dispara automaticamente a impressão de um recibo.
- Notificação sonora. Toca um alerta de áudio além da notificação de desktop quando um novo pedido chega.
- Impressão de teste. Envia um recibo de amostra para a impressora configurada e verifica a conexão.
Resumo da arquitetura
A Cafeteria usa um modelo de dados cloud-first. Cada mesa, categoria, produto, pedido e registro de liquidação fica armazenado no banco de dados na nuvem do handy.cafe. Seu servidor local do HandyCafe replica esse estado e consulta o endpoint de Pedidos a cada 3 segundos em busca de atividade nova. As páginas visíveis ao cliente são servidas diretamente pela nuvem do handy.cafe; elas não exigem que o seu servidor fique acessível pela internet.
Como os dados vivem na nuvem:
- Os códigos QR continuam funcionando mesmo quando o servidor está offline, mas a equipe não consegue ver os pedidos no painel até a conectividade voltar.
- As alterações no menu são enviadas ao handy.cafe em poucos segundos após o salvamento.
- Os pedidos feitos pelos clientes chegam ao painel de Pedidos na próxima verificação de 3 segundos.
Próximos passos
- Planta de Mesas: Monte o layout espacial do seu estabelecimento e configure cada mesa.
- Gerenciamento do Menu: Crie categorias, produtos e variações.
- Pedidos: O painel ao vivo dos pedidos recebidos.
- Menu do Cliente: O que os clientes veem ao escanear o QR de uma mesa.
- Como Configurar a Cafeteria: Passo a passo completo da configuração.