Pular para conteúdo

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

  1. 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 build via Vite (npm run build), confira se o diretório dist foi copiado corretamente para /usr/share/nginx/html.
  2. Sonda de integridade do container falhando: Teste o endpoint interno via terminal da VPS:
    docker compose exec landing wget -qO- http://127.0.0.1:8080/health
    
    A resposta deve ser exatamente ok.
  3. 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.