# 📋 Guia de Instalação - Modelo de Predição de Glosas

## 🔧 Pré-requisitos
- Python 3.8 ou superior
- pip (gerenciador de pacotes Python)
- Sistema operacional: Windows, macOS ou Linux

## 📦 Instalação Completa

### 1. Criar ambiente virtual (recomendado)
```bash
# Criar ambiente virtual
python3 -m venv venv

# Ativar ambiente virtual
# macOS/Linux:
source venv/bin/activate

# Windows:
venv\Scripts\activate
```

### 2. Instalar todas as dependências
```bash
pip install -r requirements.txt
```

## 🚀 Instalação Mínima (apenas para usar modelos prontos)

Se você só precisa fazer predições com modelos já treinados:

```bash
pip install pandas numpy scikit-learn xgboost joblib
```

## 📊 Instalação para Treinamento

Para treinar novos modelos:

```bash
pip install pandas numpy scikit-learn xgboost joblib matplotlib pymysql python-dotenv
```

## 🔬 Instalação para Análise Avançada

Para usar SHAP e análises avançadas:

```bash
pip install shap imbalanced-learn seaborn
```

## 🌐 Instalação para API REST

Para criar servidor API:

```bash
pip install flask flask-cors
```

## ⚡ Comandos Rápidos

### Instalação completa em uma linha:
```bash
python3 -m venv venv && source venv/bin/activate && pip install -r requirements.txt
```

### Atualizar todas as dependências:
```bash
pip install --upgrade -r requirements.txt
```

### Verificar instalação:
```bash
python -c "import pandas, numpy, sklearn, xgboost, joblib; print('✅ Todas as dependências básicas instaladas!')"
```

## 🐛 Solução de Problemas

### macOS - Erro com libomp (XGBoost):
```bash
brew install libomp
```

### Windows - Erro de compilação:
Instale o Visual C++ Build Tools:
https://visualstudio.microsoft.com/visual-cpp-build-tools/

### Linux - Dependências do sistema:
```bash
sudo apt-get update
sudo apt-get install python3-dev python3-pip
```

## 📝 Notas

- Use sempre um ambiente virtual para evitar conflitos
- As versões especificadas foram testadas e são compatíveis
- Para produção, considere usar Docker para garantir consistência