Engenharia

Offline-first é uma fila, não um slogan

12 de novembro de 2026 · Software by Design

Uma cuidadora documenta uma visita numa cave sem rede. Um terminal continua a registar enquanto o wifi do estaleiro está em baixo. «Funciona offline» imprime-se facilmente numa lista de funcionalidades, o que conta é o que acontece exatamente a esses registos e o que nunca lhes pode acontecer.

A outbox, especificada com honestidade

Quando a rede cai, as nossas apps companheiras não guardam registos «em memória» à espera de sorte. Cada registo pendente entra numa fila cifrada no dispositivo, texto cifrado AES-GCM em armazenamento local, a chave no cofre seguro da plataforma, limitada a 32 entradas para que uma ligação morta não faça crescer um atraso sem limites. A fila é FIFO e esvazia-se sozinha quando a conetividade volta.

A cifragem em repouso é a parte discreta que conta: um registo de ponto é um dado pessoal. «Só esteve uma hora no telemóvel» não é resposta a um dispositivo roubado.

Porque decide o servidor, não o telefone

Reenviar registos em fila é onde o offline costuma mentir. Uma repetição pode chegar duas vezes. Duas ações em fila podem chegar fora de ordem. Por isso cada registo leva um identificador de pedido do cliente e o carimbo temporal real, quando aconteceu, não quando chegou. O servidor reserva o identificador antes de qualquer escrita: uma repetição duplicada torna-se um no-op em vez de um registo duplo. Mesmo id, conteúdo diferente? É um conflito 409, não uma sobreposição silenciosa. E a conformidade avalia-se no momento do registo, uma entrada às 07:02 reenviada conta às 07:02, dentro da janela de skew configurada pela organização (24 h por defeito, teto rígido de 72).

A variante quiosque resolve uma versão mais dura do mesmo problema: não há sessão pessoal no dispositivo. Os cartões resolvem-se através de uma cache de identidades NFC limitada e cifrada, máximo 500 entradas, TTL de sete dias, para que uma falha do terminal não se torne uma fila à porta.

O limite que nos impomos

A tolerância offline é uma janela, não um modo de vida. Os registos mais antigos do que o skew configurado deixam de ser reenviados e sobem à superfície para uma pessoa decidir, uma «entrada» com uma semana que aparece do nada é exatamente o mecanismo que descredibiliza um registo horário. E quem termina sessão com registos pendentes vê-o dito, esperar ou descartar, escolha vossa, dito com clareza.

Isto é «offline-first» nas nossas apps: não que a interface abra sem sinal, mas que o rasto de auditoria sobreviva a um corte. O ArbeitszeitCheck móvel e terminal, e o CareCheck, entregam isto hoje.