Files
App-Estoque-LiberiKids/README-DEPLOY.md
2025-11-29 21:31:52 -03:00

181 lines
3.4 KiB
Markdown

# 🚀 Deploy Rápido - Liberi Kids
## ⚡ Deploy em 3 Comandos
### 1. 🖥️ **Servidor Local (Recomendado para começar)**
```bash
# 1. Configure suas credenciais
cp .env.example .env
# Edite o .env com suas credenciais do Supabase
# 2. Execute o deploy automático
npm run deploy:local
# 3. Acesse: http://localhost:5000
```
### 1.1 🔄 **Servidor Local com Auto-Reinicialização (PM2)**
Para manter o sistema rodando mesmo após reiniciar o servidor:
```bash
# Deploy completo com PM2 (mantém rodando sempre)
./scripts/deploy-servidor.sh
# Ou configure manualmente:
npm install -g pm2
pm2 start ecosystem.config.js
pm2 save
pm2 startup
# Acesse: http://localhost:5000
```
**📖 Guia completo:** Ver `DEPLOY-SERVIDOR-LOCAL.md` para instruções detalhadas
### 2. ☁️ **Nuvem Gratuita (Vercel)**
```bash
# 1. Deploy automático
npm run deploy:vercel
# 2. Configure variáveis no dashboard do Vercel
# 3. Acesse a URL fornecida
```
### 3. 🐳 **Docker (Containerizado)**
```bash
# 1. Configure o .env
cp .env.example .env
# 2. Execute com Docker
docker-compose up -d
# 3. Acesse: http://localhost:5000
```
---
## 📋 **Pré-requisitos Mínimos**
- ✅ Node.js 18+
- ✅ Conta no Supabase (gratuita)
- ✅ Credenciais do Supabase configuradas
---
## 🔧 **Configuração Rápida do Supabase**
1. **Acesse:** https://supabase.com/dashboard
2. **Crie um projeto** (ou use existente)
3. **Vá em Settings > API**
4. **Copie:**
- Project URL → `SUPABASE_URL`
- anon public key → `SUPABASE_ANON_KEY`
5. **Cole no arquivo .env**
---
## 🌐 **Opções de Hospedagem**
| Plataforma | Custo | Facilidade | Recomendado Para |
|------------|-------|------------|------------------|
| **Vercel** | Gratuito | ⭐⭐⭐⭐⭐ | Pequenas empresas |
| **Railway** | $5/mês | ⭐⭐⭐⭐ | Empresas médias |
| **VPS** | $5-20/mês | ⭐⭐⭐ | Controle total |
| **Local** | Gratuito | ⭐⭐⭐⭐ | Desenvolvimento |
---
## 🚨 **Resolução de Problemas**
### ❌ Erro: "SUPABASE_URL não definida"
```bash
# Solução: Configure o arquivo .env
cp .env.example .env
# Edite com suas credenciais
```
### ❌ Erro: "Porta 5000 em uso"
```bash
# Solução: Mate processos na porta
sudo lsof -ti:5000 | xargs kill -9
```
### ❌ Erro: "Build falhou"
```bash
# Solução: Limpe e reinstale
rm -rf node_modules client/node_modules
npm install
cd client && npm install
```
---
## 📱 **Acesso Móvel**
A aplicação é **PWA** (Progressive Web App):
- ✅ Funciona no celular
- ✅ Pode ser "instalada"
- ✅ Interface responsiva
- ✅ Funciona offline (parcialmente)
---
## 🔒 **Segurança**
### Para Produção:
- ✅ Use HTTPS sempre
- ✅ Configure firewall
- ✅ Mantenha Node.js atualizado
- ✅ Use variáveis de ambiente
- ✅ Backup regular do Supabase
---
## 📞 **Suporte Rápido**
### Logs de Erro:
```bash
# PM2 (local)
pm2 logs liberi-kids
# Docker
docker logs liberi-kids-app
# Vercel
vercel logs
```
### Comandos Úteis:
```bash
# Reiniciar aplicação
pm2 restart liberi-kids
# Status do servidor
pm2 status
# Parar aplicação
pm2 stop liberi-kids
```
---
## 🎯 **Próximos Passos**
Após o deploy:
1.**Teste todas as funcionalidades**
2.**Configure backup automático**
3.**Monitore performance**
4.**Configure domínio próprio** (opcional)
5.**Treine usuários**
---
**🎉 Sua aplicação está pronta para o mundo real!**
Para suporte detalhado, consulte: `DEPLOY-GUIDE.md`