Cenário lives in MunicipalityFilters with provider wrapping filters and results; roadmap and plan marked delivered.
10 KiB
Seletor de Cenário junto aos filtros de Municípios
Status: entregue (2026-07-29)
Atualizado em: 2026-07-29
Item do roadmap: docs/roadmap.md (Fill-ins)
Impeccable: B — encaixe em MunicipalityFilters + MunicipalityListOverview (/campanha/municipios); sem rota nova
Appetite: ~0,25–0,5 dia eng; relocação de controle + ajuste do provider; sem migration
Responsável: —
- Revisão 2026-07-29 (implementação): pós-B16 ✓ o Cenário pousou na barra slim (desktop: entre resumo e Salvar/Limpar; mobile: após filtros staff, antes de Ordenar).
MunicipalityEstimateScenarioProviderenvolve filtros +CampaignListResultsem staff. HintVOTE_ESTIMATE_SCENARIO_FILTERS_HINT. Testes do shell de filtros montam o provider (mesmo contrato que a página). Caminhos reais:src/components/campaign/municipality/*,src/components/campaign/votePledge/VoteEstimateScenarioField.tsx.
Design (Impeccable)
Âncoras: PRODUCT.md (princípios 2 — clareza sob pressão — e 8 — Feel the action) / DESIGN.md (register product; Field Desk) · tema data-theme='campaign' · shells MunicipalityFilters, VoteEstimateScenarioField, MunicipalityEstimateScenarioProvider.
Na implementação (implement-roadmap-item): craft compacto → critique → polish (só posição do controle; sem redesign da lista/overview).
Brief compacto:
- Persona / contexto: Assessor / CG monta o recorte de municípios (TI, tipo, prioridade…) e já quer escolher qual cenário lê na lista/overview no mesmo gesto — sem descer o olhar até o card de visão geral.
- Job principal: um único eixo de controles de leitura da lista: filtros de recorte + cenário de estimativa.
- Estratégia de cor: Restrained.
- Edit where you see: não — o seletor só troca leitura (estado local A10); mutação de estimativas permanece nos Popovers/forms existentes.
- Anti-goals: segundo seletor duplicado overview+filtros; meter Cenário na URL; redesign do layout de filtros; unificar com o seletor do mapa do Início neste item.
Dados → decisão → apresentação
Dados: N/A — este item não muda métricas, agregação nem forma de apresentação; só relocação do controle de leitura já entregue em A10. Overview/lista continuam com número do cenário ativo + faixa secundária.
Contexto
Em /campanha/municipios (staff), o seletor Cenário (VoteEstimateScenarioField) vive no header de MunicipalityListOverview — acima do CampaignMetricStrip, abaixo da barra de filtros (MunicipalityFilters: busca, TI, tipo, assessoria, tendência, prioridade). O estado é local via MunicipalityEstimateScenarioProvider (default central), sincronizando overview + células da lista; no Início o mapa tem seletor próprio quando Ano=2026.
A página hoje embrulha o provider só em torno dos resultados, de propósito — comentário em municipios/page.tsx: troca de cenário não deve re-renderizar os filtros. Pedido de produto (2026-07-24): o Cenário deve ficar junto dos outros filtros da página.
Nota 2026-07-24 (B16): filtros-no-header-lista-municipios.md relocaciona os selects de recorte (
region/kind/…) para o header da tabela no desktop. O destino deste fill-in passa a ser a barra slim (busca + Limpar + Cenário), não a fileira completa atual — mesmo componenteMunicipalityFilters, layout enxuto. Preferir aterrar Cenário com ou depois de B16 se ambos forem pegos na mesma janela.
Polish anterior (notebook 2026-07-23) já tinha movido o seletor do mapa → overview; este item completa o agrupamento mental “controles de recorte/leitura da lista”.
Objetivos
- Staff em
/campanha/municipios: seletor Cenário renderizado na mesma fileira/região deMunicipalityFilters(visível comshowStaffFilters), reusandoVoteEstimateScenarioField. - Remover o seletor do header de
MunicipalityListOverview(overview continua a reagir ao contexto: strip, labels, flash). - Expandir o
MunicipalityEstimateScenarioProviderpara envolver filtros + resultados quando staff — o controle nos filtros precisa do contexto; um único provider por página. - Cenário permanece estado local (não URL); Limpar continua zerando só query params / busca — não reseta cenário.
- Guardrails: sem migration, sem collection, sem Consent, sem server action; semântica A10 intacta;
leadernão vê o seletor (página já redireciona;showStaffFiltersfalse).
Decisões travadas
- Fill-in com plano próprio (não reabrir A10; não absorver só em R6; não item de trilha B). Relocação barata, paralelizável, cortável; A10 já entregue a semântica. (2026-07-24, classificação roadmap-item.) Rejeitado: fase informal de A10 (mistura entrega fechada com polish de layout); só R6 (atrasa quick win no critique largo); ID B novo (infla grafo por ~½ dia).
- Provider envolve filtros +
CampaignListResults(staff). Necessário para o seletor viver emMunicipalityFilters. Custo: troca de cenário re-renderiza a árvore dos filtros — aceitável (controle local, sem navegação). Rejeitado: prop-drillscenario/setScenariosem provider; dois providers; manter seletor no overview e nos filtros (duplicata). - Cenário continua fora da URL e fora de
buildMunicipalityFiltersKey/ Limpar. Alinhado à decisão A10 (Ano/Escala locais; sócomparena URL do mapa). Rejeitado:?estimate=neste item; Limpar resetar cenário (mistura recorte URL com lente de leitura). - Hint:
VOTE_ESTIMATE_SCENARIO_FILTERS_HINTno controle da barra de filtros; mapa no Início permanece comVOTE_ESTIMATE_SCENARIO_MAP_HINT. - i18n e naming (AGENTS.md): identificadores existentes (
VoteEstimateScenarioField,MunicipalityEstimateScenarioProvider); strings “Cenário” / Pessimista / Média / Otimista.
Questões em aberto
- Posição exata na fileira (antes ou depois dos selects de recorte)? Resolvido 2026-07-29: desktop = barra slim B16 (antes de Salvar/Limpar); mobile = após assessores, antes de Ordenar.
- Mapa do Início: espelhar “Cenário nos filtros do dashboard”? Opções: A) neste item | B) fora / R6 se critique pedir. Recomendação: B — pedido é a página de municípios; mapa já agrupa Cenário com Ano/Escala.
Abordagem proposta
flowchart LR
page["municipios/page.tsx"] --> provider["MunicipalityEstimateScenarioProvider"]
provider --> filters["MunicipalityFilters + VoteEstimateScenarioField"]
provider --> results["CampaignListResults"]
results --> overview["MunicipalityListOverview sem seletor"]
results --> list["MunicipalityList células"]
filters -.setScenario.-> provider
provider -.scenario.-> overview
provider -.scenario.-> list
Componentes:
MunicipalitiesPage(src/app/(campaign)/campanha/(app)/municipios/page.tsx): moverMunicipalityEstimateScenarioProviderpara envolver{filters}+{CampaignListResults…}quandoisStaffView; atualizar o comentário (provider deixa de ser “só results”).MunicipalityFilters(src/components/campaign/MunicipalityFilters.tsx): seshowStaffFilters, renderizarVoteEstimateScenarioFieldna fileira (id estável, ex.municipality-filter-estimate-scenario); consumiruseMunicipalityEstimateScenario()— só montar essa página staff com provider ao redor.MunicipalityListOverview(src/components/campaign/MunicipalityListOverview.tsx): remover o bloco do seletor no header; manteruseMunicipalityEstimateScenario, strip, flash e métricas.VoteEstimateScenarioField: reusar; ajustar hint exportado se o texto ainda falar só de “visão geral” como locus do controle.- Migration: Sem migration, sem collection, sem server action.
Depth check: reusa field + context + filters existentes; sem hook/shared shell novo (<3 call sites de “filtro+cenário”).
Dependências
- Nenhuma de outro plano aberto. Reusa A10 entregue (
voteEstimate,MunicipalityEstimateScenarioProvider,VoteEstimateScenarioField) e o fill-in filtros-auto (filtros-auto-pracas.md).
Não escopo
- Seletor de Cenário no mapa do Início /
MunicipalityMapPanel(permanece com Ano=2026) — R6 ou pedido futuro. - Persistência de cenário em URL, cookie ou perfil.
- Mudança de agregação, default
central, ou assimetria leader. - Redesign do overview / metric strip / flash.
- Unificar
MunicipalityFilterscom filtros de outras listas.
Rabbit holes
?estimate=na URL “só para share”. Explode RSC/key de filtros e diverge do mapa. Mitigação: Decisão travada — estado local; gatilho só com pedido explícito de share de cenário.- Provider global de cenário em todo
/campanha. Acopla Início↔lista sem necessidade. Mitigação: provider só na página de municípios (como hoje, com escopo ampliado na página). - Tratar Cenário como filtro de where / incluir em Limpar. Muda semântica A10. Mitigação: fora de
MunicipalityListStatee dehasActiveFilters.
Adiado com gatilho
- Mesma colocação mental no dashboard (mapa). Revisitar quando: R6 critique o Início ou produto pedir “um só lugar para Cenário” entre mapa e lista.
- Cenário fora do
<form role="search">. Revisitar quando: auditoria a11y/semântica da barra B16 apontar conflito busca × cenário (fill-in mantém padrão B16). - Mount único do seletor (breakpoint). Revisitar quando: medição mostrar custo dos dois
VoteEstimateScenarioField(desktop/mobile) ou regressão de foco/Popover.
Já resolvido no simplify (não reabrir)
- Provider obrigatório no controle de Cenário +
MunicipalityEstimateScenarioProvidernos testes do shell de filtros (campaignListFilterNavigation.unit.spec.ts).
Referências
docs/roadmap.md(Fill-ins abertos)src/app/(campaign)/campanha/(app)/municipios/page.tsx— composição filters / provider / resultssrc/components/campaign/MunicipalityFilters.tsx— fileira de controlessrc/components/campaign/MunicipalityListOverview.tsx— seletor atual + flashsrc/components/campaign/VoteEstimateScenarioField.tsx— controle reutilizadosrc/components/campaign/MunicipalityEstimateScenarioContext.tsx— estado local- cenarios-estimativa-votos.md (A10) — semântica e default
- filtros-auto-pracas.md — precedente de fill-in na mesma superfície
- AGENTS.md — naming; campaign staff vs leader
PRODUCT.md/DESIGN.md— Field Desk, Feel the action