After B8 F2 polygons, the textual zone breakdown under the dashboard map is redundant; register the removal in the roadmap and align B8+/B8 plan notes.
10 KiB
Remover lista "Municípios por zona eleitoral" do Início
Status: rascunho
Atualizado em: 2026-07-26
Item do roadmap: docs/roadmap.md (Fill-ins)
Impeccable: B — encaixe em MunicipalityMapPanel no Início (/campanha); sem rota nova
Appetite: ~0,25–0,5 dia eng; remove bloco UI + payload zoneBreakdown do bundle; sem migration
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (clareza sob pressão; anti dashboard clutter) / DESIGN.md (register product; Field Desk) · tema data-theme='campaign' · shells MunicipalityMapPanel + BahiaMap + MapFeatureReadout.
Na implementação (implement-roadmap-item): craft compacto → critique → polish (só remoção de densidade morta + relocação de uma frase de ressalva; sem redesign do mapa).
Brief compacto:
- Persona / contexto: CG / Assessor / Candidato no Início; o mapa já pinta cada ZE de Salvador (B8 F2 ✓). A lista de 19 linhas abaixo repete o que o coroplético + clique no polígono já respondem.
- Job principal: o Início volta a ser mapa + controles + readout — sem rolagem obrigatória por uma lista que o polígono tornou redundante.
- Estratégia de cor: Restrained — nenhuma superfície nova.
- Edit where you see: não — só leitura no mapa; sem mutação.
- Anti-goals: redesign do mapa; segunda navegação textual para ZE; apagar a malha/artefato B8; esconder a ressalva jurídica de aproximação.
Dados → decisão → apresentação
- Vou apresentar dados? Não (N/A nesta entrega) — remove uma superfície tabular redundante. A decisão “qual pedaço de Salvador?” continua no mapa (B8 F2 ✓: polígono por ZE + readout + clique →
/campanha/municipios/salvador-ze-N). - Decisões desbloqueadas: N/A (não introduz métrica). A decisão já desbloqueada pelo mapa permanece.
- Forma escolhida: mapa (já entregue) — por quê a lista era o degrau de pobreza antes dos polígonos; com polígonos, a lista é degrau a mais sem nova decisão. Rejeitado: manter lista “por se”; chart/KPI de zonas no Início.
- Anti-goals de dado: sem % estadual absoluto; sem segunda série tabular no dashboard.
Contexto
Até o B8 F2 ✓ (2026-07-26), Salvador era um polígono no mapa; a única visão por Município-zona era a lista textual zoneBreakdown em MunicipalityMapPanel — título "Municípios por zona eleitoral", 19 links + votos do ano/cenário selecionado (src/components/campaign/map/MunicipalityMapPanel.tsx ~L593–625). O bundle carrega isso em MunicipalityMapBundle.zoneBreakdown (municipalityMapContract.ts / municipalityMapData.ts).
Com o artefato bahia-municipality-zones.topo.json e o re-keying por map key, cada ZE é pintável, hoverável e clicável. Pedido de produto (2026-07-26): remover a seção — não precisamos mais dela.
O fill-in de engenharia B8+ (escala-dry-pos-b8f2.md) F3 ainda assume a lista viva (só move a ressalva “é aproximado…” para fora do gate !comparisonActive). Este item supersede essa premissa: a lista sai; a ressalva fica atrelada à malha (decisão já travada no B8+), não a um <ul> de zonas.
Objetivos
- Em
/campanha(staff,MunicipalityMapPanel): sumir o bloco "Municípios por zona eleitoral" (título, lista, números). - Remover
zoneBreakdowndo contrato do bundle e do loader (e os intermediárioszoneVotesBySlug/zoneVotes2026BySlugse só servirem a ele) — dead code dies. - Manter uma ressalva de aproximação (TRE/IBGE, não limite oficial TSE) visível quando a malha de zonas está em jogo — inclusive no modo comparação (alinha B8+ F3).
- Atualizar int
municipalityMapData.int.spec.ts(pins dezoneBreakdown) e qualquer copy/comentário que ainda diga que a lista é a navegação N>1. - Guardrails: sem migration, sem collection, sem Consent, sem server action; malha B8 /
BahiaMap/ catálogokind === 'zona'intactos; card de bairros no detalhe (F1) intacto.
Decisões travadas
- Fill-in com plano próprio (sem ID B novo). Quick win de densidade no Início pós-B8 F2; ~¼–½ dia; paralelizável; cortável. (2026-07-26, classificação roadmap-item.) Rejeitado: B43 de trilha (infla grafo para delete de bloco); absorver só como nota no B8+ sem plano de produto (pedido explícito de produto merece plano próprio + link no Fill-ins); deixar para R6 (atrasa).
- Remover UI + dropar
zoneBreakdowndo bundle — não só esconder. Payload RSC do Início carrega 19 rows por visita; knip/engineering-standards: o que a mudança orfanou morre no mesmo PR. Rejeitado:display: none/ flag; manter array “por se” sem consumidor. - Ressalva de aproximação sobrevive, atrelada à malha. Uma frase muted sob o mapa (ou junto à legenda), gated por presença de ZE no escopo (
salvador-ze-*emmunicipalitiesByMapKeyou boolean derivado no painel) e visível também em comparação. Fonte: decisão B8+ F3 + rabbit hole B8 (“tratar polígono derivado como limite oficial”). Rejeitado: apagar a ressalva com a lista; duplicar copy em dois braços. - Lista de bairros no detalhe da ZE (B8 F1) permanece. Geografia operacional no município ≠ lista redundante no dashboard. Rejeitado: cascatear remoção para
MunicipalityZoneNeighborhoodsCard. - i18n e naming (AGENTS.md): identificadores
zoneBreakdown/MunicipalityZoneBreakdownRowsaem; strings pt-BR da seção saem; disclaimer permanece em pt-BR.
Questões em aberto
- Gate da ressalva: “há ZE no escopo do ator” vs “malha de zonas carregou no cliente”? Opções: A) keys
salvador-ze-*emmunicipalitiesByMapKey(server/escopo) | B) flag doBahiaMapapós load da malha | C) sempre no painel. Recomendação: A — assessor sem Salvador na carteira não vê frase sobre ZE; se o chunk falhar, B8+ F3 degrada o mapa e a ressalva some junto com as zonas no escopo visual (aceitável). (assumido) - Quem landa primeiro: este fill-in ou B8+ F3? Opções: A) este fill-in primeiro (B8+ F3 vira “não há lista; só degradar chunk + ressalva já no lugar”) | B) B8+ primeiro (este fill-in remove o
<ul>e mantém a frase onde F3 a colocou). Recomendação: A se o pedido de produto for o próximo a implementar; senão B — o plano do B8+ foi atualizado para não depender da lista. (ordem = quem puxar o PR)
Abordagem proposta
flowchart LR
panel["MunicipalityMapPanel"] -->|remove| list["ul zoneBreakdown"]
panel -->|keep relocated| note["Ressalva aproximação"]
contract["municipalityMapContract"] -->|drop| zb["zoneBreakdown"]
loader["municipalityMapData"] -->|drop| maps["zoneVotes*BySlug"]
tests["municipalityMapData.int"] -->|rewrite| scope["pins de escopo / map key"]
Componentes:
MunicipalityMapPanel.tsx: apagar o bloco ~L593–625; comentário “zone breakdown below”; atualizar o comentário deMunicipalityMapSelectionque menciona “zone list”. Inserir a ressalva (uma<p className="text-sm text-muted-foreground">) fora do gate de comparação, condicionada ao escopo com ZE.municipalityMapContract.ts: removerMunicipalityZoneBreakdownRowezoneBreakdowndeMunicipalityMapBundle.municipalityMapData.ts: parar de montarzoneBreakdown/zoneVotesBySlug/zoneVotes2026BySlug(verificar que nenhum outro campo os lê — hoje só alimentam a lista).tests/int/municipalityMapData.int.spec.ts: trocar expects dezoneBreakdownpor asserts de escopo já existentes (ex.: keyssalvador-ze-*emmunicipalitiesByMapKey/ length de unidades no escopo).docs/TESTING.md: dropar a coluna “zone breakdown shape” da linha do loader se ainda apontar para o campo.- B8+ / B8 planos: ver Dependências — notas de coordenação, não reescrever histórico F2.
- Migration: Sem migration, sem collection, sem server action.
Depth check: delete/estreitamento nos módulos que já são donos do bundle e do painel — sem wrapper novo.
Dependências
- Dura:
B8 F2✓ (polígonos — sem eles a lista ainda seria a única visão por ZE). - Soft: B8+ F3 (escala-dry-pos-b8f2.md) — mesma ressalva / mesmo arquivo; quem entrar 2º só ajusta.
- Reusa:
MunicipalityMapPanel,BahiaMap,municipalitiesByMapKey,formatElectionNumber(só se algum residual precisar — provavelmente some do painel).
Não escopo
- Alterar malha / script / artefato TopoJSON — B8 / B8+ F1.
- Degradar chunk das zonas / memoização de rejeição — B8+ F3.
- Rank competitivo por ZE — débito com gatilho no plano B8.
- Desambiguar ZE no card "Onde estou" — mesmo plano B8, gatilho "pedido de campo".
- Remover coluna "Tipo" na lista de municípios — fill-in remover-coluna-tipo-municipios.md.
- Card "Bairros" no detalhe da ZE — B8 F1.
Rabbit holes
- "Já que a lista some, refaço o readout / legenda de Salvador." Explode em redesign do B13. Mitigação: só delete + uma frase de ressalva.
- "Já que zoneBreakdown morre, unifico navegação e proximity." F4 do B8+ já colapsa
MunicipalityMapNavigation. Mitigação: não misturar PRs. - Extrair CSS compartilhado lista-zona ↔ card de bairros (S6 do B8). A lista do mapa some — o gatilho morre. Mitigação: fechar S6 como obsoleto na nota do plano B8 (abaixo), sem extrair nada.
Adiado com gatilho
- Nenhum neste item. (S6 do B8 fica obsoleto com a remoção — ver plano B8.)
Referências
docs/roadmap.md(Fill-ins abertos)src/components/campaign/map/MunicipalityMapPanel.tsx— bloco "Municípios por zona eleitoral"src/utilities/municipalityMapContract.ts—zoneBreakdownsrc/utilities/municipalityMapData.ts— montagem do arraytests/int/municipalityMapData.int.spec.ts— pins- poligonos-pracas-zona.md — B8 F2 ✓ (pai)
- escala-dry-pos-b8f2.md — B8+ (coordenação F3)
- remover-coluna-tipo-municipios.md — precedente fill-in Impeccable B de densidade
- AGENTS.md — mapa keyed por map key; naming
PRODUCT.md/DESIGN.md— Field Desk, clareza sob pressão