Primeiro commit

GOOGLE-DRIVE-SETUP.md

@@ -0,0 +1,146 @@
+# 📁 Google Drive Integration - Guia de Configuração
+
+Este guia explica como configurar a integração com Google Drive para armazenar as fotos dos produtos automaticamente na nuvem.
+
+## 🎯 Benefícios da Integração
+
+- **☁️ Armazenamento na Nuvem:** Fotos salvas automaticamente no Google Drive
+- **🔒 Backup Seguro:** Suas imagens ficam protegidas na nuvem do Google
+- **📱 Acesso Universal:** Visualize as fotos de qualquer dispositivo
+- **💾 Economia de Espaço:** Não ocupa espaço no servidor local
+- **🔗 URLs Públicas:** Links diretos para visualização das imagens
+
+## 🚀 Configuração Passo a Passo
+
+### 1. Criar Projeto no Google Cloud Console
+
+1. Acesse [Google Cloud Console](https://console.cloud.google.com/)
+2. Clique em **"Selecionar projeto"** → **"Novo projeto"**
+3. Digite o nome: `Liberi Kids - Sistema`
+4. Clique em **"Criar"**
+
+### 2. Ativar Google Drive API
+
+1. No menu lateral, vá em **"APIs e serviços"** → **"Biblioteca"**
+2. Pesquise por **"Google Drive API"**
+3. Clique na API e depois em **"Ativar"**
+
+### 3. Criar Credenciais OAuth 2.0
+
+1. Vá em **"APIs e serviços"** → **"Credenciais"**
+2. Clique em **"+ Criar credenciais"** → **"ID do cliente OAuth"**
+3. Selecione **"Aplicação da Web"**
+4. Configure:
+   - **Nome:** `Liberi Kids Sistema`
+   - **URIs de redirecionamento autorizados:** 
+     ```
+     http://localhost:5000/auth/google-drive/callback
+     ```
+5. Clique em **"Criar"**
+6. **Copie o Client ID e Client Secret** que aparecerão
+
+### 4. Configurar no Sistema
+
+1. Acesse **Configurações** no sistema Liberi Kids
+2. Encontre a seção **"📁 Google Drive - Armazenamento de Fotos"**
+3. Clique para expandir
+4. Cole as credenciais:
+   - **Client ID:** Cole o ID copiado do Google Cloud
+   - **Client Secret:** Cole o Secret copiado do Google Cloud
+5. Clique em **"Salvar Credenciais"**
+
+### 5. Autorizar Acesso
+
+1. Após salvar, clique em **"Autorizar Google Drive"**
+2. Uma nova janela abrirá com a tela de login do Google
+3. Faça login com sua conta Google
+4. Autorize o acesso aos arquivos do Google Drive
+5. A janela fechará automaticamente
+6. Verifique se o status mudou para **"✅ Conectado"**
+
+## 📋 Como Funciona
+
+### Upload Automático
+- Quando você cadastra um produto com fotos, o sistema detecta automaticamente se o Google Drive está configurado
+- Se estiver conectado, as fotos são enviadas para a pasta **"Liberi Kids - Fotos Produtos"**
+- Caso contrário, usa o armazenamento local como antes
+
+### Organização das Fotos
+- **Pasta Principal:** `Liberi Kids - Fotos Produtos`
+- **Nome dos Arquivos:** `Marca_NomeProduto_Tamanho_Cor_Timestamp.jpg`
+- **Exemplo:** `Nike_Camiseta_M_Azul_1641234567890.jpg`
+
+### URLs Públicas
+- Cada foto recebe uma URL pública do Google Drive
+- As URLs são salvas no banco de dados
+- As imagens são exibidas normalmente no sistema
+
+## 🔧 Configurações Avançadas
+
+### Informações de Armazenamento
+O sistema mostra:
+- **Espaço Usado:** Quanto você já utilizou
+- **Espaço Total:** Limite da sua conta Google
+- **Espaço Livre:** Quanto ainda pode usar
+
+### Renovação Automática
+- Os tokens de acesso são renovados automaticamente
+- Não é necessário reautorizar frequentemente
+- O sistema mantém a conexão ativa
+
+## 🛠️ Solução de Problemas
+
+### Erro: "Credenciais não configuradas"
+- Verifique se copiou corretamente o Client ID e Client Secret
+- Certifique-se de que ativou a Google Drive API
+
+### Erro: "Autorização pendente"
+- Clique em "Autorizar Google Drive" novamente
+- Verifique se não bloqueou pop-ups no navegador
+
+### Erro: "Erro de conexão"
+- Clique em "Tentar Novamente"
+- Se persistir, clique em "Reconfigurar Tudo"
+
+### Fotos não aparecem
+- Verifique se as URLs começam com `https://drive.google.com/`
+- Teste se consegue acessar a pasta no Google Drive
+
+## 📊 Monitoramento
+
+### Status da Conexão
+- **🟢 Conectado:** Tudo funcionando
+- **🟡 Não configurado:** Precisa configurar credenciais
+- **🔵 Autorização pendente:** Precisa autorizar acesso
+- **🔴 Erro de conexão:** Problema na conexão
+
+### Ações Disponíveis
+- **Atualizar Status:** Verifica a conexão atual
+- **Abrir Google Drive:** Acessa sua pasta no navegador
+- **Desconectar:** Remove a integração
+
+## 🔐 Segurança
+
+### Dados Protegidos
+- Credenciais salvas criptografadas no Supabase
+- Tokens renovados automaticamente
+- Acesso limitado apenas às pastas necessárias
+
+### Permissões
+O sistema solicita apenas:
+- **drive.file:** Criar e gerenciar arquivos criados pelo app
+- **drive.readonly:** Ler informações básicas do Drive
+
+## 📝 Notas Importantes
+
+1. **Conta Google:** Use uma conta Google com espaço suficiente
+2. **Backup Local:** O sistema mantém fallback para armazenamento local
+3. **Compatibilidade:** Funciona com produtos existentes
+4. **Performance:** Upload pode ser mais lento que armazenamento local
+5. **Dependência:** Requer conexão com internet para upload
+
+## 🎉 Pronto!
+
+Após seguir todos os passos, suas fotos de produtos serão automaticamente salvas no Google Drive, proporcionando backup seguro e acesso universal às imagens do seu estoque.
+
+Para dúvidas ou problemas, verifique os logs do sistema ou entre em contato com o suporte técnico.