chore: sincroniza projeto para gitea

INICIO-RAPIDO-SERVIDOR.md

@@ -0,0 +1,163 @@
+# 🚀 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! 🎉**