# Deploy e operação

## Deploy em cPanel/UOL

1. Fazer backup dos arquivos atuais.
2. Fazer backup do banco.
3. Subir somente arquivos alterados.
4. Conferir permissões de `storage`, `uploads`, `cache` e `logs`.
5. Conferir `.env` de produção.
6. Testar login/admin.
7. Testar uploads.
8. Testar geração de PDF.
9. Testar endpoints JSON usados pelo Power BI.
10. Conferir logs após publicação.

## Erros comuns

### 504 Gateway Timeout

Causas frequentes:

- Geração de ZIP grande.
- Loop sem paginação.
- Consulta sem índice.
- API externa lenta.
- Hospedagem compartilhada com limite de recurso.

Correção padrão:

- Processar em lotes.
- Evitar ZIP pesado.
- Gerar PDFs individuais sob demanda.
- Criar índices no banco.
- Adicionar timeout e retry controlado.

### Resource Limit Is Reached

- Reduzir processamento síncrono.
- Remover exportação de todos os registros de uma vez.
- Filtrar por unidade/período.
- Fazer paginação.

### PDF baixando sem extensão

- Definir nome com `.pdf`.
- Sanitizar nome/sobrenome.
- Enviar headers corretos.