Fase 1.1: Adicionar dependências opcionais (spaCy) ao pyproject.toml

[bdcdo]

🚀 Fase 1.1: Adicionar Dependências Opcionais (spaCy)

📝 Descrição

Adicionar spaCy como dependência opcional ao projeto para suportar lemmatization em português.

🎯 Objetivos

• Adicionar spaCy ao pyproject.toml com versão específica
• Configurar dependências opcionais para funcionalidades avançadas
• Manter compatibilidade com instalação básica
• Documentar nova dependência

🔧 Implementação Técnica

Modificações em pyproject.toml:

dependencies = [
    # ... dependências existentes ...
    "pandas==2.2.3",
    "scikit-learn==1.6.1",
    "nltk==3.9.1",
    # ... outras ...
]

[project.optional-dependencies]
advanced = [
    "spacy>=3.7.0,<4.0.0",
]

Documentação de instalação:

# Instalação básica (comportamento atual)
pip install cluster-facil

# Instalação com funcionalidades avançadas
pip install cluster-facil[advanced]

✅ Critérios de Aceitação

• spaCy adicionado como dependência opcional
• Instalação básica continua funcionando sem spaCy
• README.md atualizado com instruções de instalação
• Versão específica definida para compatibilidade

🔗 Relacionado

• Issue principal: Adicionar stemming/lemmatization #13
• Próxima: Criar módulo text_preprocessing.py

⏱️ Estimativa

2 horas - Modificação simples mas importante para estrutura

🧪 Testes

• CI passa com instalação básica
• CI passa com instalação avançada
• Importação funciona corretamente em ambos os casos