importChannel ?? $booking->originChannel; if ($channel !== null) { return $channel->booking_model === ChannelBookingModel::PortalBooking ? self::PORTAL_BOOKING : self::PORTAL_INQUIRY; } return $booking->source === 'website' ? self::OWN : self::MANUAL; } public static function kindLabel(Booking $booking): string { $portal = ($booking->importChannel ?? $booking->originChannel)?->name; return match (self::kind($booking)) { self::OWN => 'Eigene Webseite: Anfrage → Angebot → Annahme', self::MANUAL => 'Manuell erfasste Buchung', self::PORTAL_BOOKING => 'Portal-Buchung'.($portal ? " ({$portal})" : '').': beim Portal verbindlich, Vertrag von uns', default => 'Portal-Anfrage'.($portal ? " ({$portal})" : '').': wir antworten persönlich, Angebot und Vertrag von uns', }; } /** * The milestones of the process with the activities that belong to each. An activity names the action on the * booking page that does it ("action"), so the landlord sees what was done, what is open and where to do it. * * @return list}> */ public static function steps(Booking $booking): array { $today = CarbonImmutable::today(); $kind = self::kind($booking); $closed = in_array($booking->status, [BookingStatus::Cancelled, BookingStatus::Declined, BookingStatus::Expired], true); $binding = in_array($booking->status, BookingStatus::occupying(), true); $hasEmail = filled($booking->guest?->email); $activity = fn (string $label, bool $done, ?string $action = null): array => ['label' => $label, 'done' => $done, 'action' => $done ? null : $action]; $steps = []; $steps[] = ['label' => 'Anfrage / Eingang', 'state' => 'done', 'detail' => $booking->created_at?->format('d.m.Y'), 'activities' => [ $activity($kind === self::OWN ? 'Anfrage über die Webseite eingegangen' : 'Vorgang angelegt ('.$booking->bookingChannelLabel().')', true), ]]; if (in_array($kind, [self::PORTAL_BOOKING, self::PORTAL_INQUIRY], true)) { $asked = $booking->contact_requested_at !== null; $steps[] = ['label' => 'Gast & Kontaktdaten', 'state' => $hasEmail ? 'done' : ($closed ? 'skipped' : 'current'), 'detail' => $hasEmail ? null : ($asked ? 'erfragt am '.$booking->contact_requested_at->format('d.m.Y') : 'fehlen noch'), 'activities' => [ $activity('Gast um Kontaktdaten bitten', $hasEmail || $asked, 'Gast um Kontaktdaten bitten'), $activity('Kontaktdaten eintragen (Name, E-Mail, Anschrift)', $hasEmail, 'Kontaktdaten eintragen'), ]]; } $needsOffer = in_array($kind, [self::OWN, self::PORTAL_INQUIRY, self::MANUAL], true); if ($needsOffer) { $steps[] = [ 'label' => 'Angebot', 'state' => $booking->offer_version > 0 || $binding ? 'done' : ($closed ? 'skipped' : 'current'), 'detail' => $booking->offer_version > 0 ? 'Version '.$booking->offer_version.', '.$booking->offer_sent_at?->format('d.m.Y') : null, 'activities' => [$activity('Angebot mit Vertragsentwurf an den Gast senden', $booking->offer_version > 0 || $binding, 'Angebot senden')], ]; } $steps[] = [ 'label' => $needsOffer ? 'Annahme / Vertrag' : 'Bestätigung / Vertrag', 'state' => $binding ? ($booking->confirmation_sent_at !== null || $booking->accepted_at !== null || $needsOffer ? 'done' : 'current') : ($closed ? 'skipped' : ($booking->status === BookingStatus::OfferSent ? 'current' : 'todo')), 'detail' => $booking->accepted_at ? 'angenommen '.$booking->accepted_at->format('d.m.Y') : ($booking->confirmation_sent_at ? 'Vertrag gesendet '.$booking->confirmation_sent_at->format('d.m.Y') : null), 'activities' => array_values(array_filter([ $needsOffer ? $activity('Gast nimmt das Angebot an (oder Buchung direkt bestätigen)', $binding, 'Direkt bestätigen') : $activity('Buchung bestätigen (Zeitraum fest belegen)', $binding, 'Direkt bestätigen'), $activity('Mietvertrag mit Anlagen an den Gast senden', $booking->confirmation_sent_at !== null, $binding ? 'Bestätigung erneut senden' : null), $booking->guest_confirmed_at ? $activity('Gast hat die Buchung per E-Mail bestätigt', true) : null, ])), ]; if ($booking->wantsPaymentTasks()) { $paid = $booking->paidAmount(); $steps[] = ['label' => 'Anzahlung', 'state' => $closed ? 'skipped' : ($paid >= $booking->deposit && $binding ? 'done' : ($binding ? 'current' : 'todo')), 'detail' => $booking->deposit_due_on ? 'fällig '.$booking->deposit_due_on->format('d.m.Y') : null, 'activities' => [ $activity('Zahlungseingang erfassen', $paid >= $booking->deposit && $binding, 'Zahlungen (unten)'), ]]; $steps[] = ['label' => 'Restzahlung', 'state' => $closed ? 'skipped' : ($paid >= $booking->total && $binding ? 'done' : ($binding && $paid >= $booking->deposit ? 'current' : 'todo')), 'detail' => 'fällig '.$booking->balance_due_on?->format('d.m.Y'), 'activities' => [ $activity('Restzahlung erfassen', $paid >= $booking->total && $binding, 'Zahlungen (unten)'), ]]; } else { $steps[] = ['label' => 'Zahlung', 'state' => 'skipped', 'detail' => 'läuft über das Portal', 'activities' => []]; } $arrived = ! $closed && $binding && $booking->arrival <= $today; $left = ! $closed && $binding && $booking->departure <= $today; $steps[] = ['label' => 'Anreise', 'state' => $closed ? 'skipped' : ($arrived ? 'done' : 'todo'), 'detail' => $booking->arrival->format('d.m.Y'), 'activities' => [ $activity('Anreise-Informationen ('.$booking->property->arrival_info_days_before.' Tage vorher, automatisch)', $booking->arrival_info_sent_at !== null), ]]; $steps[] = ['label' => 'Vor Ort', 'state' => $closed ? 'skipped' : ($arrived && ! $left ? 'current' : ($left ? 'done' : 'todo')), 'detail' => null, 'activities' => []]; $steps[] = ['label' => 'Abreise', 'state' => $closed ? 'skipped' : ($left ? 'done' : 'todo'), 'detail' => $booking->departure->format('d.m.Y'), 'activities' => []]; return $steps; } /** * What has happened so far, oldest first: milestones from the booking's own timestamps, payments and mails. * * @return list */ public static function history(Booking $booking): array { $events = []; $add = function (mixed $at, string $label) use (&$events): void { if ($at !== null) { $events[] = ['at' => CarbonImmutable::instance($at), 'label' => $label]; } }; $add($booking->created_at, 'Vorgang angelegt ('.$booking->bookingChannelLabel().')'); $add($booking->contact_requested_at, 'Gast um Kontaktdaten gebeten'); $add($booking->offer_sent_at, 'Angebot Version '.$booking->offer_version.' gesendet'); $add($booking->accepted_at, 'Angebot vom Gast angenommen'); $add($booking->guest_confirmed_at, 'Gast hat die Buchung per E-Mail bestätigt'); $add($booking->confirmed_at, 'Buchung verbindlich bestätigt'); $add($booking->confirmation_sent_at, 'Bestätigung mit Mietvertrag an den Gast gesendet'); $add($booking->confirmation_failed_at, 'Versand der Bestätigung fehlgeschlagen'); $add($booking->arrival_info_sent_at, 'Anreise-Informationen gesendet'); $add($booking->cancelled_at, 'Storniert'); $add($booking->archived_at, 'Archiviert'); foreach ($booking->payments()->get() as $payment) { $add($payment->paid_on ?? $payment->created_at, ($payment->amount < 0 ? 'Erstattung ' : 'Zahlung ').Money::format(abs($payment->amount)).' erfasst'); } foreach (BookingMessage::query()->where('booking_id', $booking->id)->get() as $message) { $add($message->sent_at, 'E-Mail: '.$message->subject.' ('.$message->audience.')'); } foreach (BookingTask::query()->where('booking_id', $booking->id)->where('status', BookingTaskStatus::Done)->get() as $task) { $add($task->completed_at, 'Aufgabe erledigt: '.$task->kind->getLabel()); } usort($events, fn (array $a, array $b): int => $a['at'] <=> $b['at']); return $events; } private static function cancelledText(Booking $booking, bool $open): string { $cancellation = Cancellation::query()->where('booking_id', $booking->id)->first(); if ($cancellation === null) { return $open ? 'Stornokosten bzw. Rückzahlung sind noch zu klären (siehe Aufgaben).' : 'Nichts mehr zu tun. Die Buchung bleibt zur Historie erhalten.'; } $balance = $cancellation->balance(); $text = 'Storniert am '.$cancellation->cancelled_on->format('d.m.Y').' ('.($cancellation->days_before ?? '?').' Tage vor Anreise). Stornokosten '.Money::format($cancellation->fee()).', bezahlt '.Money::format($cancellation->paid_amount).'.'; return $text.($cancellation->status === Cancellation::OPEN ? ($balance > 0 ? ' Noch einzufordern: '.Money::format($balance).'.' : ($balance < 0 ? ' Zu erstatten: '.Money::format(-$balance).'.' : ' Ausgeglichen – bitte als abgerechnet markieren.')) : ' Erledigt.'); } /** * @return array{title: string, text: string, color: string} */ public static function next(Booking $booking): array { $today = CarbonImmutable::today(); $kind = self::kind($booking); $money = fn (int $cents): string => Money::format($cents); $openTasks = BookingTask::query()->where('booking_id', $booking->id)->where('status', BookingTaskStatus::Open)->get(); $costs = $openTasks->firstWhere('kind', BookingTaskKind::CancellationFee); $wish = $openTasks->firstWhere('kind', BookingTaskKind::CancellationRequest); if ($wish !== null && $booking->status !== BookingStatus::Cancelled) { return ['title' => 'Stornierungswunsch des Gastes', 'text' => 'Der Gast möchte stornieren. Bitte prüfen: stornieren (mit Mail an den Gast) oder ablehnen, und Stornokosten klären.', 'color' => 'danger']; } return match (true) { $booking->status === BookingStatus::Cancelled => ['title' => 'Storniert', 'text' => self::cancelledText($booking, $costs !== null || $wish !== null), 'color' => $costs !== null ? 'warning' : 'gray'], $booking->status === BookingStatus::Declined => ['title' => 'Abgelehnt', 'text' => 'Der Zeitraum ist wieder frei.', 'color' => 'gray'], $booking->status === BookingStatus::Expired => ['title' => 'Abgelaufen', 'text' => 'Die Haltefrist ist verstrichen. Sie können die Anfrage trotzdem noch bestätigen, solange der Zeitraum frei ist.', 'color' => 'gray'], blank($booking->guest?->email) && $booking->departure > $today => ['title' => 'Kontaktdaten fehlen', 'text' => ($booking->contact_requested_at ? 'Die Kontaktdaten wurden am '.$booking->contact_requested_at->format('d.m.Y').' erfragt – Antwort abwarten. ' : 'Den Gast um Kontaktdaten bitten („Gast um Kontaktdaten bitten“). ').'Sobald sie da sind: „Kontaktdaten eintragen“ – dort lässt sich der Vertragsprozess automatisch starten oder von Hand weiterführen.', 'color' => 'warning'], $booking->status === BookingStatus::Reserved => ['title' => 'Anfrage prüfen', 'text' => $kind === self::PORTAL_BOOKING ? 'Kontaktdaten des Gastes eintragen, dann „Direkt bestätigen“ – der Vertrag geht per E-Mail an den Gast.' : 'Angebot senden („Angebot senden“) oder ablehnen.'.($booking->hold_expires_at ? ' Vorgemerkt bis '.$booking->hold_expires_at->format('d.m.Y, H:i').' Uhr.' : ' Es ist kein Zeitraum vorgemerkt.'), 'color' => 'warning'], $booking->status === BookingStatus::OfferSent => ['title' => 'Wartet auf den Gast', 'text' => 'Angebot Version '.$booking->offer_version.' ist beim Gast. Gültig bis '.$booking->hold_expires_at?->format('d.m.Y, H:i').' Uhr.', 'color' => 'info'], $booking->confirmation_failed_at !== null && $booking->confirmation_sent_at === null => ['title' => 'Bestätigung nicht zugestellt', 'text' => 'Die Buchung steht, aber die Bestätigungs-E-Mail ist nicht beim Gast angekommen. „Bestätigung erneut senden“.', 'color' => 'danger'], $kind === self::PORTAL_BOOKING && $booking->confirmation_sent_at === null && $booking->contract_path === null => ['title' => 'Vertrag senden', 'text' => 'Die Buchung ist beim Portal verbindlich. Bitte den Vertrag an den Gast senden (Bestätigung erneut senden).', 'color' => 'warning'], $booking->wantsPaymentTasks() && $booking->openDeposit() > 0 && $booking->status === BookingStatus::Confirmed => ['title' => 'Anzahlung offen', 'text' => $money($booking->openDeposit()).' fällig bis '.$booking->deposit_due_on?->format('d.m.Y').'. Zahlungseingang unter „Zahlungen“ erfassen.', 'color' => $booking->deposit_due_on?->isPast() ? 'danger' : 'warning'], $booking->wantsPaymentTasks() && $booking->openAmount() > 0 && $booking->balance_due_on?->lessThanOrEqualTo($today->addDays(14)) => ['title' => 'Restzahlung offen', 'text' => $money($booking->openAmount()).' fällig bis '.$booking->balance_due_on->format('d.m.Y').'.', 'color' => $booking->balance_due_on->isPast() ? 'danger' : 'warning'], $booking->arrival <= $today && $booking->departure > $today => ['title' => 'Gast ist vor Ort', 'text' => 'Abreise am '.$booking->departure->format('d.m.Y').'.', 'color' => 'success'], $booking->arrival > $today => ['title' => 'Anreise in '.$today->diffInDays($booking->arrival).' Tagen', 'text' => 'Anreise am '.$booking->arrival->format('d.m.Y').'. Anreise-Informationen gehen '.$booking->property->arrival_info_days_before.' Tage vorher automatisch an den Gast.', 'color' => 'success'], default => ['title' => 'Aufenthalt beendet', 'text' => 'Abreise war am '.$booking->departure->format('d.m.Y').'.', 'color' => 'gray'], }; } }