App-Estoque-LiberiKids/INICIO-RAPIDO-SERVIDOR.md

🚀 Início Rápido - Servidor Local Persistente

Como rodar o sistema no servidor e manter funcionando sempre

---

⚡ Método Rápido (Recomendado)

Execute apenas 1 comando:

./scripts/deploy-servidor.sh

Este script vai:

• ✅ Verificar dependências
• ✅ Instalar PM2 automaticamente
• ✅ Fazer build do frontend
• ✅ Iniciar a aplicação
• ✅ Configurar para reiniciar automaticamente

---

🔧 Configuração Manual

Se preferir fazer passo a passo:

1. Instalar PM2 (Gerenciador de Processos)

sudo npm install -g pm2

2. Configurar o projeto

# Instalar dependências
npm install
cd client && npm install && cd ..

# Configurar .env
cp .env.example .env
nano .env  # Configure suas credenciais

# Build do frontend
npm run build

3. Iniciar com PM2

# Iniciar aplicação
pm2 start ecosystem.config.js

# Salvar configuração
pm2 save

# Configurar para iniciar no boot
pm2 startup
# Execute o comando que o PM2 mostrar

---

📊 Comandos Essenciais

# Ver status
pm2 status

# Ver logs em tempo real
pm2 logs liberi-kids-estoque

# Reiniciar aplicação
pm2 restart liberi-kids-estoque

# Parar aplicação
pm2 stop liberi-kids-estoque

# Monitorar recursos
pm2 monit

---

🔄 Atualizar Aplicação

Quando fizer alterações no código:

# 1. Se alterou o frontend
cd client && npm run build && cd ..

# 2. Reiniciar PM2
pm2 restart liberi-kids-estoque

---

🌐 Acessar Aplicação

Após iniciar, acesse:

• Local: http://localhost:5000
• Na rede: http://SEU-IP:5000
• Catálogo: http://localhost:5000/catalogo

---

🛡️ Systemd (Alternativa ao PM2)

Se preferir usar systemd:

# Instalar serviço
sudo ./scripts/install-systemd.sh

# Comandos
sudo systemctl status liberi-kids
sudo systemctl restart liberi-kids
sudo journalctl -u liberi-kids -f

---

⚠️ Problemas Comuns

Porta em uso

sudo lsof -i :5000
sudo kill -9 PID

PM2 não encontra node

pm2 unstartup
pm2 startup
pm2 save

Aplicação não inicia

pm2 logs liberi-kids-estoque --lines 50

---

📖 Documentação Completa

Para mais detalhes, consulte:

• Guia Completo: DEPLOY-SERVIDOR-LOCAL.md
• Deploy Geral: README-DEPLOY.md

---

✅ Resumo

1. Execute: ./scripts/deploy-servidor.sh
2. Configure auto-start quando solicitado
3. Sistema rodará sempre, mesmo após reiniciar servidor
4. Use pm2 logs para monitorar

Pronto! 🎉