Sentinela: incidentes e chamados dos meus apps, direto no celular
Ferramenta interna que recebe sinais, sonda o health de cada app, avalia regras e abre incidentes com push nativo no celular. PWA com Web Push e VAPID, sem Firebase, e chamados na mesma ferramenta.
Quando você mantém vários apps sozinho, o pior jeito de descobrir um problema é por um usuário reclamando, ou nem descobrir. Eu queria uma resposta única para "está tudo bem?", numa tela só, no celular. O Sentinela é essa resposta: uma ferramenta interna que junta sinais dos meus apps, transforma em incidentes e me avisa por push nativo, com os chamados de usuários na mesma ferramenta.
Ela é só minha, não é um produto. O interessante aqui é como ela decide o que merece me acordar.
O que ele faz
- Recebe sinais dos apps: erro, métrica, evento e heartbeat, por uma API com chave por app, com SDK em TypeScript e cliente em .NET.
- Sonda o health de cada app a cada minuto, porque um app fora do ar não consegue reportar o próprio incidente.
- Puxa do meu analytics o que o usuário vê: erro de JavaScript no navegador, queda de tráfego ou conversão, LCP lento.
- Avalia regras e abre incidentes: falta de heartbeat, rajada de erros, limite de métrica, latência, evento de negócio e padrão de log.
- Avisa por Web Push, sem Firebase, e também por Slack, Discord, e-mail, webhook e WhatsApp, cada canal com sua gravidade mínima.
- Escala: incidente aberto e não reconhecido notifica de novo em escada, 5, 15, 30 e depois a cada 60 minutos.
- Respeita a noite: silêncio noturno adia o push para o fim da janela em vez de descartar, e incidente crítico fura o silêncio.
- Mostra o negócio: coletor diário de assinaturas e vendas, cockpit por produto e resumo semanal por push.
- Guarda chamados separados dos incidentes, porque triar reclamação é outra atividade.
De sinal a incidente sem ruído
Monitor que grita demais vira monitor ignorado. Por isso quase toda a lógica está em decidir quando dois eventos são a mesma coisa e quando um silêncio significa alguma coisa.
- Duas chaves, dois trabalhos. A chave de idempotência garante que o mesmo sinal reenviado não vira duas linhas. O fingerprint decide se duas ocorrências são o mesmo problema, usando o topo da stack quando o app o envia, e caindo para rota ou caminho. Assim, um
TypeErrorem dois lugares diferentes não vira um incidente só. - Reocorrência não notifica. Ela só incrementa o contador do incidente aberto, e um cooldown segura o redisparo depois de resolvido.
- O silêncio do próprio worker não culpa ninguém. A regra de app fora do ar só dispara se existem heartbeats na janela e nenhum deu OK. Se não existe nenhum, quem ficou fora foi o worker, e acusar o app seria falso positivo.
Decisões que valeram a pena
- Índice único parcial em vez de lock. Um índice garante um único incidente por fingerprint enquanto ele não está resolvido. É SQL escrito à mão, porque o Prisma não gera índice parcial, e o trade-off é lembrar disso a cada migração nova. Em troca, a corrida entre duas avaliações morre no banco.
- Outbox fora da transação do incidente. A notificação é gravada e entregue por outro loop, com backoff de 1, 5, 15, 60 e 60 minutos. Uma falha de entrega nunca perde um incidente. A outbox guarda chaves de tradução, não texto pronto: a mensagem é montada no idioma de cada aparelho na hora da entrega.
- Worker dentro do processo do servidor. Os loops rodam no mesmo processo do Next.js, sem Redis nem fila externa. É bem mais simples de operar, e o preço está escrito no README: uma réplica só. Com duas, o índice ainda evita incidente duplicado, mas o push sairia em dobro.
- Billing como fonte da verdade. A visão de negócio vem de chaves restritas e somente leitura por produto, cifradas no banco com AES-GCM, sem nenhuma mudança nos apps. As fontes são plugáveis, então produto com venda avulsa entra por outro caminho.
Arquitetura
- PWA primeiro. Barra de abas no celular, sidebar no desktop, tema claro e escuro. No iPhone, push só funciona com o app instalado na Tela de Início, então o onboarding em dois passos trata esse caso.
- Diagnóstico de push. Há um teste só no aparelho e outro pelo serviço de push real: se o primeiro aparece e o segundo não, o problema está no caminho. Endpoints mortos são podados sozinhos.
- Clients que somem. Sem configuração, o cliente vira no-op silencioso, então dev e preview não precisam saber que o Sentinela existe.
- MCP de administração. Um servidor MCP remoto expõe apps, incidentes e chamados para eu cuidar deles por um agente, sem automação de login.
- Página de status pública, separada do painel.
- Limite honesto. Ninguém monitora o Sentinela: se ele cair, o silêncio dele parece "tudo bem". A solução é um pinger externo, não mais código.
Números
Medidos em 31/10/2026.
- 95 commits na
main, desde 10/08/2026. - Cerca de 20 mil linhas em arquivos versionados, 18 mil delas em TypeScript.
- 214 casos de teste em 32 arquivos, contados nos arquivos.
- 14 migrations e 16 modelos no Prisma.
- 6 canais de saída, contando o Web Push.
Next.js 16 · React 19 · TypeScript · Prisma 6 · PostgreSQL · Web Push (VAPID) · Tailwind CSS 4 · MCP
Código privado: o case detalha a arquitetura e as decisões técnicas.
Quer algo assim?
Eu também desenvolvo sistemas sob medida. Me conta o que você precisa.
Veja também
Para operações com várias unidades: o operador escaneia o QR Code do local, executa o checklist com fotos, geolocalização e assinatura, e o gestor acompanha SLA, escalação e relatórios.
14 dias grátis.
Crie uma rifa em um minuto, divulgue no WhatsApp, receba no Pix direto na sua conta e sorteie com comprovante público. O sorteio usa compromisso e revelação: qualquer pessoa recalcula o resultado no navegador.


