teqo-backup/docs/plans/acoes-rapidas-grade-3x2-fab-overlay-impl.md
Cursor Agent 8d30667c2a
B132 — grade 3×2 no Início/FAB overlay e polimento do drawer
- CampaignHomeActionStrip: grid-cols-3 no mobile; variante grid para overlay
- CampaignQuickActionsOverlay: grade no lugar da strip; altura por conteúdo;
  pt-4 na busca focada; limpa query ao fechar
- CampaignQuickActionsHost: clear() em fechamento e mudança de rota
- Testes unit atualizados; impl plan em docs/plans/

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

2.9 KiB
Raw Blame History

Impl: Ações rápidas — grade 3×2 (Início + FAB) e polimento do overlay

Status: aprovado Atualizado em: 2026-08-02 Issue: #280 Intenção: docs/plans/acoes-rapidas-grade-3x2-fab-overlay.md Appetite restante: ~0,5d (layout + overlay polish)

Leitura da intenção

  • Outcome: Início mobile e overlay FAB usam grade 3×2; overlay sem strip scroll; drawer encaixa no conteúdo; busca com respiro no topo quando focada; query limpa ao fechar/navegar.
  • O que NÃO negociar: catálogo/lockdown; Início md+ strip; sem migration; sem snap/peek.
  • O que reavaliar: variante strip no overlay → nova variante grid (grade em todas as larguras do overlay); bleed -mx-4 obsoleto com grade.

Abordagem recomendada

flowchart LR
  Strip["CampaignHomeActionStrip"]
  Strip -->|responsive| H["grid 3-col lt-md / strip md+"]
  Strip -->|grid| O["grid 3-col sempre"]
  Strip -->|strip| S["flex scroll"]
  Host["CampaignQuickActionsHost"] -->|close/pathname| Clear["useHomeSearch.clear"]

Opções consideradas: A) reutilizar responsive no overlay (quebra desktop — vira strip) | B) variante grid dedicada | C) prop columns={3}
Recomendação: B — grid para overlay; responsive passa de 2→3 colunas no mobile.
Rejeitadas: A (aceite exige grade no dialog desktop); C (over-parameterize).

Componentes / mudanças

  • CampaignHomeActionStrip: variant ganha 'grid'; responsive usa grid-cols-3; grid = grid grid-cols-3 gap-3 sem overflow/pan.
  • CampaignHomeActionButton: sem mudança (já w-full em responsive/grid).
  • CampaignQuickActionsOverlay: variant="grid"; remove bleed wrapper; drawer sem flex-1 stretch — altura auto com max-h só como teto; pt-4 na busca quando uiFocused.
  • CampaignQuickActionsHost: clear() em onOpenChange(false) e no useEffect de pathname.
  • Tests: strip spec 2→3 cols; overlay strip→grid; bleed test removido/atualizado; clear on close/pathname.
  • Migration: sem migration.

Dados → forma

N/A — chrome de launcher.

Fases verificáveis

  1. Strip variants — grid-cols-3 + variante grid.
  2. Overlay polish — grid, altura conteúdo, respiro busca, clear query.
  3. Gates — pnpm gate:fast; pnpm push.

Rabbit holes / Não escopo (engenharia)

  • Refatorar Drawer.tsx globalmente.
  • Extrair tile genérico.
  • Mudar tamanho dos círculos de ação.

Riscos e mitigação

  • 3 colunas em 390px: gap-3 + w-full já usados em B122; labels line-clamp-2.
  • Clear no Início: provider separado no home — clear no host só afeta overlay provider.
  • Dialog desktop altura: manter max-h como teto para resultados longos.

Aceite de engenharia

  • Aceite de produto da intenção ainda coberto
  • Invariantes AGENTS/engineering-standards
  • Testes unit previstos (strip, overlay, clear)

Self-score decision-quality: 5/5