teqo-backup/docs/plans/chassis-bottom-drawer-acoes-rapidas.md
Cursor Agent a2eabaccba B79 — chassis do bottom drawer de ações rápidas + busca global (mobile)
Monta CampaignQuickActionsDrawer não-modal no layout (app) para staff fora
do Início e de /acoes, com snap collapsed/expanded, padding de peek no scroll,
registry vazio para catálogos B80+, e busca global reutilizada via
CampaignStaffGlobalSearch.

Closes #15

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-07-31 02:34:08 +00:00

9.2 KiB
Raw Permalink Blame History

Chassis do bottom drawer de ações rápidas + busca (mobile)

Status: entregue (B79 chassis — busca → B91) Atualizado em: 2026-07-31 Issue: #15 (B79) Priority: P1 Model: composer-2.5 Item do roadmap: docs/roadmap.md (Trilha B, item B79 — UX-1 chrome pós-B73) Impeccable: C — chrome novo em toda rota (app) exceto Início e wizards; gesto drag + slot de ações Appetite: ~1–1,5 dia eng; shell não-modal + snap/drag + registry/slot de ações + padding; sem busca (B91); sem migration Responsável: —

Design (Impeccable)

Âncoras: PRODUCT.md (Clarity under pressure; Feel the action; anti spreadsheet) / DESIGN.md (hybrid mobile Mandate Red + sidebar Sheet) · tema data-theme='campaign' · primitivo Drawer (src/components/ui/Drawer.tsx, já com modal={false} que não monta overlay).

Na implementação (implement-roadmap-item): shape → craft → critique → polish.

