Files
SteelBase/public/docs-historicos/GUIA-DEPLOY.md

5.5 KiB

🚀 Guia Rápido de Deploy

Pré-requisitos

  • Conta no Vercel ou Netlify (gratuita)
  • Git instalado (opcional)
  • Navegador web

🎯 Opção 1: Deploy via Interface Web (MAIS FÁCIL)

Vercel

  1. Acesse: https://vercel.com
  2. Faça login com GitHub, GitLab ou email
  3. Clique em "Add New..." → "Project"
  4. Importe seu repositório Git OU
  5. Arraste a pasta do projeto para o site
  6. Clique em "Deploy"
  7. Pronto! Seu site estará no ar em ~30 segundos

URL: https://seu-projeto.vercel.app

Netlify

  1. Acesse: https://netlify.com
  2. Faça login com GitHub, GitLab ou email
  3. Arraste a pasta do projeto para a área "Drop"
  4. Aguarde o upload e deploy
  5. Pronto! Seu site estará no ar

URL: https://seu-projeto.netlify.app


🎯 Opção 2: Deploy via CLI (Mais Controle)

Vercel CLI

# 1. Instalar Vercel CLI (uma vez)
npm install -g vercel

# 2. Fazer login
vercel login

# 3. Na pasta do projeto, executar
vercel

# 4. Seguir as instruções:
#    - Set up and deploy? Yes
#    - Which scope? Sua conta
#    - Link to existing project? No
#    - Project name? aco-calc-pro (ou outro)
#    - Directory? ./
#    - Override settings? No

# 5. Para produção
vercel --prod

Netlify CLI

# 1. Instalar Netlify CLI (uma vez)
npm install -g netlify-cli

# 2. Fazer login
netlify login

# 3. Na pasta do projeto, executar
netlify deploy

# 4. Seguir as instruções:
#    - Create & configure a new site? Yes
#    - Team? Sua conta
#    - Site name? aco-calc-pro (ou outro)
#    - Publish directory? . (ponto)

# 5. Para produção
netlify deploy --prod

🎯 Opção 3: Deploy via Git (Automático)

1. Criar Repositório no GitHub

# Na pasta do projeto:
git init
git add .
git commit -m "Initial commit"
git branch -M main
git remote add origin https://github.com/seu-usuario/aco-calc-pro.git
git push -u origin main

2. Conectar ao Vercel

  1. Acesse https://vercel.com
  2. Clique em "Add New..." → "Project"
  3. Selecione seu repositório do GitHub
  4. Clique em "Deploy"
  5. Deploy automático a cada push!

3. Conectar ao Netlify

  1. Acesse https://netlify.com
  2. Clique em "Add new site" → "Import an existing project"
  3. Selecione GitHub
  4. Selecione seu repositório
  5. Clique em "Deploy site"
  6. Deploy automático a cada push!

⚙️ Configurações Importantes

Variáveis de Ambiente (Nenhuma necessária!)

Este projeto é 100% estático, não precisa de variáveis de ambiente.

Build Settings

  • Build Command: Nenhum (deixe vazio)
  • Output Directory: . (raiz do projeto)
  • Install Command: Nenhum

Headers e Cache

Já configurados em:

  • vercel.json para Vercel
  • netlify.toml para Netlify

🔍 Verificar Deploy

Após o deploy, teste:

  1. Abra o site na URL fornecida
  2. Teste o menu MATERIAIS → Catálogo de Perfis → Cantoneiras
  3. Clique em "🔄 Carregar Dados" se necessário
  4. Verifique se os 39 itens aparecem
  5. Teste outros cálculos e funcionalidades

🐛 Problemas Comuns

Erro 404 ao acessar rotas

Solução: Já configurado em vercel.json e netlify.toml

CSVs não carregam

Causa: Caminho incorreto ou CORS
Solução: Verificar se pasta BD/perfis/ foi incluída no deploy

Dados não aparecem

Solução: Clicar no botão "🔄 Carregar Dados" manualmente

Cache não funciona

Solução: localStorage pode estar desabilitado no navegador


📊 Monitoramento

Vercel

Netlify


🎨 Domínio Personalizado

Vercel

  1. Vá em Settings → Domains
  2. Adicione seu domínio
  3. Configure DNS conforme instruções
  4. Aguarde propagação (~24h)

Netlify

  1. Vá em Domain settings
  2. Adicione custom domain
  3. Configure DNS conforme instruções
  4. Aguarde propagação (~24h)

🔄 Atualizar Site

Via Git (Automático)

git add .
git commit -m "Atualização"
git push

Deploy automático em ~30 segundos!

Via CLI

# Vercel
vercel --prod

# Netlify
netlify deploy --prod

Via Interface

Arraste a pasta atualizada novamente.


💡 Dicas

Performance

  • CSVs são cacheados automaticamente
  • Headers de cache já configurados
  • Compressão automática (gzip/brotli)

SEO

  • Meta tags já incluídas no index.html
  • Sitemap pode ser adicionado se necessário
  • robots.txt pode ser adicionado

Analytics

  • Vercel Analytics: Automático (plano gratuito)
  • Google Analytics: Adicionar código no index.html
  • Netlify Analytics: Disponível (pago)

Checklist Final

Antes de fazer deploy:

  • Testar localmente (abrir index.html)
  • Verificar se CSVs estão na pasta BD/perfis/
  • Verificar se todos os arquivos .js estão incluídos
  • Testar carregamento de cantoneiras
  • Verificar console por erros
  • Testar em diferentes navegadores
  • Verificar responsividade (mobile)

🎉 Pronto!

Seu site estará no ar em minutos!

URLs de exemplo:

  • Vercel: https://aco-calc-pro.vercel.app
  • Netlify: https://aco-calc-pro.netlify.app

Boa sorte com o deploy! 🚀