teqo-backup/docs/changelog/2026-09-24-c220.md

2.9 KiB

C220 — Central de Conteúdos: o link do próprio Instagram baixa e cataloga a peça (2026-09-24): colar o link de uma peça do próprio perfil (@depjorgesolla) na Central (/campanha/comunicacao/conteudos) deixava de baixar e analisar em silêncio — virava "peça-link" sem motivo. O parse de link (lib/contentPiece.ts) passa a aceitar também a grafia que o browser copia do perfil (/<perfil>/reel/<shortcode>/, p|reel|reels|tv, com/sem www./m., query ignorada) e rejeita /stories/, instagr.am e hosts fora de Instagram/YouTube como antes; o match com a mídia oficial passa a ser pelo shortcode (o kind é apresentação — /p/ABC/ casa o reel), o que também garante que link de terceiro nunca baixa. O cliente Graph API (instagramFeed.ts) ganhou paginação por cursor com janela total declarada: maxResults continua o teto por página (50 ⇒ exatamente uma chamada, board intocado) e o resolver da peça pede 500 mídias (CONTENT_PIECE_LINK_INSTAGRAM_WINDOW, early-stop no match, paging.next ignorado de propósito — leva o token na URL); refresh de token segue o contrato do dono e o refreshedAccessToken agora é persistido best-effort pelo helper existente. Quando a extração não acontece, a resolução devolve um motivo honesto em vocabulário fechado (novo select linkFailureReason + migration 20260924_045625_add_content_piece_link_failure_reason): nao-encontrado ("Link não encontrado entre as mídias recentes do perfil"), carrossel, indisponivel e sem-credencial — com o teto de 4 GB da casa, storage e ffmpeg seguindo falhou/Reprocessar (sentinela ContentPieceMediaTooLargeError distingue o cap do transporte) e YouTube permanecendo link-only sem motivo. O job é o único escritor do motivo no write final pronto; anexar o arquivo original e o retry limpam o campo. A ficha porta o design aprovado classe-a-classe: placeholder "Buscando a mídia no perfil oficial…", barra "Procurando a publicação no perfil oficial…", card "Processamento da peça" com os três passos no desktop, card verde "Arquivo e transcrição prontos"/"Arquivo pronto" quando a mídia chega, e o card âmbar "Por que o arquivo não foi baixado" com o literal + "A peça continua disponível pelo link." + Anexar; a lista fica limpa, com o rótulo neutro "Instagram · Peça-link" no card mobile (o tipo não é repetido quando é palpite). Crítica final do designer certificada em tier primário (openai/gpt-5.6-sol) após corrigir o tracker no mobile (hidden md:block). Verificação: unit (contentPiece com parse prefixado/rejeições/labels verbatim/view model, instagramFeed com cursor/paginação/1 página no board), int (contentPiece: resolver com deps injetadas para match/carrossel/sem credencial/feed e download falhos/sentinela do teto, job/attach/retry persistindo e limpando o motivo), e2e (campaignSpeechAcervo: ficha mostra o literal, lista não), pnpm gate:fast, pnpm test:int (946) e o e2e afetado local.