SmartHub AppsMáquina de aquisição

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ênciaOndeComando / caminho
Push dos 10 commits locais (P0.1 a P3.1)smarthub/radar, local em /tmp/ecomsmart/radargit 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.comGitLab.comavisar se o projeto não existir lá ainda

Para destravar o P0.2 (DNS)

PendênciaOndeValor
Registro A radar.ecomsmart.com.brCloudflare, zona ecomsmart, DNS only2.25.167.223
Registro A roi.ecomsmart.com.bridem2.25.167.223
Registro A api.radar.ecomsmart.com.bridem2.25.167.223

Para destravar o P0.3 (Stripe)

PendênciaOndeObservação
STRIPE_SECRET_KEY, STRIPE_PUBLISHABLE_KEY, STRIPE_WEBHOOK_SECRETSecret radar-stripe, namespace producaoModo 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 StripeID 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 StripeUm Price por plano

Para destravar o P1.1 (conector Nuvemshop)

PendênciaOndeObservação
NUVEMSHOP_CLIENT_ID, NUVEMSHOP_CLIENT_SECRETSecret radar-conectores, namespace producaoApp criado no Partners da Nuvemshop
TOKEN_CIPHER_KEY (cifra o token OAuth salvo)Secret radar-conectoresGerar 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ênciaOndeObservação
Banco Postgres real com ~100 mil pedidos sintéticosAmbiente de homologaçãoCrité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ênciaOndeObservação
Confirmar o build real da imagem com ChromiumPipeline 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 PDFSecret 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)NuvemshopMesma 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ênciaOndeObservação
Capturas de tela reais (claro/escuro, desktop/mobile) da página /design-system/App no arCritério de aceite 2 do P2.1 — só dá pra tirar print depois do deploy (P0.1)

Para destravar o P2.2 (landings)

PendênciaOndeObservação
PageSpeed mobile ≥ 90 nas 3 landings, com capturaApp no ar, PageSpeed InsightsCritério de aceite 1 do P2.2
Rich Results Test validando FAQPage e Product sem erroApp no ar, Rich Results Test do GoogleCritério de aceite 2 do P2.2
12 capturas (3 páginas × claro/escuro × mobile/desktop)App no arCritério de aceite 5 do P2.2
Imagem OG 1200×630 de cada landingFá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 concorrenteRadar 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ênciaOndeObservação
Gerar os 30 PNGs de verdade e conferir visualmenteApp/imagem com Chromium realAs 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 PNGChromium realCrité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ãosPNGs geradosCritério de aceite 5 do P2.3

Para destravar o P2.4 (as 35 peças da campanha)

PendênciaOndeObservação
Rodar python manage.py campanha_lancamento com Chromium real e conferir as 35 imagensApp/imagem com Chromium realTodas 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ãosPNGs geradosCritério de aceite 5 do P2.4

Para destravar o P3.1 (integração Meta)

PendênciaOndeObservação
Reautorizar o conector "claude.ai Meta Ads"claude.ai → Configurações → ConectoresO 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 sistemaMeta for DevelopersPermissões ads_management, ads_read, business_management, pages_read_engagement
Secret radar-meta no namespace producaoMETA_APP_ID, META_APP_SECRET, META_SYSTEM_TOKEN, META_AD_ACCOUNT_ID (já sei: 1101885009684618), META_PAGE_ID, META_IG_ACTOR_ID, META_DATASET_IDOs 3 últimos dependem de completar a descoberta acima primeiro
Confirmar no Gerenciador de Eventos que PageView/CompleteRegistration chegam de verdadeMeta Business SuiteCrité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ênciaOndeObservação
Servidor mcp-google-ads está fora do ar (502 Bad Gateway)https://mcp-google-ads.ecomsmart.com.br/mcp, namespace mcp no clusterBloqueia 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 usarEntre 7888449233 (ECOMSMART - ASSESSORIA) e 7760866166 (Clique e Calce) — a MCC é 7561881321O 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-adsRepo 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 AdsInterface 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ãoSecret radar-google-ads, namespace producaoO radar reaproveita as credenciais do mcp-google-ads — não precisa de developer token/OAuth próprio
google_diagnostico rodando de verdadeApp no ar, servidor MCP saudávelHoje 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ênciaOndeObservação
Gerenciador de Eventos da Meta mostrando Purchase recebido pelo pixel e pela CAPI, marcado como deduplicado — com captura de telaMeta Business SuiteCrité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,0Meta Business Suite, aba de qualidade de eventos do datasetCrité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 telaInterface do Google AdsCrité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ênciaOndeObservação
FIRECRAWL_USUARIO/FIRECRAWL_SENHA (já existem na skill /firecrawl-ecomsmart)Secret radar-firecrawl, namespace producaoServidor 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édioApp no ar, Firecrawl no arCritério de aceite 5
Dashboard no Grafana com dado realGrafana do clusterCrité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 residencialPROXY_RESIDENCIAL_URLNenhum 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ênciaOndeObservação
Capturas das 4 telas do painel (visão geral, produtos, histórico, configurar), claro e escuroApp no arCrité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ênciaOndeObservação
Reautorizar o conector "claude.ai Meta Ads" (ou ter o token de sistema real do P3.1)claude.ai → Configurações → ConectoresCrité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 salvaApp no ar + token realCrité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 escuroApp no arCrité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ênciaOndeObservaçã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 perdidoApp no ar + Stripe realA 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:

CredencialTrava a partir de
Nuvemshop: client id e secretP1.1
Meta: app id, app secret, token de sistema, ad account, pixel/datasetP3.1
Google Ads: servidor mcp-google-ads saudável + token do serviçoP3.2
Proxy residencialP5.1
Evolution: URL e token adminP8.1
DataForSEO: login e senhaP9.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.

© 2026 EcomSmart · Uso interno · pt-BR