App-Estoque-LiberiKids/README-DEPLOY.md

🚀 Deploy Rápido - Liberi Kids

⚡ Deploy em 3 Comandos

1. 🖥️ Servidor Local (Recomendado para começar)

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

# 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)

# 1. Deploy automático
npm run deploy:vercel

# 2. Configure variáveis no dashboard do Vercel
# 3. Acesse a URL fornecida

3. 🐳 Docker (Containerizado)

# 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"

# Solução: Configure o arquivo .env
cp .env.example .env
# Edite com suas credenciais

❌ Erro: "Porta 5000 em uso"

# Solução: Mate processos na porta
sudo lsof -ti:5000 | xargs kill -9

❌ Erro: "Build falhou"

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

# PM2 (local)
pm2 logs liberi-kids

# Docker
docker logs liberi-kids-app

# Vercel
vercel logs

Comandos Úteis:

# 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