3.1 KiB
3.1 KiB
Impl: B124 — Sidebar Municípios: filtros salvos colados (sem disclosure)
Status: aprovado Atualizado em: 2026-08-02 Issue: #253 Intenção: docs/plans/sidebar-filtros-salvos-proximidade.md Appetite restante: ~0,5 dia eng (dentro)
Leitura da intenção
- Outcome: Atalhos de filtro salvo aparecem sempre visíveis, indentados e colados logo abaixo de Municípios — leem como filhos, não como seção própria.
- O que NÃO negociar: sem chevron/disclosure/hover; Apagar+Desfazer intactos;
listQueryMatchpuro; sem serializador de URL no layout(app); a11y (aria-labelna lista,aria-currentno ativo). - O que reavaliar: hipótese de editar
Sidebar.tsx— preferir ajuste local emMunicipalityNavSavedFiltersviaclassNamenoSidebarMenuSub.
Abordagem recomendada
flowchart TD
A[MunicipalityNavSavedFilters] --> B[Remove disclosure state + chevron]
B --> C[SidebarMenuSub sempre visível]
C --> D[Tighten vertical gap via className]
E[municipalitySavedFilters.ts] --> F[Remove open storage API]
G[e2e] --> H[Replace disclosure test with always-visible reload]
Opções consideradas:
- A: Só esconder chevron mas manter estado open — rejeitada (viola aceite).
- B: Mover sub-lista para fora do
SidebarMenuItemde Municípios — rejeitada (quebra semântica de filho; mais churn). - C (recomendada): Remover disclosure no componente existente; apagar API de open; apertar
mt/pynoSidebarMenuSublocalmente.
Recomendação: C — menor diff, dono correto, aceite coberto.
Componentes / mudanças
MunicipalityNavSavedFilters.tsx: remover chevron,openstate,useEffectde auto-open, imports mortos; lista sempre montada; foco no delete aponta para link de Municípios;classNamecom-mt-0.5 py-0para proximidade.municipalitySavedFilters.ts: removerOPEN_STORAGE_KEY,read/writeMunicipalitySavedFiltersOpen; manterremoveItem(OPEN_STORAGE_KEY)emclearpara limpar legado no logout.CampaignSidebar.tsx: atualizar comentário do slot children (sem disclosure).- Migration: sem migration.
- UI: Impeccable B — shape (sub-lista indentada) + craft (gap) + critique (sem controles órfãos).
Dados → forma
N/A — navegação localStorage inalterada.
Fases verificáveis
- Server/utilities — remover API de open; limpar exports mortos.
- UI — componente always-on + spacing.
- Testes — ajustar e2e disclosure → always-visible após reload;
pnpm gate:fast;pnpm push.
Rabbit holes / Não escopo (engenharia)
- Não refatorar
SidebarMenuSubglobalmente. - Não adicionar rótulo "Filtros salvos".
- Não truncar lista a 4 itens.
Riscos e mitigação
- Foco ao apagar último filtro: resolver sucessor como link
Municípiosno mesmoli(já existia como fallback). - Legado
localStorageopen:clearMunicipalitySavedFiltersno logout remove a chave antiga.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto
- Invariantes AGENTS/engineering-standards
- Testes e2e ajustados (sem disclosure)