- 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>
10 KiB
BOOKING-E2E-ACCEPTANCE
Stand: 30.10.2026 · Branch feature/buchung-e2e · Umgebung: lokale Entwicklung, PHP 8.4, SQLite, Mails/HTTP gefaket.
Ergebnis in Kürze
- Vollsuite: 561 Tests, 561 bestanden (
php artisan test, 30.10.2026, 4. Lauf). Davon neu: 14 + 3 inBookingAcceptanceTest(17), 12 inAutoOfferTest; 1 bestehender Test bereinigt (dump()).vendor/bin/pint --dirty: sauber. - Hinweis zur Stabilität: In zwei früheren Läufen schlugen
WebsiteTenancyTest(Status 301) undPrivacyHardeningTest(Datei im Test-Datenträger fehlt) fehl. Diese Läufe liefen zeitgleich mit einem zweiten Testlauf bzw. nach einer Fehlkonfiguration meinerseits (fehlenderuse-Import, inzwischen behoben); im sauberen Einzellauf bestehen sie. Eine Ursachenklärung fürWebsiteTenancyTest(301 beim Parallellauf) habe ich nicht durchgeführt. - NICHT durchgeführt (BLOCKED): MariaDB-Parallelitätstests, Browser-E2E, Zustellung echter Test-Mails, Sichtprüfung der PDFs, Staging-Durchlauf. Gründe unten.
- Empfehlung: NO-GO für Staging-Freigabe/Aktivierung echter Buchungen, solange die BLOCKED-Punkte offen sind. Technisch kein bekannter Fehler im Code; die Lücke ist fehlender praktischer Nachweis.
Blockierte Nachweise (Warum)
| Nachweis | Status | Grund / nötige Entscheidung |
|---|---|---|
| Echte Parallelität auf MariaDB | BLOCKED | Lokal ist kein MariaDB vorhanden. Ich habe ein portables MariaDB (ZIP von archive.mariadb.org) in das Scratch-Verzeichnis geladen, den Start der heruntergeladenen Binärdatei verweigerte das Berechtigungssystem („Code from External“). Ich habe das nicht umgangen. Optionen: MariaDB/Docker selbst bereitstellen und DB_CONNECTION=mariadb für einen Testlauf freigeben, oder die Tests gegen die Staging-DB laufen lassen (Freigabe nötig). Der Schutz beruht auf SELECT … FOR UPDATE (Wohnung + Buchung); unter SQLite ist lockForUpdate wirkungslos, die Tests belegen daher die Logik (frisches Neuladen unter Sperre, Idempotenz mit veralteter Modellkopie), nicht das Sperrverhalten der Datenbank. |
| Browser-E2E, Tastatur/Screenreader | BLOCKED | nicht ausgeführt |
| Echte Mailzustellung (SPF/DKIM, Anhang öffnen) | BLOCKED | Staging läuft mit MAIL_MAILER=log (MVP-TECHNICAL-GATE #3); Staging-Deployment ohne gesonderte Freigabe nicht erlaubt |
| PDF-Sichtprüfung | BLOCKED | PDFs werden in Tests nur auf Existenz und Snapshot-Quelle geprüft, nicht visuell |
| Staging-Durchlauf mit Mail-Umleitung | BLOCKED | Deployment/Migration auf Staging nicht freigegeben |
Testfälle (Auftrag §13)
Legende: PASS = automatisiert ausgeführt und bestanden · PARTIAL = Logik getestet, Praxisnachweis offen · BLOCKED = nicht ausgeführt · EXISTING = durch bereits vorhandenen, bestehenden Test abgedeckt (in der Vollsuite grün).
| # | Fall | Ergebnis | Nachweis (Test) |
|---|---|---|---|
| 1 | Manuelle Anfrage ohne Vorreservierung | PASS | AutoOfferTest::test_without_pre_reservation_a_request_blocks_nothing (keine Sperre, Mailtext „noch nicht reserviert“, zweite Anfrage derselben Zeit möglich) |
| 2 | Manuelle Anfrage mit Vorreservierung | PASS | test_manual_mode_sends_the_receipt_and_no_offer |
| 3 | Automatisches Angebot mit Vorreservierung | PASS | test_automatic_mode_sends_the_offer_instead_of_the_receipt, …_can_be_accepted_end_to_end |
| 4 | Auto ohne Vorreservierung | PASS | test_automatic_mode_without_pre_reservation_falls_back_to_manual_and_says_why (Grund in Notiz + Betreiber-Mail); Formular lehnt die Kombination ab (Regel in PropertyForm, nicht per Test geprüft) |
| 5 | Angebot aufrufen und annehmen | PASS (HTTP) / BLOCKED (Mail-Client) | test_accepting_twice_over_http_…, OfferWorkflowTest |
| 6 | Bestätigung + PDF | PARTIAL | Mail mit Vertrag gesendet, Datei vorhanden (test_acceptance_records_the_evidence_and_confirms_once); Inhalt nicht visuell geprüft |
| 7 | Kalender und iCal-Ausgabe | PARTIAL | Belegung/occupying() geprüft; Feed-Inhalt nach Annahme nicht eigens neu getestet (Feed wird live aus DB gebaut; ChannelExportRequestTest EXISTING) |
| 8 | Abgelaufene Haltefrist | PASS | test_expired_offer_cannot_be_accepted; OfferWorkflowTest::test_offer_holds_the_dates_until_it_expires |
| 9 | Annahme kurz vor Fristablauf | PARTIAL | Frist wird in der Transaktion gegen die gesperrte Zeile geprüft; Randfall (Sekunden vor Ablauf) nicht eigens getestet. Bekannte Lücke: signierte POST-URL läuft mit der Frist ab → 403 mit neuer deutscher Seite statt Angebots-Hinweis |
| 10 | Doppelte Annahme | PASS | test_second_acceptance_…_idempotent, test_stale_copy_…, test_accepting_twice_over_http_… (1× Bestätigung, 1× Betreiber-Mail) |
| 11 | Gleichzeitige Annahmen | BLOCKED (MariaDB) | nur Logik (Fall 10) belegt |
| 12 | Zwei konkurrierende Buchungen | PARTIAL | test_two_overlapping_stays_cannot_both_become_binding (sequenziell); echte Parallelität BLOCKED |
| 13 | Konflikt durch externen Kalendereintrag | PASS | test_conflicting_occupation_prevents_acceptance_and_leaves_no_evidence |
| 14 | Änderung von Preis/Bedingungen nach Versand | PASS | test_changed_website_texts_do_not_alter…, test_tampered_offer_is_refused…, test_changed_terms_snapshot_is_refused |
| 15 | Erfolgreicher Import | EXISTING | ChannelSyncTest |
| 16 | Fehlgeschlagener Import | PASS | test_stale_calendar_import_blocks_the_automatic_offer (HTTP 500 gefaket → Kanal bleibt veraltet), test_acceptance_is_refused_while_a_portal_calendar_is_stale |
| 17 | Sofortbuchungsportal vor Abruf | PASS | test_instant_booking_portal_holds_the_offer_back_until_it_fetched_our_feed |
| 18 | Sofortbuchungsportal nach nachgewiesenem Abruf | PASS | derselbe Test (Angebot nach Abruf per bookings:auto-offers); Abruf als Datensatz erzeugt, nicht über den echten Feed-Endpunkt |
| 19 | Kanal ohne Sofortbuchung | PASS | test_portal_without_instant_booking_needs_no_proof |
| 20 | Nicht zuordenbarer Abruf | PASS | test_unattributable_feed_request_is_not_recorded_as_proof, test_feed_fetch_before_the_block_or_failed_fetch_or_other_channel_is_no_proof |
| 21 | Sync-Fehler nach bestätigter Buchung | PASS | test_failing_portal_task_creation_does_not_fail_the_acceptance |
| 22 | Anfrage über Portal-Mail | EXISTING | PortalMailTest (nicht Teil dieser Änderung) |
| 23 | Portal-Mail unvollständig | EXISTING | PortalMailTest::…without_readable_dates… |
| 24 | iCal ohne Gastdaten | EXISTING | ChannelOccupationResolutionTest, ChannelSyncTest |
| 25 | Bereits verbindliche Portalbuchung | EXISTING | PortalMailTest::test_booking_mail_blocks_immediately… (Sperre, kein Annahmeprozess) |
| 26 | Doppelt eintreffende Infos | EXISTING | ChannelOccupationResolutionTest (UID-/Alias-Fälle) |
| 27 | Mailfehler bei Angebot | PASS | test_failing_offer_mail_is_reported_but_the_offer_stays |
| 28 | Mailfehler bei Bestätigung | PASS | test_failing_confirmation_mail_keeps_the_binding_booking_and_can_be_resent (keine Adresse im Postfachtext) |
| 29 | Wiederholter Nachversand | PASS | gleicher Test + test_command_retries_failed_confirmations_once_the_mail_server_is_back (genau 1 Zustellung) |
| 30 | Abgelaufener/manipulierter Link | PASS | test_invalid_signature_shows_the_german_error_page, OfferWorkflowTest::test_offer_page_needs_a_valid_signature, …older_offer_version… |
| 31 | Fehlerhafte Session / 419 | PARTIAL | deutsche 419-Seite angelegt; kein Test, der ein 419 auslöst |
| 32 | Regression bei deaktivierter Automatik | PASS | Standard manual; gesamte bestehende Suite grün (561/561) |
| – | GET löst nichts aus | PASS | test_get_on_the_offer_link_never_changes_the_booking |
| – | Testbetrieb/Mail-Umleitung unverändert | EXISTING | bestehende Tests (MailRoutingTest u. a.) grün; Code in Settings nicht angefasst |
| – | Live: Muster-Texte blockieren Auto-Angebot | PASS | test_live_operation_needs_released_contract_texts_for_automatic_offers |
Kontrolle nach Tests (§13 Abnahmekriterien) – was geprüft wurde
Datenbankstatus, Annahmenachweis (Felder, Hash), gespeicherte Angebotsversion und Snapshot, Postfacheinträge, gesendete Mailklassen und Anzahl: per Assertion in den Tests. Belegungskalender: occupying()/Verfügbarkeitsprüfung. Nicht geprüft: ausgehende iCal-Feeds nach Annahme (kein eigener Test), tatsächliche E-Mail-Inhalte außer den genannten Textstellen, PDF-Inhalt, Admin-Ansicht (Infolist/Aktion „Bestätigung erneut senden“ sind nur durch die Seitenaufrufe der bestehenden Suite „gerendert“, die neue Aktion selbst hat keinen Test), Monitoring.
Bekannte Fehler und Einschränkungen
- Neue Admin-Aktion und die Property-Formulargültigkeit (auto + ohne Vorreservierung) sind ungetestet.
- Keine Tests für 419 und die Annahme in der letzten Sekunde.
- Echte Datenbanksperren unbelegt (siehe oben) – wichtigster offener Punkt.
- Migrationen wurden nur in der SQLite-Testdatenbank ausgeführt; nicht gegen MariaDB (Syntax ist Standard
json/string/boolean/timestamp, aber ungeprüft). - Das Verhalten „Annahme verlangt aktuellen Import“ gilt für alle Wohnungen mit aktivem Import (nicht nur Automatik) und kann Annahmen bei gestörtem Portalimport verhindern (gewollt, siehe Implementation §Restrisiken).
- Ursache der früheren Einzelfehler in
WebsiteTenancyTestnicht geklärt (siehe oben).
Status produktive Einsatzfähigkeit
Code und automatisierte Tests: bereit zur Überprüfung (Review). Nicht einsatzbereit für echte Gäste, solange offen: MariaDB-Parallelitätsnachweis, Staging-Durchlauf mit echter Mailzustellung und PDF-Sichtprüfung, Produktivumgebung (MVP-TECHNICAL-GATE #1–#4), freigegebene Vertragstexte, separate Compliance-Prüfung.
GO / NO-GO
NO-GO für Aktivierung automatischer oder verbindlicher Online-Buchungen mit echten Gästen. GO für: Code-Review, Merge in einen Feature-Branch, anschließend MariaDB-Test und Staging-Migration nach ausdrücklicher Freigabe.
Nächste Schritte (Reihenfolge)
- Entscheidung, wie MariaDB für den Parallelitätstest bereitgestellt wird (lokal selbst installiert oder Docker; oder Test gegen Staging-DB).
- Dann: zwei-Prozess-Test (gleichzeitige Annahme, konkurrierende Buchung) und Migrationen auf MariaDB.
- Freigabe für Staging-Migration + Deployment → Durchlauf mit Mail-Umleitung, PDF- und Feed-Prüfung.