Uebergabe Buchungsprozess: Anforderungen, Stand, Maengel, empfohlenes Vorgehen
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m34s

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-10-30 19:17:28 +01:00
1 parent 81c025f1ee
commit c8bb0f6e97
2 files changed
+101

No files matched your search

+2
View File
@@ -1,5 +1,7 @@
# Projektstand
**Buchungsprozess – Übergabe an eine neue Session (30.10.2026):** Die Portal-Erweiterungen des Buchungsprozesses (Portal-Direktbuchung erfassen, „Akte anlegen“, Statuswechsel von Hand, Menü) wurden neben dem Angebotsablauf statt auf ihm gebaut und sind für den Betreiber nicht brauchbar. **Vor jeder Arbeit am Buchungsprozess `docs/UEBERGABE-BUCHUNGSPROZESS.md` lesen** (Anforderungen, Stand, Mängelliste, empfohlenes Vorgehen) und das Konzept dort mit dem Betreiber abstimmen, bevor Code entsteht.
**Hauptadresse und Abspielgeschwindigkeit (30.10.2026):** Weitere Adressen einer Website (z. B. www.stommer.info) leiten jetzt dauerhaft (301, nur GET/HEAD) auf die Hauptadresse (`Site.domain`) um (`ResolveTheme::toMainAddress`). Vorher lud die Seite unter www Skripte, Schriften und Videos von der Adresse ohne www – der Browser blockierte sie als fremde Herkunft: kein JavaScript (Titelvideo, Menü-Pfeile), Ersatzschrift. `Site::origin()` nimmt verbindlich das Feld `domain`. Videos haben eine **Abspielgeschwindigkeit** (Webseite › Videos, 0,5×–1×), die überall gilt, wo das Video läuft.
**Titelvideo, Rundgang, freie Termine, Buchungsseite (30.10.2026, Branch `feature/titelvideo-rundgang`):** Neue Verwaltung **Webseite › Videos** (`Video`: Datei bis 100 MB, Standbild, Kapitel mit Raum aus dem Grundriss; Upload-Grenzen von Livewire/Medienbibliothek auf 100 MB angehoben – vorher scheiterten schon Fotos über 10 MB). **Titelbereich:** „Video statt Foto“ (stumme Schleife, lädt nur ohne „Bewegung reduzieren“/Save-Data, Pause-Knopf) und „Nächste freie Termine“ (`App\Availability\NextFreeStays`: bis zu 3 buchbare, nicht überlappende Zeiträume mit Gesamtpreis, 10 Min. zwischengespeichert, Klick füllt die Anfrage vor; Seebad: Fahrkarten). **Neuer Baustein „Rundgang (Video)“** (Anordnung wählbar: volle Breite/Video links/rechts; Kapitel als Fahrplan; lädt erst beim Start); Grundriss-Räume mit Kapitel bieten „Im Rundgang ansehen“. **Buchungsseite:** Preis links unter dem Kalender, Formular rechts (auf großen Bildschirmen mitlaufend) – keine halbleere Seite mehr; Ablauf „Anfrage → Angebot → Annahme“ als Grafik (abschaltbar). **Seebad:** Sonnenaufgang des Trenners einmal beim Hinscrollen statt unmerklicher Dauerbewegung. Aus dem Agenturvideo (41,7 MB, Rechte bei Stommers) geschnitten: Titelschleife „Garten und Meer“ (9 s, 3,5 MB) und Rundgang (58 s, 14,5 MB) – liegen nicht im Repo, Upload über den Admin. Lokal mit Bildschirmfotos (Desktop/Handy) geprüft. Tests: **526 Feature-Tests grün**, Pint, `themes:check` beide Themes.
+99
View File
@@ -0,0 +1,99 @@
# Ü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.
## 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.