Buchungsprozess: Angebots-Snapshot, atomare Annahme, Auto-Angebot, Kanalfreigabe
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:
LarsandClaude Sonnet 5.5 committed 2026-10-30 12:01:02 +01:00
1 parent e7cc37a15b
commit eafab8a2cb
47 files changed
+2099 -104

No files matched your search

+111
View File
@@ -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;
}
}