# 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`