7.3 KiB
Impl: Cards da seção "Acompanhe de perto": sem cantos arredondados, imagem de borda a borda, chip removido
Status: aprovado Atualizado em: 2026-08-19 Issue: #90 Intenção: docs/plans/cards-acompanhe-de-perto-polimento.md Appetite restante: herdado (~0,5–1 dia; na prática, horas)
Leitura da intenção
- Outcome: os cards da seção "Acompanhe de perto" (bento 1+4 no desktop, carrossel no mobile) passam a ter cantos retos (card e capa), capa de borda a borda, sem borda e sem sombra no card (decisão do humano em 2026-08-19, após o gate — estende o rascunho, que mantinha
border/shadow) e nenhum chip de badge — nem tipos de post do site, nem origens externas (decisão B do gate). O texto interno (título, subtítulo, meta) continua com o respiro atual (p-3) em relação às bordas. - O que NÃO negociar: nada além da superfície muda — compartilhamento (S4) usável no canto, grade do bento, carrossel, links, bandas do S5 (borda/background da seção) e o fail-closed da seção (some inteira quando nada é visível). Nada de tokens de cor, capas reais, proporções ou outras seções.
- O que reavaliar: a hipótese da intenção ("mover o padding para o bloco de texto e remover o badge; dados de badge tendem a ficar órfãos — o executor decide o que descartar"). Confirmado no código:
badgeLabelvive só no card + nas três funções de mapeamento da seção +POST_TYPE_BADGE_LABELS(com um unit test dedicado). Decisão de engenharia: remover os órfãos por completo (tipo do card, constante e teste unitário) — manter morto seria dead code flagrável pelo knip (CI-blocking).
Abordagem recomendada
flowchart LR
A[CampaignContentCard.tsx<br/>superfície do card] --> B["card: -rounded-xl -p-3 -gap<br/>capa: -rounded-lg<br/>texto: +p-3<br/>badge span: removido"]
A --> C["CampaignContentCardData<br/>-badgeLabel"]
D[CampaignContentSection.tsx] --> E["-badgeLabel nas 3 funções<br/>-import POST_TYPE_BADGE_LABELS"]
F[posts.ts] --> G["-POST_TYPE_BADGE_LABELS"]
H[postsDateFormats.unit.spec.ts] --> I["-describe POST_TYPE_BADGE_LABELS"]
J[frontend.e2e.spec.ts] --> K["badge loop: 812-814,<br/>YouTube: 952,<br/>Instagram: 1153<br/>→ ausência + raio 0"]
Opções consideradas: A (superfície no card único + remoção dos órfãos) | B (variante/flag de card, ex. variant="flat") | C (manter POST_TYPE_BADGE_LABELS e o badge no DOM com CSS oculto)
Recomendação: A — o card é o único componente da seção (bento e carrossel reusam CampaignContentCard); não há outro consumidor com cantos arredondados para preservar, então uma variante seria abstração sem dono. A remoção dos dados de badge é limpa: badgeLabel não é usado em mais nenhum lugar do repo.
Rejeitadas: B (over-engineering: nenhum outro card usa o componente; "edit the owner, don't twin"); C (dead code + dead data path; knip derruba o CI e o teste unitário continuaria pinando um contrato morto).
Componentes / mudanças
CampaignContentCard.tsx(src/components/):cardClassNamevira constante semfeatured(o único uso do param era ogap-3/gap-2;featuredcontinua dirigindosizesda imagem e oh3):flex h-full flex-col bg-white transition-shadow ...— semrounded-xl, semp-3, semgap, semborder border-(--campaign-line)e semshadow-sm/hover:shadow-md/transition-shadow. Capa: removerounded-lg(mantémoverflow-hidden— o zoom hover continua contido na própria capa). Bloco de texto: ganhap-3(flex flex-1 flex-col gap-1 p-3), igual ao draft. Badge<span>removido;badgeLabelsai deCampaignContentCardData. O anel de foco (focus-visible:ring-2 ring-(--pt-red)) do link permanece — a11y.CampaignContentSection.tsx(src/components/):badgeLabelremovido detoArticleCardData/toVideoCardData/toInstagramCardData; importPOST_TYPE_BADGE_LABELSremovido. Nada mais muda (limites, mesclagem, capas, metas).src/utilities/posts.ts: deletaPOST_TYPE_BADGE_LABELS(único consumidor era a seção;POST_TYPE_LABELSplural fica — usado nas listagens).tests/unit/postsDateFormats.unit.spec.ts: import e describe dePOST_TYPE_BADGE_LABELSremovidos.- Migration: sem migration (nenhuma mudança de schema/coleção).
- Access / Consent: nenhum.
- UI: Impeccable B — encaixe em um componente existente (shape→craft→critique→polish). O botão
ContentShareButton(S4) segueabsolute top-2 right-2sobre a capa, agora sem moldura; o draft mantém o botão no canto — sem mudança nele.
Dados → forma (se aplicável)
- N/A — nenhum dado novo; apenas remoção de um campo de superfície (
badgeLabel) do tipo de dados do card.
Fases verificáveis
- Superfície + órfãos —
CampaignContentCard.tsx,CampaignContentSection.tsx,posts.ts, unit test do badge; verificação:pnpm typecheck+pnpm test:unit(o describe removido some, o resto passa). - e2e —
tests/e2e/frontend.e2e.spec.ts: loop de badges (812–814) e as asserçõesYouTube/Instagram(952, 1153) → asserções de ausência (toHaveCount(0)para os quatro tipos + YouTube/Instagram nos testes de feed) e pin do novo visual no teste do bento (border-radius: 0pxno card e na capa,border-top-width: 0pxebox-shadow: noneno card, no mesmo espírito dos pins CSS do S5).toHaveCSScomfirst()para não quebrar com o carrossel escondido no mobile. - Gates —
pnpm lint,pnpm format:check,pnpm exec knip,pnpm check:cycles,pnpm test(unit+int). E2e roda no CI (OPS59) — local opcional compnpm test:e2e:affected.
Rabbit holes / Não escopo (engenharia)
- Não tocar
ContentShareButton,CampaignContentCarousel, banda/bordas da seção (S5),POST_TYPE_LABELS(plural),getVisiblePosts/fail-closed ou capas. O rascunho HTML do gate fica intocado como artefato — a remoção de borda/sombra é decisão do humano posterior ao gate e não altera o arquivo do rascunho. - Não criar variante de card, não esconder badge via CSS, não renomear
h3/metas. - Cuidado com o
gapremovido: omt-autoda meta continua pinando a data ao rodapé do bloco; op-3do bloco de texto é quem dá o respiro (draft).
Riscos e mitigação
- e2e que assere badge que não mapeei — verificado por grep: só 812–814 (loop), 952 (YouTube) e 1153 (Instagram) no
frontend.e2e.spec.ts;waitForHomeHTMLsó usa títulos/links de cabeçalho. Grep final antes do push. - Raio 0 pinado pelo e2e pode flake por arredondamento —
toHaveCSS('border-radius', '0px')é determinístico (nenhum token de raio no card/capa). - Dead code residual —
POST_TYPE_BADGE_LABELSebadgeLabelremovidos do mesmo PR; knip no gate confirma. - Capa sem cover (placeholder
--campaign-band) — continua com borda a borda e cantos retos, igual ao draft; nada quebra.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (raio 0 card+capa, capa borda a borda, texto
p-3, nenhum chip em nenhum card, sem borda e sem sombra no card) - Invariantes AGENTS/engineering-standards (card único como dono da superfície; S5/bandas intocadas; fail-closed da seção intacto)
- Testes de domínio previstos (unit/int) onde access/write paths mudam — N/A (nenhum write path muda); e2e atualizados para o novo estado visual