- Buchung ist der einheitliche Vorgang: Eingangsart, Vorgangsart A1–A6, eingefrorenes Abwicklungsprofil, gespeicherter Verlauf (booking_events); Gast, Personen und Beträge dürfen unbekannt sein, Platzhalter-Gäste werden migriert und nicht mehr angelegt - Einstellungen in Ebenen: Vermieterstandard (So arbeite ich), Abweichung der Wohnung (Experte), Abweichung je Portal und Eingangsart; ersetzt booking_model als Steuergröße - Ein Weg für extern verbindliche Buchungen (TakeOverExternalBooking) statt RecordPortalBooking und "Akte anlegen"; Portalpreis als belegte Gesamtposition - Startseite "Zu erledigen", neue Vorgangsseite mit nächstem Schritt, Automatik-Schalter, "Beenden" mit Storno statt Statusumschaltung; Status von Hand nur im Expertenmodus - Migration übernimmt bisheriges Verhalten unverändert (abweichende Wohnungswerte bleiben als Abweichung), Bericht: php artisan process:settings-report Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
98 lines
4.3 KiB
PHP
98 lines
4.3 KiB
PHP
<?php
|
||
|
||
namespace App\Actions;
|
||
|
||
use App\Enums\BookingStatus;
|
||
use App\Enums\BookingTaskKind;
|
||
use App\Enums\BookingTaskStatus;
|
||
use App\Exceptions\ReservationException;
|
||
use App\Mail\BookingCancelled;
|
||
use App\Mail\CancellationRequested;
|
||
use App\Models\Booking;
|
||
use App\Models\BookingTask;
|
||
use App\Support\CancellationCost;
|
||
use App\Support\Money;
|
||
use App\Support\Settings;
|
||
use Illuminate\Support\Facades\DB;
|
||
use Illuminate\Support\Facades\Log;
|
||
use Illuminate\Support\Facades\Mail;
|
||
use Throwable;
|
||
|
||
/**
|
||
* The landlord cancels a binding booking. The dates are free again; the guest and the landlord are informed by mail
|
||
* (the guest mail can be switched off, e.g. when the guest cancelled by phone and was told already) and a task for
|
||
* the cancellation costs is created. Open cancellation requests of the guest are completed.
|
||
*/
|
||
class CancelBooking
|
||
{
|
||
/**
|
||
* @return bool whether the guest has been informed (true as well when no mail was wanted; false when it failed)
|
||
*
|
||
* @throws ReservationException
|
||
*/
|
||
public function handle(Booking $booking, bool $notifyGuest = true, bool $costsTask = true, string $by = 'Verwaltung', string $initiatedBy = 'landlord'): bool
|
||
{
|
||
if ($notifyGuest && blank($booking->guest?->email)) {
|
||
throw new ReservationException('Der Gast hat keine E-Mail-Adresse – bitte ohne Mail an den Gast stornieren oder die Adresse ergänzen.');
|
||
}
|
||
|
||
DB::transaction(function () use ($booking, $costsTask, $by, $initiatedBy): void {
|
||
$booking->lockForTransition();
|
||
|
||
if (! in_array($booking->status, BookingStatus::occupying(), true)) {
|
||
throw ReservationException::invalidTransition($booking->status->getLabel(), 'storniert');
|
||
}
|
||
|
||
$booking->update(['status' => BookingStatus::Cancelled, 'cancelled_at' => now()]);
|
||
app(RecordCancellation::class)->handle($booking, $initiatedBy);
|
||
|
||
if ($booking->caseType()->isExternallyBinding()) {
|
||
// The contract was made on the portal: the cancellation has to happen (or be checked) there as well.
|
||
BookingTask::query()->firstOrCreate(['booking_id' => $booking->id, 'kind' => BookingTaskKind::PortalCancellation], [
|
||
'status' => BookingTaskStatus::Open,
|
||
'due_on' => today(),
|
||
'note' => 'Stornierung auch im Portal „'.($booking->processChannel()?->name ?? 'Portal').'“ veranlassen bzw. prüfen, ob sie dort wirksam ist.',
|
||
]);
|
||
}
|
||
|
||
BookingTask::query()->where('booking_id', $booking->id)->where('kind', BookingTaskKind::CancellationRequest)->where('status', BookingTaskStatus::Open)
|
||
->update(['status' => BookingTaskStatus::Done, 'completed_by' => $by, 'completed_at' => now()]);
|
||
|
||
if ($costsTask) {
|
||
$cost = CancellationCost::calculate($booking);
|
||
BookingTask::query()->firstOrCreate(['booking_id' => $booking->id, 'kind' => BookingTaskKind::CancellationFee], [
|
||
'status' => BookingTaskStatus::Open,
|
||
'due_on' => today(),
|
||
'note' => $cost ? 'Vorschlag nach Stornoregel „'.$cost['policy'].'“: '.Money::format($cost['fee']).' ('.$cost['tier_text'].')' : 'Keine Stornoregel hinterlegt – Kosten von Hand festlegen.',
|
||
]);
|
||
}
|
||
});
|
||
|
||
$booking->loadMissing(['guest', 'property']);
|
||
|
||
return $this->notify($booking, $notifyGuest);
|
||
}
|
||
|
||
private function notify(Booking $booking, bool $notifyGuest): bool
|
||
{
|
||
$informed = true;
|
||
|
||
try {
|
||
Mail::to(Settings::notificationRecipients())->send(new CancellationRequested($booking, cancelled: true));
|
||
} catch (Throwable $exception) {
|
||
Log::warning('Stornomitteilung an den Vermieter nicht zugestellt', ['booking' => $booking->id, 'exception' => $exception::class]);
|
||
}
|
||
|
||
if ($notifyGuest) {
|
||
try {
|
||
Mail::to($booking->guest->email, $booking->guest->full_name)->send(new BookingCancelled($booking, cancelled: true));
|
||
} catch (Throwable $exception) {
|
||
$informed = false;
|
||
Log::warning('Stornomail an den Gast nicht zugestellt', ['booking' => $booking->id, 'exception' => $exception::class]);
|
||
}
|
||
}
|
||
|
||
return $informed;
|
||
}
|
||
}
|