SmartHub AppsMáquina de aquisição

Arquitetura e Kubernetes

Tudo no cluster `ecomsmart-hostinger`. Imagens no registry próprio. Deploy por pipeline do GitLab self-hosted. Nenhum `kubectl apply` manual fora de teste.

Restrição de capacidade do cluster — ler antes de planejar deploy

Levantamento de 17/09/2026 (registrado na skill /firecrawl-ecomsmart): os quatro nós do cluster estavam com 98 a 99% da CPU alocada em requests. Isso é anterior a este projeto e não foi causado por ele.

Consequência prática e imediata para o SmartHub Apps:

Decisão: publicar o site agora (cabe), e antes do prompt P0.1 rodar uma auditoria de requests do cluster. Ou some um worker, ou reduzimos os requests dos serviços existentes que estão superdimensionados. Está no P0.0.

Vale também investigar o Longhorn: vários volumes apareceram faulted com ReplicaSchedulingFailure: insufficient storage mesmo com mais de 100 GB livres em todos os nós. É problema pré-existente e afeta qualquer PVC novo.

Atualização de 23/09/2026 — P0.0 confirmado, decisão de P0.1

Reauditoria com kubectl describe nodes:

NóCPU alocávelRequestsLivre
k8s-ecomsmart-control-014000m3890m (97%)110m
k8s-ecomsmart-control-028000m7510m (93%)490m
k8s-ecomsmart-control-034000m3920m (98%)80m
k8s-ecomsmart-worker-014000m3840m (96%)160m

Total livre em requests: ~840m de CPU no cluster inteiro. Longhorn hoje está majoritariamente healthy — só um volume ficou detached/unknown (não faulted), problema menor que o levantamento de 17/09 sugeria.

Decisão (sem cortar nada em produção): em vez de reduzir requests de serviço já em produção — ação de maior risco, que exige aprovação explícita por afetar sistema compartilhado — o esqueleto do radar (P0.1) nasce com requests mínimos: radar-web 100m×2, radar-worker 100m×2, radar-beat 50m — 500m no total, dentro dos 840m livres. Isso destrava o P0.1 sem tocar em nada que já roda. A liberação de capacidade nominal (a que o P0.0 original previa) continua pendente e só deve ser feita com aprovação explícita, um serviço por vez, exatamente como o D1/D2 do runbook descreve.

Domínios

HostO que serveProxy Cloudflare
apps.ecomsmart.com.brEste site — planejamento e execuçãoDNS only
radar.ecomsmart.com.brA aplicação: Raio-X, Radar de Preço, Radar de AnúnciosDNS only
roi.ecomsmart.com.brPainel de investido contra faturadoDNS only
api.radar.ecomsmart.com.brWebhooks de Stripe, Nuvemshop, MetaDNS only

Proxy desligado porque o cert-manager valida por HTTP-01 e o proxy da Cloudflare quebra o desafio. Para ligar o proxy depois, migrar para DNS-01.

Fluxo da máquina

     Meta Ads (frio)        Google Ads (demanda)      App Nuvemshop / Tray
           |                        |                          |
           +------------------------+--------------------------+
                                    |
                    Landing por produto (radar.ecomsmart.com.br)
                    captura utm_* + gclid + fbclid + fbp/fbc
                                    |
                    +---------------------------------+
                    |  CONECTAR LOJA (OAuth)          |  gratis, sem cartao
                    |  Raio-X gerado em ~3 min        |
                    +---------------------------------+
                                    |
                          LEAD SCORE automatico
              faturamento · pedidos/mes · % compra unica
              investe em trafego? · tem WhatsApp no site?
                                    |
              +---------------------+---------------------+
              |                                           |
      fatura < R$ 30k                            fatura >= R$ 30k
      nutricao por e-mail                        FILA DO VENDEDOR em 24h
      oferta Radar R$ 97/ano                              |
              |                                           |
              v                                           v
      CHECKOUT STRIPE  ------------------->    Ligacao com o Raio-X na tela
      R$ 97/ano · CARTAO ARQUIVADO             Upgrade = 1 clique
              |                                           |
              v                                           v
      Meta CAPI + Google offline conv.             HUB R$ 299/mes
      (algoritmo aprende com COMPRA REAL)          trial 7d · R$ 99 x3
                                    |
                                    v
                    +-------------------------------+
                    |  PAINEL ROI                   |
                    |  Meta + Google spend          |
                    |  x Stripe (MRR, receita, LTV) |
                    |  = CAC, ROAS, payback         |
                    +-------------------------------+

Serviços no cluster

Namespace producao, o mesmo do Hub.

