🚀 Classificação Automática de Emails

Sistema inteligente para classificação automática de emails corporativos do setor financeiro, utilizando inteligência artificial (OpenAI GPT) e técnicas avançadas de NLP.

📋 Funcionalidades

• Classificação Automática: Categoriza emails em "Produtivo" ou "Improdutivo"
• Respostas Personalizadas: Gera respostas automáticas baseadas no conteúdo específico
• Suporte a Arquivos: Processa emails em formato .txt e .pdf
• Processamento Inteligente: NLP com stemming, remoção de stop words e análise estrutural
• API REST: Endpoints bem documentados com FastAPI
• Fallback Inteligente: Sistema baseado em regras quando a IA não está disponível

🚀 Rodando Localmente

Opção 1: Containers Docker

1. Pré-requisitos

• Docker e Docker Compose
• Chave da API OpenAI

2. Instalação

git clone https://github.com/Darlan0307/Classificador-Email-IA.git
cd Classificador-Email-IA

# Configure as variáveis de ambiente
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
# Edite o .env do backend com sua chave da OpenAI

3. Inicialização

docker compose up -d

4. Testes

O Frontend estará disponível em:

• Aplicação: http://localhost:8080

A API estará disponível em:

• Aplicação: http://localhost:8000
• Documentação: http://localhost:8000/docs

Opção 2: Baixando todas as dependências

1. Pré-requisitos

• Python
• pip
• NPM
• Chave da API OpenAI

2. Instalação

git clone https://github.com/Darlan0307/Classificador-Email-IA.git
cd Classificador-Email-IA

# Configure as variáveis de ambiente
cp backend/.env.example backend/.env
cp frontend/.env.example frontend/.env
# Edite o .env do backend com sua chave da OpenAI

3. Configuração backend

Crie um terminal específico para o backend e execute os comandos abaixo:

# Acessar diretório do backend
cd backend

# Crie e ative o ambiente virtual
# No Linux / macOS
python3 -m venv venv

source venv/bin/activate

# No Windows
python -m venv venv

venv\Scripts\activate

# caso o comando acima não funcione, use o seguinte:
venv\Scripts\activate.bat
#ou
venv\Scripts\Activate.ps1


# Instale as dependências
pip install -r requirements.txt

4. Configuração Frontend

Crie um terminal específico para o frontend e execute os comandos abaixo:

# Acessar diretório do frontend
cd frontend

# Instale as dependências
npm install

5. Inicialização

No terminal específico do backend, execute:

python src/main.py

No terminal específico do frontend, execute:

npm run dev

6. Testes

O Frontend estará disponível em:

• Aplicação: http://localhost:8080

A API estará disponível em:

• Aplicação: http://localhost:8000
• Documentação: http://localhost:8000/docs

📸 Screenshot

Página Principal

📊 Categorias de Classificação

Produtivo

Emails que requerem ação específica ou resposta:

• ✅ Solicitações de suporte técnico
• ✅ Dúvidas sobre sistemas/processos
• ✅ Pedidos de informação ou status
• ✅ Relatórios de problemas
• ✅ Questões operacionais

Improdutivo

Emails que não necessitam ação imediata:

• ✅ Mensagens de felicitação
• ✅ Agradecimentos gerais
• ✅ Mensagens sociais/pessoais
• ✅ Comunicados informativos
• ✅ Saudações sazonais

🛠️ Tecnologias Utilizadas

Backend

• Python
• FastAPI
• Pydantic
• OpenAI GPT
• NLTK
• PyPDF2
• HTTPX

Frontend

• React
• Typescript
• Tailwind CSS

📝 Licença

Este projeto está sob a licença MIT. Veja o arquivo LICENSE para mais detalhes.