Udalosti

Každý prechod spustí udalosť s príslušným modelom. Všetky udalosti sú v RoundlyConsulting\Approvals\Events a obsah vystavujú ako verejné vlastnosti:

Zastrešujúca udalosť

Prihláste sa na ApprovalStatusChanged raz a uvidíte všetky prechody: rozhodnutie schválené, zamietnuté, stiahnuté — aj prepínačom či zmenou názoru, ktorá ho nahradí — alebo expirované, nevybavené vyžiadanie zrušené po uzavretí jeho kola a žiadosť vyhodnotenú, expirovanú či uzavretú vašou aplikáciou. Nesie subjekt (zmenenú Approval alebo ApprovalRequest), stavy from a to typu ApprovalStatus a aktéra, ak je známy — pri vyhodnotenej žiadosti či zrušenom vyžiadaní je null:

use RoundlyConsulting\Approvals\Events\ApprovalStatusChanged;

class AuditApprovalChanges
{
    public function handle(ApprovalStatusChanged $event): void
    {
        // $event->from, $event->to, $event->subject, $event->actor
        logger()->info("approval moved {$event->from->value} -> {$event->to->value}");
    }
}

Konkrétne listenery

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Approvals\Events\ApprovalApproved;
use RoundlyConsulting\Approvals\Events\ApprovalRequestResolved;

Event::listen(function (ApprovalApproved $event): void {
    $approval = $event->approval;   // the Approval model
});

Event::listen(function (ApprovalRequestResolved $event): void {
    $request = $event->request;     // approved, rejected or expired — see $request->status
    $subject = $request->subject;   // e.g. the Release
});

ask() vytvorí čakajúce rozhodnutie, žiadne nemení, preto spustí len ApprovalRequested. Zmeny stupňov, delegovanie aj výmena schvaľovateľov (ApprovalApproversReplaced) tiež spúšťajú len vlastné udalosti — nie zastrešujúcu.

Keď sa kolo uzavrie

Či kolo vyhodnotia jeho rozhodnutia, vyprší, alebo ho uzavrie vaša aplikácia, udalosti prídu vždy v rovnakom poradí: ApprovalCancelled a ApprovalStatusChanged pre každé zrušené vyžiadanie, potom ApprovalRequestResolved a nakoniec ApprovalStatusChanged pre žiadosť. Listener vyhodnotenia tak nikdy neuvidí vyžiadanie, ktoré na kole ešte čaká. Zneplatnenie (voidIfChanged()) aj uzatvárajúca kontrola prahu uzavrú kolo rovnako a na záver spustia ApprovalRequestVoided, resp. ApprovalThresholdUnreachable.