teqo-backup/docs/plans/fab-acoes-rapidas-substituir-drawer-impl.md
Cursor Agent dbce18002c
B126 — FAB de ações rápidas substitui drawer persistente
Remove o bottom drawer não-modal (snap/peek/scroll-coupling) e introduz
um FAB em todas as larguras fora do Início e wizards. Abrir o FAB mostra
overlay modal: Dialog no desktop (busca em cima) e Drawer no mobile
(ações em cima), reutilizando strip e busca globais do Início.

Closes #260

Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
2026-08-02 18:39:27 +00:00

75 lines
3.8 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# Impl: FAB de ações rápidas (substituir bottom drawer persistente)
Status: aprovado
Atualizado em: 2026-08-02
Issue: #260
Intenção: docs/plans/fab-acoes-rapidas-substituir-drawer.md
Appetite restante: herdado (~1d)
## Leitura da intenção
- **Outcome:** drawer persistente some; FAB em todas as larguras fora do Início/wizards abre overlay modal com ações contextuais + busca no ritual do Início por breakpoint.
- **O que NÃO negociar:** catálogo contextual por rota; lockdown leader; sem FAB no Início nem `/campanha/acoes/*`; sem snap/peek/scroll-coupling; sem migration/RBAC.
- **O que reavaliar:** manter `CampaignQuickActionsDrawer` como nome — renomear para `CampaignQuickActionsOverlay`; snap context e `campaignQuickActionSnap.ts` saem por completo.
## Abordagem recomendada
```mermaid
flowchart LR
Host["CampaignQuickActionsHost"]
Host --> Fab["CampaignQuickActionsFab"]
Host --> Overlay["CampaignQuickActionsOverlay"]
Overlay -->|lt-md| Drawer["Drawer modal"]
Overlay -->|md+| Dialog["Dialog modal"]
Drawer --> Layout["actions↑ search↓ (mobile)"]
Dialog --> Layout2["search↑ actions↓ (desktop)"]
```
**Opções consideradas:** A) um único Drawer em todas as larguras | B) Sheet lateral desktop | C) Dialog md+ + Drawer mobile espelhando `CampaignHomeLayout`
**Recomendação:** **C** — ritual do Início já codificado em order classes; overlay sob demanda sem estados intermediários.
**Rejeitadas:** A (desktop drawer inferior compete com sidebar); B (chrome paralelo).
### Componentes / mudanças
- **`campaignQuickActionMount.ts`:** renomear `shouldMountQuickActionsDrawer` → `shouldMountQuickActionsFab`; remover gate mobile do comentário.
- **`CampaignQuickActionsOverlay.tsx`** (substitui `CampaignQuickActionsDrawer.tsx`): conteúdo ações+busca; `useIsMobile` escolhe Drawer vs Dialog; ordem espelha `CampaignHomeLayout`; retração de ações quando `uiFocused`.
- **`CampaignQuickActionsFab.tsx`:** botão flutuante fixo; abre/fecha overlay; some quando overlay aberto.
- **`CampaignQuickActionsHost.tsx`:** estado `open`; fecha em `pathname` change; remove peek scroll (`CampaignContentScrollWithPeek`).
- **`CampaignAppScrollChrome.tsx`:** remove `CampaignQuickActionsSnapProvider`; `GlobalSearchProvider` só quando FAB elegível.
- **Deletar:** `CampaignQuickActionsSnapContext.tsx`, `campaignQuickActionSnap.ts`.
- **Migration:** sem migration.
- **UI:** Impeccable C — FAB discreto `bottom-4 right-4`, safe-area; Dialog `max-w-lg`; Drawer `max-h-[85dvh]`.
### Dados → forma
N/A — chrome de navegação.
## Fases verificáveis
1. **Remover snap/peek** — deletar snap modules; simplificar scroll chrome.
2. **Overlay + FAB** — novo overlay/dialog; host wiring; mount em todas as larguras.
3. **Tests + gates** — reescrever unit drawer→overlay; atualizar mount spec; `pnpm gate:fast`; `pnpm push`.
## Rabbit holes / Não escopo (engenharia)
- Refatorar `Drawer.tsx` além do que snap removal naturalmente limpa (snapPoints ainda usados por outros? — não, só quick actions; manter API do kit).
- FAB no Início ou unificar ritual Início.
- Grid 2×3 no overlay (permanece strip).
## Riscos e mitigação
- **Provider Tooltip (B102):** manter `TooltipProvider` no layout `(app)` — overlay continua sibling do scroll.
- **Teclado mobile no Dialog:** não usamos Dialog no mobile — Drawer modal cobre.
- **Testes snap:** remover; cobrir open/close + ordem busca/ações + suggest POST.
## Aceite de engenharia
- [ ] Aceite de produto da intenção ainda coberto
- [ ] Invariantes AGENTS/engineering-standards
- [ ] Testes de domínio previstos (unit) onde mount/overlay mudam
## Débitos deferidos (autônomo)
- Dialog desktop `max-w-lg` pode precisar polish se resultados de busca ficarem apertados — gatilho: feedback de uso pós-merge.
Self-score decision-quality: 5/5