mirror of
https://github.com/fsolla/teqo.git
synced 2026-11-19 06:45:21 +00:00
10 KiB
10 KiB
Impl: S6 — Home de campanha sem carrossel no desktop
Status: aprovado Atualizado em: 2026-08-18 Issue: #34 Intenção: docs/plans/home-campanha-sem-carrossel-desktop.md Appetite restante: herdado (~0,5–1 dia eng; só layout, sem dados novos)
Leitura da intenção
- Outcome: no desktop (≥1024px) as seções "Por que essa eleição importa" (3 cards) e "Nossa caminhada" (6 cards) mostram todo o conteúdo de uma vez — grade estática, sem auto-avanço, sem rolagem oculta, sem indicadores/chips; mobile (<1024px) 100% preservado.
- O que NÃO negociar: mobile intocado (comportamento e geometria); mesma copy/imagens/ordem; sem redesenho de cards; seção "Acompanhe de perto" (S1) fora do escopo; zero schema/migration/ Consent/dados.
- Questões em aberto da intenção (assumidas, validar no gate): chips somem no desktop (A);
cards de bandeira com altura por conteúdo e respiro (A); breakpoint
lg= 1024px (A); a seção dos 6 cards é "Nossa caminhada" (confirmado — eyebrow atual no site). - O que reavaliar: a hipótese "variante estática em
lgdentro doCampaignCarousel" — rejeitada: oCampaignCarouselé o módulo pinado à geometria Penpot de auto-avanço (precedente S1: "not a variant ofCampaignCarousel"); o padrão consagrado no repo para "bento/grid no desktop + carrossel no mobile" é renderização-irmã com toggle CSS (hidden md:gridmd:hiddenemCampaignContentSection). Ver Decisão 1.
Abordagem recomendada
flowchart LR
subgraph page[page.tsx — server]
A[problemItems/flagItems] --> B[Grade estática desktop<br/>hidden lg:grid]
A --> C[Carrossel mobile existente<br/>lg:hidden]
end
B --> D[CampaignProblemCard / CampaignFlagCard<br/>components presentacionais compartilhados]
C --> D
E[styles.css<br/>@media min-width 64rem<br/>.campaign-flags height recalibrada] --> B
Opções consideradas: A | B | C | D
Recomendação: A — renderizações-irmãs no page.tsx (grade estática server-rendered
hidden lg:grid + carrossel atual embrulhado em lg:hidden), com os dois cards extraídos para
components presentacionais compartilhados — exatamente o padrão S1 (CampaignContentSection +
CampaignArticleCard).
Rejeitadas:
- B) track único vira grade via CSS dentro do
CampaignCarousel(lg:grid lg:overflow-visible- matchMedia para suprimir JS/a11y no desktop). O S1 já rejeitou estender esse módulo para um
layout diferente ("pinned to the Penpot auto-advancing geometry"); a troca de semântica a11y
(
aria-roledescription="carrossel", "N de M") não é expressável em CSS — exigiria estado de matchMedia com flip pós-hidratação — e o componente é pinado por unit + e2e de swipe.
- matchMedia para suprimir JS/a11y no desktop). O S1 já rejeitou estender esse módulo para um
layout diferente ("pinned to the Penpot auto-advancing geometry"); a troca de semântica a11y
(
- C) desmontar o carrossel no desktop (wrapper client com matchMedia). Custo: componente
wrapper novo + dupla renderização pós-hidratação para matar um timer invisível de ~1 re-render/
4s numa subárvore
display:none— o mesmo custo que o S1 já aceita (carrossel montado oculto no desktop, sem timer por não ter auto-avanço). Não vale o movimento. - D) duplicar o JSX dos cards inline no
page.tsx(grade copiada, carrossel intocado). Cria duas fontes de verdade do markup do card (~50 linhas) com risco de drift em qualquer mudança visual futura. O S1 extraiu o card (CampaignArticleCard) — a extração é o dono do concern.
Componentes / mudanças
CampaignProblemCard(src/components/CampaignProblemCard.tsx, server/presentacional): o artigo do cardproblem(imagemfill/imageFrame, gradiente, título+corpo overlay) — extraído verbatim dolido carrossel; recebeitem(CampaignCarouselItem).CampaignFlagCard(src/components/CampaignFlagCard.tsx, server/presentacional): o artigo do cardflags(título+corpo) — extraído verbatim; recebeitem+ propsize: 'compact' | 'spacious'(paddingpx-3.5 py-2.5no carrossel — mobile intocado — ep-4na grade, conforme o rascunho UI aprovado).CampaignCarousel(src/components/CampaignCarousel.tsx): SÓ re-roteia o markup dos cards para os dois components extraídos; classes, estado, timers e a11y byte-idênticos. Unit tests existentes permanecem sem mudança.page.tsx(src/app/(frontend)/(home)/page.tsx): dentro de cada wrapper absoluto existente (.campaign-problem-carousel/.campaign-flags-carousel), renderiza:- grade desktop:
<div class="hidden lg:block px-(--campaign-carousel-inset)">→<ol data-grid="problem|flags" class="grid grid-cols-3 gap-[21px]|gap-[14px]">com os components de card (lih-[437px]no problem; altura por conteúdo no flags); - carrossel: wrapper
<div class="lg:hidden">→CampaignCarouselinalterado.
- grade desktop:
styles.css(src/app/(frontend)/styles.css): sob@media (min-width: 64rem)recalibra apenas.campaign-flags { height: clamp(…) }— a grade problem mantém a geometria atual (top 191 + 437 + 31px de respiro já existentes). A altura do flags vira clamp fluido entre âncoras medidas no browser (pior caso ~1024px: corpos de 3 linhas; caso largo: 2 linhas); o mobile (<64rem) fica intacto.- Migration: sem migration. Access/Consent: n/a. UI: Impeccable B — shape → craft (browser, viewports 1024/1280/1440/1920) → critique (agente design-vision sobre screenshots) → polish.
Dados → forma
- Sem dados novos — itens já existem (
problemItems/flagItems). Forma: grade estática com os mesmos cards; sem contadores, sem elementos novos (restrição da intenção).
Fases verificáveis
- Extração dos cards (tracer/refactor neutro) — criar
CampaignProblemCard/CampaignFlagCard, re-rotear oCampaignCarouselpara usá-los;pnpm test(unitcampaignCarouselverde, sem diff de comportamento) prova a neutralidade. - Grades no
page.tsx+ toggle CSS — wrappershidden lg:block/lg:hidden,data-grid, gridsgrid-cols-3; verificação visual no browser (dev server da worktree). - Altura do flags em desktop — medir a grade (2 linhas) em 1024/1280/1440/1920 no browser,
fixar o clamp fluido em
styles.css; conferir respiro ≥ 24px em todas as larguras. - e2e — reescrever
auto-advances and keeps carousel controls synchronized(tests/e2e/frontend.e2e.spec.ts): no viewport desktop → grade estática (3 cards numa linha, 6 cards 3×2), semaria-current, chips/carrossel ocultos; resize mobile → auto-avanço e chips sincronizados continuam. Teste novo de geometria desktop (respiro bottom ≥ 24, sem overflow horizontal em 1024/1280/1920). Swipe mobile e demais testes intocados. - Gates —
pnpm gate:fastna iteração;pnpm push+ changelog OPS44 na entrega.
Rabbit holes / Não escopo (engenharia)
- Não redesenhar o card problem no desktop (draft mostra card redesenhado com imagem 280px + texto abaixo — é esboço; a intenção corta "redesenho de cards"; mantém o overlay atual).
- Não mexer em hero/prova social/S1; não tocar na geometria mobile das seções.
- Não desmontar o carrossel no desktop via wrapper client (Decisão 1-C rejeitada) — o guard de
display:noneno auto-avanço já elimina o churn do timer oculto sem mover o componente.
Riscos e mitigação
- Regressão mobile: componente e CSS mobile intocados + pinos existentes (mobileSpacing @430, swipe @430, spacing tests) verificam.
- Altura do flags errada no desktop: âncoras medidas no browser (não chutadas) + e2e de respiro asserta o invariante (bottom ≥ 24) em vez de pixels fixos; clamp com folga.
- Cards problem estreitos em 1024 (≈207px de coluna): tradeoff assumido da intenção ("cards preenchendo a coluna"); texto é overlay absoluto no bottom do card fixo 437px — sem clip; verificado visualmente na craft.
- Duplicação de DOM (grade + carrossel oculto): mesma que o S1 já aceita; o carrossel oculto
fica fora da árvore a11y (
display:none), sem foco, sem movimento visível. O timer de auto-avanço do carrossel oculto foi morto por guard dedisplay:noneno effect (pós-simplify).
Pós-simplify (3 reviewers) — aplicado
lg:órfãos removidos doCampaignCarousel(o carrossel nunca renderiza ≥1024px agora).- Grade duplicada extraída em
CampaignCardGridlocal nopage.tsx(fonte única do contrato). overflow: hiddenna seção flags ≥64rem — zoom de texto ≥125% clipa na banda em vez de pintar sobre o footer.- Guard de
display:noneno auto-avanço do carrossel (jsdom não computadisplay:none— unit tests preservados). - e2e:
document.fonts.readyantes das medições; eixo x no grid problem; pinoscrollHeight ≤ clientHeight(sem rolagem oculta); comentário do clamp com âncoras.
Débitos (triage autônoma)
- Registrado: Issue #58 (S6-FOLLOWUP, kind defect,
depends: [S6]) — a CLI do Playwright 1.58.2 ignora--grep/posicionais epnpm test:e2e:affectedroda a suíte completa silenciosamente (plano:docs/plans/s6-followup-playwright-filtros-cli-ignorados.md). - Defer (gatilho): literais de gap da grade (
gap-[21px]/gap-[14px]) não referenciam a geometria do carrossel — gatilho: recalibração Penpot da geometria do carrossel. - Descartado: contratos de tipo dos cards (armadilha knip; structural typing ok), aria-labels duplicados (copy pinada no e2e), DOM duplicado sem CSS (tradeoff S1 consagrado), tablet 768–1023 sem pino e2e (S6 não tocou <1024).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (grade desktop, mobile 100% preservado)
- Invariantes AGENTS/engineering-standards (sem migration/Consent; identificadores em inglês; copy pt-BR intocada)
- Unit
campaignCarouselverde sem edição; e2e frontend reescrito cobre grade desktop + carrossel mobile;pnpm test,pnpm test:e2e, lint/format/tsc/knip/cycles verdes - Changelog OPS44 (
docs/changelog/2026-08-18-s6.md+pnpm changelog:build)
Self-score decision-quality: 4/5 — opções explícitas com razões + precedente do repo; rejeitadas documentadas; fases verificáveis; único salto medido (altura do flags) fica pinned por e2e de invariante em vez de pixel mágico.