mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 17:13:07 +00:00
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>
3.8 KiB
3.8 KiB
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
CampaignQuickActionsDrawercomo nome — renomear paraCampaignQuickActionsOverlay; snap context ecampaignQuickActionSnap.tssaem por completo.
Abordagem recomendada
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: renomearshouldMountQuickActionsDrawer→shouldMountQuickActionsFab; remover gate mobile do comentário.CampaignQuickActionsOverlay.tsx(substituiCampaignQuickActionsDrawer.tsx): conteúdo ações+busca;useIsMobileescolhe Drawer vs Dialog; ordem espelhaCampaignHomeLayout; retração de ações quandouiFocused.CampaignQuickActionsFab.tsx: botão flutuante fixo; abre/fecha overlay; some quando overlay aberto.CampaignQuickActionsHost.tsx: estadoopen; fecha empathnamechange; remove peek scroll (CampaignContentScrollWithPeek).CampaignAppScrollChrome.tsx: removeCampaignQuickActionsSnapProvider;GlobalSearchProvidersó quando FAB elegível.- Deletar:
CampaignQuickActionsSnapContext.tsx,campaignQuickActionSnap.ts. - Migration: sem migration.
- UI: Impeccable C — FAB discreto
bottom-4 right-4, safe-area; Dialogmax-w-lg; Drawermax-h-[85dvh].
Dados → forma
N/A — chrome de navegação.
Fases verificáveis
- Remover snap/peek — deletar snap modules; simplificar scroll chrome.
- Overlay + FAB — novo overlay/dialog; host wiring; mount em todas as larguras.
- Tests + gates — reescrever unit drawer→overlay; atualizar mount spec;
pnpm gate:fast;pnpm push.
Rabbit holes / Não escopo (engenharia)
- Refatorar
Drawer.tsxalé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
TooltipProviderno 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-lgpode precisar polish se resultados de busca ficarem apertados — gatilho: feedback de uso pós-merge.
Self-score decision-quality: 5/5