App-Estoque-LiberiKids/GOOGLE-SHEETS-SETUP.md

📊 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
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