- layout=grid no botão com w-full/min-w-0 sem box-content no mobile - li min-w-0, gap-2, data-layout=grid-3 no strip - e2e com geometria (boundingBox) em viewport 390 - impl plan docs/plans/inicio-acoes-grade-3cols-2rows-impl.md Co-authored-by: Francisco Solla <fsolla@users.noreply.github.com>
62 lines
3 KiB
Markdown
62 lines
3 KiB
Markdown
# Impl: Início / FAB — grade 3 colunas × 2 linhas (corrigir orientação)
|
||
|
||
Status: aprovado
|
||
Atualizado em: 2026-08-02
|
||
Issue: #302
|
||
Intenção: docs/plans/inicio-acoes-grade-3cols-2rows.md
|
||
Appetite restante: ~0,5d (causa real + testes de geometria)
|
||
|
||
## Leitura da intenção
|
||
|
||
- **Outcome:** Início mobile e overlay FAB mostram 6 ações staff em **3 colunas × 2 linhas** (verificável em viewport ~390), não 2×3; `md+` Início mantém strip.
|
||
- **O que NÃO negociar:** catálogo/lockdown; sem migration; não reabrir snap/peek; liderança sem layout paralelo.
|
||
- **O que reavaliar:** B132 já trocou `grid-cols-2` → `grid-cols-3`, mas testes só assertam `className` — a causa visual provável é **min-width dos itens da grade** (`min-width: auto` + `box-content` + `w-[5.5rem]` residual) comprimindo para 2 colunas percebidas ou clip pelo `overflow-hidden` do shell de retraction.
|
||
|
||
## Abordagem recomendada
|
||
|
||
```mermaid
|
||
flowchart LR
|
||
Strip["CampaignHomeActionStrip"]
|
||
Strip -->|grid/responsive lt-md| G["grid-cols-3 + li min-w-0"]
|
||
Btn["CampaignHomeActionButton"]
|
||
Btn -->|layout=grid| W["w-full min-w-0 border-box"]
|
||
E2E["e2e viewport 390"]
|
||
E2E --> Geo["boundingBox: 3 por linha"]
|
||
```
|
||
|
||
**Opções consideradas:** A) só reafirmar `grid-cols-3` | B) `min-w-0` + `layout=grid` no botão | C) reduzir círculo/gap
|
||
**Recomendação:** **B** — corrige sizing real sem redesign; gap-2 só se critique pedir.
|
||
**Rejeitadas:** A (já feito em B132, insuficiente); C (fora do apetite salvo falha em 390).
|
||
|
||
### Componentes / mudanças
|
||
|
||
- **`CampaignHomeActionButton`:** `layout: 'grid'` — `w-full min-w-0 max-w-full`, `box-border` (sem `box-content` na grade).
|
||
- **`CampaignHomeActionStrip`:** `li` com `min-w-0`; `layout='grid'` quando `variant` é `grid` ou `responsive`; `gap-2` no mobile grid (mais folga horizontal em 390px); `data-layout="grid-3"` no `<ul>` para e2e.
|
||
- **`CampaignQuickActionsOverlay`:** sem mudança estrutural (já `variant="grid"`).
|
||
- **Testes:** helper de geometria em e2e (`campaignHomeActions.e2e.spec.ts` + overlay em `campaignMunicipalities.e2e.spec.ts`); unit para `layout=grid` e `min-w-0` no `li`.
|
||
- **Migration:** sem migration.
|
||
|
||
## Fases verificáveis
|
||
|
||
1. **Strip + button sizing** — `layout=grid`, `min-w-0`, gap ajustado.
|
||
2. **E2e geometria** — 3 botões na primeira linha, 3 na segunda (staff); overlay FAB idem.
|
||
3. **Gates** — `pnpm gate:fast`; `pnpm push`.
|
||
|
||
## Rabbit holes / Não escopo (engenharia)
|
||
|
||
- PWA cache bust (fora do repo); se persistir pós-deploy, runbook separado.
|
||
- Refatorar `HomeChromeRetractionShell` globalmente.
|
||
- Grade em `md+`.
|
||
|
||
## Riscos e mitigação
|
||
|
||
- **Leader 2 ações:** grade 3-col deixa 1 célula vazia — aceite da intenção.
|
||
- **Desktop overlay dialog:** `layout=grid` mantém `w-full` (sem `md:w-[5.5rem]`).
|
||
|
||
## Aceite de engenharia
|
||
|
||
- [ ] Aceite de produto da intenção ainda coberto
|
||
- [ ] Invariantes AGENTS/engineering-standards
|
||
- [ ] E2e viewport 390 com geometria 3×2 (não só className)
|
||
|
||
Self-score decision-quality: 5/5
|