$data */ public static function record(Booking $booking, string $type, string $summary, ?string $reason = null, array $data = [], ?string $actor = null, ?CarbonInterface $at = null): BookingEvent { $event = new BookingEvent([ 'booking_id' => $booking->id, 'type' => $type, 'summary' => mb_substr($summary, 0, 500), 'actor' => $actor ?? self::actor(), 'reason' => $reason ?? self::$reason, 'data' => $data === [] ? null : $data, 'occurred_at' => $at ?? now(), ]); $event->tenant_id = $booking->tenant_id; $event->save(); return $event; } /** * Who is acting right now: the named actor, the signed-in user or the system (scheduler, mail import). */ public static function actor(): string { return self::$actor ?? auth()->user()?->name ?? self::SYSTEM; } }