BK-150 · Loop de metricas do Squad com social_post_metrics_history

Natureza deste arquivo

• Este backlog vivo registra o escopo funcional e documental do BK-150.
• O histórico final desta entrega fica em docs/changelog/2026/CL-2026-03-19-BK-150.md.

Status

• Estado do BK: concluído e regularizado documentalmente
• Responsável: codex
• Branch técnica em fechamento: vps/BK-150-squad-metrics

Problema

• O RNT já possuía coleta em social_post_metrics_history, mas o approval e a próxima run do Squad não reaproveitavam esse histórico de forma útil.
• O primeiro corte do BK-150 tentou ancorar o resumo de métricas no queue_id atual, perdendo justamente o caso principal de performance anterior antes da aprovação.

Objetivo

• Anexar desempenho anterior útil ao artefato aprovado.
• Mostrar esse resumo na UI de approval.
• Repassar contexto resumido de performance para a próxima run do Squad.

Escopo entregue

• admin/modulos/campanhas/action_squad.php
• passou a gravar metrics_summary com base na última performance anterior útil por peca_id + canal compatível, excluindo o queue_id atual;
• passou a gravar current_queue_metrics separadamente quando houver métrica do próprio item.
• admin/modulos/campanhas/aprovar_squad.php
• passou a mostrar painel de desempenho anterior útil antes da aprovação, usando a mesma lógica de compatibilidade de canal.
• admin/modulos/campanhas/social_squad_helper.php
• passou a aceitar uso embedded sem responder JSON bruto;
• centralizou helpers de consulta e resumo de métricas;
• passou a injetar lastPerformance no contexto da próxima run.
• Documentação canônica regularizada neste ciclo:
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/LOCK.md
• docs/backlog/BK-150-loop-metricas-squad-social.md
• docs/changelog/2026/CL-2026-03-19-BK-150.md

Fora de escopo

• Não houve criação de tabela nova.
• Não houve criação de cron novo.
• Não houve refatoração grande do Cérebro.
• Não houve heurística preditiva nova nesta fase.

Validações executadas

• php -l admin/modulos/campanhas/action_squad.php
• php -l admin/modulos/campanhas/aprovar_squad.php
• php -l admin/modulos/campanhas/social_squad_helper.php
• git diff --check

Path List

• admin/modulos/campanhas/action_squad.php
• admin/modulos/campanhas/aprovar_squad.php
• admin/modulos/campanhas/social_squad_helper.php
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/LOCK.md
• docs/backlog/BK-150-loop-metricas-squad-social.md
• docs/changelog/2026/CL-2026-03-19-BK-150.md