mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 08:03:06 +00:00
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>
124 lines
9.2 KiB
Markdown
124 lines
9.2 KiB
Markdown
# 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](../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 `href`s). 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
|
||
|
||
```mermaid
|
||
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](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](busca-global-bottom-drawer.md) (B91 — fatia busca)
|
||
- `src/components/ui/Drawer.tsx` — `modal={false}` sem overlay
|
||
- `src/lib/campaignActionRoutes.ts` — `wizardActionHref`
|
||
- `src/lib/campaignHomeActions.ts` + `CampaignHomeActionStrip`
|
||
- `src/app/(campaign)/campanha/(app)/layout.tsx` — scroll + chrome
|
||
- [remover-bottom-nav-mobile.md](remover-bottom-nav-mobile.md) · [fluxos-acao-primeiro-inicio.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.
|