- bookings.hold_purpose (offer wie bisher / clarification). - RequestHold: vollständige Anfrage → Angebots-Hold unverändert; unvollständig, aber Wohnung, Zeitraum, verwendbare E-Mail und freier Zeitraum → nur Klärungsreservierung (15 min automatisch / 180 min Freigabe oder manuell, 0 = keine); sonst nichts (B1). Auch für Portalanfragen ohne Gastdaten. - ExpireReservations beendet nur Angebots-Holds; ein abgelaufener Klärungsblock gibt nur den Kalender frei, der Vorgang bleibt offen. - Vervollständigen erzeugt keinen Hold; erst SendOffer setzt den unveränderten Angebots-Hold. AutoOffer prüft danach nur die Verfügbarkeit. - Booking::clarificationState() liefert den tatsächlichen Sperrstatus. - Architekturtest: nur die bestehenden Reservierungsschritte schreiben Holds. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
202 lines
10 KiB
PHP
202 lines
10 KiB
PHP
<?php
|
||
|
||
namespace App\Actions;
|
||
|
||
use App\Availability\AvailabilityChecker;
|
||
use App\Documents\DocumentComposer;
|
||
use App\Documents\OfferTerms;
|
||
use App\Documents\RentalContract;
|
||
use App\Enums\BookingStatus;
|
||
use App\Enums\DocumentKind;
|
||
use App\Enums\InboxMessageKind;
|
||
use App\Enums\QuoteLineType;
|
||
use App\Exceptions\ReservationException;
|
||
use App\Filament\Resources\Bookings\BookingResource;
|
||
use App\Mail\OfferMade;
|
||
use App\Models\Booking;
|
||
use App\Pricing\PriceCalculator;
|
||
use App\Pricing\PriceQuote;
|
||
use App\Pricing\QuoteException;
|
||
use App\Pricing\QuoteLine;
|
||
use App\Pricing\StayRequest;
|
||
use App\Process\CaseLog;
|
||
use App\Process\CaseRequirements;
|
||
use App\Support\Inbox;
|
||
use Carbon\CarbonImmutable;
|
||
use Illuminate\Support\Arr;
|
||
use Illuminate\Support\Facades\DB;
|
||
use Illuminate\Support\Facades\Log;
|
||
use Illuminate\Support\Facades\Mail;
|
||
use Illuminate\Support\Facades\URL;
|
||
use Throwable;
|
||
|
||
/**
|
||
* Booking path 1 (docs/KONZEPT.md §6a): the landlord turns a request into an offer. Dates, guests, promo
|
||
* code, a manual price adjustment and the guest's contact data can be changed; the price is calculated again,
|
||
* the contract draft is generated and the guest receives it with a signed link to accept or decline.
|
||
* Sending again replaces the previous offer (links of older versions stop working).
|
||
*/
|
||
class SendOffer
|
||
{
|
||
public function __construct(
|
||
private PriceCalculator $calculator,
|
||
private AvailabilityChecker $availability,
|
||
private RentalContract $contract,
|
||
private Inbox $inbox,
|
||
) {}
|
||
|
||
/**
|
||
* The offer is checked through its composition ({@see DocumentComposer}) like every other document: points the
|
||
* landlord has to confirm (e.g. an unreleased template, missing contract data, a request that by the settings
|
||
* reserves nothing) stop it unless `acknowledged` is set. `expected_version` makes a repeated call harmless: when
|
||
* another offer was sent in the meantime, nothing is sent again.
|
||
*
|
||
* @param array{arrival?: string, departure?: string, guests?: int, promo_code?: ?string, price_adjustment?: ?int, price_adjustment_label?: ?string, valid_until?: ?string, offer_message?: ?string, contract_template_id?: int|string|null, annex_ids?: ?list<int|string>, guest?: array<string, ?string>, acknowledged?: bool, expected_version?: ?int} $changes
|
||
*
|
||
* @throws QuoteException
|
||
* @throws ReservationException
|
||
*/
|
||
public function handle(Booking $booking, array $changes = [], bool $sendMail = true): Booking
|
||
{
|
||
if ($sendMail && blank($booking->guest?->email)) {
|
||
throw new ReservationException('Vor dem E-Mail-Versand bitte die E-Mail-Adresse des zugeordneten Gastes ergänzen.');
|
||
}
|
||
|
||
if (! in_array($booking->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true)) {
|
||
throw ReservationException::invalidTransition($booking->status->getLabel(), 'als Angebot versendet');
|
||
}
|
||
|
||
// G2a (v0.11): never an own binding offer without the required details – not even confirmed by hand.
|
||
if (($missing = CaseRequirements::blocker($booking->loadMissing('guest'), CaseRequirements::OFFER)) !== null) {
|
||
throw new ReservationException($missing);
|
||
}
|
||
|
||
$toConfirm = app(DocumentComposer::class)->compose($booking, DocumentKind::Offer, $changes)->toConfirm();
|
||
if ($toConfirm !== [] && ! ($changes['acknowledged'] ?? false)) {
|
||
throw new ReservationException('Bitte die Hinweise prüfen und ausdrücklich bestätigen: '.implode(' ', $toConfirm));
|
||
}
|
||
|
||
DB::transaction(function () use ($booking, $changes): void {
|
||
$booking->lockForTransition();
|
||
|
||
if (! in_array($booking->status, [BookingStatus::Reserved, BookingStatus::OfferSent, BookingStatus::Expired], true)) {
|
||
throw ReservationException::invalidTransition($booking->status->getLabel(), 'als Angebot versendet');
|
||
}
|
||
|
||
if (isset($changes['expected_version']) && $booking->offer_version !== (int) $changes['expected_version']) {
|
||
throw new ReservationException('Inzwischen wurde schon ein Angebot gesendet (Version '.$booking->offer_version.'). Es wurde nichts erneut gesendet.');
|
||
}
|
||
|
||
$arrival = CarbonImmutable::parse($changes['arrival'] ?? $booking->arrival);
|
||
$departure = CarbonImmutable::parse($changes['departure'] ?? $booking->departure);
|
||
|
||
if (! $this->availability->isAvailable($booking->property, $arrival, $departure, ignore: $booking)) {
|
||
throw ReservationException::notAvailable();
|
||
}
|
||
|
||
$promoCode = array_key_exists('promo_code', $changes) ? (filled($changes['promo_code']) ? trim((string) $changes['promo_code']) : null) : $booking->promo_code;
|
||
$stay = new StayRequest($arrival, $departure, (int) ($changes['guests'] ?? $booking->guests), $booking->extras ?? [], $promoCode);
|
||
$adjustment = (int) ($changes['price_adjustment'] ?? 0);
|
||
$adjustmentLabel = trim((string) ($changes['price_adjustment_label'] ?? '')) ?: ($adjustment < 0 ? 'Nachlass' : 'Zuschlag');
|
||
$quote = $this->quoteFor($booking, $stay, $adjustment, $adjustmentLabel);
|
||
|
||
if (filled($changes['guest'] ?? null)) {
|
||
$booking->guest->update(Arr::only(array_map(fn ($value) => filled($value) ? trim((string) $value) : null, $changes['guest']), ['first_name', 'last_name', 'phone', 'street', 'postal_code', 'city', 'country']));
|
||
}
|
||
|
||
$booking->update([
|
||
'status' => BookingStatus::OfferSent,
|
||
'arrival' => $arrival->toDateString(),
|
||
'departure' => $departure->toDateString(),
|
||
'guests' => $stay->guests,
|
||
'promo_code' => $quote->promoCodeApplied ? $promoCode : null,
|
||
'price_adjustment' => $adjustment !== 0 ? $adjustment : null,
|
||
'price_adjustment_label' => $adjustment !== 0 ? $adjustmentLabel : null,
|
||
'quote' => $quote->toArray(),
|
||
'total' => $quote->total(),
|
||
'deposit' => $quote->deposit(),
|
||
'balance_due_on' => $quote->balanceDueOn->toDateString(),
|
||
'hold_expires_at' => filled($changes['valid_until'] ?? null) ? CarbonImmutable::parse($changes['valid_until']) : now()->addHours($booking->process()->holdHours()),
|
||
'hold_purpose' => Booking::HOLD_OFFER,
|
||
'offer_version' => $booking->offer_version + 1,
|
||
'offer_sent_at' => now(),
|
||
'offer_message' => $changes['offer_message'] ?? null,
|
||
'offer_terms' => OfferTerms::capture(OfferTerms::templateFor($booking, $changes['contract_template_id'] ?? null), $booking, array_key_exists('annex_ids', $changes) && is_array($changes['annex_ids']) ? array_map('intval', $changes['annex_ids']) : null),
|
||
]);
|
||
$booking->refresh();
|
||
$booking->update(['offer_hash' => OfferTerms::hash($booking)]);
|
||
});
|
||
|
||
$booking->refresh();
|
||
$this->contract->generate($booking, draft: true);
|
||
CaseLog::record($booking, 'document', 'Angebot Version '.$booking->offer_version.' erstellt'.(isset($booking->offer_terms['template']['name']) ? ' (Vorlage '.$booking->offer_terms['template']['name'].', Version '.$booking->offer_terms['template']['version'].')' : ' (Texte der Webseite)'), data: array_filter([
|
||
'kind' => DocumentKind::Offer->value,
|
||
'template' => $booking->offer_terms['template'] ?? null,
|
||
'annexes' => array_map(fn (array $annex): string => $annex['name'].' (Version '.$annex['version'].')', (array) ($booking->offer_terms['annexes'] ?? [])),
|
||
'pdf_sha256' => $booking->offer_pdf_sha256,
|
||
'offer_hash' => $booking->offer_hash,
|
||
'confirmed' => $toConfirm,
|
||
]));
|
||
|
||
if ($sendMail) {
|
||
$this->deliver($booking);
|
||
}
|
||
|
||
return $booking;
|
||
}
|
||
|
||
/**
|
||
* Sends the offer mail. The offer is already saved (and its validity runs), so a failing mail server is
|
||
* recorded in the admin inbox and reported to the caller instead of being lost.
|
||
*
|
||
* @throws ReservationException
|
||
*/
|
||
public function deliver(Booking $booking): void
|
||
{
|
||
try {
|
||
Mail::to($booking->guest->email, $booking->guest->full_name)->send(new OfferMade($booking, $this->offerUrl($booking)));
|
||
} catch (Throwable $exception) {
|
||
// Only class and booking id are logged: mail errors can contain the recipient's address.
|
||
Log::warning('Angebot nicht zugestellt', ['booking' => $booking->id, 'exception' => $exception::class]);
|
||
$this->inbox->post(
|
||
InboxMessageKind::OfferMailFailed,
|
||
'booking-'.$booking->id.':v'.$booking->offer_version,
|
||
'Angebot '.$booking->reference.' nicht zugestellt',
|
||
'Das Angebot ist gespeichert und der Zeitraum gehalten, aber die E-Mail konnte nicht versendet werden. Auf der Buchungsseite kann der Angebotslink kopiert und dem Gast anders übermittelt werden.',
|
||
actionUrl: BookingResource::getUrl('view', ['record' => $booking]),
|
||
propertyId: $booking->property_id,
|
||
);
|
||
|
||
throw new ReservationException('Das Angebot wurde gespeichert, aber die E-Mail konnte nicht versendet werden. Der Angebotslink kann über „Angebotslink“ kopiert werden.');
|
||
}
|
||
}
|
||
|
||
/**
|
||
* The guest's link to the offer page; valid while the offer is valid and only for this offer version.
|
||
*/
|
||
public function offerUrl(Booking $booking): string
|
||
{
|
||
$parameters = ['booking' => $booking, 'v' => $booking->offer_version];
|
||
|
||
return $booking->website()?->temporarySignedRoute('offers.show', $booking->hold_expires_at, $parameters)
|
||
?? URL::temporarySignedRoute('offers.show', $booking->hold_expires_at, $parameters);
|
||
}
|
||
|
||
/**
|
||
* Price for the (possibly changed) stay plus the manual adjustment; a reduction never makes the stay negative.
|
||
*
|
||
* @throws QuoteException
|
||
*/
|
||
public function quoteFor(Booking $booking, StayRequest $stay, int $adjustment, string $label): PriceQuote
|
||
{
|
||
$quote = $this->calculator->calculate($booking->property, $stay);
|
||
if ($adjustment === 0) {
|
||
return $quote;
|
||
}
|
||
|
||
$adjustment = max($adjustment, -$quote->rent());
|
||
|
||
return $quote->withLine(new QuoteLine(QuoteLineType::Adjustment, $label, 1, $adjustment, $adjustment));
|
||
}
|
||
}
|