# 📊 Configuração Google Sheets - Liberi Kids

Este guia explica como configurar a integração com Google Sheets para exportar dados do sistema.

## 🚀 Passo a Passo

### 1. Criar Projeto no Google Cloud Console

1. Acesse [Google Cloud Console](https://console.cloud.google.com/)
2. Clique em **"Criar Projeto"** ou selecione um existente
3. Dê um nome ao projeto (ex: "Liberi Kids Sheets")
4. Anote o **Project ID** gerado

### 2. Ativar APIs Necessárias

1. No menu lateral, vá em **"APIs e Serviços" > "Biblioteca"**
2. Procure e ative as seguintes APIs:
   - **Google Sheets API**
   - **Google Drive API**

### 3. Criar Credenciais OAuth 2.0

1. Vá em **"APIs e Serviços" > "Credenciais"**
2. Clique em **"+ CRIAR CREDENCIAIS" > "ID do cliente OAuth"**
3. Escolha **"Aplicação da Web"**
4. Configure:
   - **Nome:** Liberi Kids
   - **URIs de redirecionamento autorizados:**
     ```
     http://localhost:5000/auth/google/callback
     ```
   - Para produção, adicione também:
     ```
     https://seu-dominio.com/auth/google/callback
     ```

### 4. Copiar Credenciais

1. Após criar, você verá as credenciais na tela
2. **Copie o Client ID** (formato: 123456789-abc123.apps.googleusercontent.com)
3. **Copie o Client Secret** (formato: GOCSPX-abc123def456...)
4. Guarde essas informações para inserir na interface do sistema

### 5. Configurar Tela de Consentimento OAuth

1. Vá em **"APIs e Serviços" > "Tela de consentimento OAuth"**
2. Escolha **"Externo"** (para uso geral)
3. Preencha as informações obrigatórias:
   - **Nome do app:** Liberi Kids
   - **Email de suporte:** seu-email@exemplo.com
   - **Domínios autorizados:** localhost (para desenvolvimento)

### 6. Adicionar Escopos

Na configuração da tela de consentimento, adicione os escopos:
- `https://www.googleapis.com/auth/spreadsheets`
- `https://www.googleapis.com/auth/drive.file`

## 🔧 Configuração no Sistema

Após obter as credenciais do Google Cloud Console:

1. **Acesse o sistema Liberi Kids**
2. **Vá em Configurações > Google Sheets**
3. **Preencha os campos:**
   - **Client ID:** Cole o Client ID copiado
   - **Client Secret:** Cole o Client Secret copiado
   - **URI de Redirecionamento:** Já preenchido automaticamente
4. **Clique em "Salvar Credenciais"**
5. **Clique em "Conectar com Google"** para autorizar

## 📋 Dados Exportados

### Aba "Produtos"
- ID da Roupa
- Nome do Produto  
- Fornecedor
- Tamanho
- Estação
- Gênero
- Valor da Compra
- Valor da Venda
- Data da Compra
- Data da Venda
- Estoque Atual
- Marca

### Aba "Vendas"
- ID da Venda
- Cliente
- Data da Venda
- Tipo de Pagamento
- Valor Total
- Desconto
- Valor Final
- Status
- Observações
- Produtos Vendidos

## 🎯 Como Usar

1. **Configuração inicial:**
   - Configure as credenciais conforme descrito acima
   - Autorize o acesso ao Google na primeira vez

2. **Exportar dados:**
   - Vá em Configurações > Google Sheets
   - Escolha o tipo de exportação (Produtos, Vendas ou Tudo)
   - Defina um nome para a planilha (opcional)
   - Clique em exportar
   - A planilha será criada e aberta automaticamente

## 🔒 Segurança

- ✅ **Credenciais salvas no Supabase** de forma segura
- ✅ **Tokens são salvos localmente** e renovados automaticamente
- ✅ **Acesso limitado** apenas às planilhas criadas pelo app
- ✅ **Dados criptografados** durante a transmissão

## 🚨 Troubleshooting

### Erro: "Credenciais do Google não configuradas"
- Vá em Configurações > Google Sheets
- Preencha os campos Client ID e Client Secret
- Clique em "Salvar Credenciais"

### Erro: "redirect_uri_mismatch"
- Verifique se o URI de redirecionamento está correto no Google Cloud Console
- Para desenvolvimento: `http://localhost:5000/auth/google/callback`

### Erro: "access_denied"
- Verifique se as APIs estão ativadas
- Confirme se os escopos estão configurados corretamente

### Planilha não abre automaticamente
- Verifique se o bloqueador de pop-ups está desabilitado
- A URL da planilha aparece no toast de sucesso

## 📞 Suporte

Se encontrar problemas:
1. Verifique os logs do servidor no terminal
2. Confirme se todas as APIs estão ativadas
3. Teste a conexão na página de Configurações

---

**Desenvolvido para Liberi Kids - Sistema de Controle de Estoque**