Files
fewo-stommer/docs/UEBERGABE-BUCHUNGSPROZESS.md
2026-10-31 13:11:34 +01:00

27 KiB
Raw Permalink Blame History

Ü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

  1. 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.
  2. 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.
  3. 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“.
  4. Vorhandene Kontaktkarte (Gast) verwenden, keinen Platzhalter neben einer vorhandenen Karte anlegen.
  5. 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.

2a. Entscheidungen und Prozessmodell (Abstimmung vom 30.10.2026)

Quelle: Antworten des Betreibers in der Session vom 30.10.2026. Als Annahme markierte Punkte sind noch nicht bestätigt.

Grundsatz

Möglichst viel automatisieren; automatische Entscheidungen sind für den Benutzer korrigierbar und rückgängig zu machen.

Automatische Akte (Antwort auf §5 Frage a)

  • Die vorhandene Regelengine erkennt verbindliche externe Buchungen (Prämisse bisher: Buchungen erkennen, nicht pauschal „Blocker“). Greift eine Regel sicher, entsteht die Buchung mit Akte ohne manuelle Bestätigung.
  • Reine Termine ohne sichere Erkennung bleiben Sperrzeit und müssen erst geklärt werden („Buchung oder nur Blocker?“).
  • Jede Zuordnung ist umkehrbar: Stellt sich später heraus, dass es nur ein Blocker war, wird die Buchung wieder zur Sperrzeit (Akte archivieren, Verlauf behalten, nichts löschen).

Buchungsakte = Dashboard (Antwort auf §5 Frage b)

  • Einstieg zeigt: Gast, Zeitraum, Personenzahl, Preis mit allen Posten/Rabatten, Vertragsvorlage, Anlagen, Stornobedingungen, laufende Fristen, Mahnstatus, nächster Schritt.
  • Fehlende Informationen werden als fehlend markiert; Felder erscheinen je nach Status und Informationslage dynamisch.
  • Kommunikation, verbindliche Vertragsunterlagen, Zahlungen, Verlauf: vollständig im Zugriff (Register), nicht zwingend auf dem Einstieg.
  • Gilt für alle Akten, egal ob eigenes Portal oder Fremdportal.
  • „Menü“ im Sinne der Fragen = die linke Seitennavigation des Admin-Bereichs; sie wird erst ganz zum Schluss gemeinsam festgelegt.

Workflow-Modell: ein maximaler Ablauf, Profile überspringen Schritte

Es gibt einen maximalen Workflow. Je Portal und Buchungstyp legt ein Prozessprofil fest, welche Schritte gelten, übersprungen oder anders ausgeführt werden (Vorlage, Anlagen, Storno, Zahlungsaufgaben, Mahnwesen, Versand des Vertrags durch uns oder das Portal). Das Profil ist der „Standardprozess je Portal und Buchungstyp“ (§2); die Vorlagenwahl richtet sich nach dem tatsächlichen Buchungstyp, nicht nur nach Channel::booking_model (Mangel §4.9).

Maximale Schritte (Reihenfolge): Eingang/Anfrage → Verfügbarkeit/Vorreservierung → Angebot (Zusammenstellung) → Annahme → Bestätigung + Vertrag → Kontaktdaten klären → Kalender/Portal-Abgleich → Zahlung (Aufgaben, Fristen, Mahnstatus) → Anreise-Information → Aufenthalt → Abschluss. Zusätzlich jederzeit: Storno, Vertragsänderung.

Profil Quelle / Typ Ablauf Übersprungen oder anders
Standard (eigenes Portal) Webseite-Anfrage; ebenso manuell/telefonisch Alle Schritte. Angebot (versioniert, Vertragsentwurf, signierter Link) → Annahme durch Gast mit Nachweis → Bestätigung mit Vertrag von uns → Zahlungsaufgaben (Anzahlung/Rest) → Anreise-Mail nichts; Mahnwesen als Aufgaben/Zusammenfassung, keine automatischen Mahn-Mails
Anfrage über Fremdportal Portal liefert nur Anfrage Wir antworten persönlich (im Portal oder per Mail), danach wie Standard: Angebot und Vertrag von uns, Annahme, Zahlung über uns Kontaktweg über das Portal; Zahlungsaufgaben je Portal einstellbar
FeWo-direkt Direktbuchung Portal liefert verbindliche Buchung ohne Kontaktdaten Eingang gilt als Annahme. Gast per Portalnachricht um Kontaktdaten bitten → Buchung bestätigen → Vertrag von uns (Vorlage „FeWo-direkt Direktbuchung“) → Anreise-Mail. Nach Eintrag der Kontaktdaten läuft der Prozess wahlweise automatisch oder manuell weiter Angebot und Annahme entfallen; keine Zahlungsaufgaben und kein Mahnwesen (Zahlung über das Portal); Preis kommt vom Portal (Anpassungszeile gegenüber unserer Berechnung)
Weiteres Portal, nur Direktbuchung verbindliche Buchung wie FeWo-direkt, Details je Portal Vertrag je Konfiguration von uns oder vom Portal (dann Vertragsschritt übersprungen)
Buchungshub mit Partnerportalen Herkunft: Hub direkt oder Partnerportal Profil je Herkunft (siehe Konfigurationsmodell) je Herkunft verschieden
Eigenbelegung Sperrzeit keine Akte –

