Pular para conteúdo

Flow Gateway

O flow-gateway é o ponto único de entrada HTTP/HTTPS reverso da infraestrutura pública no domínio consolidado (flow.ecomsmart.com.br). Rodando sobre um container Nginx, ele recebe o tráfego roteado pelo Cloudflare Tunnel e distribui as requisições entre a Landing Page institucional, o Painel Administrativo e os endpoints de onboarding do WhatsApp.

O gateway isola a topologia de containers da VPS e garante que o navegador do usuário acesse uma URL unificada, eliminando problemas de CORS e complexidade de múltiplos subdomínios.


Papel na Plataforma

flowchart TD
    user([Navegador / Lojista]) -->|HTTPS| cf[Cloudflare CDN / Proxy]
    cf -->|Cloudflare Tunnel: ecomsmart-flow-prod| tunnel[cloudflare-tunnel-flow]
    tunnel -->|HTTP :8080| gw[Flow Gateway]

    gw -->|/, /assets/*, /brand/*| landing[Landing:8080]
    gw -->|/api/v1/onboarding/*| wpp[WhatsApp Entrypoint:8000]
    gw -->|demais rotas /login, /dashboard, /api| panel[Panel SPA & Proxy:8000]
    panel -->|proxy /auth, /api, /merchants| platform[Frontend Entrypoint / BFF:7000]

    style user fill:#f8fafc,stroke:#64748b,stroke-width:1.5px,color:#1e293b
    style cf fill:#fefce8,stroke:#d97706,stroke-width:1.5px,color:#92400e
    style tunnel fill:#f8fafc,stroke:#64748b,stroke-width:1.5px,color:#1e293b
    style gw fill:#f0f9ff,stroke:#0284c7,stroke-width:2px,color:#0369a1
    style landing fill:#f0fdf4,stroke:#16a34a,stroke-width:1.5px,color:#166534
    style wpp fill:#faf5ff,stroke:#9333ea,stroke-width:1.5px,color:#6b21a8
    style panel fill:#f0f9ff,stroke:#0284c7,stroke-width:1.5px,color:#0369a1
    style platform fill:#fefce8,stroke:#d97706,stroke-width:1.5px,color:#92400e

Limites de Responsabilidade

É responsabilidade do Flow Gateway NÃO é responsabilidade do Flow Gateway
Terminar o túnel HTTP local na porta 8080. Terminar certificados SSL/TLS públicos (função do Cloudflare Edge).
Roteamento por prefixo de URI entre Landing, Painel e WhatsApp Entrypoint. Autenticar credenciais ou verificar tokens JWT/sessão (BFF/painel).
Resolução dinâmica de DNS de containers via 127.0.0.11. Processar dados de negócio, pedidos ou catálogos.
Responder ao healthcheck do container em GET /health. Criptografia de WhatsApp Flows (pertence ao WhatsApp Entrypoint).

Matriz de Roteamento de Rotas

O arquivo de configuração nginx.conf define o roteamento estrito por prioridade de prefixo:

Caminho da URL Destino Interno Finalidade
/ http://landing:8080 Página inicial da Landing Page institucional.
/index.html http://landing:8080 Documento raiz estático da Landing Page.
/assets/* http://landing:8080 Imagens, CSS e bundles estáticos da Landing.
/brand/* http://landing:8080 Logotipos e identidades visuais da EcomSmart.
/api/v1/onboarding/* http://whatsapp-entrypoint:8000 Endpoints de Meta Embedded Signup para conexão de WABA.
/health Resposta local 200 "ok\n" Sonda de integridade do container Nginx.
/* (todas as demais rotas) http://panel:8000 SPA do painel (React), telas de login, dashboard e APIs proxy.

Características de Resiliência

flowchart LR
    gw[Flow Gateway Nginx] -->|Query DNS 127.0.0.11| dns[Docker Embedded DNS]
    dns -->|Atualiza IP dinâmico em 10s| gw
    gw -->|Proxy sem cache de IP morto| dest[Containers Recriados]

    style gw fill:#f0f9ff,stroke:#0284c7,stroke-width:1.5px,color:#0369a1
    style dns fill:#fefce8,stroke:#d97706,stroke-width:1.5px,color:#92400e
    style dest fill:#f0fdf4,stroke:#16a34a,stroke-width:1.5px,color:#166534
  1. Resolução Dinâmica de IP (resolver 127.0.0.11 valid=10s ipv6=off;): Quando qualquer container de destino (landing, panel ou whatsapp-entrypoint) é reiniciado ou atualizado, seu IP interno no Docker pode mudar. O Nginx revalida os nomes a cada 10 segundos, evitando erros 502 Bad Gateway por IPs cacheados obsoletos.
  2. Payloads Grandes (client_max_body_size 64M;): Suporte a uploads de imagens de produtos e planilhas de catálogo sem rejeição antecipada pelo proxy.
  3. Preservação de Cabeçalhos (proxy_params): Encaminha X-Forwarded-For, X-Forwarded-Proto, X-Real-IP e Host originais da Cloudflare para que os serviços internos saibam o IP real do cliente.

Configuração Essencial

Variável / Parâmetro Padrão Descrição
FLOW_GATEWAY_PORT 3080 Porta local mapeada no host Docker (127.0.0.1:3080:8080).
Rede Docker ecomsmart-net Rede compartilhada obrigatória com o túnel da Cloudflare e os backends.
Arquivo de Proxy /etc/nginx/proxy_params Parâmetros compartilhados de repasse HTTP montados em modo somente leitura.

Diagnóstico Rápido

  1. Página retorna 502 Bad Gateway no domínio: Confirme se os containers panel e landing estão em execução na mesma rede ecomsmart-net. Execute docker ps --filter "name=ecomsmart" na VPS.
  2. Healthcheck do container: Teste localmente na VPS com curl -i http://127.0.0.1:3080/health. A resposta esperada é HTTP 200 com corpo ok.
  3. Falhas de rota do Embedded Signup: Se a janela de autorização do WhatsApp da Meta falhar ao conectar a conta, verifique se a URL /api/v1/onboarding/ está alcançando o container whatsapp-entrypoint:8000.