Files
fewo-stommer/BOOKING-E2E-READINESS.md
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

195 lines
24 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 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.**