teqo/docs/plans/municipios-mobile-sem-moldura.md
Francisco Solla 324e1c3c51 feat(B184): omnibox mobile sem moldura como padrão das listas (sticky no form, X de limpar no input, salvar filtro no header, cards edge-to-edge)
- Chassis CampaignListOmnibox (B127): abaixo de md a label some (input carrega
  aria-label), o campo perde borda/sombra (md: restaura), o form do filtro vira
  barra sticky com linha separadora (sticky no form porque não escapa do
  containing block — a coluna do input dentro do wrapper curto não grudava),
  o texto Limpar vira X circular dentro do input (chips OU busca; slot sempre
  renderizado com invisible; hit target 44px; live region de limpeza), botão
  texto Limpar desktop-only. Padrão para as 11 listas via
  campaignListOmniboxFormClassName.
- Municípios: Salvar filtro vira icon no header mobile (C94/C95 slot,
  presentation='icon', nome de rename = contrato 2.5.3); cards edge-to-edge
  com separador de linha (border-b last:border-b-0, -mx-4, gate md:).
- Atualizações: Nova atualização vai para o header mobile (único trailing
  mobile-visible que grudaria na barra).
- campaignMobileHeaderIconClassName compartilhada (3º consumidor).
- E2E mobile novo (390x844) com pins: foco/aria-expanded após limpar, salvar
  -> renomear no header, cards, desktop invertido.
- D7 registrado no caminho: sticky dos headers da tabela desktop morto.
2026-08-10 03:11:43 -03:00

7.6 KiB
Raw Blame History

B184 — Municípios mobile: lista sem moldura (omnibox sticky + cards edge-to-edge)

Status: registrado Atualizado em: 2026-08-09 Issue: #514 Priority: P2 Model: composer-2.5 Impeccable: B — encaixe na tela mobile da lista de municípios (/campanha/municipios) Canvas UI: /home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-plans-plan-issue-14/canvases/plan-b184-ui-draft.canvas.tsx Appetite: ~0,5–1 dia eng; um encaixe em lista existente Responsável: —

Escopo ampliado (decisão do produto, 2026-08-09): o look sem moldura/sticky do filtro vira o padrão mobile do chassis CampaignListOmnibox — todas as listas /campanha (11 call sites), não só municípios. Cards edge-to-edge e "Salvar filtro" no header continuam municípios-only (as outras listas não têm árvore de cards B42 nem saved filters). Desktop permanece inalterado em todas as listas.

Intenção

No celular, a lista de municípios acumula chrome que rouba espaço da fila: a label "Filtrar municípios" gasta uma linha inteira, o filtro vem numa caixa com borda e sai da tela ao rolar, e os cards têm moldura arredondada + gap — tudo isso empurra os dados para baixo e quebra o ritmo de varredura do assessor em campo. Queremos leitura fluida edge-to-edge: filtro sem moldura e sempre visível, cards separados só por uma linha, e as ações de filtro no lugar esperado — limpar dentro do próprio input (X circular, padrão comum) e salvar filtro no header como icon button.

Persona e fluxo

  • Persona / contexto: assessor ou coordenador no celular, varrendo a fila de municípios entre visitas; uma mão, atenção curta.
  • Job principal: filtrar e rolar a fila sem lutar com moldura, mantendo o filtro sempre à mão.
  • Fluxo desejado: abre /campanha/municipios no celular → vê o filtro limpo, sem label, preso sob a barra superior → limpa tudo com o X circular dentro do input (só aparece quando há o que limpar) → salva o recorte pelo icon no header → rola a fila de cards contínuos (só uma linha separando cada um) → o filtro permanece visível o tempo todo → toca num card e abre o detalhe.
  • Anti-goals de produto: não virar redesenho geral do shell; não mudar o comportamento de filtragem (chips continuam dentro da omnibox); não alterar desktop; cards edge-to-edge e salvar no header não vazam para as outras listas.

Esboço de fluxo (B)

Ver Canvas UI (rascunho side-by-side "Hoje × Depois"). Jornada textual: [abre lista] → [filtro sem label, sem borda, sticky] → [rola cards contínuos com separador de linha] → [filtro continua visível] → [toca card → detalhe]

