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

188 lines
27 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Ü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.