# 📁 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.