gaas-governanca-comunicacoes
Lê a planilha de governança de links/templates do CRM (GOVERNANÇA_LINKS_E_TEMPLATES, CSV ';' latin-1), cruza os ID TEMPLATE (af_sub3) com os ACTIVITY NAME e com o Supabase (activities + communication_
SKILL.md.claude/skills/gaas-governanca-comunicacoes/SKILL.md
GitHubGaaS — Governança de Comunicações (template_id × activity_name)
Você prepara o terreno da aba Comunicações: interpreta a planilha de governança,
cruza com o histórico (activities) e o catálogo (communication_templates), e deixa
cada peça pronta para o operador só adicionar o asset (HTML/imagem).
Princípios (não-negociáveis)
- Dry-run primeiro, gravação só com aprovação. O
analyzeNÃO grava nada. Mostre o relatório ao usuário e espere o OK antes de rodarapply. - Linhas suspeitas NÃO são importadas por padrão. A inteligência de taxonomia
sinaliza; quem decide é o usuário (ver
references/taxonomia_marcas.md). - Preservar a caixa exata de template_id e af_sub3. Não normalizar silenciosamente. Antes de aplicar, conferir o contrato atual do banco; se uma constraint divergir, registrar o conflito e não alterar a identidade para contorná-la.
- Só metadados, sem link agora. Não cria
attribution_linksnem gera links. - Pré-cria templates como
draftsem asset. O asset é adicionado depois, no app.
Workflow
Analisar (dry-run):
& "C:\Users\Pablo Prado\.cache\codex-runtimes\codex-primary-runtime\dependencies\python\python.exe" .claude\skills\gaas-governanca-comunicacoes\scripts\governance_templates.py analyze "CAMINHO\DO\GOVERNANCA.csv"Gera
outputs/governance_report_<ts>.jsone imprime o resumo por status.Ler o relatório e apresentar ao usuário — contagem por status e, em especial, a lista de suspeitos com o motivo de cada um. Status possíveis:
ok— activity_name existe e taxonomia consistente → será vinculado.planejado_sem_activity— template sem activity_name ainda → cria draft, sem vínculo.activity_nao_encontrada— activity_name não existe emactivities→ cria draft, sem vínculo.suspeito— activity_name copiado entre apps OU marca divergente → não importa sem decisão.
Esperar a decisão do usuário. Não rode
applyantes de o usuário aprovar.Aplicar (grava no banco):
& "C:\...\python.exe" .claude\skills\gaas-governanca-comunicacoes\scripts\governance_templates.py apply "outputs\governance_report_<ts>.json"- Faz upsert dos templates
draft(com metadados: app, campanha, semana/af_sub2, segmento/af_sub1, nome, códigos, activity_names planejados). - Vincula
activities.template_idapenas nas linhasok. - Não importa
suspeito(use--include-suspeitosó se o usuário mandar).
- Faz upsert dos templates
Reportar quantos templates draft entraram e quantas activities foram vinculadas.
O que NÃO fazer
- Não rode
applysem mostrar o relatório e obter aprovação. - Não tente "adivinhar/corrigir" o activity_name certo — apenas sinalize (decisão do operador).
- Não crie attribution_links nem gere links AppsFlyer (fora de escopo agora).
- Não sobrescreva templates já existentes (o apply pula
template_ja_existe).
Conexão Supabase
Os scripts usam a REST API com a publishable key fornecida por SUPABASE_ANON_KEY (projeto
mipiwxadnpwtcgfcedym — "GaaS Framework Afinz"). Para sobrescrever, use
--supabase-url / --supabase-key ou as env SUPABASE_URL / SUPABASE_ANON_KEY.
Governança multifonte e links AppsFlyer
Para reconciliar SFMC, links, catálogo e cobertura de assets, ler governanca-multifonte.md. O modo de planilha acima não cria links; o modo multifonte pode preparar propostas de links, sempre sem aplicar vínculos fracos. Preservar a caixa exata de template_id/af_sub3 em ambos. O antigo nome gaas-communication-governance é um alias desta capacidade.
Configuração após instalação
Defina SUPABASE_URL e SUPABASE_ANON_KEY no ambiente (ou use as opções de linha de comando existentes). O pacote público não contém valores de chave. Acesso autenticado pode ser exigido pelas políticas atuais do banco; não contorne RLS.