CL-2026-03-19-BK-148 · Modularizacao segura de redes_sociais.php (fase 1)

Resumo

• A fase 1 da modularização reduziu o acoplamento de admin/modulos/campanhas/redes_sociais.php sem big bang rewrite.
• Foi criado o helper admin/modulos/campanhas/redes_sociais_ui_helper.php para absorver blocos de menor risco de preparo/render.
• A tela única da Central de Redes Sociais foi preservada.

Escopo entregue

• admin/modulos/campanhas/redes_sociais.php
• passou a delegar blocos menores para helper dedicado;
• ficou menor e mais legível, preservando os contratos da tela.
• admin/modulos/campanhas/redes_sociais_ui_helper.php
• centraliza preparo do estado da ponte social;
• centraliza preparo do fallback browser de FB Events;
• renderiza o painel de fallback browser;
• renderiza o Radar de Recomendacao;
• renderiza o conteúdo superior da aba Squad Social.

Resultado técnico observado

• A manutenção do módulo social fica menos arriscada nas próximas fases.
• O helper novo evita acoplar UI HTML ao social_squad_helper.php, que já é entrypoint AJAX com Content-Type: application/json.
• O BK-148 ficou regularizado também na trilha documental canônica do repositório.

Validações

• php -l admin/modulos/campanhas/redes_sociais.php
• php -l admin/modulos/campanhas/redes_sociais_ui_helper.php
• git diff --check

Próximos passos registrados

1. BK-149: hardening de permissões e arquivos runtime do social.
2. BK-150: fechamento do loop de métricas com social_post_metrics_history.