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

10 KiB
Raw Blame History

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 in BookingAcceptanceTest (17), 12 in AutoOfferTest; 1 bestehender Test bereinigt (dump()). vendor/bin/pint --dirty: sauber.
  • Hinweis zur Stabilität: In zwei früheren Läufen schlugen WebsiteTenancyTest (Status 301) und PrivacyHardeningTest (Datei im Test-Datenträger fehlt) fehl. Diese Läufe liefen zeitgleich mit einem zweiten Testlauf bzw. nach einer Fehlkonfiguration meinerseits (fehlender use-Import, inzwischen behoben); im sauberen Einzellauf bestehen sie. Eine Ursachenklärung für WebsiteTenancyTest (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

  1. Neue Admin-Aktion und die Property-Formulargültigkeit (auto + ohne Vorreservierung) sind ungetestet.
  2. Keine Tests für 419 und die Annahme in der letzten Sekunde.
  3. Echte Datenbanksperren unbelegt (siehe oben) – wichtigster offener Punkt.
  4. Migrationen wurden nur in der SQLite-Testdatenbank ausgeführt; nicht gegen MariaDB (Syntax ist Standard json/string/boolean/timestamp, aber ungeprüft).
  5. 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).
  6. Ursache der früheren Einzelfehler in WebsiteTenancyTest nicht 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)

  1. Entscheidung, wie MariaDB für den Parallelitätstest bereitgestellt wird (lokal selbst installiert oder Docker; oder Test gegen Staging-DB).
  2. Dann: zwei-Prozess-Test (gleichzeitige Annahme, konkurrierende Buchung) und Migrationen auf MariaDB.
  3. Freigabe für Staging-Migration + Deployment → Durchlauf mit Mail-Umleitung, PDF- und Feed-Prüfung.