📦
projeto-leads-management
No description available
0 installs
Trust: 30 — Low
Other
Ask AI about projeto-leads-management
Powered by Claude · Grounded in docs
I know everything about projeto-leads-management. Ask me about installation, configuration, usage, or troubleshooting.
0/500
Loading tools...
Reviews
Documentation
Sistema de Gerenciamento de Leads
Um sistema completo de gerenciamento de leads desenvolvido com React, TypeScript, Supabase e Tailwind CSS.
📋 Funcionalidades
- ✅ Interface moderna e responsiva
- ✅ Autenticação de usuários
- ✅ CRUD completo de leads
- ✅ Filtros e busca avançada
- ✅ Dashboard com métricas
- ✅ Importação de dados CSV
- ✅ Sistema de tags e categorização
- ✅ Exportação de relatórios
🚀 Tecnologias Utilizadas
Frontend
- React 18 - Biblioteca para interfaces de usuário
- TypeScript - Superset tipado do JavaScript
- Vite - Build tool e dev server
- Tailwind CSS - Framework CSS utilitário
- Lucide React - Ícones modernos
- React Router - Roteamento SPA
Backend
- Supabase - Backend as a Service
- PostgreSQL - Banco de dados relacional
- Row Level Security (RLS) - Segurança a nível de linha
Ferramentas de Desenvolvimento
- ESLint - Linter para JavaScript/TypeScript
- PostCSS - Processador CSS
- Node.js - Runtime JavaScript
📁 Estrutura do Projeto
project/
├── src/ # Código fonte da aplicação
│ ├── components/ # Componentes React reutilizáveis
│ ├── contexts/ # Contextos React (Auth, etc.)
│ ├── lib/ # Configurações e utilitários
│ ├── pages/ # Páginas da aplicação
│ ├── services/ # Serviços de API
│ ├── types/ # Definições de tipos TypeScript
│ └── utils/ # Funções utilitárias
├── supabase/ # Configurações do Supabase
│ └── migrations/ # Migrações do banco de dados
├── sql_batches/ # Scripts SQL para importação
├── public/ # Arquivos estáticos
├── dist/ # Build de produção
└── scripts/ # Scripts de importação e utilitários
🛠️ Instalação e Configuração
Pré-requisitos
- Node.js 18+
- npm ou yarn
- Conta no Supabase
1. Clone o repositório
git clone <url-do-repositorio>
cd projeto-leads-management
2. Instale as dependências
npm install
3. Configure as variáveis de ambiente
Crie um arquivo .env na raiz do projeto:
VITE_SUPABASE_URL=sua_url_do_supabase
VITE_SUPABASE_ANON_KEY=sua_chave_anonima_do_supabase
4. Configure o banco de dados
Execute as migrações do Supabase:
npx supabase db reset
5. Inicie o servidor de desenvolvimento
npm run dev
A aplicação estará disponível em http://localhost:5173
📊 Scripts de Importação de Dados
O projeto inclui vários scripts para importação de dados CSV:
import-auto-supabase.py- Importação automática via API do Supabaseimport-batch-api.py- Importação em lotes via APIimport-direct-psql.py- Importação direta no PostgreSQLcsv-to-sql.py- Conversão de CSV para SQLsplit-sql-file.py- Divisão de arquivos SQL grandes
Uso dos scripts de importação:
# Converter CSV para SQL
python csv-to-sql.py
# Importar via API do Supabase
python import-auto-supabase.py
# Importar diretamente no PostgreSQL
python import-direct-psql.py
🗄️ Estrutura do Banco de Dados
Tabela leads
id- UUID (chave primária)nome- Nome do leademail- Email do leadtelefone- Telefone do leadempresa- Empresa do leadstatus- Status do lead (novo, contatado, qualificado, etc.)origem- Origem do leadvalor_potencial- Valor potencial do negócioobservacoes- Observações adicionaiscreated_at- Data de criaçãoupdated_at- Data de atualizaçãouser_id- ID do usuário (para RLS)
🔐 Autenticação e Segurança
- Autenticação via Supabase Auth
- Row Level Security (RLS) habilitado
- Políticas de segurança por usuário
- Validação de dados no frontend e backend
📱 Funcionalidades da Interface
Dashboard
- Métricas de leads por status
- Gráficos de conversão
- Leads recentes
- Estatísticas gerais
Gerenciamento de Leads
- Lista paginada de leads
- Filtros por status, origem, data
- Busca por nome, email, empresa
- Edição inline
- Exclusão com confirmação
Importação de Dados
- Upload de arquivos CSV
- Mapeamento de colunas
- Validação de dados
- Preview antes da importação
🚀 Deploy
Build para produção
npm run build
Deploy no Vercel/Netlify
- Conecte o repositório
- Configure as variáveis de ambiente
- Deploy automático
🤝 Contribuição
- Fork o projeto
- Crie uma branch para sua feature (
git checkout -b feature/AmazingFeature) - Commit suas mudanças (
git commit -m 'Add some AmazingFeature') - Push para a branch (
git push origin feature/AmazingFeature) - Abra um Pull Request
📄 Licença
Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.
📞 Suporte
Para suporte, entre em contato através do email ou abra uma issue no GitHub.
Desenvolvido com ❤️ usando React + Supabase