Konfigurationsmodell (Entscheidung 30.10.2026): Es gibt einen Standardprozess (eigenes Portal). Für jedes angeschlossene Portal wird daran angeknüpft und innerhalb der Portalkonfiguration nach Buchungstyp abgewichen. Alles ist frei konfigurierbar, nichts ist je Portal fest verdrahtet. Beispiele, die möglich sein müssen:

  • Anfragen aus einem Direktbuchungsportal werden komplett von uns verarbeitet (Angebot, Vertrag, Zahlung).
  • Eine Direktbuchung wird wahlweise vom Portalbetreiber oder von uns abgewickelt (Vertrag, Zahlung, Mahnwesen).
  • Buchungsherkunft: Bei einem Buchungshub unterscheidet sich die Abwicklung nach der Herkunft (direkt im Hub oder über ein Partnerportal), obwohl die Buchung bei uns nur über das angeschlossene Portal eingeht. Das Profil wird also nach Portal → Buchungstyp → Herkunft aufgelöst; die Herkunft muss aus den Portaldaten erkennbar sein (Erkennbarkeit je Portal noch zu klären).
  • Auflösungsreihenfolge: spezifischster Treffer gewinnt (Portal + Typ + Herkunft → Portal + Typ → Portal → Standardprozess).

Konfigurierbar je Schritt und Profil: gilt / wird übersprungen, automatisch / manuell, Vorlage, Anlagen, Stornoregel, Zahlungsaufgaben, Mahnwesen, wer den Vertrag verschickt (wir / Portal). Das Konfigurationsmodell ist noch nicht entworfen und vor dem Bau mit dem Betreiber abzustimmen.

Angebot, Vertrag, Vertragsänderung (Antwort zu Frage 3)

  • Angebot ist bis zur Annahme änderbar (neue Version).
  • Nach der Annahme ist es ein Vertrag und unveränderlich. Änderungen (z. B. Zusatzleistungen) erzeugen einen Änderungsvertrag, der den alten Vertrag ersetzt, neu geschrieben und versendet wird und den Ersatz ausdrücklich nennt.
  • Der Änderungsvertrag soll vom Kunden bestätigt werden. Bis zur Annahme gilt der alte Vertrag weiter.
  • Standard: gleiche Konditionen. Der Vermieter kann wählen, ob Konditionen angepasst werden (Rabatte entfallen, kürzere Laufzeit → höherer Tagespreis, zusätzliche Person kostet mehr).
  • Annahme (juristisch ungeprüft): Vertragsänderung ≙ kostenfreie Stornierung mit neuem Angebot.
  • Daraus folgt: Die Zusammenstellung wird vor der Annahme (Angebot) bzw. als Änderungsvertrag nach der Annahme bearbeitet, nie am bestehenden Vertragsdokument.

2b. Entwurf Prozessmodell (30.10.2026, Vorschlag, vom Betreiber noch nicht bestätigt)

Anlass: Das Profilmodell aus §2a reicht nicht. Der eigene Prozess dient als Vorlage, kennt aber bei der Anfrage schon Name, Personenzahl, kalkulierten Preis, Zusatzleistungen und E-Mail. Bei Fremdportalen fehlt das und muss über wechselnde Wege beschafft werden. Ziel: wenige Archetypen, leicht anpassbar je Portal, keine Konfigurationshölle.

Was im Code schon trägt (nicht neu erfinden)

  • ICalRuleEngine (Regeln mit Bedingungen, Extraktionen, Priorität, event_type, Herkunftskanal origin) erkennt Kalendereinträge je Portal.
  • PortalMailParser / ParsedPortalMail / PortalEmailType (Buchung, Stornierung, Anfrage, Unbekannt) erkennen Portalmails; ChannelBookingModel (Anfrage / Portalbuchung / Gemischt) ist die bisherige, zu grobe Unterscheidung.
  • Der Angebotsablauf (SendOffer, AcceptOffer, ConfirmBooking, OfferTerms) ist der Standardprozess.

