teqo/docs/plans/remover-lista-zonas-mapa-inicio.md
Francisco Ignácio Fontoura Solla a5b6341ccb docs: plan fill-in to drop zone list from campaign home map
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.
2026-07-27 00:00:29 -03:00

10 KiB
Raw Blame History

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 zoneBreakdown do contrato do bundle e do loader (e os intermediários zoneVotesBySlug / zoneVotes2026BySlug se 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 de zoneBreakdown) 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álogo kind === '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 zoneBreakdown do 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-* em municipalitiesByMapKey ou 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 / MunicipalityZoneBreakdownRow saem; 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-* em municipalitiesByMapKey (server/escopo) | B) flag do BahiaMap apó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 de MunicipalityMapSelection que 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: remover MunicipalityZoneBreakdownRow e zoneBreakdown de MunicipalityMapBundle.
  • municipalityMapData.ts: parar de montar zoneBreakdown / zoneVotesBySlug / zoneVotes2026BySlug (verificar que nenhum outro campo os lê — hoje só alimentam a lista).
  • tests/int/municipalityMapData.int.spec.ts: trocar expects de zoneBreakdown por asserts de escopo já existentes (ex.: keys salvador-ze-* em municipalitiesByMapKey / 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 — zoneBreakdown
  • src/utilities/municipalityMapData.ts — montagem do array
  • tests/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