Pular para conteúdo

Domínio Flow

Esta página documenta a arquitetura de borda, a topologia de rede e os procedimentos operacionais para publicação do domínio consolidado flow.ecomsmart.com.br, que unifica a Landing Page e o Painel Administrativo sob o mesmo origin HTTP, eliminando complexidades de CORS e múltiplos subdomínios.


Topologia de Borda e Roteamento

O tráfego de usuários passa pela rede segura da Cloudflare e entra na VPS através do túnel dedicado ecomsmart-flow-prod:

flowchart TD
    user([Navegador do Usuário / Lojista]) -->|HTTPS :443| cf[Cloudflare Edge: flow.ecomsmart.com.br]
    cf -->|Cloudflare Tunnel: Protocolo HTTP/2| tunnel[Container: cloudflare-tunnel-flow]
    tunnel -->|HTTP :8080 na rede ecomsmart-net| gw[Flow Gateway Nginx :8080]

    gw -->|/, /assets/*, /brand/*| landing[Landing Page: Nginx :8080]
    gw -->|/api/v1/onboarding/*| wpp[WhatsApp Entrypoint :8000]
    gw -->|/login, /dashboard, /panel-assets| panel[Painel SPA: Nginx :8000]
    panel -->|proxy /api, /auth, /merchants| bff[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 bff fill:#fefce8,stroke:#d97706,stroke-width:1.5px,color:#92400e

O certificado SSL/TLS termina na Cloudflare. O tráfego entre a Cloudflare e a VPS trafega criptografado via túnel Argo, e a comunicação interna entre containers ocorre na rede privada Docker ecomsmart-net.


Resultado e Mapeamento de Rotas

URL Pública Destino Interno Comportamento Esperado
https://flow.ecomsmart.com.br/ landing:8080 Landing institucional com apresentação do produto.
https://flow.ecomsmart.com.br/assets/* landing:8080 CSS, imagens e scripts com hash da Landing.
https://flow.ecomsmart.com.br/brand/* landing:8080 Logotipos institucionais e favicons.
https://flow.ecomsmart.com.br/api/v1/onboarding/* whatsapp-entrypoint:8000 Pop-up da Meta para Embedded Signup.
https://flow.ecomsmart.com.br/login panel:8000 Tela de autenticação do painel de controle.
https://flow.ecomsmart.com.br/dashboard/... panel:8000 Rotas protegidas da SPA do painel.
https://flow.ecomsmart.com.br/panel-assets/* panel:8000 Bundles isolados da SPA do painel (evita conflito com a landing).
https://flow.ecomsmart.com.br/api/... panel:8000 $\rightarrow$ bff:7000 APIs consumidas pelo frontend com cookies de sessão.

Configuração na Cloudflare

1. Registro DNS

Na zona ecomsmart.com.br: * Tipo: CNAME * Nome: flow * Destino: <TUNNEL_ID>.cfargotunnel.com * Proxy: Ativado (nuvem laranja) * TTL: Automático

(Não deve existir registro do tipo A com nome flow apontando diretamente para o IP da VPS).

2. Configuração do Túnel (Zero Trust)

No Cloudflare Zero Trust Dashboard: * Nome do Túnel: ecomsmart-flow-prod * Published Application: * Hostname: flow.ecomsmart.com.br * Caminho: (vazio) * URL do Serviço: http://flow-gateway:8080

Evitar Destino Antigo

Configurar a URL do serviço como http://landing:8080 publica apenas a landing, quebrando as rotas de /login e do painel. O destino correto é sempre http://flow-gateway:8080.


Deploy e Testes de Validação

Para aplicar ou validar o domínio unificado sem reiniciar bancos ou agentes:

# 1. Atualizar e recriar apenas os containers envolvidos
docker compose -f infra/docker-compose.yaml up -d --build --no-deps landing panel
docker compose -f infra/docker-compose.yaml up -d --no-deps --force-recreate frontend-entrypoint
docker compose -f infra/docker-compose.yaml up -d --no-deps flow-gateway

# 2. Testar o roteamento localmente na porta de diagnóstico 3080
curl -I http://127.0.0.1:3080/
curl -I http://127.0.0.1:3080/login
curl -I http://127.0.0.1:3080/dashboard/visao-geral

Os três testes devem retornar HTTP 200 OK.


Checklist de Validação Externa (Janela Anônima)

  1. [x] A página inicial abre a landing em https://flow.ecomsmart.com.br/.
  2. [x] O botão "Entrar no Painel" navega para https://flow.ecomsmart.com.br/login.
  3. [x] Login com credenciais válidas autentica e redireciona para /dashboard.
  4. [x] Atualizar a página em uma rota interna (ex: /dashboard/conversas) não retorna erro 404.
  5. [x] Não ocorrem erros 404 para recursos em /assets/ ou /panel-assets/.
  6. [x] O fluxo de Embedded Signup do WhatsApp completa sem bloqueio de CORS.

Procedimento de Rollback

Caso o tráfego público precise ser revertido imediatamente:

  1. No Cloudflare Zero Trust, acesse as rotas do túnel e altere a URL do serviço de volta para:
    URL do serviço: http://landing:8080
    
  2. O tráfego do domínio flow.ecomsmart.com.br volta instantaneamente a atender exclusivamente a landing.
  3. Os administradores continuam podendo acessar o painel pelo endereço legado de contingência (https://prod-panel.application-ec.shop) até a estabilização.