Files
fewo-stommer/BOOKING-E2E-READINESS.md
T
LarsandClaude Sonnet 5.5 eafab8a2cb
Deploy FeWo mit PipelineManager / deploy (push) Failing after 3m38s
Buchungsprozess: Angebots-Snapshot, atomare Annahme, Auto-Angebot, Kanalfreigabe
- 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>
2026-10-30 12:01:02 +01:00

24 KiB
Raw Blame History

BOOKING-E2E-READINESS – End-to-End-Direktbuchung

Stand: 30.10.2026 · Branch feature/titelvideo-rundgang · Phase 1: Analyse und Plan, nur lesend. Es wurden keine Code-, Datenbank-, CMS- oder Serveränderungen vorgenommen. Phase 2 beginnt erst nach ausdrücklicher Freigabe.

Grenzen dieser Analyse (ehrlich vorab):

  • Geprüft wurde der Quellcode (Actions, Controller, Views, Mails, Observer, Tests). Die Testsuite wurde nicht ausgeführt, Staging (stommer.info) wurde nicht aufgerufen, kein Mail-Versand versucht.
  • Die Aussagen zu Nebenläufigkeit (Abschnitt 3) sind Code-Analyse, nicht durch Lasttest belegt. Sie sind in Phase 2 mit einem echten Parallel-Test auf MariaDB zu bestätigen.
  • Rechtstexte, Button-Wortlaut und Vertragsinhalte wurden nicht rechtlich bewertet (Verantwortung Betreiber).

1. Fazit in drei Sätzen

Der Weg „Anfrage → Angebot → signierter Link → Annahme → Bestätigung + Vertrag“ existiert bereits vollständig (KONZEPT §6a, Weg 1) und ist architektonisch passend. Zum Soll-Prozess fehlen drei Dinge: (a) das Angebot wird heute manuell durch die Vermieterin erzeugt (Soll: automatisch), (b) die Annahme ist nicht transaktionssicher und nicht idempotent, und die Fehlerbehandlung bei Mailproblemen kann einen Gast nach verbindlicher Buchung vor eine Fehlerseite stellen, (c) die Vertragsbedingungen werden nicht als Angebotsversion eingefroren – die Annahme-Nachweise hashen die zum Zeitpunkt der Annahme gerade gültigen Texte, nicht die dem Gast gezeigten. Alles ist mit kleinen, rückwärtskompatiblen Änderungen lösbar, ohne Architekturumbau.


2. Ist-/Soll-Abgleich

# Soll-Schritt Ist (Fundstelle) Bewertung
1 Gast stellt unverbindliche Anfrage Livewire\BookingRequest → CreateReservation; Bot-Schutz, Rate-Limits ✅ vorhanden
2 Verfügbarkeit prüfen, Preis berechnen CreateReservation (Property-lockForUpdate, AvailabilityChecker, PriceCalculator) ✅ vorhanden
3 Zeitraum befristet reservieren, versioniertes Angebot mit allen Bedingungen Reservierung: Reserved + hold_expires_at (✅). Angebot: SendOffer erhöht offer_version, speichert quote, erzeugt Entwurfs-PDF (✅). Aber: nur auf manuelle Aktion im Admin; Bedingungen werden nicht als Snapshot gespeichert ⚠️ Lücke A + C
4 Angebot per E-Mail mit sicherem Annahmelink OfferMade + SendOffer::offerUrl() (temporarySignedRoute, Ablauf = hold_expires_at, Version v im Link) ✅ vorhanden
5 Link öffnet nur die Angebotsseite, ohne Buchung GET /angebot/{booking} → OfferController::show ändert nichts; Annahme nur per POST ✅ vorhanden
6 Gast prüft Preis, Leistungen, Zahlungs-/Stornobedingungen resources/views/offer.blade.php: Aufenthalt, Preiszeilen, Zahlungsplan, contract.terms, stay.cancellation, Gültig-bis ✅ weitgehend. Lücken: Bedingungen kommen aus aktuellem CMS-Stand (C); Hausordnung (stay.house_rules) steht im PDF, aber nicht auf der Seite; kein speicher-/druckbares Dokument auf der Seite selbst
7 Ausdrückliche Bestätigung „Zahlungspflichtig buchen“ Checkbox „gelesen“ + Button, Text aus offer.accept_button (Default: „Angebot zahlungspflichtig annehmen“), Hinweis offer.accept_note ✅ technisch; Wortlaut ist Betreiber-/Rechtsfrage (Q1)
8 Gültigkeit und Verfügbarkeit erneut prüfen Gültigkeit/Version/Status: AcceptOffer::ensureAcceptable. Verfügbarkeit: ConfirmBooking (in Transaktion, ohne Sperre) ⚠️ Lücke B
9 Annahme dokumentieren, Confirmed setzen AcceptOffer: accepted_at + JSON acceptance (Version, Zeit, Gesamt, quote_sha256, terms_sha256, via) → ConfirmBooking ⚠️ Nachweis unvollständig (C); Schreiben nicht atomar mit Statuswechsel (B)
10 Bestätigung + Vertragsunterlagen BookingConfirmed mit Vertrags-PDF (RentalContract::generate) ⚠️ Fehlerbehandlung (D); finales PDF wird aus aktuellen Texten neu gerendert (C)
11 Kalender verbindlich gesperrt, Portal-Sync ausgelöst occupying()-Scope; iCal-Feed wird bei Abruf live berechnet (kein Cache, no-cache); BookingObserver → CreateChannelTasks für Portale mit manueller Sperre, Webhook-Automation ✅ im Kern; Fehlerpfad prüfen (E)

