Udalosti

RoundlyConsulting\Credits\Events\CreditsModified sa spustí po každej zaznamenanej zmene. Nesie entitu s kreditmi, nový záznam Credit a výsledný zostatok:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Credits\Events\CreditsModified;

Event::listen(function (CreditsModified $event): void {
    // $event->creditable, $event->credit, $event->balance
});

Obsah udalosti

final class CreditsModified implements ShouldDispatchAfterCommit
{
    use Dispatchable;

    public function __construct(
        public readonly Model&Creditable $creditable,
        public readonly Credit $credit,
        public readonly int $balance,   // the bucket's balance this change produced
    ) {}
}

balance je zostatok skupiny, ktorá sa zmenila — zistíte ju z $event->credit->bucket — nie súčet naprieč skupinami. Je to zostatok, ktorý táto zmena vytvorila, načítaný pod zámkom vlastníka v transakcii zmeny, takže doň nikdy nepresiakne súbežná zmena.

Kedy sa spúšťa

• Po každom úspešnom zápise — add(), deduct(), modify(), setTo() a ich podobách pre Money na scope, ako aj príslušných metódach traitu — a pre každú entitu, ktorú zmení credits:modify.
• Až keď je zmena potvrdená: CreditsModified implementuje ShouldDispatchAfterCommit, takže v setTo() alebo vo vašej vlastnej DB::transaction() ju listenery dostanú až po potvrdení vonkajšej transakcie — a pri zmene, ktorá sa vráti späť, vôbec. Listener, ktorý vyhodí výnimku, zmenu nevráti; ak ju chcete zastaviť, overte podmienky ešte pred zmenou.
• Nie, keď je setCreditsTo() bez účinku, lebo zostatok už sedí.
• Nie, keď zmenu odmietne ochrana pred prečerpaním, 64-bitový limit alebo kontrola meny — nič sa nezapísalo.

Listener

Pošlite potvrdenie, aktualizujte dashboard alebo upozornite na nízky zostatok:

use Illuminate\Support\Facades\Log;

Event::listen(function (CreditsModified $event): void {
    Log::info("Balance for {$event->creditable->getKey()} is now {$event->balance}");

    if ($event->credit->amount < 0 && $event->balance < 10) {
        // $event->credit->bucket is running low — notify the owner
    }
});

Udalosti rezervácií

Rezervácie spúšťajú vlastné udalosti, všetky ShouldDispatchAfterCommit — listenery ich dostanú až po potvrdení transakcie. Obnovenie spustí CreditsModified pre svoj rozdielový záznam (žiadnu, ak zostatok už sedel):

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Credits\Events\CreditHoldCaptured;
use RoundlyConsulting\Credits\Events\CreditHoldExpired;

Event::listen(function (CreditHoldCaptured $event): void {
    // $event->creditable, $event->hold, $event->credit (the debit), $event->released (0 for a full capture)
});

Event::listen(function (CreditHoldExpired $event): void {
    // $event->hold — the owner via $event->hold->creditable, which may be gone
});