DeploymentRéplicasRequestsLimitsPapel
apps-site220m / 32Mi100m / 64MiEste site, nginx estático
radar-web2200m / 384Mi1000m / 1GiDjango, gunicorn
radar-worker2200m / 512Mi1000m / 1GiCelery: sync, Raio-X, alertas
radar-beat150m / 128Mi200m / 256MiCelery beat, strategy: Recreate
radar-render1300m / 768Mi1500m / 1,5GiChromium: PDF do Raio-X e criativos de anúncio

Postgres e Redis: reaproveitar as instâncias que já existem no cluster, criando apenas banco e usuário novos. Não subir outro Postgres.

Firecrawl — o crawler já existe

O cluster já tem Firecrawl self-hosted no namespace firecrawl, em firecrawl.ecomsmart.com.br, com Basic Auth, deployado por Helm e pipeline próprio (skill /firecrawl-ecomsmart, repo ecomsmart/infrastructure/firecrawl).

Isso muda o desenho do Radar de Preço de forma relevante: não construímos motor de crawl. O radar-worker chama POST /v2/scrape do Firecrawl e recebe o HTML ou o markdown já renderizado, inclusive de páginas que dependem de JavaScript. O que fica do nosso lado é o que é específico do produto:

Limitações a respeitar, já conhecidas:

Grupo VIP — sessões de WhatsApp por tenant

Não é um Deployment novo: é capacidade adicional no mesmo servidor Evolution self-hosted que já roda a instância corporativa EAPI - DURAES (skill /evolution-api-ecomsmart), com uma instância a mais por loja assinante.

POST {evolution}/instance/create   -> uma instancia por tenant, QR Code proprio
webhook group-participants-update  -> radar-worker processa entrada/saida
webhook messages-upsert            -> radar-worker conta engajamento e aplica filtro

Isolamento obrigatório: a instância corporativa (relatórios internos da EcomSmart) e as instâncias de clientes vivem no mesmo servidor, mas nunca no mesmo namespace lógico — prefixar nome de instância com tenant-<loja_id> e nunca reutilizar o webhook da instância corporativa para tráfego de cliente.

Capacidade: cada sessão ativa consome memória o tempo todo, diferente do resto do catálogo. Planejar o servidor Evolution para n_clientes × 300 MB de folga e revisar antes de cada lote de vendas — é o único produto do catálogo cujo custo de infra cresce linearmente com a base de clientes, não com o uso.

Vitrine SEO — DataForSEO

Chamada de API paga, sem infra própria a manter. O radar-worker chama o DataForSEO na geração de descrição e grava o resultado em PalavraChaveCache (chave: termo normalizado, TTL 30 dias) — a mesma palavra-chave pesquisada por dois lojistas diferentes no mesmo mês paga a chamada uma vez só.

radar-worker -> cache? -> DataForSEO (keyword data, e no Pro tambem SERP) -> LLM gera a descricao

Nenhum segredo de LLM externo é assumido aqui — usar o mesmo provedor já disponível no ambiente Claude Code/Agent SDK do projeto, não contratar chave de LLM à parte.

Orçamento de recursos

ComponenteRAM
apps-site128 Mi
radar-web2 Gi
radar-worker2 Gi
radar-beat256 Mi
radar-render1,5 Gi
Evolution — instâncias de Grupo VIP300 Mi × nº de clientes (crescente, revisar por lote)
Postgres (fatia deste projeto)2 Gi
Redis (fatia)512 Mi
Total fixocerca de 8,4 Gi, mais o Grupo VIP por cliente

Se o cluster não tiver essa folga, a ordem de corte é radar-render (gera PDF sob demanda em vez de em fila) e depois reduzir radar-worker para uma réplica. O Grupo VIP não entra nesse corte — é custo direto por cliente pagante, não folga de plataforma.

Estrutura do repositório

smarthub/apps
  README.md
  docs/                    planejamento em markdown (vira este site)
  prompts/                 os 20 prompts de execução
  brand/                   tokens.css, simbolo-e.svg, base.html, manual v2.4
  build/
    build.py               gerador do site estático
    md.py                  renderizador markdown sem dependência
  site/
    assets/app.css         identidade v2.4, claro e escuro
    assets/app.js          tema, menu, copiar código
    *.html                 gerado pelo build
  k8s/
    base/                  deployment, service, ingress, configmap
    overlays/producao/     kustomization
  Dockerfile               multi-stage: python constrói, nginx serve
  nginx.conf
  .gitlab-ci.yml

Pipeline

Estágios build → deploy.

build — imagem multi-stage. Estágio 1 em python:3.12-slim roda python3 build/build.py. Estágio 2 em nginx:alpine copia site/. Envia para registry.ecomsmart.com.br/smarthub/apps:$CI_COMMIT_SHORT_SHA e :latest.

deploy — só em main. export KUBECONFIG=$KUBECONFIG_ECOMSMART no before_script, aplica com kubectl apply -k k8s/overlays/apps, atualiza a imagem com kubectl set image e espera com kubectl rollout status --timeout=300s.