3. Gefundene Schwachstellen (aus dem Code belegt)

B1 – Annahme ist nicht atomar und nicht idempotent (AcceptOffer::handle, ConfirmBooking::handle)

  • ensureAcceptable() liest Status/Frist außerhalb einer Transaktion und ohne Zeilensperre. Zwei gleichzeitige POSTs (Doppelklick, Mail-Client-Prefetch ist hier unkritisch, weil POST) können beide die Prüfung bestehen.
  • Beide schreiben accepted_at/acceptance; beide rufen ConfirmBooking mit veraltetem In-Memory-Status OfferSent auf → doppelte BookingConfirmed-Mail und doppelte OfferAnswered-Mail sind möglich; confirmed_at und deposit_due_on werden überschrieben.
  • Wird ConfirmBooking mit notAvailable abgewiesen, bleiben accepted_at und acceptance bereits gesetzt, während der Status OfferSent bleibt (Schreiben erfolgt vor der Transaktion). Das ist ein falscher Annahmenachweis.
  • Zweiter, nacheinander erfolgender Klick: Gast sieht die Fehlermeldung „Eine Buchung im Status ‚Bestätigt‘ kann nicht angenommen werden“, obwohl seine Annahme gelungen ist. Soll: idempotent („bereits angenommen am …“).

B2 – Verfügbarkeitsprüfung ohne Sperre (ConfirmBooking, SendOffer)

  • CreateReservation sperrt die Property-Zeile (lockForUpdate), ConfirmBooking und SendOffer nicht. Unter MariaDB/InnoDB (REPEATABLE READ) ist exists() ein nicht sperrender Lesezugriff. Für überlappende Buchungen reicht die Sperre in CreateReservation nur, solange alle Schreiber dieselbe Sperre nehmen.
  • Konkretes Risiko: Hold einer Anfrage läuft ab (Expired-Status wird nur vom 5-Minuten-Cron gesetzt, der Kalender gibt den Zeitraum aber sofort frei) → Dritter reserviert denselben Zeitraum → alte Anfrage wird danach durch den Admin über ConfirmBooking bestätigt (Expired ist dort erlaubt, Prüfung läuft ohne Sperre). Für die Gast-Annahme ist das durch ensureAcceptable (Frist) abgefangen; für Parallelität zweier Bestätigungen gilt B2 trotzdem.
  • Es gibt keine Datenbank-Garantie gegen überlappende verbindliche Buchungen (kein Constraint; bei MariaDB ohnehin nur mit Exclusion-Tricks möglich). Sinnvoll ist daher die konsequente Property-Sperre in jedem schreibenden Pfad.
  • Portal-Importe (SyncChannel → BlockedPeriod) laufen unabhängig; eine Doppelbelegung durch Portalbuchung zwischen Prüfung und Commit wird erst von ConflictDetector / ReportChannelConflicts gemeldet (Restrisiko laut KONZEPT §7, nicht lösbar ohne Channel-Manager-API).

