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

179 lines
4.2 KiB
Markdown

# 🚀 Workflow Deploy PIX - Local para Servidor
## 📋 **Seu Fluxo de Trabalho**
Você desenvolve na **máquina local** e depois faz **deploy para o servidor**. Este guia é específico para essa situação.
---
## ⚡ **Deploy Automático (Recomendado)**
### **1. Execute o Script de Deploy:**
```bash
# Na sua máquina local:
cd /home/tiago/Downloads/app_estoque
./deploy-pix-completo.sh tiago@192.168.195.145
```
**O script fará automaticamente:**
- ✅ Build do frontend React
- ✅ Envio de todos os arquivos PIX
- ✅ Instalação das dependências no servidor
- ✅ Configuração inicial do .env
---
## 🔧 **Configuração Final no Servidor**
### **2. Configurar Credenciais Mercado Pago:**
```bash
# Conecte no servidor:
ssh tiago@192.168.195.145
cd ~/app_estoque
# Edite o .env:
nano .env
# Configure estas linhas:
MERCADOPAGO_ACCESS_TOKEN=TEST-sua_access_token_aqui
MERCADOPAGO_PUBLIC_KEY=pk_test_sua_public_key_aqui
BASE_URL=http://192.168.195.145:5000
```
### **3. Aplicar SQL no Supabase:**
- Acesse: https://supabase.com/dashboard
- Vá em **SQL Editor**
- Execute o conteúdo do arquivo: `aplicar-pix-supabase.sql`
### **4. Reiniciar Servidor:**
```bash
# No servidor:
pm2 restart liberi-kids
# ou se não estiver rodando:
pm2 start server-supabase.js --name liberi-kids
```
---
## 🏦 **Obter Credenciais Mercado Pago**
1. **Acesse:** https://www.mercadopago.com.br/developers
2. **Faça login** ou crie conta
3. **Vá em:** "Suas integrações" → "Criar aplicação"
4. **Escolha:** "Pagamentos online"
5. **Copie:**
- **Access Token:** `TEST-1234567890-abcdef...`
- **Public Key:** `pk_test_1234567890abcdef...`
---
## 📁 **Estrutura de Arquivos Enviados**
```
servidor:~/app_estoque/
├── server-supabase.js # Backend atualizado com PIX
├── config/
│ └── mercadopago.js # Serviço PIX
├── client/build/ # Frontend compilado
├── sql/
│ └── add-pix-fields.sql # Migração banco
├── scripts/
│ └── migrate-pix-fields.js # Script migração
├── aplicar-pix-supabase.sql # SQL direto Supabase
├── configurar-pix-servidor.sh # Script configuração
└── .env # Configurações (você edita)
```
---
## 🧪 **Como Testar**
1. **Acesse o sistema** no servidor
2. **Vá em Vendas**
3. **Clique no botão PIX** (ícone 💳)
4. **Verifique se:**
- Modal PIX abre
- QR Code é gerado
- Código PIX aparece para copiar
---
## 🔄 **Próximos Deploys**
Para **atualizações futuras**, você pode:
### **Opção 1: Script Completo (Recomendado)**
```bash
./deploy-pix-completo.sh tiago@192.168.195.145
```
### **Opção 2: Envio Manual**
```bash
# Build local:
cd client && npm run build && cd ..
# Envio específico:
rsync -avz --progress server-supabase.js tiago@192.168.195.145:~/app_estoque/
rsync -avz --progress client/build/ tiago@192.168.195.145:~/app_estoque/client/build/
rsync -avz --progress config/ tiago@192.168.195.145:~/app_estoque/config/
# Reiniciar no servidor:
ssh tiago@192.168.195.145 "cd ~/app_estoque && pm2 restart liberi-kids"
```
---
## ⚠️ **Troubleshooting**
### **Erro de Conexão SSH:**
```bash
# Teste a conexão:
ssh tiago@192.168.195.145
# Se não funcionar, verifique:
# - Servidor ligado?
# - SSH funcionando?
# - Credenciais corretas?
```
### **Erro no Build:**
```bash
# Na máquina local:
cd client
npm install
npm run build
```
### **Erro no Servidor:**
```bash
# No servidor:
ssh tiago@192.168.195.145
cd ~/app_estoque
npm install
pm2 logs liberi-kids
```
---
## 💡 **Dicas Importantes**
1. **Sempre faça build local** antes do deploy
2. **Mantenha credenciais seguras** no .env do servidor
3. **Use credenciais TEST** para desenvolvimento
4. **Configure webhook URL** no Mercado Pago para produção
5. **Monitore logs** com `pm2 logs liberi-kids`
---
## 🎉 **Resultado Final**
Após seguir este workflow, você terá:
-**PIX funcionando** no servidor
-**QR Code automático** nas vendas
-**Confirmação em tempo real**
-**Interface moderna** e responsiva
-**Deploy automatizado** para futuras atualizações
**Seu sistema estará pronto para aceitar pagamentos PIX!** 🏦💳