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>
9.0 KiB
9.0 KiB
BOOKING-COMPLIANCE-HANDOVER
Technische Fakten für die nachgelagerte Compliance-Prüfung. Keine rechtlichen Bewertungen, keine Änderung von CMS-Rechtstexten. Stand: 30.10.2026, Entwicklungsstand Branch feature/buchung-e2e (nicht deployt). Details: BOOKING-E2E-IMPLEMENTATION.md.
1. Tatsächlicher Ablauf des Vertragsschlusses (Direktbuchung)
- Gast sendet das Anfrageformular (
/buchen, Livewire; Bot-Schutz: Honeypot, Zeitsperre, Rate-Limits). Eingabe: Name, E-Mail, optional Telefon/Adresse, Nachricht, Zeitraum, Personen, optional Rabattcode, Einwilligungs-Checkbox Datenschutz, optional Newsletter-Opt-in. - System prüft Verfügbarkeit und berechnet den Preis (
PriceCalculator). Je Wohnung: Vorreservierung an (Kalender wird bis zum Ablauf der Haltefrist gesperrt) oder aus (keine Sperre). - Manueller Modus (Standard): Eingangsbestätigung an den Gast (unverbindlich, ggf. mit Ablaufzeit der Vormerkung), Mitteilung an den Betreiber; Betreiber erstellt/sendet das Angebot im Admin. Automatischer Modus: Angebot geht sofort an den Gast, wenn alle Prüfungen bestanden sind (Details Implementation §Phase 3); sonst Rückfall auf manuell.
- Angebot (Version n): E-Mail mit Preisaufstellung und PDF-Entwurf (Angebot/Mietvertrag) im Anhang und einem signierten, befristeten Link (
/angebot/{id}?v=n, Ablauf = Angebotsfrist). - Der Link öffnet die Angebotsseite (GET, ändert nichts). Sie zeigt Zeitraum, Preiszeilen, Zahlungsplan, Mietbedingungen, Stornobedingungen, „Gültig bis“, Hinweistext (
offer.accept_note), Checkbox „Ich habe die Angaben und Bedingungen dieses Angebots gelesen“ und die Schaltfläche (Beschriftungoffer.accept_button, CMS; Standardtext aktuell „Angebot zahlungspflichtig annehmen“). Daneben „Angebot ablehnen“. - Annahme = POST auf eine signierte URL (CSRF-geschützt, Rate-Limit 10/min). Eine Transaktion prüft Version, Status, Frist, Prüfsumme des Angebots, Verfügbarkeit (und vorher Aktualität der Portalkalender), schreibt den Nachweis und setzt die Buchung auf
Confirmed. - Danach: Vertrags-PDF (final) wird erzeugt; Bestätigungs-E-Mail mit PDF geht an den Gast; Betreiber erhält eine Annahme-Mail. Fristen: Anzahlung = Annahmetag +
deposit_due_days(Standard 7), Rest zum vereinbarten Termin. - Der Kalender ist sofort belegt (iCal-Ausgangsfeed wird bei jedem Abruf live berechnet); für Portale mit manueller Sperre entstehen Aufgaben (+ optionaler Webhook).
2. Angebots- und Annahmenachweise (Datenbank bookings)
| Feld | Inhalt |
|---|---|
offer_version, offer_sent_at, hold_expires_at |
Version, Versandzeit, Gültigkeit (nach Annahme null) |
quote, total, deposit, balance_due_on |
Preis und Zahlungsplan der Version |
offer_terms (JSON) |
eingefrorene Texte: Mietbedingungen, Storno, Hausordnung, Vertragseinleitung/-schluss, Vertragshinweis, Annahmehinweis, Button-Beschriftung; Anzahlungsfrist; Vermieter- und Bankdaten; captured_at |
offer_hash |
SHA-256 über Version, Termine, Personen, Quote, Beträge, Zahlungstermin, Snapshot |
acceptance (JSON), accepted_at |
Version, Zeitpunkt, Gültigkeit, Gesamtbetrag, offer_hash, quote_sha256, terms_sha256 (Hash der angezeigten Texte), Button-Text, via=offer_link |
confirmed_at, deposit_due_on, contract_path, offer_path |
Bestätigungszeit, Fälligkeit, Pfade der PDFs |
confirmation_sent_at, confirmation_failed_at |
Zustellstatus der Bestätigungsmail (nur Versand an den Mailserver, kein Lesenachweis) |
| Es wird keine IP-Adresse, kein User-Agent und kein Token im Nachweis gespeichert. Der Nachweis zeigt „diese Angebotsversion mit diesem Inhalt wurde über den signierten Link angenommen“; er identifiziert den Handelnden nur über den Besitz des Links. | |
| Nach Versand geänderte CMS-Texte wirken nicht auf bestehende Angebote (Snapshot). Eine Änderung der gespeicherten Angebotsdaten verhindert die Annahme (Hash-Prüfung, Postfachmeldung). |
3. Technische Darstellung der Vertragsinformationen
- Angebotsseite (HTML) und PDF (Angebot/Entwurf → final) werden aus demselben Snapshot gerendert. PDFs liegen als Dateien (nicht neu gerendert beim Abruf); „Mietvertrag neu erzeugen“ im Admin nutzt den Snapshot.
- Das Angebots-PDF hängt an der Angebotsmail (dauerhaft speicherbar); das finale Vertrags-PDF an der Bestätigungsmail. Auf der Angebotsseite selbst gibt es keinen PDF-Download-Link (Hinweis auf den Anhang).
- Hausordnung steht im PDF, nicht auf der Angebotsseite. Die Texte sind noch Mustertexte im CMS (
[MUSTER …]); im Livebetrieb werden automatische Angebote nur bei freigegebenen (nicht-Muster) Texten und gefüllter IBAN gesendet. - Zahlungspflicht-Hinweis und Button-Beschriftung sind CMS-Felder (
offer.accept_note,offer.accept_button).
4. Speicherorte und Aufbewahrung
- PDFs:
storage/app/private/contracts/tenants/{tenant}/bookings/{booking}/(nicht per Web erreichbar). Buchungsdaten/Nachweise: Datenbank, Tabellebookings; Gäste:guests. - Löschung/Anonymisierung (
guests:anonymize, täglich): nie bestätigte Anfragen nach 6 Monaten (FEWO_RETENTION_INQUIRY_MONTHS); Gästedaten bestätigter Buchungen 10 Jahre (FEWO_GUEST_RETENTION_YEARS) – Vorschlagswerte lautdocs/LOESCHKONZEPT.md. Vertragsdokumente haben dort noch keine Löschfrist (als Lücke vermerkt).internal_notes/acceptancewerden nicht gesondert gelöscht. - Datenbank-Backup täglich (
backup:database, 14 Dateien), enthält Gäste- und Buchungsdaten. - Logs: bei Mail-/Sync-/Auto-Angebot-Fehlern nur Meldungstext, Exception-Klasse und Buchungs-ID, keine Adressen, Links oder Tokens (Laufzeit: Laravel-Log, Kanal
daily, 14 Tage).
5. Automatisch versendete Nachrichtentypen
| Klasse | Empfänger | Auslöser |
|---|---|---|
ReservationReceived |
Gast | Anfrage (nicht bei erfolgreichem Auto-Angebot) |
NewReservation |
Betreiber | Anfrage (inkl. Hinweis „Angebot automatisch versendet“ bzw. Gründe) |
OfferMade |
Gast | Angebot (manuell/automatisch) |
OfferAnswered |
Betreiber | Annahme/Ablehnung durch den Gast |
BookingConfirmed (+ Vertrag-PDF) |
Gast | Annahme / direkte Bestätigung; Nachversand durch Admin/Befehl |
BookingDeclined, ReservationExpired |
Gast / Betreiber | Ablehnung durch Betreiber / Ablauf |
PaymentReminder, ArrivalInformation, ReviewRequest |
Gast | Fristen (bestehend, unverändert) |
MarketingConsentRequest |
Gast | nur bei Newsletter-Opt-in (bestehend) |
| Digest/Kanal-/Postfach-Meldungen | Betreiber | bestehend |
Im Testbetrieb gehen alle Mails ausschließlich an die Testadresse (App\Support\Settings, unverändert). |
6. Technische Stornierungs-/Kündigungsmöglichkeiten
- Gast: Angebot ablehnen (Angebotsseite, bis zur Annahme). Eine Stornierung/Kündigung nach Annahme ist im Gastbereich nicht vorgesehen (kein Kundenkonto, kein Stornolink); sie läuft über Kontakt (Telefon/E-Mail).
- Betreiber: Aktionen Ablehnen, Stornieren (setzt
Cancelled, gibt den Kalender frei), Vormerkung verlängern. Eine automatische Berechnung von Stornokosten gibt es nicht; die Stornobedingungen sind reiner CMS-Text im Snapshot. - Es gibt keine automatische Stornierung bei Nichtzahlung (nur Zahlungserinnerungen).
7. Externe Datenquellen und Empfänger
- Eingehend: iCal-Feeds der Portale (nur Zeiträume, ggf. Titel/Beschreibungstexte), Portal-Benachrichtigungs-Mails aus dem Betreiber-Postfach (IMAP) – können Gästedaten enthalten (Aufbewahrung 90 Tage laut Löschkonzept).
- Ausgehend: iCal-Feeds je Portal (nur Belegungen, ohne Gästedaten, Zugriff über zufälligen Token pro Kanal); optional signierter Webhook an die Betreiber-Automation (n8n) mit Aufgabendaten (Zeitraum, Kanal); Mailserver (Strato SMTP).
- Aufgezeichnet: Abrufe der Export-Feeds je Kanal (Zeit, Methode, User-Agent, Status) in
channel_export_requests. - Keine externen Dienste im Buchungsweg (kein Captcha, keine Zahlungs-/Tracking-Dienste).
8. Cookies / Technologien (neu betroffen)
Keine neuen Cookies oder Browser-Speicher. Die Angebotsseite nutzt die bestehende Laravel-Sitzung und das XSRF-Cookie (CSRF-Schutz des Annahmeformulars). Neue deutsche Fehlerseiten (403/404/419/429/500/503) laden keine externen Ressourcen.
Die Angebotsseite ist noindex; Links stehen in Zugriffsprotokollen des Webservers (signierte URL) – Aufbewahrung dort liegt bei Strato.
9. Bekannte technische Einschränkungen, die für die Prüfung relevant sind
- Der Nachweis enthält keine IP/Geräteangabe (Entscheidung offen, siehe READINESS Frage 5).
- Standard-Buttontext enthält „zahlungspflichtig annehmen“, nicht wörtlich „Zahlungspflichtig buchen“ (CMS, Betreiber).
- Bestätigungsseite nach Annahme (Erfolgsmeldung) und Bestätigungs-E-Mail sind die einzigen unverzüglichen Bestätigungen; Zustellung der Mail kann scheitern (Statusfeld, Nachversand).
- Widerrufsinformationen, AGB-Link, Datenschutzlink auf der Angebotsseite sind nicht automatisch eingebaut (nur CMS-Texte
contract.terms/stay.cancellation); der Datenschutzlink am Anfrageformular ist laut MVP-TECHNICAL-GATE Blocker #2 offen.