Medido em probe: com export const revalidate, revalidateTag('posts') para
de regenerar a home (a rota /artigos, sem o export, convergia; a home
ficava stale para sempre). Remove o export e resolve o congelamento da
label relativa por threshold: relativa < 48h, data absoluta além (nunca
mente congelada). Spec: polling positivo do HTML da home pós-revalidate
(ISR serve stale uma vez sob carga) e about:blank antes do cleanup
(prefetch prod de links apagados = 404 no guard).
12 KiB
Impl: S1 — Seção de conteúdos na home de campanha — Artigos
Status: aprovado Atualizado em: 2026-08-17 Issue: #17 Intenção: docs/plans/secao-conteudos-home-artigos.md Appetite restante: ~1 dia eng (herdado)
Leitura da intenção
- Outcome: a home pública de campanha ganha, na 3ª posição (entre a prova social e "Por que essa eleição importa"), uma seção "Acompanhe de perto" com bento de 5 artigos (1 grande + 4 pequenos) no desktop e carrossel de 1 por tela no mobile (~390px), lendo o
postcollection com a visibilidade pública existente; sem artigos visíveis, a seção inteira é ocultada (Prova → Problema intacto). - O que NÃO negociar: zero mudança de schema/migration/Consent;
isPostVisiblefail-closed (nada de bypass dohiddeneleitoral); cache público = tagpostsexistente; o card inteiro é link para a rota canônica (getPostCanonicalPath), mesma aba; bento fixo sem paginação ("Ver artigos →" →/artigos); sem zona morta no vazio. - O que reavaliar: a hipótese "estilos no bloco
[data-theme='campaign-site']de styles.css" está certa, mas as seções atuais (campaign-problem/campaign-flags) usam altura fixa + posicionamento absoluto com geometria clampada do Penpot — o grid de conteúdo é alto e variável, então a seção nova usa flow normal com os mesmos tokens tipográficos/inset; e o carrossel mobile é navegação manual 1/tela com dots, job diferente doCampaignCarousel(auto-advance de destaques) — ver Decisão 2.
Abordagem recomendada
flowchart LR
H[page.tsx<br/>home] --> S[CampaignContentSection<br/>server]
S --> V[getVisiblePosts<br/>tag posts]
V --> SL[slice 5<br/>first post = destaque]
SL --> B[Bento desktop<br/>md+ grid 4 col]
SL --> C[CampaignContentCarousel<br/>client · <md]
B --> CARD[Card Artigo<br/>badge tipo · capa · título · meta]
C --> CARD
S -.0 visíveis.-> HIDE[(não renderiza<br/>Prova → Problema)]
Opções consideradas: A | B | C
Recomendação: A — uma seção server (CampaignContentSection) que lê getVisiblePosts(), fatia 5 e renderiza o bento desktop, com um client component pequeno (CampaignContentCarousel) só para o modo mobile (estado de scroll/índice/dots); helpers puros novos em src/utilities/posts.ts (dono de formatação de post).
Rejeitadas: B) estender CampaignCarousel com uma 3ª variant content — o contrato dele (variants problem/flags, auto-advance 4s, chips, geometria clampada pinada por e2e de swipe/geometria) não tem dots nem "1 de 5"; enfiar o modo manual 1/tela no mesmo módulo torna-o raso e arrisca os dois use-cases pinados; C) tudo client — o bento desktop não precisa de JS e ganharia re-render client.
Componentes / mudanças
CampaignContentSection(src/components/CampaignContentSection.tsx, server): dono da seção — eyebrow "Acompanhe de perto", título "A caminhada, em tempo real", subtítulo, link "Ver artigos →" (/artigos), bento desktophidden md:grid, carrossel mobilemd:hidden.data-home-section="contents"(convençãoproof/problem/flags). Renderizanullquandoposts.length === 0.CampaignContentCarousel(src/components/CampaignContentCarousel.tsx, client): snap-x mandatário 1/tela + dots-botões (aria-current) + contador "N de 5 · deslize para ver os próximos",aria-roledescription="carrossel",data-carousel="contents", respeitaprefers-reduced-motion; padrões copiados doCampaignCarousel(scrollToItem/syncActiveItem,scrollbar-hide).- Card (
CampaignArticleCard, server-friendly, dentro do section file): badge de tipo (Decisão 3), capacoverImage(next/image fill, fallback sem imagem), título, meta "há X · categoria" (Decisão 4);LinkparagetPostCanonicalPath(post), mesma aba. Variaçãofeatured(grande) só no bento. formatRelativePostDate(src/utilities/posts.ts): "hoje", "há 1 dia", "há 5 dias" viaIntl.RelativeTimeFormat('pt-BR'); novo recordPOST_TYPE_BADGE_LABELSsingular (Notícia|Campanha|Artigo|Evento).src/app/(frontend)/(home)/page.tsx: insere<CampaignContentSection />entrecampaign-proofecampaign-problem; a página passa a depender da tagposts(ISR — comportamento já desenhado para consumidores de post;afterChangedo Post/Tag já revalida).src/app/(frontend)/styles.css: classes da seção no bloco[data-theme='campaign-site'](tokens--pt-red,--campaign-surface,--campaign-line,--campaign-content-inset; tipografiacampaign-section-*); flow normal, sem altura fixa.- Migration: sem migration. Access/Consent: nenhum — leitura pública via helpers existentes.
- UI: Impeccable B — seção nova na home pública com wireframe aprovado; shape → craft → critique → polish no navegador.
Dados → forma (se aplicável)
- Forma: meta = "há X · categoria" (data relativa + categoria do post) — dados já exibidos no site, nenhum contador inventado (restrição da intenção). Rejeitadas: data longa absoluta (
formatPostDate) no card — o rascunho aprovado mostra recência, e "prova de atividade" pede relativa; contadores/visualizações — proibido pela intenção.
Decisões de engenharia
-
Carrossel mobile novo vs estender
CampaignCarousel. Opções: A)CampaignContentCarouselpróprio | B) variantcontentnoCampaignCarousel. Recomendação: A — jobs diferentes (auto-advance de destaques vs navegação manual 1/tela com indicador); o contrato atual é pinado por Penpot + e2e. Não é twin: é o mesmo padrão visual-mechanics, encapsulado por job. Alternativas rejeitadas: B porque muda contrato pinado e adiciona dots/counter/aria-current a um módulo que não os expõe. -
Badge do card. Opções: A) label do tipo do post (Notícia/Campanha/Artigo/Evento) | B) "Artigo" fixo (literal do aceite). Recomendação: A — a intenção decidiu "os N mais recentes visíveis, qualquer tipo"; com o feed misto, um badge "Artigo" sobre uma notícia seria desonesto. O aceite foi escrito assumindo artigos; o badge de tipo cumpre o mesmo papel do badge de fonte do wireframe. Alternativas rejeitadas: B porque engana no feed misto (decisão A da intenção). → Confirmar no gate (divergência de leitura do aceite).
-
Ocultação com 1–4 posts. Opções: A) ocultar só com zero visíveis; bento/carrossel se adaptam | B) exigir os 5 para renderizar. Recomendação: A — zero é o fail-closed do aceite; com 1–4, mostrar o que existe (grid auto preenche; "1 de N" no carrossel). Alternativas rejeitadas: B porque esconderia conteúdo real da campanha no meio de funil.
-
Meta relativa vs absoluta. Opções: A) relativa ("há 1 dia · categoria") | B)
formatPostDatelonga. Recomendação: A — rascunho aprovado mostra relativa; gatilho de revisitação: trocar para absoluta é uma linha se a assessoria pedir. Alternativas rejeitadas: B porque foge do rascunho e da intenção de "atividade".
Fases verificáveis
- Tracer (server + helpers):
formatRelativePostDate+POST_TYPE_BADGE_LABELSemposts.tscom unit tests;CampaignContentSectioncom bento desktop +page.tsx+ CSS mínimo; e2e empty-state (seção ausente no estado default da suite) e full-state (cria posts viagetPayload→ revalida → asserts desktop). Gates parciais: tsc + unit. - UI mobile:
CampaignContentCarousel(dots, contador, swipe) + CSS responsivo; e2e mobile (1/tela, swipe, "1 de 5", click-through para a página do artigo, post com taghiddenausente — fail-closed); cleanup + revalidação no afterAll. - Gates finais:
pnpm gate:fast(tsc, lint, format:check, knip, check:cycles),pnpm test,pnpm buildlocal, e2e completo.
Rabbit holes / Não escopo (engenharia)
- Não mexer na API de
getVisiblePosts(limite/param) para otimizar 5 de ~39 docs — custo irrelevante, outros consumidores dependem do contrato. - Não criar hooks de scroll-snap compartilhados ("DRY < 3 call sites").
- Não animar entrada da seção / parallax / prefetch de imagens (não escopo do wireframe).
- Sem "Ver todos" além do link
/artigos; sem paginação; sem curadoria manual. - YouTube/Instagram (S2/S3), share WhatsApp (S4): fora.
- Não tocar
CampaignCarousel,PostCard(editorial), nem as geometrias clampadas das seções existentes.
Ajustes pós-review (simplify, 2026-08-18)
- A11y do carrossel: foco + setas no
<ol>(ArrowLeft/Right navegam),inert+aria-hiddennos slides inativos (saem do tab order/árvore a11y),aria-live="polite"no contador, dots com contraste ≥3:1 (--campaign-muted),tabIndexsó com >1 item,motion-reducecorta o zoom da capa. - Label relativa vs ISR (testado e revertido): a primeira resposta ao congelamento da label ("há 5 minutos" gravado no HTML estático) foi
export const revalidate = 300na home — medido em prod (Next 15.4): comrevalidatetemporal,revalidateTag('posts')deixa de regenerar a home (probe manual:/artigosconvergia, a home ficava stale para sempre) — o bust por tag é o contrato documentado do site, então orevalidatefoi REMOVIDO e a solução virou threshold na formatação: relativa < 48h (drift limitado), data absoluta além (nunca mente congelada). - Fidelidade ao rascunho:
gap-2nos cards pequenos (gap-3 no featured),mt-1no header. - Spec e2e: secret espelhado da env; polling POSITIVO do HTML da home até convergir pós-revalidate (ISR serve stale uma vez sob carga; DOM carregado não refresca);
about:blankantes do cleanup (prefetch prod dos links apagados geraria 404 no guard); classe morta.campaign-contentsremovida; lock programático 700 ms (paridade com o irmão). - Decisões registradas (refusais): (a)
formatRelativePostDatenão reusaformatRelativeAge(contratos divergentes:numeric: 'auto'→ "anteontem" vs o "há 2 dias" do rascunho;roundvsfloor; fallback absoluto; futuro → "agora"; entrada string de post) — a função é pequena e os consumidores existentes doformatRelativeAge(bell/sinal/município) não podem mudar de output; (b) gutter da seção usapx-5/8/10+max-w-[1160px]em vez do--campaign-content-insetdos irmãos (layout flow do rascunho manda — o bento wide não cabe em inset de 180px); (c) "Ver artigos →" →/artigoslista só notícias com o feed misto — corte sancionado na intenção (rabbit hole "feed infinito"), link por tipo fica como opção futura.
Riscos e mitigação
- Home vira ISR (tag
posts) em produção: o build bota o estado atual;afterChangedo Post/Tag já revalida; escrita direta (seed) segue o runbook dePOST /api/revalidate. No e2e prod-mode, o teste full-state fazPOST /api/revalidate?tag=postsantes do primeirogoto(REVALIDATE_SECRET novo no webServer env do playwright) e o empty-state roda antes — ordem no arquivo garante estado. - ISR serve stale uma vez após revalidate: asserts usam
expectcom timeout/poll em vez de assert imediato. - Dois carrosséis na home (problem + contents): seletores próprios (
data-carousel="contents"), swipe e2e aponta ao track certo. - Seção em flow normal entre duas de altura fixa: nenhum e2e existente mede posição absoluta de
problem(verificado: os testes de geometria medem hero+proof e gaps relativos) — a inserção não quebra pinagem. - Falha do
getPayloadno spec (DB errado): mesmo caminho docampaignE2EFixtures(config importado +assertTestDatabasejá guarda o processo playwright).
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (bento 1+4, carrossel 1/tela, fail-closed vazio, links canônicos)
- Invariantes AGENTS/engineering-standards (sem migration/Consent/access; leitura via helpers com tag
posts; identificadores em inglês, copy pt-BR) - Testes de domínio previstos: unit (
formatRelativePostDate, labels) + e2e (empty-state, full-state desktop+mobile, fail-closedhidden, click-through, cleanup)