BK-163 · Carrossel editorial semanal de eventos mais procurados

Natureza deste arquivo

• Este backlog vivo separa a frente editorial de conteúdo do carrossel semanal comercial de pecas.php.
• O objetivo é ter um carrossel próprio para os eventos mais procurados do site, inclusive quando não forem vendidos diretamente pelo Rio no Teatro.

Status

• Estado do BK: backlog futuro
• Responsável previsto: a definir
• Branch técnica: a abrir quando a implementação começar

Problema

• O carrossel semanal atual existe para divulgar as peças com venda/operação direta do Rio no Teatro, então não pode ser contaminado pelo universo amplo de eventos.php.
• Ainda assim, o projeto quer um segundo carrossel semanal, editorial, para gerar conteúdo sobre o que está bombando no site mesmo quando parte desses eventos não tem venda direta nossa.
• A API de carrossel do Instagram trabalha com limite operacional de até 10 itens, então a regra de curadoria precisa respeitar esse teto.

Objetivo futuro

• Criar um carrossel editorial semanal separado do fluxo comercial atual.
• Priorizar os eventos mais procurados do site usando sinais reais de audiência/comportamento.
• Garantir presença das peças com venda ativa do Rio no Teatro dentro do total curado, sem ultrapassar o teto final de 10 cards.
• Operar com approval enviado na segunda-feira e publicação agendada para a quarta-feira da mesma semana.

Fontes candidatas de ranking

• admin/modulos/dashboard/tracking.php — já agrega a tabela cliente_tracking por evento, peca_nome, peca_id e eventos como view_item / begin_checkout, servindo como base primária de popularidade semanal.
• docs/documentacao_tecnica/campanha_track/GUIA_TESTES_ROI.md — documenta a view v_ranking_fontes, útil como apoio para validar sinais de tráfego/performance quando o BK for implementado.

Regras registradas

• O weekly comercial atual de pecas.php continua separado e não deve ser alargado para este BK.
• O carrossel editorial precisa respeitar o limite total de 10 itens no feed/carrossel do Instagram.
• Se houver peças nossas com venda ativa na semana, elas devem entrar primeiro na curadoria; os demais slots são preenchidos pelos outros eventos mais procurados.
• A cadência operacional prevista é:
• segunda-feira: envio do link de approval via WhatsApp para o admin;
• quarta-feira: publicação do carrossel editorial aprovado.
• A regra exata de desempate e a janela de popularidade semanal precisam ser fechadas no início da implementação.

Checklist quando este BK for executado

• Definir a query/ranking final usando cliente_tracking como fonte primária.
• Fechar a regra de composição do top 10 total, incluindo a reserva de slots para peças com venda ativa.
• Montar capas por item usando a mesma lógica visual full-bleed do BK-160, mas em trilha editorial separada.
• Programar approval/WhatsApp e cron próprios para esse novo carrossel, sem misturar tipos de fila com planner_weekly_carousel.