Merge pull request #318 from fsolla/cursor/56661d91

B146 — plano: FAB overlay sem autofocus e fechar

docs/plans/fab-overlay-sem-autofocus-e-fechar.md

@@ -0,0 +1,97 @@
+# FAB — overlay abre sem foco na busca; fechar não cobre o campo
+
+Status: aprovado (gate 2026-08-02)
+Atualizado em: 2026-08-02
+Issue: #317
+Priority: P1
+Model: composer-2.5
+Impeccable: B — polimento do chrome já existente (`CampaignQuickActionsOverlay` / dialog do FAB)
+Appetite: ~0,5 dia eng; um outcome: abrir FAB mostra ações; fechar e busca não se sobrepõem
+Responsável: —
+
+## Intenção
+
+Ao tocar o FAB de ações rápidas, o overlay abre **já com a busca focada**. Como o ritual atual esconde/recolhe as ações quando a busca tem foco, a pessoa **não vê as ações rápidas** — exatamente o que veio buscar no FAB. Além disso, no overlay em dialog (desktop/tablet), o botão de fechar fica **por cima da barra de busca**, atrapalhando leitura e toque.
+
+Queremos: abrir = ações visíveis (idle); buscar só quando a pessoa foca/toca a busca; fechar sempre acessível e sem cobrir o campo.
+
+## Persona e fluxo
+
+- **Persona / contexto:** staff (e liderança onde o catálogo existe) fora do Início — lista/detalhe — polegar ou mouse; quer disparar uma ação rápida em um toque.
+- **Job principal:** ao abrir o FAB, ver e usar as ações do contexto sem o overlay “pular” para modo busca.
+- **Fluxo desejado:**
+  1. Toca o FAB → overlay abre em estado **idle**: grade/ações visíveis + busca **sem foco**.
+  2. Se quiser buscar, toca/foca a busca → aí sim o comportamento atual de recolhimento das ações (já esperado desde B132).
+  3. **Desktop/tablet (dialog):** controle de **fechar (X)** visível e **sem sobrepor** a barra de busca.
+  4. **Mobile (drawer):** **sem X**; handle de swipe no topo (padrão de drawer) + fechar por gesto/fora — o handle hoje não aparece no overlay do FAB (`showSwipeHandle` default off).
+  5. Fecha → volta à página; busca limpa como já combinado.
+- **Anti-goals de produto:** redesenhar catálogo/labels; recriar snap/peek do drawer antigo; mudar ranking da busca; FAB no Início; segundo inventário de ações.
+
+### Esboço de fluxo (B)
+
+```text
+[página ≠ Início]
+  → toca FAB
+  → overlay IDLE: [ações visíveis] + [busca sem foco]
+       md+: [X sem overlap na busca]
+       mobile: [handle] (sem X)
+  → (opcional) toca busca → ações recolhem (ritual atual)
+  → ação / hit / fecha → outcome ou página intacta
+```
+
+## Objetivo e aceite
+
+- Abrir o overlay do FAB **não** coloca foco automático na busca (nem teclado mobile “sobe” só por abrir) — **mobile e desktop**.
+- No estado inicial após abrir, as **ações rápidas estão visíveis** (não recolhidas por foco implícito).
+- **Desktop/tablet:** o **X** de fechar não sobrepõe a barra de busca; hit target utilizável.
+- **Mobile:** **sem botão X**; o drawer do FAB mostra o **handle** de swipe (padrão do kit; hoje o overlay não liga `showSwipeHandle`).
+- O recolhimento das ações ao **focar/interagir de propósito** com a busca permanece (comportamento de produto já aceito em B132).
+- Catálogos, lockdown de liderança, limpeza de query ao fechar/navegar e grade de ações **inalterados** em conteúdo.
+- Sem migration / Consent / RBAC.
+
+## Dados (intenção)
+
+- **Vou apresentar dados?** Não
+- **Decisões desbloqueadas:** N/A — chrome de launcher
+- **Forma:** _adiada_ — N/A
+
+Dados: N/A — atalho de intenção; sem métricas novas.
+
+## Direção no codebase (hipótese)
+
+- **Áreas prováveis:** `src/components/campaign/shell/CampaignQuickActionsOverlay.tsx` (Dialog desktop + Drawer mobile), primitivo `src/components/ui/dialog.tsx` (close absoluto padrão), `src/components/ui/Drawer.tsx` (`showSwipeHandle` / `DrawerSwipeHandle` — hoje default off e o FAB não liga), superfície de busca reusada (`CampaignGlobalSearch*` / `HomeSearchContext` — foco → `uiFocused` → recolhe ações).
+- **Precedente a olhar:** B126 (`fab-acoes-rapidas-substituir-drawer.md`), B132 (`acoes-rapidas-grade-3x2-fab-overlay.md` — foco na busca **recolhe** ações de propósito; este item corrige o foco **indesejado na abertura**).
+- **Risco de acoplamento:** não alterar o ritual do Início (busca inline) nem o comportamento “foco = recolhe ações” quando o usuário **escolhe** buscar; não inventar um segundo padrão de close para todos os Dialogs do produto sem necessidade.
+
+## Dependências
+
+- Nenhuma. Soft: B136 (orientação da grade) é independente — este item não depende dela.
+
+## Fora de escopo
+
+- Redesign do Início ou da grade de ações.
+- Mudança do conteúdo/ranking da busca global.
+- Polimento amplo do kit `Dialog`/`Drawer` além do necessário para esta superfície (ou para um close não sobrepor).
+- Novas ações no catálogo.
+
+## Rabbit holes de produto
+
+- **Desligar o recolhimento ao focar.** Se alguém “só completar”: remove o ritual B132. **Corte neste item:** só impedir foco automático na **abertura**; foco deliberado continua recolhendo.
+- **Redesenhar o chrome de todos os dialogs.** **Corte:** resolver overlap nesta superfície (ou no mínimo no padrão de close que ela usa), sem campanha de UI kit.
+
+## Questões em aberto (produto)
+
+- _(Resolvidas no gate 2026-08-02.)_
+- **Abrir sem foco na busca:** **ambos** (mobile drawer + desktop dialog).
+- **Fechar:**
+  - **Desktop/tablet:** X explícito **sem** cobrir a busca (offset/faixa — forma no impl).
+  - **Mobile:** **sem X**; **com handle** de drawer (ligar o padrão já existente no kit se ainda estiver off neste overlay).
+
+## Referências
+
+- GitHub Issue #317
+- `src/components/campaign/shell/CampaignQuickActionsOverlay.tsx`
+- `src/components/ui/dialog.tsx` (close absoluto `right-3 top-3`)
+- `src/components/ui/Drawer.tsx` (`showSwipeHandle`)
+- `docs/plans/fab-acoes-rapidas-substituir-drawer.md` (B126)
+- `docs/plans/acoes-rapidas-grade-3x2-fab-overlay.md` (B132)