BK-146 · Curadoria executiva do plano de melhoria social (Cerebro + Squad + RNT)

Natureza deste arquivo

• Este backlog vivo consolida a analise validada no codigo real e a traduz para uma fila de BKs executavel.
• O objetivo nao e reabrir trabalho ja entregue; o objetivo e corrigir diagnosticos incompletos, evitar duplicacao e ordenar os proximos passos com menos risco.

Status

• Estado do BK: concluido em 2026-03-19
• Responsavel: codex
• Branch: vps/BK-146-curadoria-plano-melhoria-social
• Estado documental: pronto para fechamento

Problema

• Uma analise externa trouxe bons sinais, mas misturou fatos corretos, leituras desatualizadas e algumas conclusoes que nao batem com o estado atual do codigo.
• Sem essa curadoria, o risco operacional e abrir BK para entregar algo que ja existe, subestimar dividas reais do Cérebro ou atacar o monolito errado primeiro.
• O stack social hoje ja tem partes importantes entregues no RNT e no Cérebro, mas ainda falta um plano unificado que respeite:
• o backlog local do RNT;
• o roadmap multiagente do Cérebro;
• o fluxo real Squad -> WhatsApp -> fila/agendamento -> rascunho/prova -> publish.

Objetivo

• Registrar o que foi validado no codigo como fato.
• Marcar explicitamente o que nao deve ser reaberto como se ainda estivesse faltando.
• Reordenar os proximos BKs em uma sequencia mais segura, incremental e alinhada ao estado real de cerebro, studio e rionoteatro.

Evidencias confirmadas nesta curadoria

• O RNT continua com concentracao critica de codigo em admin/modulos/campanhas/redes_sociais.php e admin/cron/sync_facebook_events.php.
• O Cerebro esta mais saudavel que o legado PHP, mas nao e um kernel "pequeno": kernel/index.js e studio/server.js concentram bastante responsabilidade.
• O endpoint de saude do Studio ja existe (/healthz, /health, /status), assim como o endpoint POST /api/social-copy.
• admin/cron/ai_copy_helper.php ja possui fallback HTTP -> bridge local e tratamento de timeout/parse.
• A workspace Squad Social ja existe no RNT e fala com o gateway WS do Cérebro via social_squad_helper.php + redes_sociais_squad.js.
• O loop de metricas nao nasce do zero: o RNT ja tem sync_social_metrics.php, tabela social_post_metrics_history e radar operacional em redes_sociais.php.
• O backlog central ja referencia o backlog local do RNT e o roadmap multiagente; o problema agora e harmonizacao e priorizacao, nao ausencia total de indice.

O que NAO deve ser reaberto como se estivesse faltando

• Nao abrir BK para "criar healthcheck do Cérebro do zero". O healthcheck ja existe; o que falta e exibi-lo no fluxo operacional certo.
• Nao abrir BK para "extrair redes_sociais_squad.js do PHP". O JS ja esta separado em arquivo proprio.
• Nao abrir BK para "criar metricas sociais do zero". O historico por queue_id ja existe e o RNT ja usa snapshots.
• Nao abrir BK para "criar integraçao interativa do squad com o Cérebro". A workspace via WebSocket ja esta entregue.
• Nao tratar relay inbox/outbox como se fosse o unico caminho vigente do Squad Social. Ele existe, mas nao representa sozinho o fluxo interativo atual.
• Nao assumir que o Cérebro esta sem divida tecnica. O Node esta melhor que o PHP legado, mas ainda precisa fatiar arquivos grandes e melhorar observabilidade de produto.

Fila executavel corrigida

Pre-condicao operacional ja existente

1. BK-105 no RNT continua como proximo passo operacional local para fechar prova/publish de Story assistido sem quebrar o fluxo atual.

Novos BKs propostos apos esta curadoria

1. BK-147 · Saude e modo degradado da ponte social

• Motivo: o endpoint ja existe, mas o operador ainda nao ve claramente saude, fallback e erro atual da ponte no lugar onde trabalha.
• Escopo:
• exibir badge/estado de saude do Cérebro na Central de Redes Sociais;
• expor ultimo erro util da geracao de copy e informar quando o helper caiu em fallback local;
• evitar falha "silenciosa" para operacao humana.
• Dependencias: nenhuma alem do estado atual.
• Nao inclui: criar novo runtime paralelo de health.

1. BK-148 · Modularizacao segura de redes_sociais.php (fase 1)

• Motivo: o arquivo de 5k+ linhas e o maior risco de manutencao do produto social.
• Escopo:
• extrair primeiro os blocos de menor risco: radar de metricas, cards de fallback browser/prova e bootstrap/render da aba Squad;
• manter a tela unica enquanto a logica vai para helpers/includes PHP 5.6-safe.
• Dependencias: BK-147 idealmente fechado para nao refatorar sem observabilidade.
• Nao inclui: "big bang rewrite" do modulo inteiro.

1. BK-149 · Hardening de permissoes e arquivos runtime do social

• Motivo: relay com 777 documentado e padroes 0777/0666 em rotinas sociais continuam sendo divida objetiva.
• Escopo:
• endurecer permissoes do relay e dos diretorios/arquivos runtime do fluxo social;
• documentar checklist operacional e rollback;
• alinhar o codigo do cron com a politica canonica de permissao.
• Dependencias: alinhamento com operacao/infra.
• Nao inclui: mudanca cega de owner/grupo sem plano.

1. BK-150 · Fechar o loop de metricas do Squad com social_post_metrics_history

