Projeto

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.

Criador e desenvolvedor

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 TypeError em 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.
Ficha técnica
Papel
Criador e desenvolvedor
Stack

Next.js 16 · React 19 · TypeScript · Prisma 6 · PostgreSQL · Web Push (VAPID) · Tailwind CSS 4 · MCP

Status
ativo

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.

Trabalhe comigo

Veja também