BK-144 · Servico criativo social com review interno antes do WhatsApp

Natureza deste arquivo

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

Status

• Estado do BK: concluido em 2026-03-18
• Responsavel: codex
• Branch: vps/BK-144-story-draft-proof

Problema

• O fluxo do RNT ja tentava usar IA para copy, mas dependia de CEREBRO_COPY_ENDPOINT/RNT_AI_COPY_ENDPOINT e caia em missing_endpoint, deixando o approval do WhatsApp preso em fallback generico.
• Faltava um gate interno antes do WhatsApp para reduzir criativos absurdos e preservar contexto de texto + midia.
• O Studio/Cérebro ja tinha runtime e roteador suficientes para rodar geracao e revisao, mas nao havia um servico local simples para o PHP legado consumir.

Objetivo

• Entregar um servico local no Cérebro que gere copy social, rode review interno e devolva um pacote estruturado para o RNT.
• Permitir consumo local por HTTP e por script/CLI, sem depender de endpoint externo preconfigurado.
• Preparar o terreno para o fluxo canonico: criativo -> review interno -> WhatsApp -> agenda -> draft/post -> conferencia final.

Escopo entregue

• Novo servico local kernel/social_creative_service.js com:
• geracao de copy por canal;
• review interno textual;
• 1 rodada automatica de rework quando o review interno reprovar;
• retorno estruturado com captions/mensagens, review, selected_media, selected_media_reason, creative_direction e commercial_summary.
• Nova rota local no Studio:
• POST /api/social-copy
• autorizacao por loopback ou Bearer token quando configurado.
• Hardening operacional:
• fallback degradado quando o reviewer nao devolve JSON valido;
• review visual complementar cai em skipped quando indisponivel, sem quebrar o gate principal.

Path List

• docs/LOCK.md
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/backlog/BK-143-reconciliar-squad-whatsapp-flow.md
• docs/backlog/BK-144-servico-criativo-social-review-interno.md
• docs/changelog/2026/CL-2026-03-18-BK-143.md
• docs/changelog/2026/CL-2026-03-18-BK-144.md
• studio/server.js
• kernel/social_creative_service.js

Validacoes executadas

• node --check /root/cerebro/kernel/social_creative_service.js
• node --check /root/cerebro/studio/server.js
• smoke HTTP local em POST http://127.0.0.1:9903/api/social-copy
• smoke real do servico com payload social da peca 1341, retornando copy ai_reviewed_local com review aprovado
• git diff --check

Proximos passos documentados

1. endurecer o BK-132 ate o profile de Story gerar draft/prova com estabilidade suficiente para operacao sem babysitting.
2. expandir o follow-up do BK-128 para review visual senior real quando a credencial/imagem multimodal estiver operacional no ambiente.
3. fechar no RNT o passo pos-publicacao por canal: WhatsApp com draft_url, post_url ou evidencia final assim que o item for realmente publicado.