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

Natureza deste arquivo

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

Status

• Estado do BK: concluído e regularizado documentalmente
• Responsável: codex
• Branch técnica fechada: main (commit 9d19503b9)
• Branch de regularização documental: vps/BK-148-regulariza-documentacao

Problema

• admin/modulos/campanhas/redes_sociais.php já tinha ultrapassado a faixa segura de manutenção e concentrava blocos densos demais de preparo/render.
• A próxima evolução do produto social ficaria mais arriscada sem uma primeira separação dos blocos mais seguros.
• O fechamento técnico do BK-148 ocorreu sem backlog vivo e changelog detalhado canônicos.

Objetivo

• Reduzir o risco de manutenção do módulo social sem reescrever a tela inteira.
• Extrair apenas os blocos de menor risco para helper PHP 5.6-safe.
• Registrar a trilha documental canônica do BK-148 no repositório do RNT.

Escopo entregue

• admin/modulos/campanhas/redes_sociais.php
• passou a consumir funções auxiliares para blocos visuais e de preparo de dados de menor risco;
• manteve a tela única e os fluxos operacionais existentes.
• admin/modulos/campanhas/redes_sociais_ui_helper.php
• criado como helper dedicado de UI, sem acoplar com o entrypoint AJAX de social_squad_helper.php;
• extraiu:
• get_redes_sociais_ai_bridge_state
• get_facebook_page_events_browser_fallback
• render_redes_sociais_fb_events_fallback_panel
• render_redes_sociais_radar_recomendacao_panel
• render_redes_sociais_squad_tab_content
• Documentação canônica regularizada neste ciclo:
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/LOCK.md
• docs/backlog/BK-148-modularizacao-segura-redes-sociais-fase-1.md
• docs/changelog/2026/CL-2026-03-19-BK-148.md

Fora de escopo

• Não houve modularização total de redes_sociais.php.
• Não houve mudança de comportamento funcional da UI.
• Não houve alteração em ai_copy_helper.php, sync_facebook_events.php ou métricas históricas.
• Não houve hardening de permissões/runtime nesta fase.

Validações executadas

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

Path List

• admin/modulos/campanhas/redes_sociais.php
• admin/modulos/campanhas/redes_sociais_ui_helper.php
• docs/BACKLOG.md
• docs/CHANGELOG.md
• docs/LOCK.md
• docs/backlog/BK-148-modularizacao-segura-redes-sociais-fase-1.md
• docs/changelog/2026/CL-2026-03-19-BK-148.md