# Runbook — UOL/cPanel, 504 e Resource Limit

## Sintomas

- `Gateway Timeout`.
- `Resource Limit Is Reached`.
- Requisição fica carregando infinitamente.
- Exportação de arquivos processa parte do lote e falha.

## Causas comuns

- Geração de ZIP grande em uma única requisição.
- Falta de índices em tabelas de candidatos/currículos.
- `max_execution_time`, memória ou I/O limitados na hospedagem.
- Banco remoto lento ou timeout de conexão alto.
- Arquivos em `storage/curriculos` ausentes após deploy.

## Correções recomendadas

1. Usar exportação individual em PDF, não ZIP.
2. Limitar `EXPORT_MAX_SELECIONADOS`.
3. Aplicar índices em `candidates` conforme SQL de otimização.
4. Configurar `DB_CONNECT_TIMEOUT=3`.
5. Não apagar `storage/curriculos`.
6. Manter logs internos, mas não exibir erro bruto ao usuário.
7. Remover `install.php` após a instalação.

## Checklist rápido

```bash
php -v
php -m | grep -E "pdo_mysql|gd|fileinfo"
find storage/curriculos -type f | head
```