teqo-backup/docs/plans/inicio-strip-bleed-delta-flat.md
Francisco Ignácio Fontoura Solla 1a4b5b6273 docs(plans): register B109–B111 mobile drawer and Início polish
Capture confirmed product feedback as trackable plans linked to #148–#150.
2026-08-01 17:07:04 -03:00

117 lines
6.3 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.

# Início — strip edge-to-edge de verdade + delta flat silencioso
Status: registrado
Atualizado em: 2026-08-01
Issue: #150
Priority: P1
Model: composer-2.5
Impeccable: B — `CampaignHomeLayout` / `CampaignHomeSummary`
Appetite: ~0,25–0,5d eng; CSS overflow + conditional delta; sem migration
Responsável: —
## Design (Impeccable)
Âncoras: `PRODUCT.md` / `DESIGN.md` · B57 delta · B99/B101 bleed · tema `campaign`.
Na implementação: craft compacto → critique → polish (iPhone estreito).
Brief:
- **Persona:** CG no Início mobile — strip deve nascer na borda; Δ só quando houve movimento.
- **Job principal:** (1) zero “trilho” branco nas laterais da strip; (2) sem traço/zero quando Δ = 0 nos últimos 7 dias.
- **Anti-goals:** mexer no drawer não-Início (**B109**); redesenhar o bloco de cobertura.
### Wireframe (texto)
```text
┌─ /campanha mobile ─────────────────────────────┐
│ Votos estimados │
│ 12.345 ← sem “−” / “0” / — │
│ quando Δ flat │
│ (se Δ≠0: ↑ 120 / ↓ 80 + “nos últimos 7 dias”)│
│ │
│[●][●][●][●]… →→→ ← cola nas bordas L/R │
│ ▲ sem faixa branca lateral │
│ ┌ Buscar … ──────────────────────────────────┐ │
└────────────────────────────────────────────────┘
```
## Dados → decisão → apresentação
- **Vou apresentar dados?** Sim — o Δ 7d (**B57**) já existe; este item só muda a **forma no estado flat**.
- **Decisões desbloqueadas:** CG: “houve movimento na semana?” — se não, não ocupar o campo visual com ruído.
- **Forma escolhida:** seta + magnitude **somente** se `delta !== 0 && delta !== null`; flat e unavailable → **omitir** o chip inteiro (e a linha “nos últimos 7 dias”). **Rejeitado:** manter `MinusIcon` / “0” / em-dash como “sinal de estabilidade” (produto pediu vazio).
- **Profile:** escalar assinado já carregado em `homeSummaryDelta`.
- **Anti-goals de dado:** não inventar sparkline; não mudar a janela de 7 dias.
## Contexto
**Bleed (B99/B101):** `CampaignHomeLayout` já aplica `-mx-4 w-[calc(100%+2rem)]` em `home-actions`, mas o wrapper `HomeChromeRetractionShell` usa **`overflow-hidden`** no filho interno (necessário à animação de retraction). Isso **clipa** o bleed e deixa as faixas do `p-4` do `CampaignContentScroll` visíveis como “barras brancas” laterais. Diagnóstico preferido vs “margin na strip” ou `overflow: visible` solto no scroller.
**Delta (B57):** `HomeSummaryDelta` renderiza `MinusIcon` + magnitude `"0"` quando `delta === 0`, e `"—"` quando `null`. Produto (2026-08-01): no estado **sem mudança**, **não mostrar nada**.
## Objetivos
- Strip de ações no Início mobile **visualmente edge-to-edge** (primeiro/último círculo na borda ou com peek de pan, sem gutter branco do padding da página).
- Quando `homeSummaryDelta === 0` **ou** `null`: não renderizar o span do Δ nem o caption do período; manter só o total.
- Quando `delta > 0` / `< 0`: setas + magnitude + caption inalterados.
- Unit: pins em `campaignHomeSummaryDelta` / render helper; layout pin se existir spec de classes.
- Guardrails: sem migration; desktop `md:` pode manter gutter; pan B67 intacto.
## Decisões travadas
- **Corrigir o clip do bleed (overflow na shell de retraction), não remover `p-4` da página.** **Rejeitado:** `p-0` global; `overflow: visible` cego no `campaign-content-scroll` (risco de spill horizontal da página).
- **Técnica recomendada:** tirar `overflow-hidden` do wrapper interno **só** do slot `home-actions-chrome` (ou estrutura em duas camadas: clip só na animação de altura, não no eixo X do bleed); validar que a retraction `grid-rows` continua sem flash. **Rejeitado:** duplicar a strip fora do scroll.
- **Flat/unavailable = omitir UI do Δ** (não `Minus` / não `—` / não `0`). **Rejeitado:** traço como “estável”; sr-only com magnitude zero (desnecessário se não há chip).
- **Item novo (B111), continuação de B99/B57 — não reabrir Issues fechadas.**
- **i18n:** helpers existentes; copy do período só quando Δ ≠ 0.
## Questões em aberto
- **Unavailable (`null`, sem histórico 7d): também omite?** **Opções:** A) omitir igual ao flat | B) mostrar “—” só nesse caso. **Recomendação:** **A** — produto pediu vazio na ausência de mudança útil; buraco de histórico ≠ seta. _(assumido)_
## Abordagem proposta
```mermaid
flowchart TB
Shell["home-actions-chrome"] --> Bleed["-mx-4 sem clip X"]
Bleed --> Strip["CampaignHomeActionStrip"]
Delta["homeSummaryDelta"] -->|!==0| Chip["seta + mag + caption"]
Delta -->|0 ou null| Hide["não renderiza"]
```
Componentes:
- **`CampaignHomeLayout.tsx`**: ajustar `HomeChromeRetractionShell` / slot actions para permitir bleed horizontal.
- **`CampaignHomeSummary.tsx`**: early-return em `HomeSummaryDelta` quando flat/unavailable; condicionar caption.
- **`campaignHomeSummaryDelta.ts`**: opcional helper `shouldShowHomeSummaryDelta(delta)`; atualizar aria tests.
- **Migration:** Sem migration.
## Dependências
- Soft: B57 ✓, B99 ✓, B101 ✓. Nenhuma dura.
## Não escopo
- Drawer não-Início → **B109**.
- Wizard return → **B110**.
- Mudar fórmula do snapshot / janela 7d.
## Rabbit holes
- **Refatorar retraction para Framer/WAAPI.** Mitigação: CSS grid rows já funciona; só isolar overflow.
- **Recalcular Δ no client.** Mitigação: só apresentação.
## Adiado com gatilho
- **Caption “sem variação” em tooltip no total.** Revisitar se acessibilidade pedir explicação sem chip visível.
## Referências
- GitHub Issue #150 (spec + frontmatter `id/depends/priority/model`)
- `src/components/campaign/dashboard/CampaignHomeLayout.tsx` — `-mx-4` + `overflow-hidden`
- `src/components/campaign/dashboard/CampaignHomeSummary.tsx` — `MinusIcon` / `—`
- `src/lib/campaignHomeSummaryDelta.ts`
- `docs/plans/strip-acoes-edge-gap-inicio.md` (B99), `delta-7-dias-estimativa-inicio.md` (B57)
- AGENTS.md — naming
- `PRODUCT.md` / `DESIGN.md`