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>
9.2 KiB
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-eventsda 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:
- Strip/catálogo de ações contextualizadas pela página atual (catálogos = B80–B90).
- Gesto: arrastar para cima/baixo para expandir/recolher; tap na borda/handle superior também alterna.
- 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 comhrefs). Contrato de contexto client-safe (ex.CampaignQuickActionContext:municipalitySlug?,leadershipId?, …) + helper que resolvehrefviawizardActionHref/ atalhos de lista — B80+ só preenchem o contexto e o catálogo. - Ajuste de padding do
campaign-content-scrollpara a altura do peek (substitui o antigopb-24da 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; dimbg-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 emmd+(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-searchno 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 porlayout.tsxde cada área? Opções: A) registry central pathname→catalog no(app)/layout| B) cada área exportaquickActionsvia 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 —
getCampaignNavleader 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/):Drawermodal={false}+snapPoints+showSwipeHandle; região de ações (reuso visual deCampaignHomeActionStrip/ 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
docs/roadmap.md(UX-1, B73, B79–B90)- busca-global-bottom-drawer.md (B91 — fatia busca)
src/components/ui/Drawer.tsx—modal={false}sem overlaysrc/lib/campaignActionRoutes.ts—wizardActionHrefsrc/lib/campaignHomeActions.ts+CampaignHomeActionStripsrc/app/(campaign)/campanha/(app)/layout.tsx— scroll + chrome- remover-bottom-nav-mobile.md · fluxos-acao-primeiro-inicio.md
PRODUCT.md/DESIGN.md— Field Desk mobile
Revisões
- 2026-07-31: Fatia humana — busca → B91; chassis desbloqueia B80–B90 sozinho; tracer bullet = drawer + registry + padding.