Udalosti

Každá udalosť je final readonly trieda v RoundlyConsulting\Tickets\Events s ShouldDispatchAfterCommit: spustí sa, až keď sa zmena potvrdí, nikdy pri rollbacku. $actor je ten, kto konal (null pre systém). Každá udalosť o jednom tikete — 33 z 34, všetky okrem GuestConverted — implementuje Contracts\TicketEvent:

interface TicketEvent
{
    public function ticket(): Ticket;   // TicketMerged: the source, the ticket merged away
    public function actor(): ?Model;    // null for the system, and always for TicketOverdue,
                                        // TicketDueSoon (the sweep) and TicketMentioned
}

Dispečer Laravelu doručí udalosť aj listenerom rozhraní, ktoré implementuje, takže jeden typovaný listener zachytí všetky — audit log, prenos na webhook či kanál pre dashboard:

use Illuminate\Support\Facades\Event;
use RoundlyConsulting\Tickets\Contracts\TicketEvent;

Event::listen(TicketEvent::class, function (TicketEvent $event): void {
    AuditLog::create([
        'ticket' => $event->ticket()->reference,
        'event' => class_basename($event),          // TicketReplied, TicketAssigned, …
        'actor_type' => $event->actor()?->getMorphClass(),
        'actor_id' => $event->actor()?->getKey(),
    ]);
});

Skôr než čokoľvek pošlete von, myslite na udalosti len pre agentov: TicketNoteAdded a TicketMentioned či TicketCommentUpdated / TicketCommentDeleted o poznámke alebo zadržanej odpovedi nesú obsah, ktorý žiadny žiadateľ nesmie vidieť.

Zoznam udalostí

• Interná poznámka sa dostane aj k vlastným udalostiam comments-for-laravel (CommentCreated, CommentMentioned), ktoré sa spúšťajú pri každom komentári — pred upovedomením kohokoľvek skontrolujte meta.tickets.internal.
• LifecycleTransitioning / LifecycleTransitioned z lifecycle sa spúšťajú aj pre tikety; uprednostnite udalosti tiketov vyššie.
• Tickets::fake() udalosti nepodvrhuje — každé volanie sa aj tak vykoná —, takže Event::fake() funguje vedľa neho.