domingo, 22 de novembro de 2026NewspaperEdição nº 1

Tecnologia · laravel

Pacote Laravel Rulebook organiza regras de negócio que mudam com o tempo

O Laravel Rulebook propõe resolver uma única regra válida para uma data, registrar por que ela venceu e preservar o contexto de políticas alteradas, como condições de reembolso e comissões.

Ilustração do pacote Laravel Rulebook.
Ilustração do pacote Laravel Rulebook. Imagem: reprodução/Laravel News

Regras de negócio raramente ficam estáticas. Uma taxa pode mudar no início do ano, um contrato pode alterar a janela de cancelamento e uma política de reembolso pode precisar continuar sendo explicável meses depois. O pacote Laravel Rulebook, apresentado pelo Laravel News, tenta resolver esse problema sem introduzir uma linguagem própria de regras, tabelas de configuração ou um motor de workflow.

A ideia central é manter cada regra como uma classe PHP comum, mas declarar o período no qual ela é válida. O pacote oferece janelas como sempre, a partir de uma data, até uma data ou entre duas datas. Ao receber um contexto e um instante no tempo, o Rulebook avalia as candidatas e devolve exatamente uma vencedora, escolhida por prioridade, não pela posição em um array.

A escolha por data evita um atalho frequente e perigoso: editar no lugar a condição antiga. Quando isso acontece, o código atual deixa de explicar por que uma fatura de meses atrás recebeu determinado tratamento. Com regras versionadas, a política de 2025 pode coexistir com a de 2026, e uma consulta histórica ainda encontra a versão aplicável.

O pacote também devolve o motivo de cada regra ter vencido, perdido ou ficado fora do período de validade. Há exceções próprias para os dois casos em que a aplicação não deveria adivinhar: nenhuma regra aplicável e empate entre regras. Para sistemas de atendimento, financeiro ou auditoria, esse detalhe é mais útil do que apenas um valor final, pois transforma uma decisão de negócio em algo que pode ser explicado ao usuário.

Outro recurso é o snapshot, que serializa a decisão em JSON. A aplicação pode armazenar o resultado junto com o pedido, fatura ou reembolso. Isso não substitui um histórico completo de execução, mas registra qual regra venceu, quais foram avaliadas e qual era o resultado no momento da operação.

Há limites claros. Para uma condição de data isolada, um simples match pode ser mais legível que uma hierarquia de classes. O Rulebook faz sentido quando várias políticas competem, precisam de prioridade e devem continuar justificáveis após mudanças. Ele exige PHP 8.3 e Laravel 12 ou 13, integra regras pelo contêiner de serviços e está disponível como pacote open source.

Fontes

Assuntoslaraveldesenvolvimentophpopen-source

← Voltar à edição de 07/09