O que o modo offline faz quando a internet cai

O que é o modo offline do agente

O modo offline não é um segundo sistema: é o mesmo agente de impressão que você já usa pra mandar os pedidos pra impressora térmica. Com o bloco offline no config.json dele, esse aparelho passa a fazer mais duas coisas. Ele guarda uma cópia do cardápio, das Mesas, dos garçons e das cozinhas enquanto a internet está boa, e abre uma página de pedidos num endereço da rede do restaurante, tipo http://192.168.0.50:8765/.

Quando a conexão cai, o celular do garçom não alcança mais a nuvem, mas alcança o agente pelo Wi-Fi da casa. Ele abre essa página local, escolhe o garçom e a Mesa, monta a Comanda pelo cardápio guardado e envia: o ticket sai na impressora na hora e o pedido entra numa fila guardada no próprio aparelho, com um número local, tipo OFF-1. Essa fila fica salva mesmo se o agente for reiniciado.

Por que isso salva o serviço

• A cozinha continua recebendo papel. É o que importa no meio do serviço: o ticket sai na impressora da praça certa, com Mesa, garçom, quantidade, complemento e observação, do mesmo jeito que sairia com internet.
• Nada precisa ser digitado duas vezes. Quando a conexão volta, os pedidos sobem sozinhos e entram no qmen.us com o horário em que foram feitos, na Mesa certa. Ninguém fica depois do expediente relançando comanda.
• Nenhum ticket sai repetido. Cada pedido leva uma chave própria e chega na nuvem marcado como já impresso. Se a fila for enviada de novo, o qmen.us reconhece a chave e não cria pedido duplicado.
• A página é servida de dentro da casa. Por isso ela abre mesmo sem internet: quem entrega a tela é o agente, no Wi-Fi do restaurante, não um servidor lá fora.
• Não custa nada a mais. O qmen.us é grátis pro restaurante e sem comissão por pedido, e a gente não é marketplace tipo iFood. O modo offline vem junto do agente, que você mesmo instala no aparelho da casa.

Como trabalhar sem internet em 6 passos

São seis passos: o que preparar antes, o que fazer no meio da queda e o que acontece sozinho quando a conexão volta.

1. Deixe o agente ligado e o cardápio guardado

   Tudo depende de uma coisa só: o agente precisa estar rodando antes da queda. Enquanto tem internet, ele busca o cardápio, as Mesas, os garçons e as cozinhas a cada poucos segundos e guarda essa cópia no aparelho. Se você nunca deixou ele conectar, a página local abre dizendo Sem cardápio salvo — conecte à internet uma vez. e não dá pra pedir nada.

   Dica: Dê um IP fixo ao computador ou Raspberry Pi do agente na reserva de DHCP do roteador. Assim o endereço da página local não muda de um dia pro outro e o QR do balcão continua valendo.

2. Deixe o endereço local à mão antes de precisar

   Ao iniciar, o agente escreve o endereço da página local, no formato http://192.168.0.50:8765/. Esse endereço precisa estar cadastrado no qmen.us pra virar dois atalhos: o QR pra colar perto do balcão e o aviso Sem internet — toque para abrir o modo offline, que aparece sozinho no topo do app do garçom quando a conexão some. Esse QR é do agente, não é o QR da mesa: ele abre a página de pedidos da equipe.

3. Na queda, abra a página local no celular

   O celular do garçom precisa estar no Wi-Fi do restaurante — a internet caiu, mas a rede interna continua de pé. Toque no aviso do app, leia o QR do balcão ou digite o endereço. Abre uma tela escura com o cabeçalho qmen.us — modo offline (sem internet), o nome do restaurante e os campos Garçom, Mesa, Nome do pedido (opcional) e PIN. O PIN só é exigido se a casa configurou um; errado, aparece PIN incorreto. Toque em Começar.

4. Monte o pedido e toque em Enviar e imprimir

   O cardápio guardado aparece por categoria, com o preço de cada item. Item com tamanho ou sabor abre a folha de escolhas com Adicionar e Cancelar; os outros entram com um toque. A barra de baixo mostra quantos itens e o total, e o botão Ver pedido abre a Comanda pra mudar quantidade, escrever a observação (ex: sem cebola) ou remover linha. Em Enviar e imprimir, o ticket sai na impressora da cozinha certa e a tela confirma com o número local, tipo Pedido OFF-1 impresso!

5. Saiba o que não funciona enquanto falta internet

   Durante a queda existe só a página local. O monitor da cozinha, o painel, os relatórios, o QR da mesa pro cliente e o pedido pelo chat dependem da nuvem e ficam fora do ar. Também não dá pra andar com o pedido: não existe Em preparo, Pronto nem Entregue ali, e nada de item livre ou de conta fechada. O que vale é o papel que saiu na cozinha — e o preço impresso é o do cardápio guardado.

6. Deixe a fila sincronizar sozinha quando a internet voltar

   Não tem botão de enviar tudo. O agente tenta sincronizar a cada poucos segundos e, assim que a conexão volta, sobe a fila na ordem em que os pedidos foram feitos. Cada um entra no qmen.us já como Pedido na Mesa certa, com o garçom, os itens e o horário originais, e aparece no monitor da cozinha e no app do garçom. Nenhum ticket é impresso de novo, porque a cozinha já tem o dela.

Perguntas frequentes

Glossário

Modo offline

Bloco de configuração do agente que faz ele servir uma página local de pedidos e guardar uma fila enquanto o restaurante está sem internet.

Agente de impressão

O programinha que roda no aparelho da cozinha, busca as comandas no qmen.us, imprime na térmica e confirma.

Página local

Tela de pedidos servida pelo próprio agente num endereço da rede do restaurante, tipo http://192.168.0.50:8765/, com o cabeçalho qmen.us — modo offline (sem internet).

Cardápio guardado

Cópia do cardápio, das Mesas, dos garçons e das cozinhas que o agente baixa enquanto tem internet e usa pra montar pedidos durante a queda.

Fila local

Lista de pedidos anotados offline que fica salva no aparelho do agente até a internet voltar e cada um subir pro qmen.us.

OFF-1

Número que a página local dá pro pedido durante a queda (OFF-1, OFF-2, OFF-3), pra equipe conseguir se achar antes da sincronia.

Recursos relacionados