C – Angebotsversion ist nicht unveränderlich (SendOffer, AcceptOffer, offer.blade.php, pdf/contract.blade.php)

  • Preis/Quote werden pro Version gespeichert und das Entwurfs-PDF pro Version abgelegt (gut). Nicht gespeichert: Mietbedingungen (contract.terms), Stornobedingungen (stay.cancellation), Hausordnung, Vertragseinleitung/-schluss, Zahlungsdaten (deposit_due_days, Bankdaten).
  • Die Angebotsseite rendert diese Texte live aus Content. Ändert der Betreiber nach Versand die Bedingungen, sieht der Gast beim Annehmen andere Bedingungen als in der E-Mail/dem PDF.
  • AcceptOffer berechnet terms_sha256 beim Annehmen aus dem dann aktuellen Text. Der Nachweis belegt also „Texte zum Zeitpunkt der Annahme“, nicht „Texte, die in Version n angeboten wurden“. Eine Änderung zwischen Versand und Annahme bleibt unbemerkt (Testaufgabe 5 würde das aufdecken).
  • ConfirmBooking erzeugt das finale Vertrags-PDF neu aus aktuellen Texten; es kann vom Angebots-PDF abweichen.
  • quote_sha256 wird ebenfalls erst bei Annahme gebildet; eine Änderung von quote/total zwischen Versand und Annahme (z. B. durch Admin-Bearbeitung) würde mitgehasht statt erkannt.

D – Fehlerbehandlung bei Mail (AcceptOffer, ConfirmBooking, SendOffer, OfferController::answer)

  • ConfirmBooking sendet BookingConfirmed ungeschützt nach dem Commit. Wirft der Mailversand (SMTP down), ist die Buchung bereits Confirmed, der Controller fängt nur ReservationException → Gast sieht eine 500-Seite und glaubt, nichts sei passiert. Er klickt erneut → Fehlermeldung „Status Bestätigt“ (B1). Die Betreiber-Mail OfferAnswered wird in diesem Fall nicht mehr gesendet (Exception unterbricht AcceptOffer).
  • Es gibt keine Nachversand-Möglichkeit/-Markierung: kein Feld „Bestätigung gesendet am“, kein Eintrag im Postfach (AppSupportInbox) für fehlgeschlagene Gästemails. CreateReservation fängt dagegen korrekt ab (report($exception)), ist aber ebenfalls nur im Log sichtbar.
  • SendOffer: wirft der Versand, ist der Status schon OfferSent (Frist läuft!), aber der Gast hat nichts bekommen; der Admin sieht den Fehler, ein automatischer Prozess hätte keinen Ort dafür.
  • report($exception) schreibt die Exception ins Log; Symfony-Mailer-Fehlermeldungen können Empfängeradressen enthalten → personenbezogene Daten im Log (Q6).

E – Portal-Sync-Fehlerpfad (BookingObserver::tasks, CreateChannelTasks)

  • Der iCal-Export wird live berechnet; die Sperre ist sofort im Feed sichtbar. Portale ziehen den Feed selbst (Verzögerung portalseitig, bekannt).
  • Der Observer läuft in DB::afterCommit. Exceptions in diesem Closure (z. B. DB-Fehler beim Anlegen der ChannelTask) würden nach dem Commit nach oben durchschlagen → Gast bekäme 500, obwohl Buchung steht. Mail und Webhook darin sind einzeln mit rescue/try abgesichert, die Aufgabenanlage selbst nicht.
  • Fehlgeschlagene Webhooks landen in ChannelTask.automation_error und werden vom bestehenden Erinnerungs-/Monitor-Mechanismus aufgegriffen (✅). Für den Gast-Pfad soll gelten: Sync-Fehler dürfen die Annahme nie scheitern lassen, müssen aber für die Betreiber sichtbar werden.

