PWA para um sistema clínico: instalável, com push próprio e sem dado de paciente no cache
Como o Markmedi virou um app instalável sem loja: service worker que nunca guarda páginas, web push com VAPID próprio e cuidados para computadores compartilhados de recepção.
A médica abre o Markmedi no celular entre um paciente e outro; a recepcionista deixa a agenda aberta o dia inteiro num computador que três pessoas usam. Nenhuma das duas quer "entrar no site": querem um ícone que abre direto na agenda e uma notificação quando um paciente agenda pela internet. Um app nativo resolveria, ao custo de duas lojas, dois ciclos de revisão e uma segunda base de código. O caminho que escolhi foi um PWA.
O ponto que tornou esse trabalho diferente de um PWA comum é que o conteúdo é prontuário. A parte mais importante do service worker do Markmedi é o que ele se recusa a guardar.
Manifesto e instalação
O manifesto abre em modo standalone, com o dashboard como página inicial e um parâmetro na URL para eu saber que a sessão veio do app instalado. Ele declara dois atalhos, Agenda e Pacientes, que aparecem quando a pessoa segura o ícone no Android ou clica com o botão direito no desktop. Os ícones têm uma versão maskable, para que o Android possa recortar no formato do sistema sem cortar o símbolo.
O convite para instalar respeita o usuário. O app guarda o evento beforeinstallprompt e mostra o convite no momento certo, dentro da interface. Se a pessoa dispensar, o convite some por 14 dias. No iOS, que não tem esse evento, o convite vira instruções de "Compartilhar → Adicionar à Tela de Início". Quando a instalação acontece, registro um evento pwa_installed no tracking próprio (que eu descrevo em tracking próprio em SQL).
O iOS ainda pede uma tela de abertura por tamanho de aparelho. Em vez de desenhar à mão, um script gera as imagens: 15 tamanhos, em versão clara e escura, 30 arquivos no total. Dentro do app instalado, um splash leve aparece só em display-mode: standalone.
Todo esse cabeçalho de PWA aparece apenas no "shell" da equipe da clínica. O portal do paciente e as páginas públicas (agendamento online, site) não oferecem instalação nem registram service worker. Faz sentido de produto, porque o paciente usa o portal poucas vezes por ano, e reduz o que roda no navegador de quem não é da equipe.
O service worker que não guarda páginas
A receita padrão de PWA manda colocar as páginas em cache para que o app abra offline. Num sistema clínico, isso significa deixar a lista de pacientes do dia, nomes, telefones e trechos de prontuário gravados no armazenamento do navegador de um computador compartilhado, sem expiração e fora do controle do servidor. Logout não limpa esse cache. Por isso a regra do service worker é explícita: nenhuma página, resposta do Inertia ou resposta de API é guardada.
O que ele faz, na versão atual:
- Na instalação, pré-carrega só a página offline, o ícone e o badge das notificações, o favicon e as marcas do splash.
- Assets do build (
/build/assets/*, que têm hash no nome) usam cache-first, com um limite de 120 arquivos e limpeza dos mais antigos. Um arquivo com hash nunca muda, então servir do cache é sempre correto. - Navegações usam network-first com navigation preload, que dispara a requisição em paralelo com o boot do service worker. Sem rede, a pessoa vê a página offline, que explica o que aconteceu. Ela nunca vê uma versão antiga da agenda.
- Na ativação, as versões antigas do cache da aplicação são apagadas.

self.addEventListener('fetch', (event) => {
const url = new URL(event.request.url);
if (url.pathname.startsWith('/build/assets/')) {
event.respondWith(cacheFirst(event.request)); // imutável por hash
return;
}
if (event.request.mode === 'navigate') {
event.respondWith(networkFirstWithOfflinePage(event)); // nunca grava a página
}
// qualquer outra coisa: o navegador resolve, sem cache do SW
});O custo é claro: o Markmedi não funciona offline. Considerei um modo offline para a agenda e desisti. Sincronizar alterações feitas offline com uma agenda que tem regras de concorrência no servidor (descritas em concorrência no agendamento) seria reescrever essas regras no cliente, e o ganho para uma clínica com internet ruim por alguns minutos não paga o risco.
O próprio sw.js e o manifesto são servidos pelo Nginx com Cache-Control: no-cache, para que uma versão nova do service worker chegue no próximo carregamento e não fique presa num cache intermediário.
Web push sem intermediário
As notificações push usam o protocolo padrão de Web Push com chaves VAPID próprias, pela biblioteca minishlink/web-push. Não há Firebase, OneSignal ou outro provedor no meio: o servidor do Markmedi cifra a mensagem e entrega direto no serviço de push do navegador. Menos um fornecedor recebendo dados sobre agendamentos de pacientes.

Alguns detalhes fazem diferença:
- Padding automático. O conteúdo é cifrado de ponta a ponta, mas o tamanho do pacote vaza informação: "consulta agendada" e "consulta cancelada" têm tamanhos diferentes. O padding automático deixa as mensagens com tamanhos parecidos.
- Cabeçalho
Topic. Derivado de um hash da tag da notificação, ele faz o serviço de push substituir mensagens repetidas enquanto o aparelho está desligado. Quem liga o celular depois do almoço vê uma notificação atualizada, não dez. - Limpeza. Respostas 404 e 410 do serviço de push significam inscrição morta, e a linha é apagada. Erros 429 e 5xx são tratados como temporários e vão para retry.
- Clique seguro. No
notificationclick, o service worker só abre URLs da própria origem e, se o app já estiver aberto, foca a janela existente em vez de abrir outra. Uma notificação nunca vira um redirecionamento para fora.
As inscrições ficam numa tabela com o hash do endpoint como chave única, o rótulo do aparelho e a data do último uso. Na tela de preferências, cada profissional vê os aparelhos inscritos e pode remover qualquer um.
O computador da recepção
Um caso que só apareceu em uso real: o computador da recepção é compartilhado. Se a Dra. A ativou notificações nele e depois a recepcionista entra com a própria conta, as notificações da médica não podem continuar aparecendo naquela tela. Por isso, no logout, a inscrição de push daquele navegador é esquecida no servidor. É uma linha de código que evita um vazamento bem concreto.
O que ficou de fora
Não usei Background Sync nem Periodic Sync, pelo mesmo motivo do offline: ambos pressupõem guardar algo no dispositivo para enviar depois. Também não fiz um app separado para pacientes. O portal funciona bem como site, e cada recurso que eu coloco no navegador de um paciente é mais uma superfície para manter.
O resultado é um app que a clínica instala em segundos, recebe notificações em tempo real e, se o aparelho for perdido, não leva o prontuário junto. O PWA é a camada mais próxima do usuário no Markmedi. As atualizações em tempo real dentro da agenda vêm do Reverb, assunto de tempo real com Laravel Reverb.