Add the 11 UX Pilot design pairs (.png + .html) under docs/design-refs/latest/ and link each to its roadmap item and plan. Record the decision that UX/structure is the reference but the old palette is not — implementation uses the light campaign theme tokens.
4.3 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: —
Referência visual (UX Pilot)
Design: Baseline-Eleitoral-2022.png — card "Insights do território", linha "Território de defesa · Base sólida — prioridade: manter engajamento" com chip de classificação à direita (Defesa em verde). Os quatro estados usam pares de badge do tema campaign: defesa = verde, ataque = contorno vermelho, indecisa = âmbar, perdida = cinza. Implementar como um card do stack NucleusInsights.tsx (baseline-eleitoral-tse.md), ajustando a paleta antiga do HTML/PNG para os tokens claros.
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 / votosValidosFederal2022por núcleo (soma sobre cidades∩zonas). - Classificar o núcleo em defesa/ataque/indecisa/perdida por
sollaPercentValidvs. 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.
liderancavê 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
- baseline-eleitoral-tse.md — única dependência dura.
- zonas-por-municipio.md — dependência suave herdada do baseline (melhora a qualidade de
tseZones; ver revisão 2026-07-17 no plano baseline).
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
- Politipédia AVM — "Territorialização eleitoral em campanha"
- baseline-eleitoral-tse.md
- AGENTS.md