Bausteine

  1. Informationsfelder der Buchung mit Status und Quelle: Gast (Name, E-Mail, Telefon, Anschrift), Zeitraum, Personen, Zusatzleistungen, Preis, Portalreferenz, Herkunft. Status je Feld: bekannt (Quelle: Portalmail / Kalender / Gast / manuell / unsere Berechnung), unbestätigt oder fehlt. Das Dashboard markiert „fehlt“ daraus; kein Feld wird still erfunden (kein Platzhalter-Gast).
  2. Schritte (maximaler Ablauf aus §2a). Jeder Schritt hat:
    • Regel (gilt / überspringen, optional mit Bedingung auf Felder oder Herkunft),
    • Eingangskanäle in Prioritätsreihenfolge, mehrere gleichzeitig möglich,
    • Ausgangskanäle (ebenfalls mehrere),
    • Auslösung automatisch oder manuell, Frist, Abschlusskriterium,
    • Fallback immer manuelle Eingabe: Fehlt die Information nach den Kanälen, entsteht eine Aufgabe für den Betreiber.
  3. Eingangskanäle (Informationsquellen): Portalmail-Erkennung, Kalenderregel (ICalRuleEngine), Gast-Formular über signierten Link (Kontaktdaten selbst eintragen), Antwort des Gastes per Mail/Portalnachricht (vom Betreiber abgelesen und eingetragen), manuelle Eingabe, unsere Berechnung (Preis).
  4. Ausgangskanäle: E-Mail an Gast, Portalnachricht (Text zum Kopieren; Versand durch den Betreiber im Portal), Dokument (Angebot/Vertrag/Änderungsvertrag), Aufgabe für den Betreiber, Hinweis im Postfach.
  5. Herkunftsmerkmal je Portal konfigurierbar: aus Kalenderregel, aus Mailregel (Absender/Text/Muster) oder manuell auswählbar (Pflichtfallback, wenn nur im Portal ablesbar). Die Herkunft (z. B. Hub direkt, Partnerportal X) ist Bedingung für die Prozesswahl.
  6. Prozesswahl je Portal: Tabelle „Eingangsart (Anfrage, verbindliche Buchung, ggf. weitere je Portal) × Herkunft → Archetyp + Abweichungen“. Spezifischster Treffer gewinnt, sonst Standardprozess.

Vorgeschlagene Archetypen (3–4)

Archetyp Information bei Eingang Wir tun Portal tut
A Angebotsprozess (eigene Webseite, telefonisch/manuell, Portalanfrage mit vollständigen Daten) Name, E-Mail, Personen, Preis, Zusatzleistungen (soweit erfasst) Angebot, Annahme-Link, Vertrag, Zahlungsaufgaben, Anreise-Mail höchstens Nachrichtenweg
B Portalanfrage, Daten unvollständig (Variante von A mit vorgeschaltetem Schritt „Informationen beschaffen“) oft nur Zeitraum/Name/Portalreferenz erst Daten beschaffen (Gast-Link, Portalnachricht, manuell), danach wie A Kommunikationskanal
C Verbindliche Buchung, wir erledigen Vertrag; Zahlung läuft über das Portal (FeWo-direkt) Zeitraum, Referenz, Preis vom Portal; keine Kontaktdaten Kontaktdaten beschaffen, bestätigen, Vertrag von uns, Anreise-Mail Zahlung/Mahnwesen
D Verbindliche Buchung, alles beim Portal (Hub o. Ä., wenn das Portal Vertrag und Zahlung stellt) Zeitraum, Referenz, ggf. Gastdaten erfassen, Akte, Anreise-Info, Aufenthalt/Abschluss Vertrag, Zahlung

Zusätzlich möglich, aber noch zu klären: verbindliche Buchung, die wir komplett abwickeln (Vertrag und Zahlung), als Variante von C statt eigener Archetyp. Abweichungen je Portal/Eingangsart/Herkunft sind auf wenige Schalter begrenzt: Schritt überspringen, Kanalreihenfolge, automatisch/manuell, Vorlage/Anlagen/Storno, Zahlungsaufgaben ja/nein, Vertrag von uns/Portal. Keine freien Skripte.

