Buchungsprozess: Angebots-Snapshot, atomare Annahme, Auto-Angebot, Kanalfreigabe
Deploy FeWo mit PipelineManager / deploy (push) Failing after 3m38s
Deploy FeWo mit PipelineManager / deploy (push) Failing after 3m38s
- Angebotsbedingungen und Zahlungsdaten werden je Version eingefroren (offer_terms, offer_hash) - Annahme in einer gesperrten Transaktion, idempotent, mit Nachweis; Mail- und Portalfehler machen eine gespeicherte Buchung nicht ungueltig (Postfach, Nachversand) - Je Wohnung: manuelle/automatische Angebote, optionale Vorreservierung - Automatische Freigabe abhaengig von aktuellen Importen und Feed-Abruf bei Sofortbuchungsportalen - Deutsche Fehlerseiten, Buchungsseite zeigt Angebots- und Zustellstatus - Dokumentation: BOOKING-E2E-*.md, BOOKING-COMPLIANCE-HANDOVER.md Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
e7cc37a15b
commit
eafab8a2cb
47 files changed
+2099
-104
No files matched your search
@@ -0,0 +1,111 @@
|
||||
<?php
|
||||
|
||||
namespace App\Documents;
|
||||
|
||||
use App\Models\Booking;
|
||||
use App\Support\Content;
|
||||
use Filament\Forms\Components\RichEditor\RichContentRenderer;
|
||||
use Illuminate\Support\HtmlString;
|
||||
|
||||
/**
|
||||
* The terms of one offer version, frozen when the offer is made (bookings.offer_terms): contract texts,
|
||||
* payment period and landlord/bank data. Offer page, PDFs, acceptance and confirmation read from this snapshot,
|
||||
* so later changes of the website texts never alter an offer the guest already received.
|
||||
* Bookings without a snapshot (created before it existed) fall back to the live texts.
|
||||
*/
|
||||
class OfferTerms
|
||||
{
|
||||
/** Website text keys that form part of the contract. */
|
||||
public const TEXT_KEYS = [
|
||||
'contract.intro',
|
||||
'contract.terms',
|
||||
'contract.closing',
|
||||
'stay.cancellation',
|
||||
'stay.house_rules',
|
||||
'offer.contract_note',
|
||||
'offer.accept_note',
|
||||
'offer.accept_button',
|
||||
];
|
||||
|
||||
/**
|
||||
* @return array{captured_at: string, texts: array<string, ?string>, deposit_due_days: int, owner: array<string, mixed>, bank: array<string, mixed>}
|
||||
*/
|
||||
public static function capture(): array
|
||||
{
|
||||
return [
|
||||
'captured_at' => now()->toIso8601String(),
|
||||
'texts' => collect(self::TEXT_KEYS)->mapWithKeys(fn (string $key): array => [$key => Content::get($key)])->all(),
|
||||
'deposit_due_days' => (int) config('fewo.deposit_due_days'),
|
||||
'owner' => (array) config('fewo.owner'),
|
||||
'bank' => (array) config('fewo.bank'),
|
||||
];
|
||||
}
|
||||
|
||||
public static function text(Booking $booking, string $key): ?string
|
||||
{
|
||||
$texts = $booking->offer_terms['texts'] ?? null;
|
||||
|
||||
return is_array($texts) ? ($texts[$key] ?? null) : Content::get($key);
|
||||
}
|
||||
|
||||
public static function html(Booking $booking, string $key): HtmlString
|
||||
{
|
||||
$value = self::text($booking, $key);
|
||||
|
||||
return new HtmlString(filled($value) ? RichContentRenderer::make($value)->toHtml() : '');
|
||||
}
|
||||
|
||||
public static function depositDueDays(Booking $booking): int
|
||||
{
|
||||
return (int) ($booking->offer_terms['deposit_due_days'] ?? config('fewo.deposit_due_days'));
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
public static function owner(Booking $booking): array
|
||||
{
|
||||
return $booking->offer_terms['owner'] ?? (array) config('fewo.owner');
|
||||
}
|
||||
|
||||
/**
|
||||
* @return array<string, mixed>
|
||||
*/
|
||||
public static function bank(Booking $booking): array
|
||||
{
|
||||
return $booking->offer_terms['bank'] ?? (array) config('fewo.bank');
|
||||
}
|
||||
|
||||
/**
|
||||
* Fingerprint of everything the guest agrees to in this offer version. The validity (hold_expires_at) is
|
||||
* not part of it – the landlord may extend it – but is checked separately.
|
||||
*/
|
||||
public static function hash(Booking $booking): string
|
||||
{
|
||||
return hash('sha256', json_encode(self::canonical([
|
||||
'version' => $booking->offer_version,
|
||||
'arrival' => $booking->arrival->toDateString(),
|
||||
'departure' => $booking->departure->toDateString(),
|
||||
'guests' => $booking->guests,
|
||||
'quote' => $booking->quote,
|
||||
'total' => $booking->total,
|
||||
'deposit' => $booking->deposit,
|
||||
'balance_due_on' => $booking->balance_due_on->toDateString(),
|
||||
'terms' => $booking->offer_terms,
|
||||
]), JSON_THROW_ON_ERROR | JSON_UNESCAPED_UNICODE));
|
||||
}
|
||||
|
||||
private static function canonical(mixed $value): mixed
|
||||
{
|
||||
if (! is_array($value)) {
|
||||
return $value;
|
||||
}
|
||||
|
||||
$value = array_map(self::canonical(...), $value);
|
||||
if (! array_is_list($value)) {
|
||||
ksort($value);
|
||||
}
|
||||
|
||||
return $value;
|
||||
}
|
||||
}
|
||||
Reference in new issue
Block a user