teqo-backup/docs/plans/insight-classificacao-territorial.md
Francisco Ignácio Fontoura Solla bcac665cb5 Ship /campanha nuclei MVP with RBAC, invites, and vote estimates.
Adds electoral nuclei, leaderships, updates, and WhatsApp invite flows behind campaign auth, plus the consolidated schema migration that Vercel applies on deploy.
2026-07-18 15:01:56 -03:00

3.7 KiB

Insight: classificação territorial (defesa/ataque/indecisa/perdida)

Status: rascunho Atualizado em: 2026-07-17 Item do roadmap: docs/roadmap.md (seção "Campanha → Próximos ciclos") Responsável: —

Contexto

A literatura de territorialização eleitoral (Politipédia AVM, OPUS, Seja Eleito) classifica cada território em quatro zonas operacionais — defesa (voto histórico favorável, meta: manter), ataque (desfavorável mas relevante, meta: virar/reduzir margem), indecisa (pulverizada, baixa rejeição, meta: consolidar) e perdida (desfavorável e elástica, meta: minimizar perda) — para alocar esforço de forma proporcional ao retorno. Hoje o /campanha não classifica núcleos; com o baseline TSE 2022 (ver baseline-eleitoral-tse.md) podemos derivar uma primeira classificação a partir do histórico.

Objetivos

  • Computar sollaPercentValid = sollaVotes2022 / votosValidosFederal2022 por núcleo (soma sobre cidades∩zonas).
  • Classificar o núcleo em defesa/ataque/indecisa/perdida por sollaPercentValid vs. limiares configuráveis.
  • Exibir badge no detalhe do núcleo e distribuição por classe no overview da lista (sobre o conjunto filtrado).
  • (Opcional, quando o domínio existir) refinar a classe cruzando com pesquisa de intenção de voto atual.

Decisões travadas

  • Leitura derivada — sem escrita, sem Consent, sem migration.
  • Limiares versionados em src/lib/electionInsights.ts (constantes); decisão de produto por limiar. A classe é sugestão automática, não rótulo definitivo — coordenador pode discordar.
  • Reusa getNucleusElectoralBaseline (Solla + válidos federal) do plano baseline.

Questões em aberto

  • Limiares exatos por classe — definir com produto (referência: alta % válidos → defesa; baixa + relevante → ataque; pulverizada → indecisa; baixa + alta rejeição → perdida).
  • Como incorporar rejeição (não temos dado de rejeição por geografia hoje) — adiar até domínio de pesquisas.
  • lideranca vê a classe do próprio núcleo? Recomendação: sim.

Abordagem proposta

flowchart LR
    Base["getNucleusElectoralBaseline<br/>sollaVotes + votosValidosFederal"]
    Calc["computeTerritorialClass(sollaPercentValid)<br/>classe + confiança"]
    Detail["Detalhe: badge da classe<br/>+ % válidos de Solla"]
    Overview["Overview: distribuição<br/>defesa/ataque/indecisa/perdida<br/>sobre o filtro"]
    Base --> Calc
    Calc --> Detail
    Calc --> Overview
  • Helper src/lib/electionInsights.ts: computeTerritorialClass(sollaVotes, votosValidosFederal) → { percentValid, class: 'defesa'|'ataque'|'indecisa'|'perdida'|'semBaseline' }.
  • Componente src/components/campaign/NucleusTerritorialClassification.tsx (server). Overview: bloco com contagem por classe.
  • Teste int cenários limítrofes e votosValidosFederal=0.

Arquivos a criar/alterar

  • Criar: src/components/campaign/NucleusTerritorialClassification.tsx.
  • Alterar: src/lib/electionInsights.ts, nucleos/[slug]/page.tsx + nucleusDetailPageData.ts, overview da lista.

Dependências

Não escopo

  • Mapa/PostGIS com a classe pintada por território (roadmap linha 52).
  • Pesquisa de intenção/rejeição (domínio inexistente; refinamento futuro).

Referências