Add BahiaMap surfaces on nuclei list, detail, and geral dashboard with server-side choropleth aggregation, lazy geometry loading (B5 F1), and roadmap plans for A7 F4, B5 F3, and B6 scale debts.
6.9 KiB
Escala e DRY pós-B3 (Leaflet / coroplético)
Status: registrado no roadmap (fases pendentes)
Atualizado em: 2026-07-19 (capture-review-debts pós-B3 + 2× /simplify)
Item do roadmap: docs/roadmap.md (Trilha B, item B6)
Impeccable: A — N/A (sem superfície UI nova; otimização do renderer Leaflet existente)
Responsável: —
Contexto
O B3 (mapa-bahia-geometrias.md Fase 2) entrega BahiaMap + embeds (NucleusOverviewMap, NucleusDetailMap, DashboardMap), agregação servidor em nucleusChoropleth.ts / nucleusChoroplethPageData.ts, e lazy load de geometrias (B5 F1 ✓). Duas passagens /simplify no mesmo branch já limparam o que cabia em cleanup: createCampaignClientDynamic, resolveChoroplethNuclei / single-pass bundle, remoção de geographyForCityNames duplicado, toNucleusElectionGeographyInput no dashboard, highlight O(k) via getMunicipalityFeature / getTerritoryFeature, NucleusDetailMap useMemo, alinhamento de tipos com NucleusElectionGeographyInput.
Os revisores (performance) marcaram como importante e maior que simplify o follow-up abaixo. Sem registro, cada troca de métrica no coroplético (overview/dashboard) refaz decode + L.geoJSON completo em 417 ou 27 polígonos.
BahiaMaprebuild completo do layer GeoJSON quando sóvalues(métrica) ouhighlightKeysmudam. O effect emBahiaMap.tsxdepende de[highlightKey, mode, values]e, a cada mudança, remove o layer, recriaL.geoJSONcom todas as features e reaplica estilos — mesmo quemodee o módulo de geometria já estejam carregados. O caminho correto para troca de métrica élayer.setStyle(...)(efitBoundssó quando o highlight muda).
Já resolvido no simplify/critique (não reabrir): B5 F1 lazy split mun/TI + dynamic(..., { ssr: false }); createCampaignClientDynamic; choropleth single-resolve (resolveChoroplethNuclei); DRY geographyForCityNames → resolveNucleusElectionGeography; dashboard toNucleusElectionGeographyInput; ChoroplethMapPanel passa max; detail map useMemo; highlight bounds O(k); type alignment NucleusChoroplethNucleus.
Explicitamente fora (revisores pediram skip ou triage descartou): colapsar shells finos DashboardMap / NucleusOverviewMap; CAMPAIGN_BRAND_PRIMARY para #c51414; codeForIdentityTerritory em bahiaTerritories.ts; catch vazio no BahiaMap (logging opcional); flake int campaignNucleusListOverview (totalFiltered — isolamento de DB pré-existente); métricas E1/E2 no coroplético v1 (decisão de produto B3); critique Impeccable formal nas três superfícies (polish leve sem P0–P3).
Objetivos
- Trocar métrica (núcleos / estimativa / baseline 2022) ou modo município/TI no coroplético não recria o layer GeoJSON inteiro — apenas atualiza
fillColor/ borda viasetStylequando a geometria já está montada. fitBoundsroda só quandohighlightKeysoumodemudam, não a cada alteração devalues.- Guardrails: sem migration, sem collection, sem Consent, sem server action. Client-only; manter acessibilidade (
role="img",aria-busy,aria-label).
Decisões travadas
- Um item B6, uma fase. Mesmo racional de débitos pontuais pós-entrega (VR+, RS+): um ID, PR único.
- Dependência suave de B3. Só faz sentido com
BahiaMapno produto; não reabre escopo de coroplético, tiles ou agregação servidor. - Query duplicada de votos 2022 na lista de núcleos (
loadNucleusListElectionOverview+loadNucleusChoroplethBundle) não entra neste plano — absorvida como A7 Fase 4 em escala-dry-pos-a4.md (mesmo módulonucleusElectoralBaseline.ts). - Factory mun/TI near-duplicate → B5 Fase 3 em escala-dry-pos-b2.md.
- Cortável se o mapa for raramente usado ou se troca de métrica permanecer aceitável em campo; vira não-cortável quando coordenadores alternarem métricas com frequência no overview filtrado.
- i18n e naming (AGENTS.md): identificadores em inglês; strings visíveis em pt-BR inalteradas.
Questões em aberto
- Split em dois effects ou ref de layer estável? Recomendação: effect 1 monta mapa + tiles + carrega geometria por
mode(deps[mode]); effect 2 aplica estilo quando[values, highlightKey]mudam — selayerRef.currentexiste,setStyle+fitBoundscondicional; senão aguarda effect 1. - Manter
valuescomo objeto novo a cada render do parent? Recomendação: não bloquear Fase 1 —ChoroplethMapPaneljá derivavaluesestáveis por métrica; se profiling mostrar churn, memoizar no parent num follow-up micro (fora de escopo).
Abordagem proposta
flowchart TD
B3["B3 Leaflet + coroplético"] --> F1
B5F1["B5 F1 lazy geometrias ✓"] --> F1
F1["Fase 1 — BahiaMap setStyle<br/>(split effects geometria vs estilo)"]
F1 -.não bloqueia.-> B4["B4 Zonas TSE no mapa"]
Fase 1 — setStyle incremental no BahiaMap
src/components/campaign/BahiaMap.tsx:- Separar mount do mapa/OSM (
useEffectonce) do load de geometria pormode. - Guardar
geometryModuleem ref após primeiro load; recriar layer só quandomodemuda. - Em updates de
values/highlightKey: iterarlayerRef.current.eachLayerou manterMap<featureKey, layer>e chamarsetStylecomchoroplethFillColor/ borda highlight. fitBounds: highlight quandohighlightSetnão vazio; senãoBAHIA_BOUNDS— só quando highlight oumodemudam.
- Separar mount do mapa/OSM (
- Testes: unit leve com mock de
L.geoJSON/ spy emsetStylese viável; senão checklist manual (trocar métrica 3× no overview sem flicker perceptível). - Critério: DevTools Performance — troca de métrica não dispara novo
import()de topojson nem aloca 400+ layers.
Migration: nenhuma.
Dependências
- Suave: B3 Mapa Fase 2 (Leaflet) — implementado no branch; merge pendente.
- Suave: B5 F1 lazy geometrias — entregue com B3.
- Reusa:
choroplethFillColor/choroplethMaxValue(src/lib/choroplethColorScale.ts), loadersloadMunicipalityGeometryModule/loadTerritoryGeometryModule, tiposChoroplethValues.
Não escopo
- Query duplicada overview + coroplético na lista → A7 F4 (escala-dry-pos-a4.md).
- Factory TopoJSON mun/TI → B5 F3 (escala-dry-pos-b2.md).
- Camada de zonas TSE, rota
/mapa, métricas tendência/prioridade no coroplético → B3/B4/E1/E2. react-leaflet— manterleafletdireto conforme B3.
Referências
docs/roadmap.md(Trilha B, item B6; B3/B5)docs/plans/mapa-bahia-geometrias.md— plano pai B3docs/plans/escala-dry-pos-b2.md— B5 F1/F3docs/plans/escala-dry-pos-a4.md— A7 F4 (query duplicada)src/components/campaign/BahiaMap.tsx— effect que rebuilda layersrc/components/campaign/ChoroplethMapPanel.tsx— troca de métricasrc/lib/bahiaGeometries.ts— lazy loaders- AGENTS.md — naming inglês; B3 sem migration