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
- Resolução Dinâmica de IP (
resolver 127.0.0.11 valid=10s ipv6=off;): Quando qualquer container de destino (landing,panelouwhatsapp-entrypoint) é reiniciado ou atualizado, seu IP interno no Docker pode mudar. O Nginx revalida os nomes a cada 10 segundos, evitando erros502 Bad Gatewaypor IPs cacheados obsoletos. - 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. - Preservação de Cabeçalhos (
proxy_params): EncaminhaX-Forwarded-For,X-Forwarded-Proto,X-Real-IPeHostoriginais 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
- Página retorna 502 Bad Gateway no domínio:
Confirme se os containers
panelelandingestão em execução na mesma redeecomsmart-net. Executedocker ps --filter "name=ecomsmart"na VPS. - Healthcheck do container:
Teste localmente na VPS com
curl -i http://127.0.0.1:3080/health. A resposta esperada é HTTP 200 com corpook. - 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 containerwhatsapp-entrypoint:8000.