Pôr um restaurante inteiro a trabalhar num só PC, com a internet desligada

«Funciona offline» costuma querer dizer uma fila. A aplicação continua a receber pedidos em armazenamento local, e assim que a ligação volta envia-os para outro sítio. É uma funcionalidade real, e não é esta.

A Edição Local não tem nada para sincronizar. A base de dados está na máquina à sua frente, os pedidos nunca saem do edifício, e a internet não é sequer um componente do sistema. Desligue a linha do router e a única coisa que muda é que não pode ler as notícias.

Eis como isto é realmente num estabelecimento.

A forma

Um PC Windows — normalmente a máquina do caixa — faz de servidor. Tudo o resto no estabelecimento é um ecrã apontado a ele pela WiFi.

   PC Windows (o «servidor»)
     ├── a aplicação, na porta 8080
     ├── PostgreSQL, ligada apenas a esta máquina
     └── serve /admin  /pos  /kitchen  /waiter
                    │
        WiFi do estabelecimento (LAN — não precisa de internet)
       ┌────────────┼────────────┐
   Tablet do POS   Ecrã de cozinha   Telemóvel do empregado

Daqui seguem-se duas coisas que vale a pena dizer com clareza.

Nos tablets não se instala nada. O ecrã de cozinha e o telemóvel do empregado são navegadores a abrir um endereço. Sem loja de aplicações, sem versão para manter alinhada, sem dispositivo a reconfigurar quando é substituído. Um tablet que morre é substituído por qualquer tablet.

O endereço não está configurado em lado nenhum. O endereço a que um tablet foi apontado é para onde vão os seus pedidos. É por isso que a mesma instalação funciona em qualquer endereço e em qualquer máquina: nada vai compilado lá dentro, por isso nada tem de ser reconstruído quando a rede muda.

Do que precisa

• Um PC Windows que fique ligado. O do balcão, não o portátil que alguém leva à noite.
• Um router — qualquer um. Não precisa de ligação à internet para que os tablets cheguem à caixa.
• Um ecrã para a cozinha. Um tablet Android na WiFi sem nada instalado é a escolha por omissão. Um PC pequeno com Windows a correr a app de cozinha em modo quiosque é melhor se quiser som e um ecrã que nunca adormece.
• Uma impressora térmica das normais, e um leitor de códigos de barras USB se fizer leitura.

É toda a lista de material. Sem armário de servidores e sem Docker.

As duas coisas que correm mesmo mal

Tudo o resto é instalação vulgar. Estas duas são o que se parte num estabelecimento real, e ambas devem ser feitas antes do primeiro serviço e não durante.

A regra de firewall que não se aplica a nada

A falha mais comum é «funciona no PC, não funciona no tablet». O painel abre perfeitamente na caixa, todos os tablets dão tempo esgotado, e nada em ecrã nenhum liga os dois factos.

É quase sempre isto: o Windows classifica como Pública uma rede sobre a qual não lhe disseram nada, e a WiFi do estabelecimento num computador configurado nessa manhã é uma rede sobre a qual não lhe disseram nada. Uma regra de firewall limitada a redes privadas existe então, lê-se corretamente na lista, e não se aplica absolutamente a nada.

O instalador acrescenta a regra de entrada aos perfis Privado e Público ao mesmo tempo, exatamente por isto. O assistente do primeiro arranque recusa depois terminar até ter aberto o endereço a partir de um telemóvel na WiFi do estabelecimento — um passo que custa um minuto na instalação e salva um serviço.

O endereço que se mexe

Os routers distribuem endereços por empréstimo. Quando o router reinicia, o PC pode voltar noutro, e cada marcador guardado por cada tablet aponta agora para nada.

Reserve-o. Uma reserva DHCP no router, ou um endereço fixo no PC — qualquer um serve, e um dos dois tem de ser feito antes de alguém guardar um marcador. Qualquer outro conselho sobre apontar tablets à caixa é um remendo para um endereço que se mexe.

Apontar os tablets

O assistente mostra um código QR por ecrã. Abra a câmara do tablet, digitalize, e o ecrã de cozinha ou a app do empregado abre no endereço certo. Escrever http://192.168.1.x:8080/kitchen num teclado de tablet é possível, e é o recurso, não o plano.

Guarde o marcador e depois acrescente-o ao ecrã inicial se o tablet o propuser.

Do que abdica

http://192.168.1.x:8080 não é um contexto de navegação seguro, e os navegadores negam às páginas que não o são uma lista precisa de funcionalidades. Numa instalação em LAN isso custa:

• A leitura de códigos de barras por câmara. Um leitor USB escreve como um teclado e não é afetado — e numa cozinha é de qualquer forma a melhor ferramenta.
• A instalação no ecrã inicial e os service workers. Um marcador continua a funcionar; apenas abre no navegador em vez de como aplicação própria.
• O Wake Lock, que é o que mantém o ecrã de cozinha acordado. Ponha antes o tempo de espera do ecrã do tablet em «nunca», ou use a versão de cozinha para Windows, que contorna tudo isto.

O que não custa: a ligação em direto entre a caixa e a cozinha. Um pedido registado no POS chega ao ecrã de cozinha no mesmo segundo, pela rede local, com o cabo de internet do router no chão.

Duas ligações à internet, ao todo

Tem de estar online exatamente duas vezes, e nenhuma delas durante o serviço: uma para comprar e transferir o instalador, outra para ativar a máquina. Depois disso a licença é verificada na própria máquina — nada liga para casa para atender um cliente. Para locais onde nem isso é fiável, existe uma via de ativação offline que passa por uma aplicação de mensagens.

Tudo o que vem depois desses dois momentos acontece no seu próprio cabo.