BK-198 - Documentacao canonica da arquitetura Meta Pixel e GTM

Contexto

• O time precisou redescobrir varias vezes, em dias seguidos, quais pixels o site realmente usa, quais sao legados, quais estao no GTM e quais estao no codigo local.
• O problema nao e apenas tecnico; e de governanca e memoria operacional.
• O BK-196 produziu a RCA inicial. Este BK existe para transformar essa RCA em documentacao canonica reutilizavel.

Objetivo

• documentar a arquitetura atual de tracking Meta/GTM do site
• registrar a decisao canonica do pixel principal
• registrar quais pixels sao legados, externos, proibidos ou pendentes
• documentar o que foi feito agora e o que podera ser feito no futuro

Escopo

• meta-analytics.php
• peca.php
• pedido.php
• confirm_pagamento.php
• GTM-KTLMMVG
• backlog vivo e changelog detalhado relacionados

O que precisa ficar documentado

1. Estado atual

• quais pixels existem no codigo local
• quais pixels existem no GTM
• quais warnings apareceram no console
• qual e a fonte canônica atual do pixel principal

2. O que foi feito

• correcoes locais de helper e tracking
• RCA da duplicidade
• decisao arquitetural atual

3. O que fica para frente

• possibilidade de migrar Meta para GTM-only
• pre-condicoes dessa migracao
• criterios para decidir se a migracao vale a pena

4. Como validar no futuro

• arquivo local para inspecionar primeiro
• container GTM para inspecionar
• sinais de console que indicam drift

Proximo passo

• consolidar um documento canônico de arquitetura/operacao
• deixar linkado no backlog/changelog e, se fizer sentido, em documentacao tecnica

Critério de aceite

• existe uma fonte documental unica que evita redescoberta futura
• a decisao atual e o plano futuro ficam separados com clareza
• a proxima sessao consegue retomar o tema sem nova arqueologia de codigo