Vor dem Bau zu klären

  • Stimmen die Archetypen A–D, oder braucht der Betreiber andere Abgrenzungen?
  • Welche Eingangsarten pro Portal gibt es (Anfrage, Buchung, Stornierung, Änderung?) und wie werden sie erkannt?
  • Wer bestätigt Informationen, die aus mehreren Kanälen widersprüchlich kommen (Mail sagt 3 Personen, Kalender nichts)?
  • Reihenfolge der Umsetzung: Informationsfelder mit Quelle zuerst (Grundlage für Dashboard „fehlt“), dann Schritte/Kanäle, dann Archetypen und Portalkonfiguration, dann Zusammenstellung/Änderungsvertrag.

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.

  1. Kein „Zusammenstellen vor Bestätigen“ für Portalbuchungen. „Direkt bestätigen“ (ViewBooking, Aktion confirm) 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 Aktion sendOffer ist nur bei Reserved/OfferSent/Expired sichtbar, 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.
  2. 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. OpenPortalFile setzt Personenzahl 2 und unsere Berechnung bzw. 0. Die Aktion „Zusatzleistungen erfassen“ ändert den Preis nicht.
  3. Gast. RecordPortalBooking und OpenPortalFile legen 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.
  4. „Akte anlegen“ ist ein falscher Zwischenschritt. Reservierungen aus dem Portalkalender (BlockedPeriod, Quelle channel/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.
  5. 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::CONFIRM bindet ohne Vertrag; CONTRACT bestätigt und sendet sofort. Beides umgeht die Zusammenstellung.
  6. 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, nur BookingProgress::history() aus Zeitstempeln, Zahlungen, Mails, Aufgaben).
  7. SetBookingStatus (Status von Hand) steht neben dem Workflow und umgeht ihn; Nutzen und Platz im Konzept sind nicht geklärt.
  8. Menü (AdminMode::SIMPLE_NAVIGATION auf 8 Einträge gekürzt, Gruppen umbenannt, drei Tests angepasst) wurde nicht mit dem Betreiber abgestimmt.
  9. Vorlagenwahl nach Buchungsmodell statt Buchungstyp. templateFor entscheidet nach Channel::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“.
  10. 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:

  1. Eine Zusammenstellung, ein Formular: das Angebotsformular aus ViewBooking::sendOffer in 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). SendOffer und ConfirmBooking bekommen dieselben Änderungsparameter ($changes), bind() darf nicht mehr still die Vorlage wählen.
  2. Portalreservierung = Buchung von Anfang an: SyncChannel bzw. die Klärungslogik legt für importierte Portalreservierungen die Buchung samt Akte an (Idee: OpenPortalFile dorthin verlegen, Kanaleinstellung auto_file), Gast über vorhandene Kontaktkarte zuordnen (AssignGuestAction), kein Platzhalter-Gast, wo eine Karte existiert. Danach entfällt der Knopf „Akte anlegen“.
  3. RecordPortalBooking und den Abschnitt „Buchungsweg“ zurückbauen bzw. auf den gemeinsamen Ablauf umstellen; PortalPrice (Portalpreis ↔ unsere Berechnung als Anpassungszeile) weiterverwenden.
  4. Akte: Aktivitäten als Knöpfe in der Checkliste; echten Verlauf (Ereignisse) speichern, wenn gewünscht; SetBookingStatus nur behalten, wenn der Betreiber es im neuen Konzept will.
  5. Standardprozess je Portal und Buchungstyp: templateFor auf den tatsächlichen Buchungstyp umstellen (nicht nur booking_model); in ChannelForm übersichtlich darstellen (Abschnitt ist vorhanden).
  6. 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 mit git add <Pfad> stagen.
  • Deployment auf Test: Push auf develop → Gitea Actions → test.fewo-stommer.de (erreichbar unter https://stommer.info). Push scheitert manchmal einmalig mit „Failed to authenticate“ – wiederholen. Produktion nur nach gesonderter Freigabe; pipeline.toml Produktionsziel steht auf enabled=false.
  • Serverprüfung per SSH: ssh -i ~/.ssh/strato_fewo stu100093250@51539426.ssh.w1.strato.hosting '…' (der Alias strato_fewo funktioniert nicht). Aktives Release: readlink test.fewo-stommer.de/current. Artisan dort mit /opt/RZphp84/bin/php-cli (das Standard-php ist zu alt). Hinweis „bad signature for RSA key“ ist harmlos. Eine verwaiste .deploy-lock nur nach Prüfung (leer, alt, kein Deploy-Prozess) entfernen; der Betreiber hat das einmal ausdrücklich freigegeben.
  • Filament-Fallen: Ein Closure-Parameter namens $set oder $get wird als Formular-Utility injiziert (führte zu „makeSetUtility() on null“). Aktionen in ActionGroup im Test mit TestAction::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-index des Index in einen Scratch-Ordner, vendor verknüpfen). Zeitabhängige Tests mit travelTo (Preise existieren nur für bestimmte Zeiträume; Mindestaufenthalt beachten).
  • Zeilenenden: Dateien mit CRLF nicht mit sed bearbeiten; Edit/Write bzw. Skript mit newline='' 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.