BK-160 · Carrossel semanal cover por peça

Natureza deste arquivo

• Este backlog vivo documenta o ajuste visual do cron semanal de redes sociais que hoje monta um mosaico 3x3 por página e precisa exibir uma peça por slide usando a capa oficial.

Status

• Estado do BK: em execução
• Responsável: codex
• Branch técnica: vps/BK-160-carousel-semanal-cover-por-peca

Problema

• O cron sync_facebook_events.php gera um carrossel que compacta até nove peças em um mesmo quadro, resultando em uma imagem de thumb que não representa a arte principal de cada espetáculo e prejudica a leitura visual no feed do Facebook/Instagram.
• O Instagram ainda tenta replicar esse mosaico, reforçando a necessidade de ajustar o payload antes de enviar os slides.
• O approval semanal via WhatsApp/link também saía cego para o operador: o JSON do weekly carousel ficava sem mídia útil e a tela de aprovação não mostrava todas as imagens do carrossel.
• A seleção semanal ainda precisava respeitar explicitamente a janela de temporada (inicio_temporada / fim_temporada) e exibir sessões com dia da semana por extenso, não apenas data e hora.
• O recorte semanal não pode ser ampliado para o universo de eventos.php: ele precisa continuar preso às peças vendidas/operadas via pecas.php, preservando a regra (p.id_produtor IS NULL OR p.parceria_online = 1) e só endurecendo a janela de temporada.
• O weekly comercial não deve depender de existir linha em tab_sessoes para a semana; ele precisa espelhar a vitrine de pecas.php para a segunda-alvo, usando as sessões apenas como enriquecimento de texto quando existirem.
• A operação também pediu nova cadência de approval:
• domingo: WhatsApp com link de approval do carrossel comercial de segunda;
• segunda: WhatsApp com link de approval do carrossel editorial de quarta.

Objetivo

• Reescrever o compositor do carrossel semanal para produzir até 10 slides full-bleed, cada um ocupando 1080x1350 e usando a capa da peça como imagem de fundo, mantendo rolagem lateral nativa e compatibilidade com as APIs de álbum do Meta.

Escopo

• admin/cron/sync_facebook_events.php — limitar a seleção a 10 peças elegíveis, gerar uma imagem única por peça (vide buildWeeklyCarouselSlides) e manter o payload com items[] ocupando os novos arquivos.
• admin/cron/sync_facebook_events.php — reaproveitar o payload visual do weekly carousel no approval, preencher preview real do primeiro slide e preservar a aprovação humana como gate antes do publish.
• admin/cron/sync_facebook_events.php — filtrar o carrossel semanal pela janela real da temporada e formatar sessões como sabado (28/03) as 20:30h, evitando peças fora da semana alvo sem romper o filtro de pecas.php.
• admin/cron/sync_facebook_events.php — permitir weekly comercial com apenas 1 peça elegível, trocando a headline para PROMOÇÃO DA SEMANA! no singular quando aplicável.
• admin/modulos/campanhas/aprovar_squad.php — renderizar a galeria completa dos slides do carrossel na tela de aprovação da Central de Redes Sociais.
• admin/modulos/campanhas/action_squad.php — manter o refresh/correção coerente com headline singular/plural e com os tipos semanais de approval.
• includes/inc_palcofan.php — endurecer o render das estrelas e do CTA de avaliação para não depender visualmente do Font Awesome e não sumir em mobile/browser antigo.
• docs/BACKLOG.md — registrar o BK-160 entre os itens ativos do backlog.
• docs/CHANGELOG.md — documentar o resultado final do BK.
• docs/LOCK.md — registrar e depois atualizar o lock desta execução.
• docs/backlog/BK-160-carousel-semanal-cover-por-peca.md — backlog vivo atual.
• docs/changelog/2026/CL-2026-03-25-BK-160.md — changelog detalhado que será entregue ao final.

Validações obrigatórias

• php -l admin/cron/sync_facebook_events.php
• php -l admin/modulos/campanhas/aprovar_squad.php
• git diff --check

Path List

• admin/cron/sync_facebook_events.php
• admin/modulos/campanhas/aprovar_squad.php
• docs/LOCK.md
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/backlog/BK-160-carousel-semanal-cover-por-peca.md
• docs/changelog/2026/CL-2026-03-25-BK-160.md