Landing
A Landing Page é o ponto público de apresentação institucional e comercial da plataforma EcomSmart. Desenvolvida como uma aplicação web moderna (React, Vite e Tailwind CSS) e empacotada em uma imagem estática Nginx, ela apresenta os recursos da solução, a proposta de valor para lojistas e direciona os usuários para o cadastro e login no Painel Administrativo.
No ambiente de produção, a landing divide o domínio consolidado flow.ecomsmart.com.br com o painel através do Flow Gateway, atendendo as requisições de raiz e arquivos estáticos.
Papel na Plataforma
flowchart LR
user([Visitante / Novo Lojista]) -->|HTTPS| cf[Cloudflare Edge]
cf -->|Cloudflare Tunnel| gw[Flow Gateway :8080]
gw -->|/, /index.html, /assets/*, /brand/*| landing[Landing Nginx :8080]
landing -->|Assets estáticos cacheados| user
user -.->|Clica em 'Entrar no Painel'| login[Redireciona para /login]
login -.-> gw
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 gw fill:#f0f9ff,stroke:#0284c7,stroke-width:1.5px,color:#0369a1
style landing fill:#f0fdf4,stroke:#16a34a,stroke-width:2px,color:#166534
style login fill:#faf5ff,stroke:#9333ea,stroke-width:1.5px,color:#6b21a8
Limites de Responsabilidade
| É responsabilidade da Landing | NÃO é responsabilidade da Landing |
|---|---|
| Apresentar a proposta de valor e funcionalidades do ecossistema EcomSmart. | Autenticar credenciais ou gerenciar sessões de lojistas (BFF). |
| Servir bundles otimizados de JavaScript, CSS, imagens e fontes de marca. | Acessar bancos de dados relacionais ou vetoriais. |
| Fornecer cabeçalhos estritos de cache imutável para assets estáticos. | Falar diretamente com a Meta Graph API ou WhatsApp. |
Responder à sonda de saúde do container em GET /health (200 "ok\n"). |
Processar pagamentos, cálculo de frete ou pedidos. |
Estrutura de Rotas e Políticas de Cache
O servidor Nginx do container (modules/landing/nginx.conf) aplica regras especializadas por tipo de recurso:
| Caminho da URL | Tratamento Nginx | Cabeçalhos / Política de Cache |
|---|---|---|
/ |
try_files $uri $uri/ /index.html |
SPA Fallback com revalidação padrão. |
/assets/* |
try_files $uri =404 |
expires 1y; add_header Cache-Control "public, immutable"; |
/brand/* |
try_files $uri =404 |
Cache estático para logos e símbolos institucionais. |
/health |
Resposta em texto puro 200 "ok\n" |
Sonda local de integridade com logs de acesso desativados (access_log off). |
Integração com o Domínio Unificado
No domínio consolidado (flow.ecomsmart.com.br), o Flow Gateway encaminha o tráfego estático para a landing através de regras upstream:
flowchart TD
req[Requisição para flow.ecomsmart.com.br] --> check{Caminho da URL}
check -->|/, /index.html, /assets/*, /brand/*| landing[Encaminha para landing:8080]
check -->|/api/v1/onboarding/*| wpp[Encaminha para whatsapp-entrypoint:8000]
check -->|Demais rotas /login, /dashboard| panel[Encaminha para panel:8000]
style req fill:#f8fafc,stroke:#64748b,stroke-width:1.5px,color:#1e293b
style check fill:#fefce8,stroke:#d97706,stroke-width:1.5px,color:#92400e
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
Em desenvolvimento local, a landing também pode ser acessada diretamente na porta mapeada em LANDING_PORT (padrão: http://localhost:3000).
Configuração Essencial
| Variável | Padrão | Descrição |
|---|---|---|
LANDING_PORT |
3000 |
Porta local mapeada no host Docker em desenvolvimento. |
| Rede Docker | ecomsmart-net |
Rede interna compartilhada com o Flow Gateway. |
Diagnóstico Rápido
- A página inicial retorna tela em branco ou erro 404:
Verifique o log de build do container. Como o projeto compila o frontend estático durante o
docker buildvia Vite (npm run build), confira se o diretóriodistfoi copiado corretamente para/usr/share/nginx/html. - Sonda de integridade do container falhando:
Teste o endpoint interno via terminal da VPS:
A resposta deve ser exatamente
ok. - Imagens ou fontes não carregando:
Inspecione a aba Network do navegador. Arquivos localizados em
/assets/possuem cache imutável de 1 ano; se houver atualização de imagens sem alteração do hash do arquivo Vite, execute uma limpeza de cache no navegador ou no painel da Cloudflare.