Visão geral
O TermoTracing mostra o que acontece nos sites e aplicativos web monitorados, do lado do navegador. Ele responde a três perguntas: quem visitou e o que fez (sessões), o que quebrou e quantos foram afetados (erros) e quanto foi consumido (uso e franquia).
O repositório e o painel se chamam TermoTracing. A landing page ainda usa o nome comercial Nav Analytics.
Quem usa
| Público | O que faz |
|---|---|
| Colaborador Termotubos | Entra pelo TermoAuth, cadastra os aplicativos, instala o snippet e acompanha sessões, erros e uso no painel |
| Visitante do site monitorado | Não usa o painel: o t.js roda no navegador dele e envia os eventos |
O backend só aceita tokens do TermoAuth com role = employee. Cada colaborador é uma conta separada: todos os dados ficam isolados pelo conta_id, que é o sub do token. Não existe equipe nem organização compartilhando dados.
O que o produto faz
- Instalação — Cadastro do aplicativo, snippet do
t.jse o primeiro evento. - Ingestão — O endpoint público que recebe os lotes, os limites e a retenção.
- Sessões — Indicadores do período, lista e fluxo de cada visita, exclusão LGPD.
- Erros — Grupos de erro pela assinatura, usuários afetados e status.
- Uso e franquia — Consumo do ciclo, avisos por e-mail e fatura estimada.
O caminho de um evento
1. O colaborador cadastra o aplicativo
Em Aplicativos, informa o nome, os domínios autorizados, a franquia mensal e o comportamento ao estourar. O painel gera a chave pública (pk_live_…) e mostra o snippet.
2. O site carrega o t.js
O snippet colado antes de </head> carrega o t.js servido pelo próprio painel. O script cria o anonimo_id do navegador, a sessão da aba e passa a capturar erros, requisições, navegação, cliques e métricas.
3. Os eventos chegam em lotes
A cada 5 segundos o t.js envia um lote com gzip para POST /evento/ingestao. O backend confere a chave, a origem e os limites, responde 202 e põe o lote numa fila.
4. A fila grava e agrega
Em segundo plano, cada evento é gravado uma única vez, a sessão recebe os contadores, os erros entram no grupo da sua assinatura e o uso do dia é somado.
5. O painel mostra
Visão geral, Sessões, Erros e Uso leem esses dados. Depois de 30 dias sessões, eventos e erros são apagados de vez.
Telas do painel
| Tela | Rota | O que mostra |
|---|---|---|
| Visão geral | /app/visao-geral | Sessões, usuários únicos, erros e tempo médio de carregamento do período, com a variação sobre o período anterior |
| Erros | /app/erros | Grupos de erro ordenados por usuários afetados e ocorrências |
| Sessões | /app/sessoes | Lista paginada e, em /app/sessoes/[id], o fluxo da visita página a página |
| Uso | /app/uso | Consumo do ciclo, projeção do mês, excedente e fatura estimada |
| Aplicativos | /app/aplicativos | Cadastro dos sites monitorados, chave, snippet e franquia |
| Configurações | /app/configuracoes | Links para a conta no TermoAuth (senha, dois fatores) |
/app redireciona para a Visão geral. A rota /app/dashboard existe, mas não está no menu.