Deploy FeWo mit PipelineManager / deploy (push) Failing after 3m38s
- 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>
82 lines
10 KiB
Markdown
82 lines
10 KiB
Markdown
# 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.
|