# 🚀 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**:

```bash
./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)

```bash
sudo npm install -g pm2
```

### 2. Configurar o projeto

```bash
# 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

```bash
# 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

```bash
# 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:

```bash
# 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:

```bash
# 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
```bash
sudo lsof -i :5000
sudo kill -9 PID
```

### PM2 não encontra node
```bash
pm2 unstartup
pm2 startup
pm2 save
```

### Aplicação não inicia
```bash
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! 🎉**