Runner com tags self-hosted,kubernetes,deploy.

Pull secret

O kubelet precisa puxar a imagem do registry privado muito depois do pipeline terminar. Usar Deploy Token do projeto com escopo apenas read_registry, nome k8s-registry-pull.

Nunca usar $CI_REGISTRY_PASSWORD para isso: esse token só vale durante o job, e o pod vai falhar em todo restart depois.

Segredos

Nada de chave em repositório.

CredencialOnde ficaComo chega no pod
KubeconfigVariável de grupo KUBECONFIG_ECOMSMART (tipo file, protegida)Só no pipeline
Registry pullDeploy Token k8s-registry-pullimagePullSecrets
StripeSecret radar-stripeenvFrom
Meta (app, token de sistema, ad account, dataset)Secret radar-metaenvFrom
Google AdsReaproveitar o Secret do mcp-google-adsenvFrom
Nuvemshop, Tray, ShopifySecret radar-conectoresenvFrom
Evolution (servidor compartilhado, token admin)Secret radar-evolutionenvFrom
DataForSEO (login + senha da API)Secret radar-dataforseoenvFrom
SMTP (SMTP2GO)Secret ecomsmart-hub-app já existenteenvFrom
CloudflareAinda não cadastrado no GitLab — precisa ser feito manualmenteVariável CLOUDFLARE_API_TOKEN

Gotchas conhecidos do cluster

Registrados na skill /gitlab-ecomsmart e válidos aqui:

Observabilidade

O cluster já tem Grafana, Prometheus e a stack ELK no namespace logging.

Métricas a expor:

radar_coletas_total{status}
radar_coleta_duracao_segundos
radar_proxy_custo_estimado_centavos
radar_monitoramentos_ativos
radar_raiox_duracao_segundos
radar_leads_total{fila}
radar_capi_envios_total{status}

Logs em JSON com structlog, para cair estruturados no Elasticsearch.

Achados da primeira publicação (22/09/2026)

Coisas que só apareceram ao colocar o site no ar. Valem para todo projeto novo neste GitLab e neste cluster.

AchadoDetalheO que fazer
Push com protocolo git v2 falhaO Gitaly do GitLab 19.x devolve fatal: protocol error: bad line length character e HTTP 500 com clientes git 2.42git -c protocol.version=0 -c http.postBuffer=524288000 push
Runner sem tagsO runner id=1 (k8s-ecomsmart-hostinger) está com tag_list vazia e run_untagged=true. A skill /gitlab-ecomsmart documenta tags que ele não temNão use tags: no .gitlab-ci.yml, ou o job fica pendente para sempre
bitnami/kubectl não existe maisRemovido do Docker HubUse alpine/k8s:1.31.3, que os outros pipelines do cluster já usam
Variável de grupo não é herdadasmarthub é irmão de ecomsmart, não filho. KUBECONFIG_ECOMSMART (grupo ecomsmart) não chega nos projetos de smarthubCada projeto de smarthub precisa da própria KUBE_CONFIG, como o fluxo-caixa
CI_COMMIT_SHORT_SHA tem 8 caracteresgit rev-parse --short local dá 7. As tags no registry são de 8Ao apontar imagem na mão, confira a tag real no registry
commonLabels depreciadoKustomize avisa em toda aplicaçãoUse labels com includeSelectors: false

Deploy pelo agente GitLab (resolvido em 22/09/2026)

A variável KUBECONFIG_ECOMSMART não é herdada por smarthub, e criar uma KUBE_CONFIG de projeto por API é bloqueado pela política de segurança do ambiente. A solução foi melhor que a original: GitLab Agent for Kubernetes.

O KAS já estava ativo no servidor GitLab, mas nenhum agente existia no cluster. Agora existe:

ItemValor
Configuração no repo.gitlab/agents/apps/config.yaml
Agente registradoapps (id 1) no projeto smarthub/apps
InstalaçãoHelm gitlab/gitlab-agent 2.32.0, namespace gitlab-agent
Contexto no CIsmarthub/apps:apps
Acesso liberadoEste projeto e todo o grupo smarthub

No pipeline, o deploy passou a ser simplesmente:

before_script:
  - kubectl config use-context smarthub/apps:apps

Nenhum kubeconfig guardado em variável de CI. O token do agente vive só como Secret dentro do cluster, e o GitLab o mantém do lado dele. Qualquer projeto novo do grupo smarthub reaproveita o mesmo agente — não precisa repetir nada disso.

Recursos do agente foram reduzidos de propósito (10m de CPU, 48Mi de memória em requests, 1 réplica) por causa da restrição de capacidade descrita no topo desta página. O padrão do chart é 2 réplicas, que não caberiam.

© 2026 EcomSmart · Uso interno · pt-BR