Brief compacto:

  • Persona / contexto: CG/assessor no celular, fora do Início — após B73 a bottom nav some; o ritual de ação+busca só existia no Início; nas outras páginas sobra só o sidebar fechado.
  • Job principal: ter ações rápidas do contexto da página sem escurecer nem bloquear a página atrás; poder recolher/expandir o drawer para ver mais conteúdo. (Busca global no drawer = B91.)
  • Estratégia de cor: Restrained — superfície de chrome (fundo campaign), não modal dramático.
  • Edit where you see: não neste item — launchers; escrita nos wizards/listas.
  • Anti-goals: overlay que muda opacidade/pointer-events da página; segunda bottom nav de destinos de domínio; FAB flutuante; drawer no Início (já tem dock B65); drawer em /campanha/acoes/* (ritual B59/B75); embutir busca neste item (→ B91).

Dados → decisão → apresentação

Dados: N/A — chrome de navegação/ação; hits da busca = providers B48+ já existentes.

Contexto

Decisão de produto (2026-07-30): com a remoção da bottom nav (B73), a navegação mobile frequente fica no Início (ações + busca) e no sidebar (Sheet fechado por padrão, B38 ✓). Nas demais páginas falta um atalho de intenção. Solução: bottom drawer sempre montado no viewport <md (desktop: fora — sidebar + chrome amplo bastam (assumido)), com:

  1. Strip/catálogo de ações contextualizadas pela página atual (catálogos = B80–B90).
  2. Gesto: arrastar para cima/baixo para expandir/recolher; tap na borda/handle superior também alterna.
  3. Busca no drawer ficou em B91 (fatia 2026-07-31) — não bloqueia B80–B90.

O Drawer shadcn/base-ui já expõe modal={false} (não renderiza DrawerOverlay) e snapPoints — profundidade certa; não inventar segundo sheet.

Objetivos

  • Componente shell (ex. CampaignQuickActionsDrawer) montado no layout (app) só quando: viewport mobile, actor staff (ou leader nas rotas que o plano B89 pedir), pathname não é Início exato e não está sob /campanha/acoes.
  • Não-modal: página atrás permanece 100% opaca, scrollável e interativa; o drawer ocupa faixa inferior (layout shift / padding do scroll) em vez de cobrir com scrim.
  • Snap points mínimos: collapsed (handle + talvez 1 linha de peek) e expanded (ações; região de busca reservada/vazia até B91); drag e tap no handle/borda superior alternam. Persistência de snap na sessão (recomendado: sessionStorage) — Adiado se estourar appetite.
  • Slot actions (lista já resolvida com hrefs). Contrato de contexto client-safe (ex. CampaignQuickActionContext: municipalitySlug?, leadershipId?, …) + helper que resolve href via wizardActionHref / atalhos de lista — B80+ só preenchem o contexto e o catálogo.
  • Ajuste de padding do campaign-content-scroll para a altura do peek (substitui o antigo pb-24 da bottom nav após B73).
  • Guardrails: sem migration, sem collection, sem Consent, sem server action nova de escrita; leader lockdown respeitado.
  • Tracer bullet: drawer montado + registry vazio/stub + padding → merge — isso desbloqueia B80–B90 sem esperar B91.

Decisões travadas

  • Drawer não-modal (modal={false}), nunca scrim. Pedido explícito 2026-07-30: não mudar opacidade/visibilidade/interatividade da página. Rejeitado: modal={true} (padrão do kit); Sheet full-screen; dim bg-black/10.
  • Fora do Início e fora de /acoes/*. Início já tem dock; wizard tem chrome próprio (B75). Rejeitado: unificar Início no mesmo drawer (dois docks); drawer dentro do wizard.
  • Só mobile (<md). Desktop/tablet mantêm sidebar + busca do Início quando o usuário volta. Rejeitado: drawer em md+ (ruído; compete com sidebar).
  • Catálogo por página = itens B80–B90, não hardcode no chassis. O chassis só renderiza o que a rota fornece (via registry pathname→provider ou prop do layout segment). Rejeitado: um único catálogo global idêntico ao Início em toda rota (perde o prefill).
  • Busca neste item = fora. Contrato home-search no drawer → B91. Rejeitado: manter busca no escopo do chassis (guarda-chuva que bloqueava 11 P1).
  • i18n: ids CampaignQuickActionsDrawer, quickActionContext, snap; copy pt-BR (aria do handle “Mostrar ações rápidas” / “Ocultar…”).

Questões em aberto

  • Mount: layout (app) com registry vs. slot por layout.tsx de cada área? Opções: A) registry central pathname→catalog no (app)/layout | B) cada área exporta quickActions via parallel route/slot. Recomendação: A — um mount, B80+ só registram; B se o registry virar switch gigante. (assumido)
  • Peek inicial: collapsed ou expanded? Opções: A) collapsed (mais conteúdo) | B) expanded (ações à mão). Recomendação: A no 1º paint; expandir no tap/drag — campo precisa ver a lista. (assumido — critique com device)
  • Leader: drawer só em Contatos (B89) ou também se navegar a outras rotas? Opções: A) só rotas leader | B) esconder sempre fora de Contatos. Recomendação: A — getCampaignNav leader já é mínimo.

Abordagem proposta

flowchart TB
  layout["(app)/layout.tsx mobile"] --> gate{"pathname Início ou acoes?"}
  gate -->|sim| skip["sem drawer"]
  gate -->|não| drawer["CampaignQuickActionsDrawer modal=false"]
  drawer --> handle["handle + snap"]
  drawer --> actions["ações do registry B80+"]
  drawer -.->|"B91"| search["HomeSearch* no drawer"]
  actions --> wizards["wizardActionHref + context"]

Componentes:

  • CampaignQuickActionsDrawer (src/components/campaign/shell/): Drawer modal={false} + snapPoints + showSwipeHandle; região de ações (reuso visual de CampaignHomeActionStrip / botões B44 se couberem no peek); slot/região de busca opcional (preenchida em B91).
  • campaignQuickActionRegistry / resolveQuickActionsForPath (src/lib/ client-safe): pathname + role + context → ResolvedCampaignHomeAction[] (ou tipo irmão). Contextos ricos entram pelos planos B80+.
  • (app)/layout.tsx: mount condicional; padding inferior do scroll = altura do peek.
  • Migration: Sem migration, sem collection, sem server action de escrita.

Dependências

  • Dura: B73 (remover bottom nav — senão dois chromes inferiores). Soft: B47 ✓/B48+ (busca); B45 ✓/B44 ✓ (strip/botão); B60 ✓ (wizardActionHref + ?municipio=).
  • Desbloqueia B80–B90 (não exige B91).
  • Soft: B91 (busca no drawer) depende deste chassis.

Não escopo

  • Catálogos e prefills por vertical → B80–B90.
  • Busca global embutida no drawer → B91 (busca-global-bottom-drawer.md).
  • Novos wizards / novas actions de escrita.
  • Desktop omnibox global.
  • Quadro: fora do inventário (decisão de produto 2026-07-30).

Rabbit holes

  • State machine de snap sincronizada com teclado virtual / visualViewport. Mitigação: v1 = CSS snap + padding fixo; medir iOS no craft; Adiado com gatilho se o teclado cobrir a busca.
  • Reimplementar Drawer do zero. Mitigação: modal={false} + snapPoints do kit.
  • Levantar strip do Início para shared sem medir bundle. Mitigação: reusar botão; extrair strip só se o JSX divergir <~20 linhas.

Adiado com gatilho

  • Persistir snap expanded/collapsed entre navegações. Revisitar se o CG reclamar de reabrir o drawer a cada rota.
  • Peek com 1–2 ações favoritas sem expandir. Revisitar após 1 semana de uso do collapsed-only.

Referências

Revisões

  • 2026-07-31: Fatia humana — busca → B91; chassis desbloqueia B80–B90 sozinho; tracer bullet = drawer + registry + padding.