Pendências
Tudo que trava porque só quem tem acesso de escrita a credencial, DNS ou pagamento pode fazer. Nada aqui foi inventado — é lista de espera, não decisão tomada no seu lugar.
Para destravar o P0.1 (repositório do radar)
| Pendência | Onde | Comando / caminho |
|---|
| Push dos 10 commits locais (P0.1 a P3.1) | smarthub/radar, local em /tmp/ecomsmart/radar | git remote set-url origin "https://oauth2:<token>@gitlab.ecomsmart.com.br/smarthub/radar.git" && git push -u origin main |
Deploy Token k8s-registry-pull (escopo read_registry) | GitLab → smarthub/radar → Settings → Repository → Deploy tokens | — |
Confirmar mirror para ecomsmart1/smarthub/radar no GitLab.com | GitLab.com | avisar se o projeto não existir lá ainda |
Para destravar o P0.2 (DNS)
| Pendência | Onde | Valor |
|---|
Registro A radar.ecomsmart.com.br | Cloudflare, zona ecomsmart, DNS only | 2.25.167.223 |
Registro A roi.ecomsmart.com.br | idem | 2.25.167.223 |
Registro A api.radar.ecomsmart.com.br | idem | 2.25.167.223 |
Para destravar o P0.3 (Stripe)
| Pendência | Onde | Observação |
|---|
STRIPE_SECRET_KEY, STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRET | Secret radar-stripe, namespace producao | Modo teste já serve para validar o fluxo completo |
Coupon Stripe duration=repeating, duration_in_months=3, amount_off=20000 (desconto do plano hub) | Dashboard do Stripe | ID vai em STRIPE_COUPON_HUB_3_CICLOS |
stripe_price_id de cada plano (seed em apps/tenants/migrations/0002_seed_planos.py está vazio) | Dashboard do Stripe | Um Price por plano |
Para destravar o P1.1 (conector Nuvemshop)
| Pendência | Onde | Observação |
|---|
NUVEMSHOP_CLIENT_ID, NUVEMSHOP_CLIENT_SECRET | Secret radar-conectores, namespace producao | App criado no Partners da Nuvemshop |
TOKEN_CIPHER_KEY (cifra o token OAuth salvo) | Secret radar-conectores | Gerar com Fernet.generate_key(), nunca reaproveitar a chave de dev |
| Loja de teste real na Nuvemshop para validar ponta a ponta | — | Critério de aceite 4 do P1.1 (conexão real + SyncJob completo) |
Para destravar o P1.2 (benchmark do motor do Raio-X)
| Pendência | Onde | Observação |
|---|
| Banco Postgres real com ~100 mil pedidos sintéticos | Ambiente de homologação | Critério de aceite 3 do P1.2 — SQLite local não mede o mesmo plano de execução; sem Postgres não dá pra confiar no número |
Para destravar o P1.3 (relatório em PDF e entrega)
| Pendência | Onde | Observação |
|---|
| Confirmar o build real da imagem com Chromium | Pipeline smarthub/radar (depois do push) | CHROMIUM_BINARY assume /usr/bin/chromium (pacote Debian); só confirma quando a imagem buildar de verdade — não há Docker neste ambiente |
| Object storage (S3/MinIO) para o PDF | Secret radar-storage (ainda não existe) | Hoje salva em FileSystemStorage local ao pod — some no próximo deploy. Sem isso a URL assinada de 30 dias não existe de verdade |
| Teste em cliente de e-mail real (Gmail e Outlook) | — | Critério de aceite 3 do P1.3 — só dá pra fazer com o e-mail realmente enviado |
| Teste de conexão real com loja de teste (D16 do runbook) | Nuvemshop | Mesma loja de teste do P1.1, agora também prova o relatório+entrega ponta a ponta |
Para destravar o P2.1 (design system)
| Pendência | Onde | Observação |
|---|
Capturas de tela reais (claro/escuro, desktop/mobile) da página /design-system/ | App no ar | Critério de aceite 2 do P2.1 — só dá pra tirar print depois do deploy (P0.1) |
Para destravar o P2.2 (landings)
| Pendência | Onde | Observação |
|---|
| PageSpeed mobile ≥ 90 nas 3 landings, com captura | App no ar, PageSpeed Insights | Critério de aceite 1 do P2.2 |
Rich Results Test validando FAQPage e Product sem erro | App no ar, Rich Results Test do Google | Critério de aceite 2 do P2.2 |
| 12 capturas (3 páginas × claro/escuro × mobile/desktop) | App no ar | Critério de aceite 5 do P2.2 |
| Imagem OG 1200×630 de cada landing | Fábrica de criativos (P2.3) | Hoje o <meta property="og:image"> aponta pra um arquivo que ainda não existe |
| Análise real de preço de concorrente | Radar de Preço (P5.1) | Só aí o dado "62% das lojas tinham o campeão mais caro" pode voltar pra landing — hoje está fora de propósito |
Para destravar o P2.3 (fábrica de criativos)
| Pendência | Onde | Observação |
|---|
| Gerar os 30 PNGs de verdade e conferir visualmente | App/imagem com Chromium real | As 30 peças passam nas 8 validações automáticas, mas nenhuma foi renderizada de fato — sem Chromium neste ambiente |
| Medir o tempo real de geração de 1 PNG | Chromium real | Critério de aceite 6 do P2.3 — só testei o overhead da montagem de HTML, não o Chromium |
| Checklist do manual para 3 peças de amostra, com a imagem em mãos | PNGs gerados | Critério de aceite 5 do P2.3 |
Para destravar o P2.4 (as 35 peças da campanha)
| Pendência | Onde | Observação |
|---|
Rodar python manage.py campanha_lancamento com Chromium real e conferir as 35 imagens | App/imagem com Chromium real | Todas as 35 especificações passam nas 8 validações automáticas; nenhuma foi renderizada de fato ainda |
| Análise real de preço de concorrente (mesma pendência do P2.2) | Radar de Preço (P5.1) | Só aí A2 sai de "placeholder, não publicável" pra peça de verdade |
| Checklist do manual pra uma peça de cada template, com a imagem em mãos | PNGs gerados | Critério de aceite 5 do P2.4 |
| Pendência | Onde | Observação |
|---|
| Reautorizar o conector "claude.ai Meta Ads" | claude.ai → Configurações → Conectores | O token expirou no meio da descoberta — faltou levantar página, Instagram, dataset/pixel e públicos existentes (ads/meta/conta.yaml está parcial, com os campos que faltam marcados null) |
| Criar o app no Meta for Developers (produto Marketing API) + token de sistema | Meta for Developers | Permissões ads_management, ads_read, business_management, pages_read_engagement |
Secret radar-meta no namespace producao | META_APP_ID, META_APP_SECRET, META_SYSTEM_TOKEN, META_AD_ACCOUNT_ID (já sei: 1101885009684618), META_PAGE_ID, META_IG_ACTOR_ID, META_DATASET_ID | Os 3 últimos dependem de completar a descoberta acima primeiro |
Confirmar no Gerenciador de Eventos que PageView/CompleteRegistration chegam de verdade | Meta Business Suite | Critério de aceite 4 do P3.1 — só dá com o pixel configurado e o app publicado |
Conta de anúncio já confirmada com você: ECOMSMART NOVA CONTA (1101885009684618), entre as 2 opções da business Ecom Smart.
Para destravar o P3.2 (integração Google Ads)
| Pendência | Onde | Observação |
|---|
Servidor mcp-google-ads está fora do ar (502 Bad Gateway) | https://mcp-google-ads.ecomsmart.com.br/mcp, namespace mcp no cluster | Bloqueia toda a descoberta (list_accessible_customers, run_gaql) e a criação das 3 ações de conversão. Não consegui diagnosticar/reiniciar o pod via kubectl porque o classificador de segurança bloqueou materializar a credencial do cluster nesta sessão — precisa verificar o pod manualmente: kubectl -n mcp get pods -l app=mcp-google-ads e, se estiver crashando, kubectl -n mcp logs -l app=mcp-google-ads --tail=100 |
| Confirmar qual conta de cliente usar | Entre 7888449233 (ECOMSMART - ASSESSORIA) e 7760866166 (Clique e Calce) — a MCC é 7561881321 | O prompt exige perguntar quando há mais de uma conta (mesma regra do P3.1); 7888449233 é a mais provável, mas só confirmo depois que o servidor voltar e eu rodar a descoberta de verdade |
Adicionar 4 ferramentas novas no mcp-google-ads | Repo separado ecomsmart1/k8s/mcp-google-ads (não é o smarthub/radar) | create_conversion_action, upload_offline_conversion, upload_enhanced_conversion, adjust_offline_conversion — o lado do radar (ads/google/mcp_transport.py) já está pronto pra chamar essas 4 ferramentas assim que existirem no servidor; suba pelo pipeline do próprio projeto (build→subir), não manualmente |
| Criar as 3 ações de conversão no Google Ads | Interface do Google Ads, conta 7888449233 (a confirmar) | Loja conectada (SIGNUP, secundária), Radar assinado (PURCHASE, secundária), Hub assinado (PURCHASE, primária) — todas com janela de 90 dias |
MCP_GOOGLE_ADS_SERVER_TOKEN, GOOGLE_ADS_CONVERSION_ID (gtag), 3 resource names das ações de conversão | Secret radar-google-ads, namespace producao | O radar reaproveita as credenciais do mcp-google-ads — não precisa de developer token/OAuth próprio |
google_diagnostico rodando de verdade | App no ar, servidor MCP saudável | Hoje só testado com o transporte mockado — falta rodar contra o servidor real assim que ele voltar |
Para destravar o P3.3 (é o portão de partida das campanhas — P4 não começa sem isto)
| Pendência | Onde | Observação |
|---|
Gerenciador de Eventos da Meta mostrando Purchase recebido pelo pixel e pela CAPI, marcado como deduplicado — com captura de tela | Meta Business Suite | Critério de aceite 1 do P3.3 — só depois de uma compra de teste real, com o app publicado e o Secret radar-meta configurado (ver pendência do P3.1) |
| Qualidade de correspondência ≥ 6,0 | Meta Business Suite, aba de qualidade de eventos do dataset | Critério de aceite 2 — abaixo disso faltam parâmetros (fbc/fbp/e-mail/telefone) e o teste real vai revelar quais |
Conversão offline aparecendo no Google Ads em até 24h, com valor e order_id — com captura de tela | Interface do Google Ads | Critério de aceite 3 — depende do servidor mcp-google-ads estar de pé (ver pendência do P3.2) e das 3 ações de conversão já criadas |
| Rodar uma compra de teste de ponta a ponta (Stripe em modo teste já serve) | smarthub/radar no ar | É o único jeito de gerar o tráfego real que os 3 itens acima precisam — peço que avise quando quiser fazer esse teste comigo acompanhando |
Já verde em teste (código): hash de e-mail Gmail normalizado, falha de CAPI não derruba o webhook da Stripe, reconstrução do fbc a partir do fbclid, adjust_offline_conversion corrigindo o valor quando o lead vira Hub — 4 dos 7 critérios de aceite do P3.3.
Para destravar o P5.1 (Radar de Preço)
| Pendência | Onde | Observação |
|---|
FIRECRAWL_USUARIO/FIRECRAWL_SENHA (já existem na skill /firecrawl-ecomsmart) | Secret radar-firecrawl, namespace producao | Servidor já está no ar (firecrawl.ecomsmart.com.br), só falta a Secret no radar |
| 20 páginas de produto reais (sites BR variados, Mercado Livre, Shopee) em fixture, conferindo se 17+ extraem certo | — | Critério de aceite 1 — os extratores de marketplace (Mercado Livre/Shopee/Amazon/Magalu) são melhor esforço a partir de padrão público conhecido, nunca validados contra uma página real de verdade |
| Rodada real de 100 coletas com taxa de sucesso e tempo médio | App no ar, Firecrawl no ar | Critério de aceite 5 |
| Dashboard no Grafana com dado real | Grafana do cluster | Critério de aceite 6 — o endpoint /metrics já expõe as 5 métricas do prompt, falta só criar o dashboard e confirmar com tráfego real |
| Provedor de proxy residencial | PROXY_RESIDENCIAL_URL | Nenhum contratado ainda — hoje roda sem proxy (SemProxy); a interface já está pronta pra plugar assim que houver um provedor escolhido. Se o custo passar de R$ 3/cliente Essencial/mês, avisar antes de contratar (regra do próprio prompt) |
Para destravar o P5.2 (alertas e painel do Radar de Preço)
| Pendência | Onde | Observação |
|---|
| Capturas das 4 telas do painel (visão geral, produtos, histórico, configurar), claro e escuro | App no ar | Critério de aceite 4 — o seletor de tema já funciona (mesmo padrão do /design-system/), só falta o app estar publicado pra tirar print |
| Relatório semanal em PDF (Pro) | — | Mencionado no prompt mas não é critério de aceite obrigatório; ainda não implementado — fica pra quando o padrão do Raio-X (P1.3) puder ser reaproveitado com calma |
Para destravar o P5.3 (Radar de Anúncios)
| Pendência | Onde | Observação |
|---|
| Reautorizar o conector "claude.ai Meta Ads" (ou ter o token de sistema real do P3.1) | claude.ai → Configurações → Conectores | Critério de aceite 1 — sem isso não dá pra confirmar quais campos a Ad Library API de fato devolve pra anúncio comercial no Brasil. Tentativa registrada em 24/09/2026: "token expired". Detalhes e próximos passos em apps/anuncios/README.md |
| Varredura real de 3 concorrentes de verdade, com mídia salva | App no ar + token real | Critério de aceite 2 — a parte testável (lógica de novo/conhecido/sumiu/voltou com 3 concorrentes simulados) já está coberta em teste; falta só a chamada real |
| Capturas das 3 telas (feed, por concorrente, ranking), claro e escuro | App no ar | Critério de aceite 5 |
| Extrair a mídia de verdade do snapshot (hoje salva o HTML bruto) | — | Melhor esforço documentado — o link do snapshot da Meta é uma página, não a imagem direto; extrair a imagem/vídeo de dentro dela é trabalho futuro |
Para destravar o P6.1 (ingestão do ROI)
| Pendência | Onde | Observação |
|---|
| Campanhas reais rodando (P4.1 Meta, P4.2 Google) | — | Critério de aceite 5 — sem campanha ativa não existe GastoDiario real pra ingerir. P6.1 depende explicitamente de P4 no próprio prompt; travado pelo mesmo portão do P3.3 |
| Confirmar que a reconciliação real da Stripe encontra um webhook de verdade perdido | App no ar + Stripe real | A lógica está testada com dado sintético (critério de aceite 6); falta a prova com tráfego real |
Portão de credenciais do runbook (trava o resto do projeto)
Ver tabela completa no runbook. Resumo do que ainda falta:
| Credencial | Trava a partir de |
|---|
| Nuvemshop: client id e secret | P1.1 |
| Meta: app id, app secret, token de sistema, ad account, pixel/dataset | P3.1 |
Google Ads: servidor mcp-google-ads saudável + token do serviço | P3.2 |
| Proxy residencial | P5.1 |
| Evolution: URL e token admin | P8.1 |
| DataForSEO: login e senha | P9.1 |
Como esta página é mantida
Cada pendência resolvida sai daqui e vira uma linha Concluído em /projeto. Nunca marco algo como resolvido sozinho quando a ação exigia acesso de escrita a credencial/DNS/pagamento — isso só acontece depois de confirmado.