teqo-backup/docs/plans/inicio-acoes-grid-2x3-mobile-impl.md
Cursor Agent 5b6af56b22
B122 — Início mobile: ações em grade 2×3 sem scroll
- CampaignHomeActionStrip: variant responsive (grid lt-md, strip md+)
- CampaignHomeActionButton: layout strip/grid/responsive class contracts
- CampaignHomeLayout: remove mobile bleed for grid gutter
- CampaignQuickActionsDrawer: explicit variant=strip
- Plans: inicio-acoes-grid-2x3-mobile + impl
- Tests: unit grid/strip + e2e mobile visibility

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

65 lines
2.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: Início mobile — ações em grade 2×3 (sem scroll)
Status: aprovado
Atualizado em: 2026-08-02
Issue: #249
Intenção: docs/plans/inicio-acoes-grid-2x3-mobile.md
Appetite restante: ~0,5d (layout + tests)
## Leitura da intenção
- **Outcome:** No Início mobile, as 6 ações staff aparecem numa grade 2×3 sem scroll horizontal; desktop mantém strip.
- **O que NÃO negociar:** drawer de outras rotas continua strip; catálogo/lockdown leader; long-press/tooltip.
- **O que reavaliar:** bleed `-mx-4` do B99 — removido no mobile porque a grade cabe no gutter.
## Abordagem recomendada
```mermaid
flowchart LR
Strip["CampaignHomeActionStrip"]
Strip -->|variant=responsive| R["grid lt-md / flex md+"]
Strip -->|variant=strip| S["flex + overflow-x"]
```
**Opções consideradas:** A) CSS só no strip (`grid md:flex`) | B) componente `CampaignHomeActionGrid` | C) duplicar markup no `CampaignHomeActions`
**Recomendação:** **A** — edita o dono; `variant` explícito para o drawer.
**Rejeitadas:** B (twin); C (duplica map de ações).
### Componentes / mudanças
- **`CampaignHomeActionStrip`** (`src/components/campaign/dashboard/CampaignHomeActionStrip.tsx`): prop `variant?: 'strip' | 'responsive'` (default `'responsive'`). Responsive: `grid grid-cols-2 gap-3` + sem overflow no mobile; `md:flex md:overflow-x-auto` + pan handlers. Strip: comportamento atual.
- **`CampaignHomeActionButton`** (`CampaignHomeActionButton.tsx`): `actionControlClassName` ganha `w-full md:w-[5.5rem]` quando pai é responsive (via prop `layout` ou classe compartilhada exportada).
- **`CampaignHomeActions`**: passa `variant="responsive"` (explícito).
- **`CampaignQuickActionsDrawer`**: passa `variant="strip"`.
- **`CampaignHomeLayout`**: `home-actions` perde `-mx-4 w-[calc(100%+2rem)]` no mobile; bleed só se strip voltar (não neste slice).
- **Migration:** sem migration.
- **UI:** Impeccable B — craft; sem novo token.
### Dados → forma
N/A — launcher estático.
## Fases verificáveis
1. **Strip + button** — `variant` + classes grid/strip; drawer `variant="strip"`.
2. **Layout + tests** — remover bleed mobile; unit layout/strip; e2e 6 ações visíveis em 390px.
3. **Gates** — `pnpm gate:fast`; `pnpm push`.
## Rabbit holes / Não escopo (engenharia)
- Extrair tile genérico wizard/home.
- Grid no drawer.
- Mudar tamanho do círculo sem pedido de produto.
## Riscos e mitigação
- **Pan handlers em grid mobile:** inofensivos (sem overflow); não montar scroller ref em grid se simplificar.
- **Teste bleed antigo:** atualizar spec `campaignHomeLayout` para refletir gutter no mobile.
## Aceite de engenharia
- [x] Aceite de produto da intenção ainda coberto
- [x] Invariantes AGENTS/engineering-standards
- [x] Testes de domínio previstos (unit/int) onde access/write paths mudam
Self-score decision-quality: 5/5