Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
16 KiB
Übergabe: Buchungsprozess (Stand 30.10.2026)
Für die nächste Session. Zuerst lesen, dann nichts bauen, bevor der Betreiber das Konzept in §5 bestätigt hat.
Dieses Dokument ersetzt kein Konzept, es hält fest: was der Betreiber verlangt (§2), was gebaut wurde (§3), was daran falsch ist (§4), wie es weitergehen sollte (§5), und wie man hier arbeitet (§6). Ältere Ergebnisdokumente liegen im Projektstamm (BOOKING-E2E-*.md, BOOKING-COMPLIANCE-HANDOVER.md); sie decken nur die erste Umsetzungsphase ab.
1. Warum diese Übergabe
Die letzten drei Ausbaustufen (Portal-Direktbuchung erfassen, Akte aus dem Portalkalender, Menü) wurden neben dem vorhandenen Angebotsablauf gebaut statt darauf aufzusetzen. Ergebnis: für Buchungen aus externen Portalen gibt es eigene Formulare und Aktionen, die weniger können als der Ablauf für die eigene Webseite, und mehrere Schritte, die der Betreiber nicht versteht. Die Fehlerliste steht in §4. Der Betreiber hat die Fehleinschätzung klar benannt; sie lag bei der Umsetzung, nicht bei den Vorgaben.
2. Anforderungen des Betreibers (Soll)
Quelle: Aufträge und Rückmeldungen des Betreibers in der Session vom 22.–30.10.2026. Wörtliche Aussagen sind kursiv.
Grundprinzip
- Ein Ablauf für alle Buchungstypen. Eigene Webseite, manuell/telefonisch, Portal-Anfrage, Portal-Direktbuchung (FeWo-direkt), reines Direktbuchungsportal: dieselbe Zusammenstellung, dieselben Dokumente, dieselbe Akte. Unterschiede nur in Vorgaben (Vorlage, Storno, Zahlungsaufgaben), nicht in eigenen Formularen.
- Vor dem „Bestätigen“ alles zusammenstellen: „sämtliche Informationen und Vertragsdaten (inkl. Preis, Zusatzleistungen, Rabatte, Sonderwünsche)“, außerdem Vorlage, Anlagen, Stornoregel. Der Betreiber muss vor dem Bestätigen sehen, welcher Vertrag erzeugt wird, und Vorlage/Anlagen/Preis ändern können.
- Jede Reservierung hat eine Akte (Meilensteine, Aktivitäten, nächster Schritt, Verlauf), auch bei automatischen Buchungen. „Nur bei einer gesicherten Eigenbelegung (Sperrzeit) benötige ich die Akte nicht.“ Kein manueller Zwischenschritt „Akte anlegen“.
- Vorhandene Kontaktkarte (Gast) verwenden, keinen Platzhalter neben einer vorhandenen Karte anlegen.
- Einfach bedienbar, auch für die 80-jährige Mutter des Betreibers. Menü trennt Konfiguration von Verwaltungsprozess.
Buchungswege (vom Betreiber beschrieben)
- Eigene Webseite: Anfrage → Verfügbarkeit/Vorreservierung → Angebot (versioniert, Vertragsentwurf, signierter Link) → Annahme durch den Gast (Nachweis) → verbindlich → Bestätigung mit Vertrag → Kalender/Portal-Abgleich → Zahlung als Aufgabe → Anreise-Mail → Aufenthalt → Abschluss.
- FeWo-direkt (Sonderfall): Das Portal liefert eine verbindliche Buchung ohne Kontaktdaten. Wir schreiben den Gast an (Portalnachricht) und bitten um Kontaktdaten, bestätigen die Buchung und senden den Vertrag von uns (Vorlage „FeWo-direkt Direktbuchung“ liegt vor). Zahlung läuft über das Portal: keine Zahlungsaufgaben. Mit dem Eintragen der Kontaktdaten soll der Prozess wahlweise automatisch oder manuell weiterlaufen.
- Andere Portale: liefern nur Anfragen; wir antworten persönlich, Angebot und Vertrag von uns.
- Weiteres Portal: nur Direktbuchungen.
- Standardprozess je Portal und Buchungstyp konfigurierbar; daran hängen Vertragsvorlage, Anlagen, Stornobedingungen, Zahlungsaufgaben.
Dokumente, Zahlung, Storno
- Angebot und Vertrag sind unveränderliche Dokumente (Version, Prüfsumme). Vorlagen sind editierbar, mit Versionen, ganzes Dokument mit Platzhaltern plus Anlage; Auswahl je Angebot.
- Zahlungen: Aufgaben und Zusammenfassung, keine automatischen Mahn-Mails; je Portal/Buchungstyp einstellbar (FeWo-direkt: keine).
- Anreise-Informationen automatisch N Tage vorher (Vorgabe 3, je Wohnung).
- Storno-Link und Vorreservierungs-Freigabe in Mails (je Wohnung: Anfrage / sofort / sofort solange frei), bot-sicher.
- Stornoregeln mit automatischer Kostenberechnung (gestaffelt in Prozent; Basis Mietpreis oder Gesamtpreis; Ersatzmieter-Gebühr), Storno-Verwaltung, Mail an Gast und Vermieter. Der Betreiber vermutet: FeWo-direkt rechnet vom Gesamtpreis (rechtlich fraglich), er selbst würde vom Mietpreis rechnen.
- Vertragsanlagen individuell, versioniert, mit Bedingung (immer / bei Zusatzleistung / bei Portal / manuell); Zusatzleistungen kommen aus dem eigenen Portal, bei FeWo-Buchungen müssen sie ggf. aus Daten gelesen oder per Mail erfragt werden; kostenpflichtig und kostenlos.
- Manueller Vertragsprozess muss möglich sein; Statuswechsel von Hand ausdrücklich gewünscht.
Nicht freigegeben
Eigenständige Formulierung von Vertrags- und Stornobedingungen (Texte stammen vom Betreiber), neue externe Cloud-Dienste, KI, Zahlungsintegration, Architekturumbau, Produktivänderungen ohne gesonderte Freigabe.
3. Aktueller Stand (Code, committed auf develop, Test live: Release 81c025f)
Test: 614 Feature-Tests grün (isoliert, SQLite). Nicht im Browser abgenommen; der Betreiber hat die Oberfläche inzwischen gesehen und als fehlerhaft beurteilt (§4).
| Bereich | Dateien (Auswahl) |
|---|---|
| Angebot/Annahme/Bestätigung | app/Actions/SendOffer.php, AcceptOffer.php, ConfirmBooking.php, RejectOffer.php, CreateReservation.php, AutoOffer.php, app/Documents/OfferTerms.php (Snapshot bookings.offer_terms + offer_hash), RentalContract.php, ContractPlaceholders.php |
| Vorlagen/Anlagen/Storno | Modelle ContractTemplate, ContractAnnex, CancellationPolicy, Cancellation; app/Support/CancellationCost.php; Filament-Resources ContractTemplates, ContractAnnexes, CancellationPolicies, Cancellations |
| Akte | app/Support/BookingProgress.php (Art, Meilensteine mit Aktivitäten, nächster Schritt, Verlauf), app/Filament/Resources/Bookings/Schemas/BookingInfolist.php, Pages/ViewBooking.php (Header-Aktionen), RelationManager Zahlungen/Aufgaben/Mails |
| Portal (zuletzt gebaut, siehe §4) | app/Actions/RecordPortalBooking.php, ProvideGuestContact.php, OpenPortalFile.php, SetBookingStatus.php, app/Pricing/PortalPrice.php; BookingForm (Abschnitt Buchungsweg); PortalOccupationResource (Aktion „Akte anlegen“) |
| Standardprozess je Portal | Spalten an channels (contract_template_id, contract_template_reservation_id, payment_tasks_inquiry/reservation); Abschnitt im ChannelForm; Auswahl in OfferTerms::templateFor() (nur nach Buchungsmodell des Portals: PortalBooking → Reservierungsvorlage, sonst Anfragevorlage) |
| Menü | Gruppen Verwaltung / Einrichtung / Webseite / System (AdminPanelProvider); einfache Ansicht = AdminMode::SIMPLE_NAVIGATION (8 Einträge) |
| Zahlungen/Anreise | BookingTask, SendBookingReminders, SendPaymentReminder; Digest |
| Migrationen | alle additiv; zuletzt 2026_10_30_180000_add_portal_booking_and_archive_columns_to_bookings (portal_reference, contact_requested_at, guest_confirmed_at, archived_at) |
Installiert auf Test: Vorlage „FeWo-direkt Direktbuchung“ (php artisan contracts:install-fewo-direkt), Stornoregel „Direktbuchung Standard“ (60 Tage 0 %, 30 Tage 50 %, danach 100 %, Ersatzmieter 35 €; Basis Mietpreis).
4. Bekannte Mängel (aus Code und Betreiber-Rückmeldung; nicht alle im Browser verifiziert)
Die Hauptursache ist Parallelbau: der Angebotsablauf (sendOffer-Modal in ViewBooking) kann Preis, Rabattcode, Preisanpassung, Zusatzleistungen (indirekt), Vorlage, Anlagen, Gastdaten und Gültigkeit zusammenstellen. Alles, was für Portalbuchungen danach gebaut wurde, kann das nicht.
- Kein „Zusammenstellen vor Bestätigen“ für Portalbuchungen. „Direkt bestätigen“ (
ViewBooking, Aktionconfirm) hat nur den Schalter „Mail senden“.ConfirmBooking::bind()wählt die Vorlage selbst (OfferTerms::templateFor) und friert sie ein; Anlagen/Vorlage/Preis sind dort nicht wählbar. Die AktionsendOfferist nur beiReserved/OfferSent/Expiredsichtbar, also nicht mehr bei bereits bestätigten Portalbuchungen. Folge: der Betreiber kann nicht sehen, welcher Vertrag entsteht, und nichts ändern. „Bestätigung erneut senden“ erzeugt/sendet den Vertrag, ohne dass vorher gewählt werden kann. - Preis. Bei „Buchung erfassen“ gibt es ein Feld Portalpreis; an einer bestehenden Akte (auch nach „Akte anlegen“) gibt es keine Möglichkeit, den Preis einzutragen oder neu berechnen zu lassen.
OpenPortalFilesetzt Personenzahl 2 und unsere Berechnung bzw. 0. Die Aktion „Zusatzleistungen erfassen“ ändert den Preis nicht. - Gast.
RecordPortalBookingundOpenPortalFilelegen einen neuen Platzhalter-Gast (E-Mail leer) an, auch wenn eine Kontaktkarte existiert.AssignGuestAction(vorhandenen Gast wählen) ist nicht Teil des Ablaufs. Das Modal „Kontaktdaten eintragen“ dupliziert den Abschnitt „Gast – so erscheint er im Mietvertrag“ im Angebotsmodal. - „Akte anlegen“ ist ein falscher Zwischenschritt. Reservierungen aus dem Portalkalender (
BlockedPeriod, Quellechannel/email) sollten automatisch eine Buchung/Akte haben (Soll §2.3). Aktuell gibt es sie nur per Klick (OpenPortalFile); der Kalenderabgleich (SyncChannel) legt keine an. Außerdem ist die Liste der Fremdbelegungen (OccupancyOverview) zweigleisig (Buchungen vs. Portalzeilen), Portalzeilen führen nur auf die Detailseite. - Neues Erfassungsformular weicht ab. Der Abschnitt „Buchungsweg“ in
BookingForm(Portal, Referenz, Portalpreis, Radio „Wie geht der Vertragsprozess weiter?“) ist ein eigenes Formular neben dem Angebotsablauf.RecordPortalBooking::CONFIRMbindet ohne Vertrag;CONTRACTbestätigt und sendet sofort. Beides umgeht die Zusammenstellung. - Ablauf-Checkliste (
BookingProgress::steps()+BookingInfolist::timeline()) nennt zu offenen Aktivitäten die Aktion nur als Text („→ Aktion …“), nicht als Knopf. Die Aktionen liegen als Header-Aktionen weiter oben auf der Seite; das ist für Bediener unübersichtlich. Meilensteine sind aus Zeitstempeln abgeleitet, nicht gespeichert (kein echter Statusverlauf, nurBookingProgress::history()aus Zeitstempeln, Zahlungen, Mails, Aufgaben). SetBookingStatus(Status von Hand) steht neben dem Workflow und umgeht ihn; Nutzen und Platz im Konzept sind nicht geklärt.- Menü (
AdminMode::SIMPLE_NAVIGATIONauf 8 Einträge gekürzt, Gruppen umbenannt, drei Tests angepasst) wurde nicht mit dem Betreiber abgestimmt. - Vorlagenwahl nach Buchungsmodell statt Buchungstyp.
templateForentscheidet nachChannel::booking_model; ein Portal mit Modell „Gemischt“ liefert für alle Buchungen die Anfragevorlage, auch für verbindliche. Der Betreiber erwartet Standardprozess „je Portal und Buchungstyp“. - Offen aus früheren Phasen: echte MariaDB-Nebenläufigkeitstests fehlen (nur SQLite); Stornostufen und Basis (Mietpreis/Gesamtpreis) juristisch ungeprüft; FeWo-direkt-Vertrag § 4 Platzhalter
{{ anzahlung }}vom Betreiber zu prüfen; WLAN/Kellercode unter Wohnung › Vertragsdaten einzutragen; Vorlagen/Stornoregeln den Portalen zuordnen.
5. Empfohlenes Vorgehen für die nächste Session
Schritt 0 (Pflicht): Konzept und Bildschirmentwurf mit dem Betreiber abstimmen, bevor Code entsteht. Konkrete Fragen: (a) Soll jede Portalreservierung beim Kalenderabgleich automatisch eine Buchung/Akte werden (Empfehlung: ja, mit Kanaleinstellung)? (b) Welche Felder gehören in die eine Zusammenstellung? (c) Welche Einträge braucht die einfache Ansicht wirklich?
Danach in dieser Reihenfolge:
- Eine Zusammenstellung, ein Formular: das Angebotsformular aus
ViewBooking::sendOfferin ein wiederverwendbares Schema extrahieren („Konditionen zusammenstellen“: Termin, Personen, Zusatzleistungen, Rabattcode, Preisanpassung/Portalpreis, Vorlage, Anlagen, Stornoregel-Anzeige, Gast, Gültigkeit, Nachricht, Vorschau des Vertrags). Dasselbe Schema für: Angebot senden (Webseite/Portal-Anfrage/manuell), Bestätigen (Portal-Direktbuchung, telefonisch).SendOfferundConfirmBookingbekommen dieselben Änderungsparameter ($changes),bind()darf nicht mehr still die Vorlage wählen. - Portalreservierung = Buchung von Anfang an:
SyncChannelbzw. die Klärungslogik legt für importierte Portalreservierungen die Buchung samt Akte an (Idee:OpenPortalFiledorthin verlegen, Kanaleinstellungauto_file), Gast über vorhandene Kontaktkarte zuordnen (AssignGuestAction), kein Platzhalter-Gast, wo eine Karte existiert. Danach entfällt der Knopf „Akte anlegen“. RecordPortalBookingund den Abschnitt „Buchungsweg“ zurückbauen bzw. auf den gemeinsamen Ablauf umstellen;PortalPrice(Portalpreis ↔ unsere Berechnung als Anpassungszeile) weiterverwenden.- Akte: Aktivitäten als Knöpfe in der Checkliste; echten Verlauf (Ereignisse) speichern, wenn gewünscht;
SetBookingStatusnur behalten, wenn der Betreiber es im neuen Konzept will. - Standardprozess je Portal und Buchungstyp:
templateForauf den tatsächlichen Buchungstyp umstellen (nicht nurbooking_model); inChannelFormübersichtlich darstellen (Abschnitt ist vorhanden). - Menü gemeinsam mit dem Betreiber festlegen.
Die Domänenregeln in CLAUDE.md bleiben unverändert gültig (Nächte-Semantik, lockForTransition, Snapshot/Hash, Mailfehler-Isolation, Mandanten, FollowsAdminMode).
6. Arbeitsweise und Fallen
- PHP lokal:
"$LOCALAPPDATA"/Microsoft/WinGet/Packages/PHP.PHP.NTS.8.4_*/php.exe. Tests:php artisan test --compact [Datei]; Pint:vendor/bin/pint --dirty --format agent. Volllauf rund 2,5 Minuten. - Mehrere Agenten teilen den Ordner. Fremde, uncommittete Dateien nicht anfassen und nicht stagen:
.env.production.example,ChannelController,PageController,ResolveTheme,BookingRequest.php,bootstrap/app.php,config/fewo.php,docs/BETRIEB.md,docs/ZUSAMMENARBEIT.md,theme.js,booking-request.blade.php,routes/web.php(Teil),ForceHttps.php,GoLiveComplianceTest.php,MVP-*.md. Nur eigene Dateien explizit mitgit add <Pfad>stagen. - Deployment auf Test: Push auf
develop→ Gitea Actions →test.fewo-stommer.de(erreichbar unterhttps://stommer.info). Push scheitert manchmal einmalig mit „Failed to authenticate“ – wiederholen. Produktion nur nach gesonderter Freigabe;pipeline.tomlProduktionsziel steht aufenabled=false. - Serverprüfung per SSH:
ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting '…'(der Aliasstrato_fewofunktioniert nicht). Aktives Release:readlink test.fewo-stommer.de/current. Artisan dort mit/opt/RZphp84/bin/php-cli(das Standard-phpist zu alt). Hinweis „bad signature for RSA key“ ist harmlos. Eine verwaiste.deploy-locknur nach Prüfung (leer, alt, kein Deploy-Prozess) entfernen; der Betreiber hat das einmal ausdrücklich freigegeben. - Filament-Fallen: Ein Closure-Parameter namens
$setoder$getwird als Formular-Utility injiziert (führte zu „makeSetUtility() on null“). Aktionen inActionGroupim Test mitTestAction::make('name')->arguments([])aufrufen. Tabellenaktionen auf Datensätzen, die durch die Aktion aus der Abfrage fallen, brechen („Record no longer exists“) – solche Aktionen auf die Detailseite legen. - Tests isoliert fahren, wenn andere Agenten Dateien ändern (
git checkout-indexdes Index in einen Scratch-Ordner,vendorverknüpfen). Zeitabhängige Tests mittravelTo(Preise existieren nur für bestimmte Zeiträume; Mindestaufenthalt beachten). - Zeilenenden: Dateien mit CRLF nicht mit
sedbearbeiten; Edit/Write bzw. Skript mitnewline=''verwenden. Pint normalisiert auf LF. - Sicherheit: Das im Chat gepostete Gitea-Token (Ende Oktober) muss der Betreiber widerrufen; nie speichern oder committen.
7. Offene Punkte außerhalb des Buchungsprozesses
MariaDB-Parallelitätstests (Bereitstellung der Datenbank durch den Betreiber offen); Umzug auf prod.fewo-stommer (eigene Datenbank für Test bei Strato, Deployment-Härtung); Grund der verwaisten .deploy-lock nach dem ersten Deployment (PipelineManager-Entsperrung); Startseite „Was ist heute zu tun?“ für die einfache Ansicht (Idee, nicht abgestimmt); BOOKING-E2E-*-Dokumente für spätere Phasen nachziehen.