* deploy: limpeza pós-deploy do build cache e tags locais antigas (INF3/F2) O deploy compila no homeserver e acumulava build cache + tags locais antigas no disco raiz (incidente 19/08: 45G de cache). Após o smoke: docker builder prune -f + remoção das tags locais teqo-1313 exceto o SHA em uso (best-effort, registry preserva o rollback). * feat(S9): captura de novidades da campanha na home pública (form + CTA do hero) Seção 'Receba as novidades da campanha' acima do rodapé: nome + WhatsApp obrigatórios, e-mail/estado/cidade/comentário opcionais, toggle pré-selecionado 'Quero fazer parte do time' gravado como subscription.campaignLevel (time|esporadico). CTA secundário do hero vira o atalho (#novidades, scroll suave). Contact + Subscription em withPayloadTransaction com consentimento novo fail-closed por chave estável 'campanha-novidades' — nada é gravado sem o texto aprovado no admin. Migration 20260819_192605 (state de contact nullable + coluna campaign_level). Impl plan, changelog, int + e2e. * plans(C141,C143,C142): permissões granulares por assessor + responsáveis de demanda + UI por perfil * plans(C141,C143,C142): permissões granulares por assessor + responsáveis de demanda + UI por perfil * feat(S8): seção 'Nossa história' na home — vídeo da trajetória embutido do YouTube (Closes #91) * docs(S8): resolução do conflito com S9 (história → newsletter) + nota do guard e2e dev-only * feat(S10): pixel do Meta na página pública de campanha (campo admin em SiteSettings + PageView na home + Lead no sucesso da captura) Campo tracking.facebookPixelId no global SiteSettings (mesma validação/normalização do precedente Petition, regra centralizada em facebookPixel.ts); home (grupo (home)) injeta o base code + PageView quando o ID está configurado (fail-closed) e o CampaignNewsletterForm dispara exatamente um Lead no sucesso do S9. Migration 20260819_213947_add_site_settings_facebook_pixel_id. Closes #94 * refactor(S10): simplify pass — Lead wiring unit-tested e raças de estado compartilhado do e2e resolvidas e2e: stub hermético de connect.facebook.net no guard compartilhado (specs paralelos renderizam a home com o pixel); advisory lock no Postgres serializando o login do usuário de teste (Payload perde sessão em login concorrente read-modify-write — classe documentada no webauthn); seedTestUser vira create-if-missing (sem janela de usuário ausente nem reset de senha); Lead do form protegido do catch de erro (tracking nunca falha uma captura commitada); descrição do campo compartilhada; unidade nova campaignNewsletterLead cobre exatamente um Lead no sucesso. * feat(C141): perfis de permissão por assessor — Visão × Edição configuráveis, enforcement fail-closed (Closes #105) * chore(C141): regenera changelog agregado após rebase com S10 * plans(C144): options write-scoped para formulários de escrita pós-C141 --------- Co-authored-by: Francisco Solla <admin@solla.dev>
10 KiB
Impl: Pixel do Meta (Facebook) na página pública de campanha
Status: rascunho Atualizado em: 2026-08-19 Issue: #94 Intenção: docs/plans/pixel-meta-pagina-campanha.md Appetite restante: herdado (~0,5–1 dia eng)
Leitura da intenção
- Outcome: o time de campanha paga configura no admin um campo opcional "ID do Pixel do Meta" nas configurações do site; a home pública de campanha (
/) passa a carregar o base code +PageViewdo Meta quando o ID está presente e válido; a conclusão da captura de novidades (S9) dispara exatamente umLead. Sem ID configurado, nada é carregado (fail-closed, zero impacto). - O que NÃO negociar: persistir só o ID numérico (5–20 dígitos, sem HTML/JS colado — XSS);
Leadsomente no sucesso da captura, nunca no page load; Pixel só na página pública de campanha (não vazar PageViews de notícias/etc.); sem env var obrigatória; sem CAPI/Advanced Matching, cookie banner/CMP e dedupeventIDnesta fatia (herda gatilhos do plano da petição); cache da home revalidado pela edição do admin. - O que reavaliar: a hipótese da intenção dizia "home
src/app/(frontend)/(home)/page.tsx(injeção do<MetaPixel />)" — a injeção pode morar no layout do grupo(home)(que cobre exatamente a única rota do grupo) em vez da página; e "form de captura do S9" éCampaignNewsletterForm(cliente) — a seam doLeadé o callbackonSubmit()já previsto no impl plan do S9. A leitura do global na home é compatível com o caching:getCachedGlobal('site-settings')éunstable_cachesob a tagglobal_site-settings, já revalidada peloafterChangeexistente (a home passa a ser ISR nessa tag — mesmo padrão deSiteHeader/socialLinks).
Abordagem recomendada
flowchart LR
Admin["SiteSettings global<br/>tracking.facebookPixelId (group Rastreamento/Ads)"]
Home["(home)/layout.tsx<br/>getCampaignHomeMetaPixelId"]
Pixel["MetaPixel client<br/>next/script + fbq init/PageView"]
Section["CampaignNewsletterSection<br/>getCampaignHomeMetaPixelId"]
Form["CampaignNewsletterForm<br/>pixelId prop"]
Action["submitCampaignNewsletter"]
Lead["trackMetaLead<br/>content_name novidades-da-campanha"]
Meta["Meta Events Manager"]
Admin --> Home
Home --> Pixel
Pixel --> Meta
Section --> Form
Form --> Action
Action -->|sucesso--> Lead
Lead --> Meta
Opções consideradas: A (campo no global SiteSettings + injeção no layout do grupo (home)) · B (novo global de rastreamento dedicado) · C (injeção no page.tsx em vez do layout) · D (validate compartilhado em facebookPixel.ts vs. duplicado inline)
Recomendação: A+D — porque o dono existe com revalidação pronta (afterChange → revalidateGlobal('site-settings'), apontado pelo plano da petição como destino natural de um Pixel global); o layout do grupo (home) cobre exatamente a página pública de campanha (única rota do grupo), escopando o Pixel ao aceite e impedindo vazamento; e as regras de ID do Pixel passam a viver num único módulo profundo (facebookPixel.ts já é o dono), com o validate do Petition migrando para o helper compartilhado (edit owner, sem gêmeo).
Rejeitadas:
- B (global de rastreamento dedicado): twin do
SiteSettings— o dono já existe, o plano da petição já o apontava, e um segundo global seria cerimônia sem volatilidade. - C (injeção no
page.tsx): funcionaria (única rota do grupo), mas o layout é o lugar que declara a superfície "página pública de campanha" (data-theme="campaign-site") — se o grupo ganhar outra rota pública de campanha, o Pixel a cobre por contrato; eCampaignNewsletterSectioncontinuaria precisando do pixelId de qualquer forma (2 call sites da mesma leitura). - D-duplicado (validate inline copiado do
Petition): a repetição do bloco validação/label/description é exatamente o tipo de drift que o precedente da petição adiou com gatilho ("revisitar quando o mesmo ID for colado em ≥3 petições") — o gatilho foi puxado por produto; agora as regras devem ter dono único.
Componentes / mudanças
src/lib/facebookPixel.ts(edit owner): adicionarvalidateFacebookPixelId(value: string | null | undefined): true | string— envolvenormalizeFacebookPixelIddevolvendo a mensagem pt-BR do admin ("Informe somente o ID numérico do Pixel (5 a 20 dígitos), sem HTML ou script.") quando inválido;truequando vazio ou válido (campo opcional). Módulo já importado por client — helper puro, semserver-only.src/collections/Petition.ts(edit owner): ovalidateinline do campotracking.facebookPixelIdpassa a chamarvalidateFacebookPixelId(remove a duplicação; comportamento idêntico).beforeChangee campo inalterados.src/globals/SiteSettings.ts(edit owner): novo grouptracking(label "Rastreamento / Ads", mesmo doPetition) com o campofacebookPixelId—type: 'text', opcional, label "ID do Pixel do Meta (Facebook)",admin.descriptionidêntica ao precedente,validate: validateFacebookPixelId; novo hookbeforeChangenormalizandodata.tracking.facebookPixelId(mesmo padrão doPetition).afterChange/access inalterados (update: payloadAdminOnlyjá cobre).src/utilities/campaignHomeTracking.ts(novo,server-only):getCampaignHomeMetaPixelId(): Promise<string | null>—getCachedGlobal('site-settings')()→normalizeFacebookPixelId(settings.tracking?.facebookPixelId). Esconde a forma do global + normalização; 2 call sites (layout + section); não é pass-through — é a fronteira do tracking da home.src/app/(frontend)/(home)/layout.tsx(edit owner):const pixelId = await getCampaignHomeMetaPixelId();{pixelId ? <MetaPixel pixelId={pixelId} /> : null}dentro do container do grupo. Leitura cacheada sobglobal_site-settings— a edição do admin revalida a home (ISR), guardrail da intenção.src/app/(frontend)/(home)/CampaignNewsletterSection.tsx(edit owner): lêgetCampaignHomeMetaPixelId()e passapixelId={pixelId ?? undefined}aoCampaignNewsletterCapture.src/components/CampaignNewsletterForm.tsx(edit owner):CampaignNewsletterFormganha prop opcionalpixelId?: string; no sucesso desubmitCampaignNewsletter(apósawait, antes do swaponSubmit()),if (pixelId) trackMetaLead(pixelId, NEWSLETTER_LEAD_CONTENT_NAME, crypto.randomUUID())— padrão exato doPetitionForm(linha 61-63). Constante de móduloNEWSLETTER_LEAD_CONTENT_NAME = 'novidades-da-campanha'(valor estável visível no Events Manager, mesmo padrão decontent_nameda petição).CampaignNewsletterCapturerepassa a prop.- Migration:
pnpm migrate:create add_site_settings_facebook_pixel_id— colunastracking_facebook_pixel_id(tabelasite_settings) +version_tracking_facebook_pixel_id(tabelasite_settings_versions); sem backfill, sem dado novo. Inspcionar SQL gerado antes de aplicar. - Access / Consent: nenhum — campo herdado do access do global (
update: payloadAdminOnly), sem PII nova, sem chave de Consent (mesmo precedente da petição: transparência de cookies fica no/privacidade, dependência suave herdada). - UI: Impeccable A — N/A (campo único no admin replicando o precedente aceito + script invisível ao visitante; zero superfície pública nova).
Dados → forma (não se aplica)
O dado (PageView/Lead) vive no Meta Events Manager; o app só emite o evento. Nenhuma forma de apresentação nova.
Fases verificáveis
- Tracer / schema+server — migration +
SiteSettings(group/campo/beforeChange) +validateFacebookPixelIdemfacebookPixel.ts+ refactorPetition;pnpm migratelocal (teqo e teqo_test) +pnpm generate:types; unit dovalidateFacebookPixelIdemtests/unit/facebookPixel.unit.spec.ts;pnpm exec tsc --noEmit. - UI/leitura —
campaignHomeTracking.ts+ layout com<MetaPixel>+ section/form com a seam doLead; e2e novotests/e2e/campaignHomePixel.e2e.spec.ts(configura o global via REST admin com ID válido fixo, carrega a home com?e2e=, assere o script#meta-pixel-<id>, restaura o global para null no cleanup — idempotente, chave própria, paralelo-safe no DB de teste); spec do S9 inalterado (sem pixel configurado, nada renderiza). - Gates —
pnpm gate:fast;pnpm lint,pnpm format:check,pnpm exec knip,pnpm check:cycles,pnpm test,pnpm build(comS3_*dummy egenerate:importmappor via das dúvidas); changelogdocs/changelog/2026-08-19-s10.md+pnpm changelog:build; push e PR viapnpm push(basemainno Forgejo,Closes #94).
Rabbit holes / Não escopo (engenharia)
- Não mexer em
submitCampaignNewsletter(action intacta — oLeadé puramente client-side, mesmo padrão da petição). - Não adicionar fila/retry de
Leadquandowindow.fbqnão carregou (race submit rápido vs.afterInteractive) — herda o gatilho do plano da petição (revisitar quando smoke com Meta Pixel Helper mostrarLeadausente em produção). - Não usar o ID do Pixel em outras páginas/superfícies do site.
- Não tocar CSP, env vars,
@typesde terceiros parafbq(tipagem local já existe). - Não indexar/unicidade do campo (mesmo ID pode aparecer em petição e home — aceite da intenção).
Riscos e mitigação
- Home ISR sob
global_site-settings: a primeira render pós-save usa o valor novo (tag busta a cache); o e2e usa o truque do query param (?e2e=) para bypass de fetch cache — precedente do spec S9. Nenhuma página fora do grupo(home)lê o pixel. - Pins de geometria do e2e
frontend:MetaPixelsó renderiza com ID configurado; o spec existente roda sem pixel → DOM inalterado (script +noscriptdisplay:nonenão deslocam layout). Sem re-pin esperado. - Global compartilhado no e2e: o cleanup restaura
tracking.facebookPixelIdparanull(update via REST); idempotente por run, DB de teste dedicado por worktree. - Concorrência de migration: rebase em
forgejo/mainjá feito; criar a migration após; cadeia validada porpnpm migrate+test:intno PR.
Aceite de engenharia
- Aceite de produto da intenção ainda coberto (campo admin com mesma validação; PageView na home com fail-closed; exatamente um
Leadno sucesso; cache revalidado) - Invariantes AGENTS/engineering-standards (sem HTML colado; edit owner sem gêmeos; copy pt-BR/identifiers EN;
unstable_cache/tag existentes) - Testes de domínio previstos: unit
validateFacebookPixelId(novo helper) + e2e de injeção do base code condicional