Files
App-Estoque-LiberiKids/README-DEPLOY.md
2025-10-14 14:04:17 -03:00

162 lines
3.0 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
```
### 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`