3.8 KiB
Build resiliente ao global metadata ausente
Status: entregue
Atualizado em: 2026-07-27
Item do roadmap: docs/roadmap.md (Site público → Próximos)
Impeccable: A — N/A (sem superfície visual; só <head> / JSON-LD)
Appetite: ~0,4–0,5d eng (auditoria ampliou o escopo do roadmap de ~0,25d)
Responsável: —
Dados → decisão → apresentação
Dados: N/A — a entrega só evita crash no prerender e omite canonical/OG quando não há URL; não apresenta métrica, mapa, série nem ranking.
Contexto
Fonte: simplify B16 (2026-07-25) — build local morreu no prerender de /abaixo-assinado/[id] porque stripTrailingSlash(globalMetadata.URL) recebia undefined (global vazio ou entrada de unstable_cache gravada vazia). rm -rf .next contornava o cache envenenado, mas o código continuava frágil.
Auditoria na implementação (2026-07-27) achou o mesmo padrão nas três rotas de posts (/[type], /[type]/[category], /[type]/[category]/[slug]) e nos acessos a openGraph.siteName / twitter.creator / keywords.map — corrigir só URL em só uma rota não desbloqueava o build.
Objetivos
next builddegrada em vez de morrer quando o globalmetadataestá vazio.- Cadeia de URL:
global.URL→NEXT_PUBLIC_SITE_URL→ omitir canonical / Open Graph url / JSON-LD url. - Defaults textuais (
siteName,title,description,twitterCreator) centralizados; layout deixa de hardcodarhttps://jorgesolla.com.brcomo fallback de OG url. - Todo consumidor do global passa por
resolveSiteMetadata(guard emcodebaseConventions).
Decisões travadas
- Escopo = 4 rotas + layout + todos os campos frágeis, via resolver em
src/utilities/seo.ts. Rejeitado: literal do roadmap (sóURLem/abaixo-assinado/[id]) — o build ainda quebraria nas rotas de post e noopenGraph.siteName. siteUrl === null→ omitir, não inventar domínio. Rejeitado: cair sempre emhttps://jorgesolla.com.br(o layout antigo mentia canonical em banco vazio) e omitir sem tentarNEXT_PUBLIC_SITE_URL(o segundo degrau cobre build local com env).- Impeccable A. Softened
[&_blockquote]:border-l-4→border-lna página de artigo só porque o design hook bloqueava o write SEO; alinhado ao padrão já usado na página de abaixo-assinado.
As-built
resolveSiteMetadata+SITE_METADATA_DEFAULTSemsrc/utilities/seo.ts.- Consumidores:
layout.tsx,abaixo-assinado/[id]/page.tsx,[type]/page.tsx,[type]/[category]/page.tsx,[type]/[category]/[slug]/page.tsx. - Cópias locais de
stripTrailingSlash/truncate/toAbsoluteUrlna página de abaixo-assinado removidas. - Pins:
tests/unit/siteMetadata.unit.spec.ts,tests/int/siteMetadataFallback.int.spec.ts, guard emtests/unit/codebaseConventions.unit.spec.ts.
Verificação
tsc --noEmit,lint(0 warnings),format:check,check:cycles(0), unit 548, int do pin (3) + petition layout (4),pnpm buildlocal verde (84 páginas estáticas geradas).- knip: P3 pré-existente (
payload.config.tsnão carrega). - Aikido: 0 findings novos;
dangerouslySetInnerHTMLem JSON-LD / Lexical é pré-existente (CMS/admin-controlled + escape de<no JSON-LD do artigo).
Não escopo
- Fallbacks dos globais
home/site-settings(já usam?./??). - Textos finais de privacidade / O0+ (item separado no roadmap).
- Popular o global
metadatano seed (o app falha fechado de propósito no SEO, não no HTML).
Revisões
- 2026-07-27 — entrega: escopo ampliado na auditoria; as-built acima.