• Motivo: a coleta ja existe, mas ainda nao retroalimenta o artefato aprovado nem a proxima execucao.
• Escopo:
• anexar snapshot de performance ao artefato final do squad;
• usar metricas resumidas em memoria/review de proximas runs;
• ligar o radar do RNT com o runtime do Cérebro.
• Dependencias: BK-147 para observabilidade e preferencialmente BK-148 parcial.
• Nao inclui: nova tabela de metricas do zero.

1. BK-151 · Brand profile bootstrap do RNT

• Motivo: o squad ainda trabalha com contexto disperso de marca, campanha e CTA.
• Escopo:
• consolidar perfil inicial de marca/voz/ICP/CTA/proibicoes;
• persistir um artefato canonico reutilizavel pelo squad.
• Dependencias: nenhuma rigida, mas rende melhor depois do BK-150.
• Nao inclui: crawler ilimitado ou "memoria magica" sem aprovacao.

1. BK-152 · Contrato unico de prova de rascunho/publish

• Motivo: o fluxo real ja chega perto disso, mas ainda falta contrato unico entre Studio, WhatsApp, fila e browser/manual step.
• Escopo:
• padronizar draft_url, post_url, screenshot/prova, status manual e checklist operacional;
• fechar o gap entre aprovacao do criativo e confirmacao de como a postagem ficou.
• Dependencias: BK-105, BK-147.
• Nao inclui: publish totalmente autonomo.

1. BK-153 · Refatoracao fase 1 de sync_facebook_events.php

• Motivo: o cron social de 4k linhas hoje e tao critico quanto redes_sociais.php.
• Escopo:
• separar planner, dispatcher, montagem de aprovacao e fluxo de fallback browser em modulos/testes controlados;
• preservar compatibilidade do PHP legado e do cron existente.
• Dependencias: BK-149 e BK-152 ajudam a reduzir risco.
• Nao inclui: migracao completa para Node em um salto.

1. BK-154 · Harmonizacao backlog central x backlog RNT x roadmap Squad

• Motivo: o indice central existe, mas ainda precisa deixar explicito o que esta entregue, parcial, follow-up e parqueado.
• Escopo:
• manter docs/BACKLOG.md como indice central;
• referenciar o backlog local do RNT como fonte de execucao do legado;
• manter o roadmap multiagente como camada estrategica, nao como terceiro backlog paralelo solto.
• Dependencias: nenhuma.
• Nao inclui: duplicar item em tres lugares com textos diferentes.

1. BK-155 · Piloto de migracao de cron social para Node

• Motivo: a migracao para Node faz sentido no longo prazo, mas comecar pelo cron mais critico e arriscado.
• Escopo:
• escolher um cron social menor para piloto controlado;
• validar contrato de entrada/saida, logs e rollback;
• so depois considerar a frente maior de migracao do sync_facebook_events.php.
• Dependencias: BK-153 ou, no minimo, entendimento melhor dos contratos do cron atual.
• Nao inclui: reescrever todo o stack social em Node imediatamente.

Parking lot consciente

• SQ-25 Designer de carrossel continua relevante, mas nao deve entrar antes de BK-147 a BK-152.
• SQ-33 Planejador semanal continua relevante, mas depende de feedback loop e contrato de publish/prova mais maduros.
• Dashboard "tudo no Studio" continua valido, mas o ganho imediato maior ainda esta no eixo operacao/saude/prova do fluxo atual.

Ordem recomendada de execucao

1. Fechar BK-105 no RNT.
2. Executar BK-147.
3. Executar BK-148.
4. Executar BK-149.
5. Executar BK-150.
6. Executar BK-151.
7. Executar BK-152.
8. Executar BK-153.
9. Executar BK-154.
10. Executar BK-155.

Decisao de backlog corrigido

• A fila social curada deste BK continua sendo exclusivamente:
• BK-105 no RNT como pre-condicao operacional local;
• BK-147 a BK-155 como frente progressiva de produto/operacao social.
• A trilha de higiene/repositorio apontada pelo auditor do RNT nao entra nesta fila de produto por padrao.
• Itens de organizacao, quarentena e limpeza segura do repositorio devem seguir em BK proprio de governanca/triagem, para nao deslocar a ordem da frente social nem misturar faxina de arvore com evolucao de operacao.
• Excecao: achados P0 de seguranca podem furar fila e ganhar BK proprio urgente, mas continuam fora do eixo BK-147 a BK-155.

Path List

• docs/LOCK.md
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/projects/rionoteatro/BACKLOG_SQUAD_SOCIAL_MULTIAGENTE.md
• docs/backlog/BK-146-curadoria-plano-melhoria-social.md
• docs/changelog/2026/CL-2026-03-19-BK-146.md

Criterios de aceite

1. docs/BACKLOG.md registrar o BK-146 como curadoria concluida e abrir a fila corrigida de follow-ups.
2. docs/projects/rionoteatro/BACKLOG_SQUAD_SOCIAL_MULTIAGENTE.md refletir explicitamente o que ja existe, o que e parcial e qual e a ordem real dos proximos BKs.
3. Este backlog vivo deixar claro o que nao deve ser reaberto como se ainda estivesse faltando.
4. docs/CHANGELOG.md e o CL do dia registrarem a entrega documental.

Evidencias previstas

• leitura integral dos documentos alterados antes e depois da edicao
• verificacao cruzada com o codigo real de cerebro, studio e rionoteatro
• comparacao com o backlog local do RNT
• git diff --check

Resultado final

• a analise externa virou backlog executavel, sem perder os sinais validos;
• os gaps reais ficaram ordenados por risco e dependencia;
• o plano passou a distinguir claramente "ja entregue", "parcial/follow-up" e "ainda nao existe".
• a fila social corrigida ficou explicitamente separada da trilha de higiene/repositorio do auditor.