teqo-backup/docs/plans/insight-dobradinha-2026.md
Francisco Ignácio Fontoura Solla adc0f31f5b Sync all project docs with the deployed remodel and hardening; compile roadmap
- Compile docs/roadmap.md into a next-steps document (277→206 lines): R0–R5/M1–M5
  tables and the delivered map/list item paragraphs compressed into 'Já entregue';
  janelas, grafo and cortes list only open IDs; C10/C11/C8 fill-ins keep their
  original triggers; C5 moved under 'A validar'.
- Record the production deploy of the destructive remodel chain (2026-07-23 Vercel
  builds) across roadmap, AGENTS.md, the project notebook and plans — supersedes
  every 'deploy pendente'; smoke pós-deploy + onboarding remain the open blockers.
- Fix AGENTS.md internal contradictions: Município locked-decisions bullet (435,
  Camaçari whole, candidate role), campaignUser role enum, deploy-checklist item 7
  as historical, access/* structure note, election-aggregates artifact +
  election-tse revalidate runbook.
- Sync open plans to real identifiers (plaza*/nucleus* → municipality*): the
  intelligence program (master + E8–E15/B13/C12 with artifact/caching context and
  satisfied deps), B8 rescoped to Salvador ZE 1–19 only, WhatsApp D3–D5, D2, A6
  (now the insight layer over stateDeputy), RS+, onda-0 smoke step.
- Close items verified done in code: C8 F4 (DRY de forms) complete, filtros-auto
  shared pending shell, petition generateStaticParams select/depth; ledger the
  surviving user-visible 'Praça' copy in src as new P2 debt.
- Banner delivered praça-era plans (production note + rename pointer); mark
  remodelagem-pracas.md superseded and remodelagem-municipios.md delivered.
- TECH-DEBT smell statuses, TESTING RBAC row, README quality gates, campanha
  UI rules updated to current component names.
2026-07-24 02:04:45 -03:00

5.2 KiB
Raw Blame History

Insight: oportunidades de dobradinha 2026

Status: rascunho (gatilho externo: TSE publica candidaturas — pós-15/08) Atualizado em: 2026-07-24 (refs sincronizadas pós-remodelagem Municípios) Item do roadmap: docs/roadmap.md (Próximos — Demais itens abertos, A6) Responsável: —

Revisão 2026-07-24: desde a M4, as dobradinhas OPERACIONAIS já existem no produto — entidade stateDeputy + municipality.stateDeputies / leadership.stateDeputies + vertical /campanha/dobradinhas. A6 vira a camada de insight TSE sobre esse registro: sugerir candidatos 2026 (por força local 2022 + alinhamento) para o staff registrar/priorizar como stateDeputy — não criar um segundo registro paralelo. Referências antigas a "núcleo" abaixo foram renomeadas para município.

Contexto

"Dobradinha" é a campanha conjunta entre dois candidatos que somam estrutura e votos num mesmo território. Sabendo, via baseline TSE 2022 + Fase 5 (ver baseline-eleitoral-tse.md), quais candidatos de 2022 voltam a concorrer em 2026 (runningAgain2026), podemos sugerir oportunidades de dobradinha por município/território — priorizando por (a) alinhamento político com a chapa PT/Solla e (b) força eleitoral local (votos recebidos ali em 2022). É o insight mais estratégico do conjunto e depende de dados de 2026, por isso é plano separado.

Objetivos

  • Por município, listar candidatos que concorrem de novo em 2026 (runningAgain2026=sim) com votos 2022 na geografia, partido/coligação e tier de alinhamento.
  • Ranquear por score combinando alinhamento (peso a definir) e força eleitoral local (votos 2022).
  • Exibir no detalhe do município (aba Visão geral) a lista ranqueada de potenciais parceiros de dobradinha; no overview, agregar top parceiros por território filtrado.
  • Habilitar só quando 2026 estiver carregado; enquanto não, mostrar "indisponível até a candidatura de 2026".

Decisões travadas

  • Leitura derivada — sem escrita, sem Consent, sem migration.
  • Depende do baseline TSE 2022 (Fase 1) e da Fase 5 (runningAgain2026 populado).
  • Sem PII — matching cross-ano via identityKey pública (já no plano baseline).
  • i18n/naming seguem o AGENTS.md.

Questões em aberto

  • Taxonomia de alinhamento político: como classificar partidos/coligações em tiers (aliado / aliado histórico / neutro / adversário) relativos à chapa PT/Solla. Recomendação: mapear a média contínua 0–10 de Bolognesi et al. (onda 2022; ver insight-alavancagem-chapa.md / Dataverse doi:10.7910/DVN/MFIXKW) para tiers em electionAlliances.ts, em vez de inventar um segundo mapa. Decisão de produto pelos cortes de tier.
  • Fórmula do score: como combinar alinhamento (ordinal) com força eleitoral (votos). Recomendação: score = wAlign * tierWeight + wVotes * normalizedVotes, com pesos wAlign/wVotes a definir com produto.
  • Considerar só candidatos do mesmo cargo (dep. federal + estadual) ou também majoritários? Recomendação: só proporcionais (federal/estadual) para dobradinha com Solla.
  • lideranca vê? Recomendação: sim, mas sem expor o tier de adversário (mostrar só aliados/neutros).

Abordagem proposta

flowchart LR
    Cand["electionCandidate<br/>runningAgain2026=sim"]
    Votes["electionCandidateVote 2022<br/>votos por geografia"]
    Align["electionAlliances.ts<br/>partido -> tier"]
    Score["computeDobradinhaOpportunities(...)"]
    Detail["Detalhe: lista ranqueada<br/>nome, votos 2022, partido, tier"]
    Overview["Overview: top parceiros<br/>por território filtrado"]
    Cand --> Score
    Votes --> Score
    Align --> Score
    Score --> Detail
    Score --> Overview
  • Helper src/lib/electionAlliances.ts: mapeamento partido→tier (versionado, com proveniência das coligações 2022/2026).
  • Helper src/lib/electionInsights.ts: computeDobradinhaOpportunities(candidates2026, votes2022, alliances, municipalityGeography) → Array<{ candidate, party, coalition, tier, votes2022, score }> ordenado por score.
  • Componente src/components/campaign/DobradinhaOpportunities.tsx (server). Overview: bloco agregado no MunicipalityListOverview.
  • Teste int cenários: sem 2026 carregado (desconhecido → estado indisponível); só adversários; misto.

Arquivos a criar/alterar

  • Criar: src/lib/electionAlliances.ts, src/components/campaign/DobradinhaOpportunities.tsx.
  • Alterar: src/lib/electionInsights.ts (nova função), municipios/[slug]/page.tsx + municipalityPageData.ts, overview da lista.

Dependências

  • baseline-eleitoral-tse.md — Fase 1 (collections + electionCandidateVote) e Fase 5 (runningAgain2026 + identityKey).
  • 2026 publicado pelo TSE (externo; fora do nosso controle).

Não escopo

  • Fechar dobradinhas (decisão política humana) — só sugerimos oportunidades, não fechamos alianças.
  • Cruzar com pesquisa de intenção (domínio inexistente).

Referências