149 lines
4.2 KiB
Markdown
149 lines
4.2 KiB
Markdown
# 📊 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**
|