Registro de roadmap-item de dois pedidos de produto de 2026-07-26, commitado como estava na arvore de trabalho do checkout principal: - B38 sidebar recolhido em tablet (`collapsible="offcanvas"`, trigger em `md+`, default por faixa de viewport com o cookie `sidebar_state` vencendo apos o toggle) + entrada no grafo de dependencias. - Fill-in: limitar pan/zoom do mapa da Bahia a `BAHIA_BOUNDS` (`maxBounds` com folga de 10%, `maxBoundsViscosity: 1` e `minZoom` calculado no `ResizeObserver` que ja existe), so em `BahiaMap.tsx`. - Nota de dependencia soft do B18 para o B38: com o rail recolhido, o submenu de filtros salvos precisa tratar collapsed como "abrir rail".
15 KiB
B18 — Filtros salvos na lista de Municípios (+ acesso rápido no sidebar)
Status: rascunho — costuras prontas desde o Pass 2 W1 (2026-07-25): o estado de URL é canônico e serializável (municipalityListUrl.ts, contrato congelado); salvar filtro = nomear a serialização atual
Atualizado em: 2026-07-24
Item do roadmap: docs/roadmap.md (Demais itens abertos, B18; superfície de coordenação)
Impeccable: B — encaixe em MunicipalityFilters / barra slim + CampaignSidebar (2º nível sob Municípios); sem rota nova
Appetite: ~1–1,5 dia eng; persistência local + Salvar com nome + submenu hover/sticky no sidebar; sem migration, sem collection, sem Consent
Responsável: —
Design (Impeccable)
Âncoras: PRODUCT.md (princípios 2 — clareza sob pressão — e 8 — Feel the action; exceção justificada ao “Auto-save, no Save button” porque nomear é confirmatório) / DESIGN.md (register product; Field Desk) · tema data-theme='campaign' · shells CampaignSidebar, MunicipalityFilters, primitivos SidebarMenuSub* já em src/components/ui/Sidebar.tsx.
Na implementação (implement-roadmap-item): craft compacto → critique → polish (só salvar + submenu; sem redesign da nav completa nem sync multi-device).
Brief compacto:
- Persona / contexto: Alex (CG / Assessor / Candidato) monta o mesmo recorte várias vezes na semana (ex. “Prioritárias sem assessor · TI X · sort votos”) e precisa voltar a ele em um toque a partir da nav — sem refazer selects.
- Job principal: nomear o estado atual da URL da lista e reabri-lo como atalho de 2º nível sob Municípios no sidebar.
- Estratégia de cor: Restrained — submenu indentado com
border-ldoSidebarMenuSub; active sóbrio (data-active); sem chips coloridos de “views”. - Edit where you see: não — bookmark de navegação URL; mutações B9 nas células seguem iguais.
- Anti-goals: collection/
campaignUserprefs; saved views genéricas em todas as listas; segundo nível sempre visível (polui nav); sticky em qualquer/campanha/municipios(só no filtro salvo ativo); auto-gravar sem nome (vira “Visitados”).
Dados → decisão → apresentação
- Vou apresentar dados? Não — Dados: N/A. Este item não inventa métrica; só persiste e reabre o mesmo recorte URL que a lista já resolve.
- Decisões desbloqueadas: Staff: “voltar ao recorte mental desta sessão (ex. prioritárias / TI / sem assessor) sem remontar filtros.”
- Forma escolhida: lista/tabela existente + links nomeados no sidebar — por quê: o dado já está na lista; o problema é atrito de remontagem. Rejeitado: dashboard de “minhas views”; chart de uso de filtros; segunda página de gestão de views.
- Profile: N/A.
- Anti-goals de dado: sem KPI de “quantos filtros salvos”; sem % estadual.
Self-check dados: N/A (sem superfície de métrica nova).
Contexto
Em /campanha/municipios, o estado canônico de recorte/ordem vive na URL via MunicipalityListState (src/utilities/municipalityUi.ts: q, region, kind, coverage, priority, trend, sort/dir, page, compare). Helpers já canonicalizam href (resolveMunicipalityListUrl / buildMunicipalityListHref / buildMunicipalityListVisitHref). B15 ✓ sort; B16 relocaciona filtros ao header e deixa barra slim; B17 preferência de colunas em localStorage.
O sidebar (CampaignSidebar.tsx + nav.ts) é flat — um SidebarMenuButton por item; primitivos SidebarMenuSub / SidebarMenuSubButton existem no shadcn local e não são usados. “Visitados recentemente” (recentVisits.ts) já prova o padrão client-only + limpeza no logout, mas é histórico automático — não nomeado.
Pedido de produto (2026-07-24): salvar o filtro atual com um nome, e expor os salvos como acesso rápido de 2º nível sob Municípios: aparecem no hover (desktop) ou clique/expansão (mobile no drawer do sidebar); permanecem visíveis quando a URL atual é a de um filtro salvo; somem fora de Municípios e sem hover/expansão.
FD2 (field-desk-ux-pos-critique.md) adiava “saved views genéricas”; este item é a fatia concreta e única (só lista de municípios), não um framework de views.
Objetivos
- Staff em
/campanha/municipios: affordance Salvar filtro (nome obrigatório) que grava o estado canônico atual da URL (sempage, semcompare). - Lista de filtros salvos no sidebar, indentada sob Municípios, cada um linkando ao href canônico; item ativo quando a URL atual casa com o href salvo.
- Visibilidade do submenu:
- mostrar no hover do item Municípios (desktop);
- mostrar ao expandir Municípios no drawer mobile (clique);
- mostrar (sticky) quando a página atual é um filtro salvo (match de href);
- esconder em rotas que não são de municípios e sem hover/expansão.
- CRUD mínimo: criar + abrir + apagar (renomear = questão em aberto).
- Guardrails: sem migration, sem collection, sem Consent, sem server action de escrita;
leadersem a página; access/loader inalterados; Feel the action no Salvar (pending no controle) e na navegação do atalho (CampaignListPendingjá cobre a lista).
Decisões travadas
- Item de trilha B18 (não fill-in; não fase de B16/B17; não absorver em Visitados). Job distinto: bookmark nomeado e intencional vs histórico automático (Visitados) vs viewport de colunas (B17) vs relocação de selects (B16). Appetite ~1–1,5d; cortável. (2026-07-24, roadmap-item.) Rejeitado: fill-in só (subestima o contrato de submenu sticky/hover); estender
recentVisitscom “pin” (mistura dwell automático com nomeação); saved views genéricas multi-lista (FD2 já vetou; explode escopo). - Persistência =
localStorage(não servidor). Preferência/atalho por dispositivo; mesmo racional de Visitados e B17. Key estável namespaced (ex.teqo:campaign:municipality-saved-filters). Rejeitado: collectionsavedFilter/ campo emcampaignUser(migration + access + sync sem evidência de multi-device);sessionStorage(perde no ritual diário); cookie server-side. - Estado salvo = subset da URL da lista, canonicalizado via
municipalityUi(reusarparseMunicipalityListParams+ href page=1):q,region,kind,coverage,priority,trend,sort,dir. Excluirpage(sempre reabre na 1) ecompare(lente do mapa no Início, não da lista). Excluir cenário A10 (fora da URL; lente local — alinhado ao fill-in Cenário / decisão A10). Rejeitado: gravarpage/compare/cenário; gravar snapshot de IDs de municípios (vira lista morta). - Identidade:
idclient-side (UUID) +name(pt-BR, trim, length cap) +hrefcanônico (+ opcionalsavedAt). Active = comparação de href canônico com a URL atual (pathname/campanha/municipios+ search normalizado). Rejeitado: rota dedicada/campanha/municipios/vistas/[id](URL nova cara; share pior); dedup só por nome (dois nomes iguais OK se href diferente). - UI de salvar = submit explícito com nome (Dialog/Popover + input + confirmar). Exceção justa ao princípio “Auto-save, no Save button”: nomear é confirmatório. Rejeitado: auto-save silencioso a cada mudança de filtro (vira Visitados); prompt nativo
window.prompt. - Sidebar = 2º nível sob Municípios com
SidebarMenuSub*existente; hover (desktop) / expand (mobile); sticky só no match de filtro salvo — não sticky em/campanha/municipiosgenérico nem em/campanha/municipios/[slug]. Bottom nav mobile permanece flat (atalhos vivem no drawer do sidebar). Rejeitado: sempre listar salvos sob Municípios (polui); grupo separado no rodapé do sidebar; chips no dashboard. - Limite + logout:
MAX_ENTRIEScurto (recomendação 12);clearMunicipalitySavedFilters()no logout junto comclearRecentVisits()(dispositivo compartilhado). Rejeitado: ilimitado; sync cross-device. - i18n e naming:
MunicipalitySavedFilter,municipalitySavedFilters.ts,SaveMunicipalityFilterControl,MunicipalityNavSavedFilters; strings “Salvar filtro”, “Filtros salvos”, “Apagar”; identificadores em inglês.
Questões em aberto
- Permitir salvar a lista “nua” (sem filtros, só sort default)? Opções: A) só com ao menos um param de recorte (
q/region/…) | B) qualquer estado, inclusive nua | C) nua só sesort/dir≠ default. Recomendação: A — alinhado a Visitados (buildMunicipalityListVisitLabelretorna null sem filtro); atalho “Municípios” já cobre a lista nua. (assumido — validar com produto) - Renomear no v1? Opções: A) só criar/apagar | B) renomear no submenu (inline/Dialog). Recomendação: A — apagar+recriar basta no appetite; renomear = Adiado. (assumido)
- Onde mora o botão Salvar? Opções: A) barra slim de
MunicipalityFilters(ao lado de Limpar / Colunas) | B) menu “…” da lista | C) só no overview. Recomendação: A — mesmo lugar mental dos filtros; soft com B16/B17. (assumido) - Dois salvos com o mesmo href: atualizar o existente ou criar duplicata? Opções: A) upsert (pede confirmação se nome diferente) | B) sempre criar | C) bloquear com mensagem. Recomendação: A — um atalho por href; evita submenu duplicado. (assumido)
Abordagem proposta
flowchart LR
List["/campanha/municipios?…\nMunicipalityListState"]
Save["SaveMunicipalityFilterControl\nnome + confirmar"]
Store["municipalitySavedFilters.ts\nlocalStorage"]
Nav["CampaignSidebar\nMunicípios + SidebarMenuSub"]
Match["href canônico == URL atual\n→ sticky open + active"]
List --> Save
Save --> Store
Store --> Nav
List --> Match
Match --> Nav
Nav -->|Link| List
Componentes:
src/utilities/municipalitySavedFilters.ts(client-safe, guardatypeof window):STORAGE_KEY,MAX_ENTRIES, tipos,list/upsert/remove/clear; validação de shape; no-op fora do browser. Depth: espelharrecentVisits.ts, não inventar service genérico de “prefs”.- Helpers em
municipalityUi.ts:buildMunicipalitySavedFilterHref(state)(= visit href / page=1 sem compare) +municipalityListHasSavableFilters(state)(gate do botão). Reusar parse/canonical já existentes. SaveMunicipalityFilterControl(client, emsrc/components/campaign/): Popover/Dialog com nome; desabilitado se não há filtro salvável ou se já é o ativo sem mudanças; pending imediato no confirmar; toast/inline “Salvo” curto; montar na barra slim (MunicipalityFilterspós-B16, ou fileira atual se B16 ainda não aterrissou).MunicipalityNavSavedFilters(client island noCampaignSidebar): lê storage pós-mount (sem mismatch de hidratação); renderizaSidebarMenuSubsob o item Municípios; hover/focus-within (desktop) + estado expandido (mobile);forceOpenquandousePathname+useSearchParamscasam com algumhrefsalvo; cada linha =SidebarMenuSubButton asChild+Link+ ação apagar (SidebarMenuActionou botão sr-only no hover); fechar drawer mobile ao navegar (mesmo padrão atual).CampaignSidebar/ item Municípios: especializar só o itemhref === '/campanha/municipios'(não mudarnav.tspara árvore genérica — YAGNI <3 call sites).isCampaignNavActivedo pai continua por pathname; sub-item ativo por match de search.- Logout: chamar
clearMunicipalitySavedFilters()ao lado declearRecentVisits(). - Sem migration, sem collection, sem server action, sem Consent.
Dependências
- Soft: B16 (barra slim = destino natural do Salvar) e B17 (vizinho na mesma barra) — não bloqueiam; sem eles, Salvar pousa ao lado de Limpar na fileira atual.
- Soft: precedente Visitados (visitados-recentemente.md) — padrão storage/logout.
- Soft: B38 (sidebar-recolhido-tablet.md) — com
collapsible="offcanvas", o submenu hover/expand sob Municípios só é usável com o rail expandido (ou no Sheet mobile); se B38 landar antes, o craft do B18 trata collapsed como “abrir rail”. - Nenhuma dependência dura de outro plano. Reusa
municipalityUi.ts,CampaignSidebar,SidebarMenuSub*,CampaignListPendingBoundary.
Não escopo
- Sync multi-device / preferências em
campaignUser— exigiria migration + access. - Saved views em Planos / Apoiadores / Demandas — FD2 “genéricas”; só Municípios aqui.
- Sticky do submenu em qualquer rota
/campanha/municipios*— só match de filtro salvo. - Incluir Cenário A10 ou
comparedo mapa no bookmark. - Substituir Visitados recentemente / B14 município mais próximo.
- Reorder DnD de colunas — fora de escopo.
Rabbit holes
- Framework de “nav tree” / collapsible genérico no
nav.ts. Se alguém “só preparar” para outros itens: explode o shell. Mitigação: especializar só Municípios neste item; 3º call site = gatilho de abstrair. - Rota
/vistas/[id]+ loader server. Se alguém “só para deep-link nomeado”: migration mental + share frágil. Mitigação: href = query canônica da lista. - Optimistic list sem refresh ao abrir atalho. Anti-goal Feel the action. Mitigação:
Link+ pending da região de resultados existente. - Spreadsheet / painel de gestão de views. Mitigação: criar/apagar no fluxo; sem página admin de views.
Adiado com gatilho
- Renomear filtro salvo. Revisitar quando: ≥2 atores pedirem em R6/sessão ou apagar+recriar gerar atrito medido.
- Sync servidor / share de view entre assessores. Revisitar quando: evidência de multi-device e pedido explícito de “mandar este recorte” (aí sim collection + access; não neste appetite).
- Salvar também o viewport B17 (colunas visíveis) junto do filtro. Revisitar quando: B17 estável e usuários pedirem “a view completa” (hoje misturaria bookmark de decisão com preferência de densidade).
Referências
docs/roadmap.md(Demais itens abertos · grafo · Janela 1–2 · cortes)docs/plans/visitados-recentemente.md— precedente localStorage + logoutdocs/plans/filtros-no-header-lista-municipios.md(B16) ·docs/plans/seletor-colunas-lista-municipios.md(B17)docs/plans/field-desk-ux-pos-critique.md— “saved views genéricas” adiadas; este item é a fatia concretasrc/utilities/municipalityUi.ts— estado URL / href canônico / visit labelsrc/utilities/recentVisits.ts— espelho de storagesrc/components/campaign/CampaignSidebar.tsx,nav.ts,MunicipalityFilters.tsxsrc/components/ui/Sidebar.tsx—SidebarMenuSub*- AGENTS.md — naming EN / copy pt-BR; campaign auth; sem Consent para preferência local do próprio usuário
PRODUCT.md/DESIGN.md— Field Desk; Feel the action; Auto-save (exceção nomear)