Реалізація скасування та перенесення бронювання на сайті

Реалізація відмови та переносу бронювання на сайті

Можливість самостійно відмовити або перенести запис знижує навантаження на адміністраторів та поліпшує досвід клієнта. Ключова задача — правильна логіка: відмови за N годин до запису дозволені, відмови в останній момент — нею або зі штрафом.

Правила відмови

class BookingCancellationPolicy
{
    public function canCancel(Booking $booking): CancellationResult
    {
        $hoursUntilBooking = now()->diffInHours($booking->starts_at, absolute: false);

        if ($hoursUntilBooking < 0) {
            return CancellationResult::denied('Бронювання уже прошло');
        }

        $policy = $booking->service->cancellation_policy;

        if ($hoursUntilBooking < $policy->free_cancel_hours) {
            return CancellationResult::withPenalty(
                "Відмова менше ніж за {$policy->free_cancel_hours} годин: " .
                "штраф {$policy->penalty_percent}%",
                penaltyPercent: $policy->penalty_percent
            );
        }

        return CancellationResult::free();
    }
}

Токен-посилання для відмови без авторизації

Клієнт може відмовити запис по посиланню з email без входу в аккаунт:

class Booking extends Model
{
    protected static function booted(): void
    {
        static::creating(function (Booking $booking) {
            $booking->cancel_token    = Str::random(64);
            $booking->reschedule_token = Str::random(64);
        });
    }
}

// Роут для відмови
Route::get('/bookings/cancel/{token}', function (string $token) {
    $booking = Booking::where('cancel_token', $token)
                      ->where('status', 'confirmed')
                      ->firstOrFail();

    $policy = app(BookingCancellationPolicy::class)->canCancel($booking);

    return Inertia::render('Booking/Cancel', [
        'booking' => $booking->load('service'),
        'policy'  => $policy,
    ]);
});

Форма переносу

При переносі відкривається повноцінний вибір нової дати/часу (той же компонент AvailabilityCalendar), але старий слот звільняється тільки після підтвердження нового:

public function reschedule(Request $request, string $token): JsonResponse
{
    $booking = Booking::where('reschedule_token', $token)->firstOrFail();

    DB::transaction(function () use ($booking, $request) {
        $newSlot = TimeSlot::findOrFail($request->new_slot_id);

        // Перевіряємо доступність нового слота
        if (!$newSlot->available) {
            throw new SlotUnavailableException();
        }

        // Звільняємо старий слот
        TimeSlot::where('booking_id', $booking->id)->update(['booking_id' => null]);

        // Займаємо новий
        $newSlot->update(['booking_id' => $booking->id]);
        $booking->update([
            'starts_at' => $newSlot->datetime,
            'status'    => 'rescheduled',
        ]);
    });

    // Відправляємо підтвердження переносу
    Mail::to($booking->customer_email)->send(new BookingRescheduledMail($booking));

    return response()->json(['success' => true]);
}

Терміни

Відмова та перенос бронювань з політиками та токен-посиланнями: 3–5 робочих днів.