Pular para o conteúdo principal

Serviço Cron

A aplicação inclui um serviço cron separado para lidar com tarefas agendadas:

Iniciar serviço cron em modo de desenvolvimento​

pnpm cron:dev

Iniciar serviço cron em modo de produção​

pnpm cron:start

Iniciar serviço cron localmente (para testes)​

pnpm cron:start-local

O serviço cron é executado em uma porta separada (8667 em desenvolvimento, 9667 em produção) e manipula tarefas agendadas como notificações de backup atrasado. A porta pode ser configurada usando a variável de ambiente CRON_PORT.

O serviço cron inclui:

  • Ponto de extremidade de verificação de integridade: /health - Retorna o status do serviço e tarefas ativas
  • Acionamento manual de tarefas: POST /trigger/:taskName - Executa manualmente tarefas agendadas
  • Gerenciamento de tarefas: POST /start/:taskName e POST /stop/:taskName - Controla tarefas individuais
  • Recarga de configuração: POST /reload-config - Recarrega a configuração do banco de dados
  • Reinicialização automática: O serviço reinicia automaticamente se falhar (gerenciado por docker-entrypoint.sh em implantações Docker)
  • Modo de observação: O modo de desenvolvimento inclui monitoramento de arquivos para reinicialização automática em alterações de código
  • Monitoramento de backups atrasados: Verificação automatizada e notificação de backups atrasados (executado a cada 5 minutos por padrão)
  • Limpeza do registro de auditoria: Limpeza automatizada de entradas antigas do registro de auditoria (executado diariamente às 2h UTC)
  • Agendamento flexível: Expressões cron configuráveis para diferentes tarefas
  • Integração com banco de dados: Compartilha o mesmo banco de dados SQLite com a aplicação principal
  • API RESTful: API completa para gerenciamento e monitoramento do serviço