Files
fewo-stommer/app/Actions/CancelBookingByGuest.php
T
LarsandClaude Sonnet 5.5 a73b164ea1
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m36s
Zahlungsaufgaben, Freigabe-/Storno-Link, Vertragsvorlagen, Anreise-Mail
- Zahlungen werden nicht mehr automatisch angemahnt: faellige Anzahlung/Restzahlung werden Aufgaben
  (Zahlungen & Wuensche, Tages-/Wochenuebersicht); Mail nur per Klick; je Portal und Buchungstyp abschaltbar
- Freigabe-Link in der Eingangsbestaetigung, Storno-Link in der Buchungsbestaetigung; je Wohnung
  Wunsch / sofort / sofort bis Frist; Stornowuensche und Kosten bleiben Aufgabe des Gastgebers
- Vertragsvorlagen mit Versionen (je Angebot, Portal oder Wohnung waehlbar), benutzte Versionen gesperrt;
  Angebot und finaler Vertrag als unveraenderliche PDF mit SHA-256, Vertrag wird nie neu geschrieben
- Anreise-Mail je Wohnung einstellbar (Standard 3 Tage), neue Textfelder Schluessel/Parken/Ankunftstag

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
2026-10-30 12:46:29 +01:00

99 lines
3.8 KiB
PHP
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
<?php
namespace App\Actions;
use App\Enums\BookingStatus;
use App\Enums\BookingTaskKind;
use App\Enums\BookingTaskStatus;
use App\Enums\CancellationMode;
use App\Exceptions\ReservationException;
use App\Mail\BookingCancelled;
use App\Mail\CancellationRequested;
use App\Models\Booking;
use App\Models\BookingTask;
use App\Support\Settings;
use Illuminate\Support\Facades\DB;
use Illuminate\Support\Facades\Log;
use Illuminate\Support\Facades\Mail;
use Throwable;
/**
* The guest uses the cancellation link of the booking confirmation. Depending on the property's setting the
* booking is cancelled at once (dates released) or only a request task is created for the landlord – costs
* are never settled automatically. Repeating the click changes nothing.
*/
class CancelBookingByGuest
{
/**
* What a click on the link does for this booking today.
*/
public function modeFor(Booking $booking): CancellationMode
{
$property = $booking->property;
$freeUntil = $booking->arrival->subDays($property->free_cancellation_days);
return match ($property->cancellation_mode) {
CancellationMode::Instant => CancellationMode::Instant,
CancellationMode::InstantWhenFree => today()->lessThanOrEqualTo($freeUntil) ? CancellationMode::Instant : CancellationMode::Request,
default => CancellationMode::Request,
};
}
/**
* @return CancellationMode|null what happened (Instant = cancelled, Request = request recorded); null when it had happened before
*
* @throws ReservationException
*/
public function handle(Booking $booking, ?string $message = null): ?CancellationMode
{
$outcome = DB::transaction(function () use ($booking, $message): ?CancellationMode {
$booking->lockForTransition();
$alreadyAsked = BookingTask::query()->where('booking_id', $booking->id)->where('kind', BookingTaskKind::CancellationRequest)->exists();
if ($booking->status === BookingStatus::Cancelled || $alreadyAsked) {
return null;
}
if (! in_array($booking->status, BookingStatus::occupying(), true) || $booking->arrival->isPast()) {
throw ReservationException::invalidTransition($booking->status->getLabel(), 'storniert');
}
$mode = $this->modeFor($booking);
if ($mode === CancellationMode::Instant) {
$booking->update(['status' => BookingStatus::Cancelled, 'cancelled_at' => now()]);
}
BookingTask::query()->create([
'booking_id' => $booking->id,
'kind' => BookingTaskKind::CancellationRequest,
'status' => BookingTaskStatus::Open,
'note' => trim(($mode === CancellationMode::Instant ? 'Vom Gast storniert – bitte Stornokosten und Rückzahlung prüfen. ' : '').($message ?? '')) ?: null,
]);
return $mode;
});
if ($outcome !== null) {
$this->notify($booking, $outcome);
}
return $outcome;
}
private function notify(Booking $booking, CancellationMode $mode): void
{
$booking->loadMissing(['guest', 'property']);
$cancelled = $mode === CancellationMode::Instant;
$sends = [
fn () => Mail::to(Settings::notificationRecipients())->send(new CancellationRequested($booking, $cancelled)),
fn () => $booking->guest?->email ? Mail::to($booking->guest->email, $booking->guest->full_name)->send(new BookingCancelled($booking, $cancelled)) : null,
];
foreach ($sends as $send) {
try {
$send();
} catch (Throwable $exception) {
Log::warning('Stornomitteilung nicht zugestellt', ['booking' => $booking->id, 'exception' => $exception::class]);
}
}
}
}