Início / Documentação / Deploy e operação
HTML estilizadov10Sem dependência externa
Ver Markdown originalVoltar ao Hub

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.