- 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>
24 KiB
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 rufenConfirmBookingmit veraltetem In-Memory-StatusOfferSentauf → doppelteBookingConfirmed-Mail und doppelteOfferAnswered-Mail sind möglich;confirmed_atunddeposit_due_onwerden überschrieben. - Wird
ConfirmBookingmitnotAvailableabgewiesen, bleibenaccepted_atundacceptancebereits gesetzt, während der StatusOfferSentbleibt (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)
CreateReservationsperrt die Property-Zeile (lockForUpdate),ConfirmBookingundSendOffernicht. Unter MariaDB/InnoDB (REPEATABLE READ) istexists()ein nicht sperrender Lesezugriff. Für überlappende Buchungen reicht die Sperre inCreateReservationnur, 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 überConfirmBookingbestätigt (Expired ist dort erlaubt, Prüfung läuft ohne Sperre). Für die Gast-Annahme ist das durchensureAcceptable(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 vonConflictDetector/ReportChannelConflictsgemeldet (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. AcceptOfferberechnetterms_sha256beim 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).ConfirmBookingerzeugt das finale Vertrags-PDF neu aus aktuellen Texten; es kann vom Angebots-PDF abweichen.quote_sha256wird ebenfalls erst bei Annahme gebildet; eine Änderung vonquote/totalzwischen Versand und Annahme (z. B. durch Admin-Bearbeitung) würde mitgehasht statt erkannt.
D – Fehlerbehandlung bei Mail (AcceptOffer, ConfirmBooking, SendOffer, OfferController::answer)
ConfirmBookingsendetBookingConfirmedungeschützt nach dem Commit. Wirft der Mailversand (SMTP down), ist die Buchung bereitsConfirmed, der Controller fängt nurReservationException→ Gast sieht eine 500-Seite und glaubt, nichts sei passiert. Er klickt erneut → Fehlermeldung „Status Bestätigt“ (B1). Die Betreiber-MailOfferAnsweredwird in diesem Fall nicht mehr gesendet (Exception unterbrichtAcceptOffer).- Es gibt keine Nachversand-Möglichkeit/-Markierung: kein Feld „Bestätigung gesendet am“, kein Eintrag im Postfach (
AppSupportInbox) für fehlgeschlagene Gästemails.CreateReservationfängt dagegen korrekt ab (report($exception)), ist aber ebenfalls nur im Log sichtbar. SendOffer: wirft der Versand, ist der Status schonOfferSent(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 derChannelTask) würden nach dem Commit nach oben durchschlagen → Gast bekäme 500, obwohl Buchung steht. Mail und Webhook darin sind einzeln mitrescue/tryabgesichert, die Aufgabenanlage selbst nicht. - Fehlgeschlagene Webhooks landen in
ChannelTask.automation_errorund 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(Testtest_guest_accepts_the_offer_and_the_booking_becomes_binding) enthält am Ende eindump(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_atab; 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 dessigned-Middleware (englische Standardseite!), nicht überofferExpired(). 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
- Auto-Angebot (A): Neue Action
App\Actions\AutoOffer(oder Option inCreateReservation), die nach erfolgreicher ReservierungSendOffer->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 wiehold_hourshaben (48 h, je Wohnung einstellbar). - Angebots-Snapshot (C): In
SendOfferbeim 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). - Atomare, idempotente Annahme (B1/B2):
AcceptOffer::handlekomplett inDB::transaction: Property-ZeilelockForUpdate, Buchung frisch mitlockForUpdateladen, 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.ConfirmBookingbekommt dieselbe Property-Sperre. Mails erst nach Commit. - Nachweis (C):
acceptanceumoffer_hash(Hash über Quote + Snapshot bei Versand),offer_sent_at,valid_until,button_label,checkbox_label,user_agent_hash-optional ergänzen. Bei Annahme: gespeichertenoffer_hashmit dem aktuellen vergleichen; Abweichung → Annahme abweisen („Angebot wurde geändert“) und Admin-Postfachmeldung. - Fehlerisolierung (D/E): Gast-Mails und Betreiber-Mails in
AcceptOffereinzeln intry/catch; bei Fehler Eintrag inAppSupportInbox(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 inrescue()kapseln, Fehler → Postfach. - Nachversand: Admin-Aktion „Bestätigung erneut senden“ (Buchungsseite) und Cron-Fallback
bookings:resend-confirmations, der Bestätigungen mit gesetztemconfirmation_failed_aterneut versucht. - Gast-Fehlerseiten: Deutsche 403/419-Seiten für den Annahmeweg mit Rücksprung auf die Angebotsseite (bündelt sich mit MVP-Gate #6).
- Bereinigung:
dump()ausOfferWorkflowTestentfernen.
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)
- 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? - 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.
- 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.termssind noch [MUSTER]. - 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?
- 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.)
- 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. - 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.
- 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. - 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):
- Schritt 1 – Sicherheitskern (ohne Funktionsänderung für Betreiber): Migration (nur
offer_terms,offer_hash,confirmation_*), Snapshot inSendOffer, atomare/idempotenteAcceptOffermit Sperren, Hash-Prüfung, Fehlerisolierung für Mail und Observer. Tests 2, 3, 4, 5, 6, 7, 8, 9, 10, 11 (+dump()entfernen). - Schritt 2 – Nachsende-Funktion: Admin-Aktion „Bestätigung erneut senden“ plus Command; Postfach-Einträge. Test 6 erweitern.
- Schritt 3 – Auto-Angebot:
auto_offerje Wohnung (Default aus),AutoOffer-Aufruf nachCreateReservation; Staging einschalten, produktiv erst nach Freigabe. Test 1 + 12. - Schritt 4 – Gast-Fehlerseiten 403/419 deutsch (mit MVP-Gate #6 gemeinsam).
- 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.