# Estrutura do Projeto ImgBoost

```
imgboost/
│
├── 📄 README.md                    # Documentação principal completa
├── 📄 QUICKSTART.md                # Guia de início rápido
├── 📄 CHANGELOG.md                 # Histórico de mudanças
├── 📄 CONTRIBUTING.md              # Guia de contribuição
├── 📄 LICENSE                      # Licença MIT
├── 📄 MANIFEST.in                  # Arquivos para incluir no pacote
├── 📄 requirements.txt             # Dependências Python
├── 📄 setup.py                     # Script de instalação
├── 📄 .gitignore                   # Arquivos ignorados pelo Git
├── 📄 .imgboost.conf.example       # Exemplo de configuração
│
├── 🔧 install.sh                   # Script de instalação rápida (executável)
├── 🐍 examples.py                  # Exemplos de uso programático
├── 🧪 test_imgboost.py             # Suite de testes
│
└── 📦 imgboost/                    # Pacote principal
    │
    ├── __init__.py                 # Inicialização do pacote
    ├── cli.py                      # Interface CLI com Click
    ├── core.py                     # Engine/orquestrador principal
    │
    ├── 📂 processors/              # Módulo de processadores
    │   ├── __init__.py
    │   ├── filters.py              # Filtros gerais (denoise, contrast, sharpen)
    │   ├── document.py             # Processamento de documentos/OCR
    │   └── superres.py             # Super-resolução e upscaling
    │
    └── 📂 utils/                   # Módulo de utilitários
        ├── __init__.py
        └── image_io.py             # Carregamento e salvamento de imagens

```

## Arquivos Principais

### Documentação
- **README.md**: Documentação completa com exemplos, casos de uso, API
- **QUICKSTART.md**: Tutorial rápido para começar em 5 minutos
- **CHANGELOG.md**: Histórico de versões e mudanças
- **CONTRIBUTING.md**: Guia para contribuidores

### Configuração
- **setup.py**: Configuração para instalação via pip
- **requirements.txt**: Lista de dependências
- **MANIFEST.in**: Arquivos a incluir no pacote
- **.gitignore**: Arquivos ignorados pelo controle de versão

### Scripts
- **install.sh**: Instalação automatizada (Linux/Mac)
- **examples.py**: Exemplos de uso programático
- **test_imgboost.py**: Testes automatizados

### Código Fonte

#### CLI (cli.py)
- Interface de linha de comando
- Comandos: `process`, `batch`, `info`
- Múltiplas opções configuráveis
- Barra de progresso
- Modo verbose

#### Engine (core.py)
- Orquestrador principal
- 4 modos de processamento
- Pipeline configurável
- Gerenciamento de entrada/saída

#### Processadores

**filters.py** - Filtros gerais:
- Denoise (Fast Non-Local Means)
- CLAHE (contraste adaptativo)
- Sharpening
- Unsharp mask
- Ajuste de gamma
- Enhancement para dark UI
- Balanço de branco

**document.py** - Documentos:
- Binarização adaptativa
- Deskew (correção de inclinação)
- Remoção de sombras
- Pipeline para OCR
- Detecção de regiões de texto
- Aumento de DPI

**superres.py** - Super-resolução:
- Upscaling 2x, 4x, 8x
- LANCZOS4 interpolation
- Multi-scale enhancement
- Realce de textura
- Suporte futuro para IA (Real-ESRGAN)

#### Utilitários

**image_io.py** - I/O de imagens:
- Carregamento robusto
- Salvamento com qualidade
- Suporte a múltiplos formatos
- Validação de imagens
- Conversão de formatos
- Batch loading
- Redimensionamento inteligente

## Recursos Implementados

✅ CLI profissional com Click
✅ 4 modos especializados (general, text, dark, superres)
✅ Processamento em lote paralelo
✅ Denoise inteligente
✅ CLAHE para contraste
✅ Sharpening profissional
✅ Super-resolução (tradicional)
✅ Pipeline para OCR
✅ Otimização para dark UI
✅ Múltiplos formatos (JPG, PNG, BMP, TIFF, WebP)
✅ Ajuste de qualidade
✅ Modo verbose
✅ Barra de progresso
✅ Validação de entrada
✅ Tratamento de erros
✅ Testes automatizados
✅ Documentação completa

## Próximas Features

🔜 Integração com Real-ESRGAN
🔜 Suporte a vídeo
🔜 Processamento de PDF
🔜 Interface web
🔜 GPU acceleration
🔜 Presets customizáveis
🔜 API REST
🔜 Docker container

## Linhas de Código

Total aproximado: ~2,500 linhas

- cli.py: ~200 linhas
- core.py: ~170 linhas
- filters.py: ~330 linhas
- document.py: ~280 linhas
- superres.py: ~250 linhas
- image_io.py: ~220 linhas
- tests: ~200 linhas
- exemplos: ~150 linhas
- documentação: ~700 linhas
