Primeiro commit

2025-10-14 14:04:17 -03:00
commit 33d8645eb4
109 changed files with 55424 additions and 0 deletions
--- a/GOOGLE-SHEETS-SETUP.md
+++ b/GOOGLE-SHEETS-SETUP.md
@@ -0,0 +1,148 @@
+# 📊 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**