Objetivo e aceite

  • No mobile, a label do filtro (ex.: "Filtrar municípios") não é exibida — em todas as listas (padrão do chassis).
  • O filtro é visualmente sem moldura (sem caixa/borda), fica sempre visível enquanto o usuário rola os cards/linhas, e uma linha horizontal o separa do feed abaixo — em todas as listas (padrão do chassis).
  • Os chips de filtro ativo continuam dentro da omnibox, com o mesmo comportamento de hoje — todas as listas.
  • O "Limpar" (botão de texto atual) sai do mobile; no lugar, um X circular dentro do input, junto à borda direita, que limpa os filtros — aparece só quando há o que limpar (filtros ativos ou busca digitada) — todas as listas.
  • O "Salvar filtro" atual sai da região do filtro; no mobile ele vira icon button no header (o popover de nomear/renomear continua o mesmo) — municípios apenas.
  • Os cards de município no mobile ficam sem borda nem arredondamento, edge-to-edge (sem respiro lateral da página na região da lista), com uma única linha horizontal separando um card do outro — municípios apenas (única lista com cards mobile).
  • Desktop de todas as listas fica inalterado.

Dados (intenção)

  • Vou apresentar dados? Não — item de acabamento visual; nenhum dado, KPI ou mapa muda.
  • Decisões desbloqueadas: N/A (nenhuma decisão de leitura de dado nova).

Direção no codebase (hipótese)

  • Áreas prováveis: src/components/campaign/shared/CampaignListOmnibox.tsx (label/placeholder do filtro e onde as ações nascem — o chassis compartilhado B127 agora é o dono do padrão: todos os 11 *Filters herdam), src/components/campaign/municipality/SaveMunicipalityFilterControl.tsx (popover de salvar — só muda o ancoradouro/trigger no mobile), src/components/campaign/municipality/MunicipalityListMobileCards.tsx (cards rounded-xl border), src/app/(campaign)/campanha/(app)/municipios/page.tsx (registro do icon no header via SetCampaignHeaderAction, slot C94/C95).
  • Precedente a olhar: docs/plans/polimento-mobile-lista-municipios.md (B42, mobile já entregue), Issues B120 (filtro combobox mobile) e B127 (chassis da omnibox).
  • Risco de acoplamento: o filtro é o chassis compartilhado CampaignListOmnibox (B127) usado por várias listas — o padrão mobile é intencionalmente no chassis (decisão de produto), e o desktop é preservado por variantes md:; cards/salvar no header ficam escopados a municípios.

Dependências

  • Nenhuma.

Fora de escopo

  • Desktop de todas as listas (sem mudança).
  • Cards edge-to-edge e "Salvar filtro" no header fora de municípios (outras listas não têm cards B42 nem saved filters).
  • Novos filtros, ordenação ou mudança de dados nos cards.
  • Redesign do shell/top bar.

Rabbit holes de produto

  • "Já que é sem moldura, melhora as outras listas também." Explosão de superfície e review. Decidido (2026-08-09): o look bare/sticky é o padrão do chassis para todas as listas no mobile — por isso a mudança mora no chassis e não no estilo local de municípios. O que fica cortado: cards edge-to-edge e salvar no header nas outras listas.
  • "Sticky é oportunidade de redesenhar o filtro." Nova interação sem pedido. Corte: mantém chips (dentro da omnibox), sugestões e o fluxo de salvar (só muda o ancoradouro); só muda presença visual, posição fixa e os dois controles de ação.
  • "Edge-to-edge é todo o app." Redesign de shell. Corte: só a região da lista mobile.

Questões em aberto (produto)

  • Remover a label só no mobile ou em todas as resoluções? Decidido: A — mobile-only; no desktop a label ajuda descoberta sem custo de espaço. Aplica-se ao padrão do chassis (todas as listas).
  • Cards edge-to-edge até a borda física da tela, ou só até o padding da página? Decidido: A — até a borda da tela ("seamlessly edge-to-edge" é explícito no pedido), via sangria do p-4 do scrollport.
  • O X circular de limpar aparece quando? Decidido: A — só com filtros ativos (chips) ou busca digitada — padrão de clear input; segue a mesma regra do "Limpar" de hoje ampliada à busca digitada.
  • O icon de salvar filtro no header aparece quando? Decidido: A — só quando há recorte ativo para salvar (o controle já se omite sem recorte; o header ganha o mesmo gate).
  • Região sticky do filtro: chips e busca formam a região que gruda sob a barra (confirmado no gate — chips continuam dentro da omnibox). O picker de colunas segue onde está hoje, fora da região sticky.

Referências

  • GitHub Issue: #514
  • Canvas UI (gate): /home/fsolla/.cursor/projects/home-fsolla-cursor-worktrees-teqo-plans-plan-issue-14/canvases/plan-b184-ui-draft.canvas.tsx
  • src/components/campaign/municipality/MunicipalityFilters.tsx, src/components/campaign/municipality/MunicipalityListMobileCards.tsx, src/components/campaign/shared/CampaignListOmnibox.tsx
  • docs/plans/polimento-mobile-lista-municipios.md (B42 — mobile entregue)