mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-15 18:53:06 +00:00
14cfcdb3f6
Expand the compiled next-steps doc back into the full delivery history, cross-reference plan statuses, and sync AGENTS.md, PRODUCT.md, and the Núcleos project notebook.
70 lines
3.9 KiB
Markdown
70 lines
3.9 KiB
Markdown
# Insight: inteligência competitiva (mais votado, ranking, margem)
|
||
|
||
Status: rascunho
|
||
Atualizado em: 2026-07-17
|
||
Item do roadmap: [docs/roadmap.md](../roadmap.md) (seção "Campanha → Próximos ciclos")
|
||
Responsável: —
|
||
|
||
## Referência visual (UX Pilot)
|
||
|
||
Design: [`Baseline-Eleitoral-2022.png`](../design-refs/latest/Baseline-Eleitoral-2022.png) — card "Insights do território", linha "Mais votado aqui em 2022: Dep. Fulano (PP) · Solla ficou em 4º lugar · 2.100 votos à frente"; a linha "Mais votado aqui em 2022" do bloco de baseline também alimenta este insight. Implementar como um card do stack `NucleusInsights.tsx` ([baseline-eleitoral-tse.md](baseline-eleitoral-tse.md)), com os tokens claros do tema `campaign` em vez da paleta antiga do HTML/PNG.
|
||
|
||
## Contexto
|
||
|
||
Saber onde Solla foi bem é só metade; a outra é saber **quem o superou localmente** e por quanto. O baseline TSE 2022 (ver [baseline-eleitoral-tse.md](baseline-eleitoral-tse.md)) guarda o conjunto completo de candidatos por geografia, com flag de eleito — podemos dizer, por núcleo, quem foi o mais votado para deputado federal ali em 2022, qual a margem sobre Solla, e em que colocação Solla ficou. É inteligência competitiva: onde há adversário forte a desmontar e onde Solla já é o referencial.
|
||
|
||
## Objetivos
|
||
|
||
- Por núcleo, listar o top-N candidatos a dep. federal 2022 por votos nominais na geografia, com `elected` e partido/coligação.
|
||
- Destacar `winnerFederal` (mais votado), `sollaRank` (colocação de Solla) e `marginToWinner = winnerVotes − sollaVotes` (e `marginToElectable` quando aplicável).
|
||
- Exibir no detalhe do núcleo (aba overview) uma tabela compacta; no overview, agregar "núcleos onde Solla foi o mais votado" / "onde há adversário à frente".
|
||
|
||
## Decisões travadas
|
||
|
||
- **Leitura derivada** — sem escrita, sem `Consent`, sem migration.
|
||
- **Reusa** `electionCandidateVote` + `electionCandidate` (e `elected`).
|
||
- **Top-N configurável** (default 5) em `src/lib/electionInsights.ts`.
|
||
- Cargo principal: **deputado federal** (cargo do Solla). Estadual como secundário opcional.
|
||
|
||
## Questões em aberto
|
||
|
||
- Mostrar só candidatos com `elected=true` no top, ou todos os mais votados localmente? Recomendação: todos os mais votados localmente, com flag de eleito destacada.
|
||
- `lideranca` vê o competidor? Recomendação: sim (dado público).
|
||
- Cruzar com `runningAgain2026` (plano [insight-dobradinha-2026.md](insight-dobradinha-2026.md)) para marcar quem volta — adiar ao plano de dobradinha.
|
||
|
||
## Abordagem proposta
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
Base["electionCandidateVote + electionCandidate<br/>agregados por geografia"]
|
||
Rank["ordenar por votos nominais<br/>+ flag elected"]
|
||
Calc["computeCompetitiveIntel(...)"]
|
||
Detail["Detalhe: tabela top-N<br/>+ winnerFederal + sollaRank + margem"]
|
||
Overview["Overview: núcleos onde Solla<br/>é o mais votado vs adversário à frente"]
|
||
Base --> Rank
|
||
Rank --> Calc
|
||
Calc --> Detail
|
||
Calc --> Overview
|
||
```
|
||
|
||
- **Helper** `src/lib/electionInsights.ts`: `computeCompetitiveIntel(candidateVotes, sollaNumber=1313, topN)` → `{ winner, sollaRank, marginToWinner, topCandidates[] }`.
|
||
- **Componente** `src/components/campaign/NucleusCompetitiveIntel.tsx` (server). Overview: bloco agregado no `NucleusListOverview`.
|
||
- **Teste int** cenários: Solla é o mais votado; Solla fora do top-N; `sollaVotes=0`.
|
||
|
||
## Arquivos a criar/alterar
|
||
|
||
- Criar: `src/components/campaign/NucleusCompetitiveIntel.tsx`.
|
||
- Alterar: `src/lib/electionInsights.ts`, `nucleos/[slug]/page.tsx` + `nucleusDetailPageData.ts`, overview da lista.
|
||
|
||
## Dependências
|
||
|
||
- [baseline-eleitoral-tse.md](baseline-eleitoral-tse.md) (`electionCandidateVote` + `electionCandidate` com `elected`).
|
||
|
||
## Não escopo
|
||
|
||
- Sugerir dobradinha (plano [insight-dobradinha-2026.md](insight-dobradinha-2026.md)) — aqui só exibimos o quadro competitivo, não sugerimos parceiros.
|
||
|
||
## Referências
|
||
|
||
- [baseline-eleitoral-tse.md](baseline-eleitoral-tse.md)
|
||
- AGENTS.md
|