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)
- [x] A página inicial abre a landing em
https://flow.ecomsmart.com.br/. - [x] O botão "Entrar no Painel" navega para
https://flow.ecomsmart.com.br/login. - [x] Login com credenciais válidas autentica e redireciona para
/dashboard. - [x] Atualizar a página em uma rota interna (ex:
/dashboard/conversas) não retorna erro 404. - [x] Não ocorrem erros 404 para recursos em
/assets/ou/panel-assets/. - [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:
- No Cloudflare Zero Trust, acesse as rotas do túnel e altere a URL do serviço de volta para:
- O tráfego do domínio
flow.ecomsmart.com.brvolta instantaneamente a atender exclusivamente a landing. - Os administradores continuam podendo acessar o painel pelo endereço legado de contingência (
https://prod-panel.application-ec.shop) até a estabilização.