teqo-backup/docs/changelog/2026-09-19-s19.md

1 line
2.6 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

**S19 — Links de compartilhamento com miniatura personalizada (2026-09-19):** a comunicação do mandato passa a criar no admin (`Publicações › Links de compartilhamento`) um `shareLink` — slug, destino externo, título, descrição e imagem — e a URL curta `jorgesolla1313.com.br/<slug>` serve HTML próprio com o cartão OG configurado (o crawler do WhatsApp lê título, descrição e imagem do nosso HTML) enquanto a pessoa que clica cai no destino sem interstício: 200 com `generateMetadata` (Open Graph `website`, Twitter `summary_large_image`, canonical da URL curta, `noindex,nofollow`) + `<meta http-equiv="refresh">` e `location.replace` inline (o 307 server-side faria o crawler seguir e perder o cartão); sem imagem configurada, o `resolveShareLinkOgImageUrl` cai na imagem padrão do global `metadata` e nunca emite URL relativa. A rota vive dentro do segmento dinâmico existente `[type]` (o Next 15.4.11 recusa `[slug]` paralelo, E337): quando o valor não é um post type, o dono do segmento consulta `getCachedPublishedShareLinkBySlug` (`unstable_cache` sob a tag de listing `shareLinks`, revalidada nos hooks `afterChange`/`afterDelete` da collection) e responde a mesma tela 404 para link despublicado, inexistente ou destino inválido. Modelo: `slug` único/indexado (slugify do título quando vazio, formato kebab-case, reservados com drift test contra os segmentos estáticos de `src/app/(frontend)` e contra `POST_TYPES`), `destination` só `http`/`https` (`^https?://` + parse, mensagens pt-BR claras), `title` ≤90, `description` ≤160 e `published` default `false` (kill switch; leitura anônima fail-closed por `where published: true`, escrita por `canManagePublishedContent`) — sem analytics/UTM, sem Consent/Contact e sem migration além da tabela aditiva `add_share_link` (a migration nova também corrige o snapshot perdido de `reel.source_hash` que a `add_recording` tinha deixado para trás, sem reexecutar SQL). Instruções de imagem/título/descrição e o cache do WhatsApp ficam nos `admin.description` do formulário. Testes: 4 unit da lib pura + 2 de drift, 16 int (validações, slugify, unicidade, kill switch, loader, access anônimo × editor, fallback de imagem com mock do global e revalidação da tag) e e2e `frontendShareLink` novo (OG e no-JS por meta refresh no navegador real, 404 uniforme, ciclo 404→200) — pinado no manifesto da área e no conjunto curado OPS86 (a migration torna o PR high-risk). Verificação: `pnpm gate:fast` verde (4096 unit), int e e2e da superfície verdes, `curl` manual conferindo `og:*`, `noindex` e `refresh`.