🚀 Mini CRM: Python + Google Sheets Este projeto nasceu da vontade de unir duas coisas que curto muito: automação e gestão de dados. É um Mini CRM desenvolvido em Python que utiliza tkinter para a interface e o gspread para transformar o Google Sheets em um banco de dados dinâmico e acessível.
[!IMPORTANT] Status: 🚧 Em construção e refatoração constante. Este é um projeto de estudo. O código atual é funcional, mas o meu "eu de amanhã" já está planejando refatorar tudo para Orientação a Objetos (POO), melhorar a segurança com variáveis de ambiente (.env) e otimizar a performance.
🛠️ O que ele faz hoje? Atualmente, o sistema foca na entrada rápida de leads:
Interface Amigável: Janela simples para cadastro de Nome, E-mail, Telefone e Estágio no Funil.
UX no Terminal: Máscara automática para telefones (porque ninguém merece digitar parênteses e traços toda hora).
Nuvem Real-time: Integração direta com o Google Sheets. Cadastrou no app? Apareceu na planilha.
🚀 Como rodar na sua máquina
- Preparando o terreno Primeiro, clone o repositório e instale as dependências:
Bash pip install -r requirements.txt 2. A Ponte com o Google (Configuração da API) Para o Python conversar com sua planilha, você vai precisar de uma "chave da casa":
Crie um projeto no Google Cloud Console.
Ative as APIs: Google Drive e Google Sheets.
Crie uma Conta de Serviço (Service Account) e baixe o arquivo .json com as credenciais.
O pulo do gato: Abra sua planilha no navegador e "Compartilhe" ela com o e-mail da Conta de Serviço que você acabou de criar (coloque como Editor).
Salve o arquivo JSON na raiz do projeto e atualize a variável JSON_FILE nos arquivos main.py e dbsheets.py.
- Hora do Show Com tudo configurado, é só dar o play:
Bash python main.py 📈 Próximos Passos (Backlog) [ ] Implementar POO para deixar o código mais limpo e escalável.
[ ] Migrar chaves sensíveis para um arquivo .env (Segurança em primeiro lugar!).
[ ] Adicionar uma aba de visualização/edição de leads dentro do próprio App.
[ ] Logs de erro para facilitar o debug.