🧮 A PONTUAÇÃO — como uma análise vira um número
metodo/PONTUACAO.md
title: PONTUAÇÃO DOS RELATÓRIOS — como medimos se estamos no caminho certo
criado: 2026-09-18
status: 🔒 REGRA PERMANENTE
🧮 A PONTUAÇÃO — como uma análise vira um número
O PRINCÍPIO
Cada relatório faz uma afirmação: "comprar a esta taxa é uma boa decisão".
Isso é uma previsão — e previsão se pontua. Se não pontuarmos, nunca saberemos
se o método funciona ou se estamos nos enganando.
"Coloque uma pontuação em cada futuro, baseado no passado." — o pedido do usuário
AS DUAS NOTAS (por que duas?)
A afirmação tem duas partes independentes:
| Nota | O que mede | Quando verificar | Peso |
|---|---|---|---|
| Carrego | O percentil da taxa na hora da recomendação. Alto = travamos um carrego historicamente bom. | Imediatamente | 60% |
| Timing | O que o preço fez depois (ΔPU). Taxa caiu → quem comprou ganhou marcação. | 30–365 dias | 40% |
Nota final = 0,6 × carrego + 0,4 × timing
Por que o carrego pesa mais?
Porque é a nossa tese ("carrego primeiro"). E porque os nossos próprios estudos
provam que o timing de curto prazo não é previsível (event study: eventos agendados
não movem a taxa; o que move é o imprevisto). Pesar o timing igual seria contradizer
o que aprendemos.
A normalização do timing
nota_timing = clamp(50 + 5 × ΔPU%, 0, 100)
+10% de valorização → 100 · 0% → 50 · −10% → 0. Simples e transparente.
Os graus
| Nota | Grau |
|---|---|
| ≥ 65 | 🟢 bom |
| 45–65 | 🟡 neutro |
| < 45 | 🔴 ruim |
| sem horizonte | ⏳ pendente |
AS ESTATÍSTICAS DO CONJUNTO
1. Vantagem de entrada (a métrica central)
vantagem = média(taxa travada) − média(taxa de todo o período)
Responde: "nossas entradas são melhores que uma entrada aleatória?"
Se for positiva e consistente, o método de timing tem valor. Se for ~0, não tem.
2. Acerto de timing
% dos relatórios em que a taxa NÃO subiu em 90 dias
Responde: "acertamos a direção de curto prazo?"
⚠️ Honestidade: num regime de alta de juros isso será baixo — e isso é esperado,
porque não é o que estamos afirmando. Serve para saber o ambiente, não para nos julgar.
3. Brier (calibração da confiança)
Brier = média( (confiança_declarada − resultado)² )
- 0 = perfeito · 0,25 = moeda justa · >0,25 = pior que jogar moeda
- Mede: quando dizemos 60% de confiança, acontece 60% das vezes?
- Se o Brier for pior que 0,25, nossa confiança é ruído — e devemos declarar menos confiança.
⚠️ AS REGRAS DE HONESTIDADE
- N < 30 = anedota, não estatística. O script e a página avisam sempre.
- Nada de backfill. Relatórios entram no índice quando são publicados, com a taxa
daquele dia. Nunca se reescreve uma entrada.
- As métricas de timing são informativas, não sentença. Um "🔴 ruim" de timing com
carrego 90 não significa que a decisão foi ruim — significa que o mercado ofereceu
taxa melhor depois (e o carrego continuou travado).
- A página é pública → sem valores pessoais. A pontuação é sobre a ANÁLISE
(taxas, percentis, direção), nunca sobre dinheiro aportado.
🔄 O CICLO COMPLETO
1. ANÁLISE → gera um relatório (recomendação + taxa + confiança)
2. REGISTRO → entra no INDICE.jsonl (append-only, com ID)
3. PONTUAÇÃO → o tempo passa; carrego (imediato) + timing (30-365d)
4. ESTATÍSTICA → o conjunto revela se o método tem valor
5. RECALIBRAÇÃO → se a vantagem de entrada for ~0, o método precisa mudar
É isso que fecha o ciclo: sem a pontuação, teríamos opiniões.
Com ela, temos um histórico auditável.
📁 ONDE FICA
| Item | Caminho | Público? |
|---|---|---|
| Índice de relatórios | relatorios/INDICE.jsonl | ❌ (bloqueado no servidor) |
| Pontuações | pontuacoes/PONTUACOES.json | ❌ privado |
| A página | relatorios/index.html | ✅ público (só análise) |
| Carteira (aportes) | carteira/operacoes.jsonl | ❌ NUNCA público |
🛠️ SCRIPTS
scripts/pontuar_relatorios.py— calcula as notas e as estatísticasscripts/painel_html.py— gera a página públicascripts/publicar-relatorio.sh— regenera tudo e anuncia o link (cron semanal)scripts/relatorios.py— registra/listar relatórios no índice