BK-137 · Reconciliar fluxo Squad Social com WhatsApp, agenda e rascunho

Natureza deste arquivo

• Este backlog vivo descreve o escopo e os criterios do BK-137.
• O historico final desta reconciliacao deve virar changelog detalhado quando o BK for fechado.

Status

• Estado do BK: concluido em 2026-03-18
• Responsavel: codex
• Branch: vps/BK-137-reconciliar-squad-whatsapp-flow

Problema

• O RNT ja tem pecas importantes do fluxo social entregues em producao, mas o produto-alvo ainda nao estava escrito de forma unica: o criativo deve nascer no Squad/Cérebro, ir para aprovacao no WhatsApp do admin e, depois da agenda/manual step, voltar como prova de rascunho ou de como ficara antes do publish final.
• O backlog central do Cérebro ainda apontava BK-127 e BK-128 de modo desalinhado em relacao ao historico local do RNT.
• Sem esta reconciliacao, a frente seguinte correria o risco de misturar workspace, copy, agenda manual, notified e draft browser sem um contrato operacional unico.

Objetivo

• Alinhar o backlog do RNT ao backlog central do Cérebro para o eixo redes_sociais.php.
• Registrar o fluxo-alvo do produto social:

1. Squad monta o criativo.
2. Admin aprova o criativo via WhatsApp.
3. O item entra na fila/agendamento correto.
4. Se o canal exigir passo manual/browser, o admin recebe a conferencia do rascunho/preview antes do publish final.

• Preparar a proxima implementacao sem reabrir a workspace do Squad nem a base ja entregue de copy.

Evidencias confirmadas nesta reconciliacao

• admin/cron/sync_facebook_events.php ja cria aprovacao social via WhatsApp e grava approved_payload.
• admin/modulos/campanhas/aprovar_squad.php e action_squad.php ja permitem aprovar pelo admin e colocar o item em queued.
• admin/cron/sync_facebook_page_events.php ja produz fila runtime e create-flow em modo rascunho para Facebook Events.
• admin/modulos/campanhas/redes_sociais.php ja mostra o fallback/browser draft de Events e a fila de stories manuais/notificados.

Path List

• docs/LOCK.md
• docs/BACKLOG.md
• docs/backlog/BK-137-reconciliar-squad-whatsapp-flow.md

Criterios de aceite

1. docs/BACKLOG.md do RNT passar a registrar explicitamente esta reconciliacao como item ativo.
2. A ordem ativa do backlog deixar claro que o proximo fluxo social e WhatsApp -> agenda -> conferencia de rascunho, e nao reabrir a workspace ja entregue.
3. O backlog vivo deste BK preservar o contrato operacional para a fase seguinte.

Evidencias previstas

• leitura integral dos documentos alterados antes e depois da edicao
• comparacao com o backlog central do Cérebro
• leitura dos pontos reais de fluxo em sync_facebook_events.php, sync_facebook_page_events.php, aprovar_squad.php e action_squad.php
• git diff --check

Resultado final

• o fluxo do RNT ficou reconciliado com o contrato real do produto.
• a aprovacao do WhatsApp agora recebe copy melhor, contexto comercial mais rico e metadados suficientes para decisao humana.
• a tela/admin passou a mostrar revisao interna, midia prevista e o contexto do canal.
• o proximo passo documentado sai do campo “documentacao” e volta para endurecimento operacional de draft/post-confirmation por canal.