F – Sonstiges

  • tests/Feature/OfferWorkflowTest.php (Test test_guest_accepts_the_offer_and_the_booking_becomes_binding) enthält am Ende ein dump(strip_tags(...)) – Debug-Überbleibsel, erzeugt Ausgabe in jedem Testlauf. Beim Umbau entfernen.
  • Formular-POST nutzt CSRF + Session. Bleibt die Angebotsseite > 120 Min. offen, liefert der Server eine englische 419-Standardseite (bereits in MVP-TECHNICAL-GATE #6 als Fehlerseiten-Thema). Für den Annahmeweg besonders unglücklich → deutsche 419-Seite mit Rücksprung auf die (neu signierte) Angebotsseite.
  • Die signierte POST-URL läuft mit hold_expires_at ab; der Gast, der bis kurz vor Fristende wartet, kann zwischen Seitenaufruf und Klick in den Ablauf laufen → bekommt dann die (richtige) Meldung „nicht mehr gültig“ über die 403 des signed-Middleware (englische Standardseite!), nicht über offerExpired(). Zu prüfen/abzufangen.

4. Wiederverwendbare Bestandteile (nicht neu bauen)

Bestandteil Verwendung
CreateReservation Schritt 1–2 unverändert; Property-Sperre als Vorlage für B2
SendOffer (handle(..., sendMail), offerUrl()) Auto-Angebot: Aufruf mit leerem $changes; Preis wird neu berechnet
PriceCalculator / PriceQuote / QuoteException unverändert
AcceptOffer / RejectOffer / ConfirmBooking Kern bleibt, wird gehärtet statt ersetzt
OfferController, offer.blade.php, Routen offers.* (signiert, Throttle) bleiben, Bedingungen kommen künftig aus dem Snapshot
RentalContract (Draft pro Version, finaler Vertrag) Snapshot als Datenquelle
OfferMade, BookingConfirmed, OfferAnswered, ReservationReceived, NewReservation unverändert (Inhalt Betreiber)
Booking::occupying(), AvailabilityChecker unverändert; nur Sperre ergänzen
BookingObserver → CreateChannelTasks, iCal-Feed, ConflictDetector Sync-Auslösung bleibt; Fehlerpfad absichern
ExpireReservations / bookings:expire-holds unverändert
AppSupportInbox (Postfach, Fingerprint, Erinnerungsintervall) Ablage für Mail-/Sync-Fehler
Settings::notificationRecipients(), Testmodus unverändert (alle Tests laufen im Testmodus)
ReservationException (gast-taugliche Meldungen) um wenige Fälle erweitern

5. Minimal erforderliche Codeänderungen

  1. Auto-Angebot (A): Neue Action App\Actions\AutoOffer (oder Option in CreateReservation), die nach erfolgreicher Reservierung SendOffer->handle($booking) aufruft. Gesteuert über eine Einstellung je Wohnung/Mandant (auto_offer, Default aus → bisheriges Verhalten bleibt). Fehler des Versands werden abgefangen (siehe D); die Reservierung geht nie verloren. Die bisherige Eingangsbestätigung (ReservationReceived) wird bei aktivem Auto-Angebot nicht doppelt gesendet. Hinweis: Das Angebot soll bei Auto-Angebot dieselbe Frist wie hold_hours haben (48 h, je Wohnung einstellbar).
  2. Angebots-Snapshot (C): In SendOffer beim Versand Bedingungen, Storno, Hausordnung, Vertragstexte und Zahlungsfristen in einem JSON-Feld festhalten, samt Hash. Angebotsseite, Entwurfs- und Final-PDF lesen aus dem Snapshot. Altbuchungen ohne Snapshot: Fallback auf Live-Content (rückwärtskompatibel).
  3. Atomare, idempotente Annahme (B1/B2): AcceptOffer::handle komplett in DB::transaction: Property-Zeile lockForUpdate, Buchung frisch mit lockForUpdate laden, dann Version/Status/Frist/Verfügbarkeit prüfen, Nachweis schreiben und Status setzen. Ist die Buchung bereits mit derselben Version angenommen: kein Fehler, keine zweite Mail, Erfolgsseite. ConfirmBooking bekommt dieselbe Property-Sperre. Mails erst nach Commit.
  4. Nachweis (C): acceptance um offer_hash (Hash über Quote + Snapshot bei Versand), offer_sent_at, valid_until, button_label, checkbox_label, user_agent_hash-optional ergänzen. Bei Annahme: gespeicherten offer_hash mit dem aktuellen vergleichen; Abweichung → Annahme abweisen („Angebot wurde geändert“) und Admin-Postfachmeldung.
  5. Fehlerisolierung (D/E): Gast-Mails und Betreiber-Mails in AcceptOffer einzeln in try/catch; bei Fehler Eintrag in AppSupportInbox (ohne Empfängeradresse im Text) und Zeitstempel-Felder (confirmation_sent_at, confirmation_failed_at). Der Gast sieht immer die Erfolgsseite, falls die Buchung committed ist, mit Hinweis „Bestätigung folgt“, wenn die Mail scheiterte. Observer-Closure in rescue() kapseln, Fehler → Postfach.
  6. Nachversand: Admin-Aktion „Bestätigung erneut senden“ (Buchungsseite) und Cron-Fallback bookings:resend-confirmations, der Bestätigungen mit gesetztem confirmation_failed_at erneut versucht.
  7. Gast-Fehlerseiten: Deutsche 403/419-Seiten für den Annahmeweg mit Rücksprung auf die Angebotsseite (bündelt sich mit MVP-Gate #6).
  8. Bereinigung: dump() aus OfferWorkflowTest entfernen.

Nicht geändert: Preisberechnung, Tenancy, Kanalarchitektur, Themes, Rechnungs-/Zahlungslogik (RecordPayment).


6. Notwendige Datenbankänderungen (eine additive Migration, rückwärtskompatibel)

Tabelle bookings:

Spalte Typ Zweck
offer_terms json nullable eingefrorene Bedingungen/Texte/Zahlungsfristen der aktuellen Angebotsversion
offer_hash string(64) nullable SHA-256 über quote + offer_terms + total bei Versand
confirmation_sent_at timestamp nullable Gästebestätigung nachweislich versendet
confirmation_failed_at timestamp nullable Versand fehlgeschlagen → Nachversand

Tenant/Property: Einstellung auto_offer (bool, Default false) – an der Stelle, wo hold_hours bereits liegt (properties), eine Spalte auto_offer.

Alle Spalten nullable bzw. mit Default; bestehende Daten werden nicht verändert; kein Backfill nötig (Fallback für NULL). Down-Migration entfernt die Spalten. Produktionsdaten werden nicht berührt, solange die Migration nicht deployt wird.

Optional (später): eigene Tabelle booking_events (Audit-Trail) statt JSON-Feld – für den MVP nicht nötig.


7. Tests und Akzeptanzkriterien

Alle Tests laufen in der Entwicklungsumgebung (php artisan test), Mail über Mail::fake() bzw. MAIL_MAILER=array; zusätzlich ein Staging-Durchlauf im Testmodus (Mails nur an Testadresse).

# Testaufgabe Konkrete Prüfung Akzeptanzkriterium
1 Erfolgreiche Buchung inkl. aller Mails Anfrage über Livewire → (Auto-)Angebot → GET Angebotsseite → POST Annahme Status Confirmed; genau 1× OfferMade, 1× BookingConfirmed (mit PDF-Anhang), 1× OfferAnswered; Kalender zeigt Nächte belegt; iCal-Feed enthält Sperre; Nachweis vollständig
2 Abgelaufenes Angebot Zeit hinter hold_expires_at schieben (a) vor, (b) nach Cron-Lauf GET zeigt Hinweis; POST abgelehnt mit deutscher Meldung; Zeitraum frei; Status bleibt unverändert; keine Mail
3 Doppelte Annahme zweimal POST nacheinander; zusätzlich zwei gleichzeitige Requests (zwei Prozesse gegen MariaDB) genau eine BookingConfirmed, eine confirmed_at; zweite Anfrage → Erfolgsseite „bereits angenommen“, kein Fehler, keine zweite Mail
4 Parallele Buchungen derselben Zeit (a) zwei Anfragen gleichzeitig; (b) Annahme von Angebot A, während Angebot B (anderer Gast, abgelaufene Haltefrist) denselben Zeitraum bekam; (c) Admin-ConfirmBooking parallel zur Gastannahme niemals zwei überlappende occupying-Buchungen; Verlierer erhält notAvailable-Meldung, kein Annahmenachweis, kein Statuswechsel
5 Geänderte Angebotsbedingungen (a) contract.terms nach Versand ändern; (b) Admin sendet neue Version; (c) alter Link (v=1) (a) Seite/Annahme/PDF zeigen weiterhin den Snapshot v1 und der Nachweis hasht v1; (b) alter Link → offerOutdated; (c) bei manipuliertem quote/total nach Versand wird die Annahme abgewiesen (Hash-Abweichung)
6 Fehlgeschlagener Mailversand Mailer wirft Exception bei BookingConfirmed, OfferMade, OfferAnswered Buchung bleibt Confirmed; Gast sieht Erfolgsseite mit Hinweis; confirmation_failed_at gesetzt; Postfach-Eintrag ohne E-Mail-Adresse; Nachversand per Admin-Aktion/Command klappt, danach confirmation_sent_at gesetzt. Bei OfferMade-Fehler: Angebot bleibt, Hinweis im Admin, Nachversand möglich
7 Fehlgeschlagene Kalender-Synchronisierung CreateChannelTasks/Webhook wirft Exception, Kanal mit requires_manual_blocking Annahme erfolgreich (kein 500); ChannelTask mit automation_error bzw. Postfachmeldung; iCal-Feed enthält die Sperre trotzdem; Erinnerungs-/Monitorlauf meldet die offene Aufgabe
8 Gespeicherte Nachweise Datenbank/Dateien nach Testlauf 1 prüfen acceptance enthält Version, Zeitpunkte, Gesamtbetrag, offer_hash, Texte-Hash, Beschriftungen; Hash stimmt mit nachgerechnetem Wert überein; Angebots-PDF (v), finales PDF und Snapshot sind identisch im Inhalt der Bedingungen; keine IP-Adresse, kein Token gespeichert
9 Keine Zustandsänderung per GET wiederholt GET (auch mit Prefetch-User-Agent) Status/accepted_at unverändert
10 Signatur manipulierte Signatur, fremde Booking-ID, falsche Version 403 bzw. offerOutdated; keine Datenausgabe
11 Log-Hygiene Laravel-Log nach Fehlerfällen durchsuchen keine signierten URLs, keine Tokens, keine E-Mail-Adressen/Namen
12 Regression komplette bestehende Suite, vendor/bin/pint --dirty grün; Verhalten mit auto_offer = false unverändert

Staging-Durchlauf (nach Freigabe): einmal komplett mit echter Zustellung an die Testadresse (SPF/DKIM unauffällig), PDFs öffnen, Sperre im Portal-Feed prüfen. Bei der Parallelitätsprüfung unbedingt MariaDB verwenden (SQLite verhält sich bei Sperren anders).


8. Kritische rechtlich-technische Fragen (Entscheidung beim Betreiber / Rechtsberatung)

  1. Button-Wortlaut („Zahlungspflichtig buchen“): Die Vorgabe fordert diesen Wortlaut; aktuell ist der Default „Angebot zahlungspflichtig annehmen“ (CMS-Feld offer.accept_button). Änderung ist reine CMS-Sache des Betreibers. Ist die Formulierung bei Vermietung (kein Verbrauchervertrag über Online-Kauf im engeren Sinn?) einschlägig und ausreichend?
  2. Widerrufsrecht: Für Beherbergung zu bestimmten Terminen gilt regelmäßig eine Ausnahme vom Widerrufsrecht – ist das hier so einzuordnen und muss das vor Annahme angezeigt werden? Das System kann es technisch anzeigen, entscheidet es aber nicht.
  3. Vorvertragliche Informationen / AGB: Müssen Mietbedingungen, Storno, Datenschutz und Widerrufsinformation als Link und als Anhang (dauerhafter Datenträger) vorliegen? Aktuell: Bedingungen auf der Seite + Vertrags-PDF in der Mail. Die Texte contract.terms sind noch [MUSTER].
  4. Bestätigung der Zahlungspflicht vs. Kenntnisnahme: Die aktuelle Checkbox lautet „Ich habe … gelesen“; der Button löst die Verpflichtung aus. Ist zusätzlich eine eigene Checkbox „Ich akzeptiere die Bedingungen“ gewünscht?
  5. Beweis der Annahme ohne IP-Adresse: Es wird bewusst keine IP gespeichert (Datensparsamkeit). Reicht „Zeit + Version + Hashes + Gesamtbetrag“ als Nachweis, oder wird zusätzlich ein gekürzter IP-Hash/User-Agent gewünscht? (DSGVO-Abwägung.)
  6. Personenbezogene Daten in Logs/Fehlermeldungen: Mailer-Exceptions können Adressen enthalten. Vorschlag: eigenes Exception-Masking im report()-Pfad. Aufbewahrung von Annahmenachweisen und Verträgen ist im Löschkonzept (docs/LOESCHKONZEPT.md) noch als offene Lücke vermerkt – Frist festlegen.
  7. Verbindliche Buchung ohne manuelle Prüfung: Auto-Angebot und sofortige Annahme verzichten auf menschliche Prüfung (KONZEPT §6a sah „manuell, später KI-Entwurf mit Freigabe“ vor). Bewusste Entscheidung bestätigen; Portalrisiko (Doppelbuchung durch Verzögerung beim iCal-Abgleich, KONZEPT §7/§7a) bleibt. Vorschlag: Auto-Angebot nur für Zeiträume, die weiter als X Tage entfernt sind, und/oder Sperre der Portale mit Sofortbuchung per Aufgabe.
  8. Reservierung als Zusage? Die Haltezeit blockiert den Kalender auch für andere Gäste und Portale (wegen occupying()); bei Auto-Angeboten kann Missbrauch (Blockieren fremder Termine) leichter werden – bestehende Limits (max. 2 offene Anfragen je E-Mail, Rate-Limits) greifen, ggf. E-Mail-Verifikation erwägen.
  9. Zahlungsfristen: Anzahlung wird erst mit Annahme fällig (deposit_due_days). Rechtlich festlegen, was bei Nichtzahlung passiert (Rücktritt/Storno) – aktuell nur Erinnerungen (SendBookingReminders), keine automatische Storno.

9. Vorschlag: kleine, rückwärtskompatible Implementierung (nach Freigabe)

Reihenfolge (jeweils eigenständig lauffähig, Standardverhalten unverändert):

  1. Schritt 1 – Sicherheitskern (ohne Funktionsänderung für Betreiber): Migration (nur offer_terms, offer_hash, confirmation_*), Snapshot in SendOffer, atomare/idempotente AcceptOffer mit Sperren, Hash-Prüfung, Fehlerisolierung für Mail und Observer. Tests 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 (+ dump() entfernen).
  2. Schritt 2 – Nachsende-Funktion: Admin-Aktion „Bestätigung erneut senden“ plus Command; Postfach-Einträge. Test 6 erweitern.
  3. Schritt 3 – Auto-Angebot: auto_offer je Wohnung (Default aus), AutoOffer-Aufruf nach CreateReservation; Staging einschalten, produktiv erst nach Freigabe. Test 1 + 12.
  4. Schritt 4 – Gast-Fehlerseiten 403/419 deutsch (mit MVP-Gate #6 gemeinsam).
  5. Schritt 5 – Staging-Durchlauf gemäß Abschnitt 7 mit Protokoll in docs/STATUS.md.

Umfang grob: 1 Migration, ~5 geänderte Dateien (SendOffer, AcceptOffer, ConfirmBooking, OfferController, BookingObserver), 1 neue Action, 2 Views (Angebotsseite, Fehlerseiten), 1 Command, Tests; keine neuen Abhängigkeiten, kein neuer Basisordner.

Rollback: auto_offer ausschalten stellt das bisherige Verhalten sofort wieder her; die Migration ist additiv und reversibel.

Nicht Teil dieses Vorschlags: Online-Zahlung, Kundenkonto, KI, Änderung von Preis-/Tenancy-/Kanalarchitektur, CMS-Inhalte (Bedingungen, Button-Text), Produktions-Deployment.


10. Freigabe

Bitte bestätigen, bevor Phase 2 beginnt:

  • Umfang Schritt 1–2 (Sicherheitskern + Nachversand) in der Entwicklungsumgebung
  • Schritt 3 (Auto-Angebot) ja/nein, und ob zunächst nur auf Staging
  • Antworten bzw. Zuständigkeiten zu den Fragen 1–9
  • Migration in Entwicklung/Staging ausführen (nicht in Produktion)

Bis dahin: keine Änderungen an Code, Datenbank, CMS oder Servern.