Importação Agendada - Jobs Schedule Cron

[tbizze]

Recurso para importações automáticas

No Laravel, os Jobs e Agendamentos de Tarefas (Scheduling) são recursos que permitem executar processos em horários específicos sem a intervenção do usuário, de forma automatizada.

• O Job é responsável por realizar o processo que queremos, como consultar as APIs bancárias para importar transações.
• Já o Scheduler (agendador de tarefas) define quando esse Job será executado, como todos os dias úteis às 8h.

Objetivo

Feature para realizar a importação de transações, nas contas bancárias configuradas, de forma automatizadas.

Passos para implementar:

1. Job: Vamos criar um Job que será responsável por consultar todas as contas bancárias cadastradas na tabela BankAccount e fazer a importação das transações via as APIs de cada banco (Santander e PagBank).
2. Scheduling: Utilizaremos o Scheduler do Laravel para agendar a execução do Job. Definiremos a execução de segunda a sexta-feira às 08:00.
3. Configuração de Cron: Laravel utiliza o cron do sistema para rodar suas tarefas agendadas. Precisaremos configurar uma tarefa cron no servidor para que o Laravel possa executar o seu próprio agendamento de tarefas.

Resumo:

• Criamos um Job que realiza a consulta às APIs e processa as transações.
• Configuramos o Scheduler no Laravel para executar o Job de segunda a sexta-feira às 08:00.
• Garantimos que o cron do sistema esteja configurado para rodar o agendador do Laravel.

[tbizze]

Explicação de como funciona o Cron em um Servidor Web

O Cron é uma ferramenta de agendamento de tarefas em sistemas Unix e Linux que permite a execução de comandos ou scripts em horários, dias ou intervalos de tempo específicos. Ele é amplamente utilizado em servidores web para automatizar processos, como backups, envio de emails e, no caso do Laravel, para rodar comandos definidos no scheduler da aplicação.

No Laravel, a configuração de agendamentos de tarefas (usando o schedule no arquivo Kernel.php) depende de o Cron do servidor estar configurado para rodar o comando php artisan schedule:run a cada minuto.

O Cron verifica o agendamento da aplicação e executa os comandos no horário definido.

[tbizze]

Passo a passo para implementação:

• [x] criar o Job - ImportBankTransactionsJob
• [x] criar command para testar a execução do Job - StartAutoImportCommand
• [x] corrigido TransactionImportController para enviar a view mensagens de erro
• [x] criar novo método na TransactionManagerService para testar credenciais antes de enviar request
• [x] criar novo método na TransactionManagerService para fazer o import através do Job )data será dia anterior)
• [x] corrigir SantanderService para tratar o response, identificando erros
• [x] corrigir PagBankService para tratar o response, identificando erros
• [x] corrigir CredentialBankAccount para ignorar decripty se campos nulos
• [x] alterar migration create_credentials - largura coluna
• [x] definir o Schedule para executar o Job criado app/Console/Kernel.php
• [x] configurar o Cron no Servidor