- Buchung ist der einheitliche Vorgang: Eingangsart, Vorgangsart A1–A6, eingefrorenes Abwicklungsprofil, gespeicherter Verlauf (booking_events); Gast, Personen und Beträge dürfen unbekannt sein, Platzhalter-Gäste werden migriert und nicht mehr angelegt - Einstellungen in Ebenen: Vermieterstandard (So arbeite ich), Abweichung der Wohnung (Experte), Abweichung je Portal und Eingangsart; ersetzt booking_model als Steuergröße - Ein Weg für extern verbindliche Buchungen (TakeOverExternalBooking) statt RecordPortalBooking und "Akte anlegen"; Portalpreis als belegte Gesamtposition - Startseite "Zu erledigen", neue Vorgangsseite mit nächstem Schritt, Automatik-Schalter, "Beenden" mit Storno statt Statusumschaltung; Status von Hand nur im Expertenmodus - Migration übernimmt bisheriges Verhalten unverändert (abweichende Wohnungswerte bleiben als Abweichung), Bericht: php artisan process:settings-report Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
646 lines
60 KiB
Markdown
646 lines
60 KiB
Markdown
---
|
||
id: PLAN-010
|
||
typ: umsetzungsplan
|
||
titel: Umsetzungsplan zur Prozessarchitektur v0.10
|
||
status: entwurf-zur-freigabe
|
||
version: "0.10"
|
||
stand: 2026-11-01
|
||
---
|
||
|
||
# Umsetzungsplan zur Prozessarchitektur v0.10
|
||
|
||
**Entwurf zur Entscheidung durch den Betreiber.** Dieses Dokument ist kein Teil der normativen Fachspezifikation. Es vergleicht die Sollbeschreibung v0.10 mit dem Code auf `develop`. Letzter Code-Commit zum Buchungsprozess ist `81c025f` vom 30.10.2026; danach kamen nur Website- und Compliance-Commits. Daraus leitet das Dokument einen priorisierten Umsetzungsplan ab. Es wurde nichts implementiert und nichts migriert.
|
||
|
||
**Kennzeichnung im Text:**
|
||
- **[Befund]** ist im Code nachgeprüft, mit Verweis.
|
||
- **[Empfehlung]** ist ein Vorschlag des Coding-Agenten.
|
||
- **[Annahme]** ist noch nicht geprüft und muss vor der Umsetzung bestätigt werden.
|
||
|
||
---
|
||
|
||
## 1. Management Summary
|
||
|
||
**Kernaussage:** Die fachliche Zielarchitektur v0.10 lässt sich ohne Neuentwicklung erreichen. Dafür reicht kein vorsichtiges Weiterbauen am Bestehenden. Nötig ist eine **gezielte Konsolidierung**:
|
||
|
||
- **ein** Vorgang statt drei paralleler Träger,
|
||
- **eine** Aufgabenliste statt vier,
|
||
- **eine** Zusammenstellung vor jedem Dokument,
|
||
- **eine** Einstellungshierarchie statt verstreuter Schalter an Wohnung und Kanal,
|
||
- eine neu gestaltete Vorgangsseite, die führt, statt ein Werkzeugkasten mit 17 Aktionsknöpfen zu sein.
|
||
|
||
**Was trägt:**
|
||
- Der Angebotsweg über die eigene Website (A1) ist fachlich solide und gut getestet: versionierte Angebote mit eingefrorenem Konditionsstand und Hash, signierter Annahmelink, atomare Annahme mit Kalender-Frischeprüfung, Vertragserzeugung, Zahlungserinnerungen, Anreise-Mail, Bewertung.
|
||
- Kanalanbindung, iCal-Regelwerk, Portal-Mail-Erkennung, Kalenderspiegelungen und die **Owner-/Ursprungskanal-Zuordnung** (E-028) sind vorhanden und werden weiterverwendet.
|
||
|
||
**Was nicht trägt:**
|
||
- Externe Direktbuchungen (A3–A5) entstehen nur über Umwege: manuelles „Akte anlegen“, ein zweiter Erfassungsweg, Platzhalter-Gäste und eigene Preisberechnung statt Portalpreis.
|
||
- A6 mit Gästen und Leistungen ist nicht abbildbar.
|
||
- Die Prozessart hängt am Kanal statt an der Eingangsart.
|
||
- Nach Buchungsabschluss gibt es keine Änderungsfunktion für einen gebuchten Vorgang.
|
||
- Die Bedienung setzt Kenntnis interner Statusmodelle voraus.
|
||
|
||
**Empfohlene Vorgehensweise:** neun Pakete in drei Stufen.
|
||
- **Stufe 1, Grundlagen:** Vorgangskern und Einstellungen, danach geführte Vorgangsbearbeitung.
|
||
- **Stufe 2, Kernfunktionen:** Dokumente, Eingang aller Kanäle, Änderung und Abbruch, A6, Angebotsweg mit Hold 0.
|
||
- **Stufe 3, Ergänzungen:** externe Beträge und Zahlungsstände, Aufenthalt und Abschluss.
|
||
|
||
**Erster Schritt:** Paket 1, „Vorgangskern und Einstellungen“ (§9).
|
||
|
||
**Betreiberentscheidungen:** Fünf kurze fachliche Entscheidungen sind nötig (§8.1). Keine davon blockiert Paket 1.
|
||
|
||
---
|
||
|
||
## 2. Aktualisierter Soll-Ist-Abgleich
|
||
|
||
### 2.1 Was aus der Analyse zu v0.9 weiterhin gilt
|
||
|
||
Alle damaligen Befunde sind im Code unverändert, weil seit `81c025f` niemand am Buchungscode gearbeitet hat. Durch v0.10 neu bewertet werden drei Punkte:
|
||
|
||
- Die drei damals offenen Grundsatzfragen sind **jetzt fachlich entschieden** und werden nicht erneut gestellt:
|
||
- **A6 ist immer ein Vorgang.** Quellen: [Archetypen](01_Buchungsarchetypen.md), E-023, E-024.
|
||
- **Das Profil richtet sich nach Kanal und Eingangsart. Die Partnerherkunft ist nur ein kaufmännisches Merkmal.** Quellen: E-012, [Profile](02_Abwicklungsprofile_und_Dokumente.md).
|
||
- **Bei Hold = 0 wird automatisch oder manuell bestätigt, je nach Einstellung.** Quelle: E-030.
|
||
- **Neu ist E-029:** Globale Standardwerte gelten je Vermieter, Kanalwerte überschreiben sie nur, wenn sie ausdrücklich gesetzt sind. Heute liegen die Prozess-Einstellungen an der **Wohnung**. Das ist eine zusätzliche Ebene, die v0.10 nicht vorsieht (siehe L4).
|
||
- **Neu ist die Gewichtung der Bedienbarkeit** (Auftrag §4). Die bisherige Oberfläche wird nicht als Maßstab übernommen; die UX-Befunde in 2.3 sind deshalb gleichrangig mit den fachlichen Lücken.
|
||
|
||
### 2.2 Fachliche und strukturelle Lücken
|
||
|
||
| # | Soll (v0.10) | Ist [Befund] | Bewertung |
|
||
|---|---|---|---|
|
||
| L1 | Ein Vorgang je Anlass, kein „Akte anlegen“ | Drei Träger: **(1)** `Booking`, **(2)** `BlockedPeriod` mit eigener Gastzuordnung ([AssignOccupationGuest](../../app/Actions/AssignOccupationGuest.php)) für Portalbelegungen und A6, **(3)** paralleler Erfassungsweg [RecordPortalBooking](../../app/Actions/RecordPortalBooking.php) mit Abschnitt „Buchungsweg“ in [BookingForm](../../app/Filament/Resources/Bookings/Schemas/BookingForm.php). Eine Portalreservierung wird nur per Klick über [OpenPortalFile](../../app/Actions/OpenPortalFile.php) zum Vorgang. | Strukturelle Kernlücke |
|
||
| L2 | Unbekannt ist nicht 0, keine Platzhalter | `bookings.guest_id` ist `NOT NULL` ([Migration](../../database/migrations/2026_10_22_092645_create_bookings_table.php)). `OpenPortalFile` legt deshalb den Gast „Gast (Portal)“ ohne E-Mail an, setzt 2 Personen und einen selbst berechneten Preis. `total` ist eine Pflicht-Ganzzahl. | Verstößt gegen E-014 und R01 „Kritische Ausnahmen“ |
|
||
| L3 | Profil nach Kanal **und Eingangsart**, Vorlagenwahl nicht nur nach Kanal | `Channel::booking_model` (Anfrage/Portalbuchung/Gemischt) steuert an vier Stellen: [BookingProgress](../../app/Support/BookingProgress.php), [OfferTerms::templateFor](../../app/Documents/OfferTerms.php), [Booking::wantsPaymentTasks](../../app/Models/Booking.php), [CalendarClearance](../../app/Availability/CalendarClearance.php). Bei „Gemischt“ wird für verbindliche Buchungen die Anfragevorlage gewählt. Archetypen A1–A6 kennt der Code nicht. | Kernlücke |
|
||
| L4 | Vermieterstandard → Kanalabweichung → Vorgang, „nicht gesetzt“ ≠ 0 | `hold_hours`, `pre_reservation_enabled`, `offer_mode`, `arrival_info_days_before` und `cancellation_mode` liegen an der Wohnung ([Property](../../app/Models/Property.php)). Am Tenant liegen andere Standards (`deposit_due_days`, `review_request_after_days`). Am Kanal liegen zwei Zahlungs-Booleans und zwei Vorlagen-IDs. Eine Vererbungslogik mit „nicht gesetzt“ gibt es nicht. **Kanäle sind je Wohnung angelegt** (`channels.property_id`). | Neu zu bauen; Migrationsfrage |
|
||
| L5 | Hold > 0: Angebot passend befristet; Hold = 0: Auskunft unter Vorbehalt, Buchungswunsch, erneute Prüfung | Bei der Anfrage wird `pre_reservation_enabled` berücksichtigt ([CreateReservation](../../app/Actions/CreateReservation.php): ohne Vorreservierung kein Hold). [SendOffer](../../app/Actions/SendOffer.php) setzt aber **immer** `hold_expires_at` und einen annehmbaren Link. Damit entsteht auch bei Hold = 0 ein Hold plus annehmbares Angebot, ein widersprüchlicher Zustand. Den Weg „Auskunft → Buchungswunsch“ gibt es nicht. | Lücke, Teilfehler |
|
||
| L6 | Portalpreis ist maßgeblich, keine erfundene Zerlegung, Beträge mit Quelle | [PortalPrice](../../app/Pricing/PortalPrice.php) zerlegt den Portal-Gesamtpreis in eigene Positionen plus „Abweichung Portalpreis“. `payments` kennt nur Betrag, Datum, Methode und Notiz, aber weder „laut Portal bezahlt“, Auszahlung, Provision noch Gast-Servicegebühr. | Verstößt gegen E-014, E-015 und K01 |
|
||
| L7 | Verlauf mit Ursache, Initiator und Quelle (E-019) | Der Verlauf wird aus Zeitstempeln abgeleitet (`BookingProgress::history()`), es gibt kein gespeichertes Ereignisprotokoll. | Lücke |
|
||
| L8 | Portalstorno oder -änderung erreicht den Vorgang | [SyncChannel](../../app/Actions/SyncChannel.php) löscht verschwundene Spiegeleinträge. [ProcessPortalMail](../../app/Actions/ProcessPortalMail.php) gibt bei Storno-Mails nur Sperren mit Quelle E-Mail frei. Für einen gebuchten Vorgang entsteht **keine Aufgabe**, die Buchung bleibt still „bestätigt“. | Sicherheitsrelevante Lücke |
|
||
| L9 | A6 mit Gästen, Leistungen, Kurabgabe und Zahlungen; reine Sperre schlank | Sperren ([BlockedPeriodResource](../../app/Filament/Resources/BlockedPeriods/BlockedPeriodResource.php)) haben Zweck und Notiz, aber keinen Gast, keine Leistungen und keine Zahlung. Kurabgabe existiert nur als Vertragstext. | Lücke |
|
||
| L10 | **Änderung nach Verbindlichkeit** (X02, X08): Zeitraum, Gäste, Leistungen, Preis mit Folgen | Es gibt **keine Bearbeitungsseite und keine Änderungsaktion** für gebuchte Vorgänge (Booking-Seiten: List, Create, View). Nur „Zusatzleistungen erfassen“ und die Statusumschaltung [SetBookingStatus](../../app/Actions/SetBookingStatus.php), die den Ablauf umgeht. | **Neu erkannt**, wesentliche Lücke |
|
||
| L11 | Sperrnachweis: veranlasst / sichtbar / wirksam (E-018) | `ChannelTask` kennt nur offen / erledigt / verworfen. | Kleine Lücke (E-027 pragmatisch) |
|
||
| L12 | Dokument passend zum Sachverhalt, Zusammenstellung vor Versand | `ConfirmBooking::bind()` wählt die Vorlage still. Eine Dokumentart „Dokumentation einer extern verbindlichen Buchung“ und eine A6-Bestätigung fehlen. Der Angebotsdialog ist die einzige Zusammenstellung. | Lücke |
|
||
| L13 | Abschluss mit Nachläufern (P05, E-010) | Der Status `Completed` wird von [SendBookingReminders](../../app/Actions/SendBookingReminders.php) gesetzt. Nachläufer (offene Forderung, Schaden) sind nur als Zahlungsaufgaben abbildbar. Das Abschluss-Gate ist fachlich noch offen. | Später |
|
||
|
||
### 2.3 Befunde zur Bedienung
|
||
|
||
| # | Befund [Befund] | Wirkung |
|
||
|---|---|---|
|
||
| U1 | **Vier getrennte Arbeitslisten:** „Aufgaben“ (`BookingTask`), „Portal-Aufgaben“ (`ChannelTask`), „Postfach“ (`InboxMessage`), „Ungeklärte Belegungen“ (PortalOccupations). Hinzu kommen abgeleitete „nächste Schritte“ in der Akte. | Die Vermieterin muss wissen, in welcher Liste sie suchen soll. |
|
||
| U2 | Die Vorgangsseite [ViewBooking](../../app/Filament/Resources/Bookings/Pages/ViewBooking.php) hat 17 Kopfaktionen (u. a. Angebot senden, Kontaktdaten, Kontakt anfordern, Angebotslink, PDF, Direkt bestätigen, Ablehnen, Vormerkung verlängern, Bestätigung erneut, Leistungen, Vertragstext, Vertrag, Notizen, Status setzen, Archiv, Storno). Welche gerade sinnvoll ist, muss man selbst wissen. | Keine Führung, Fehlbedienung möglich (z. B. Status setzen statt Storno) |
|
||
| U3 | „Angebot senden“ ist ein großer Dialog: Zeitraum, Personen, Rabattcode, Preisanpassung, Vorlage, Anlagen, Gültigkeit, Nachricht und Gastadresse. Vorlage und Anlagen muss man aktiv wählen. | Überladen; Entscheidungen, die das System treffen kann |
|
||
| U4 | Die einfache Ansicht ([AdminMode](../../app/Enums/AdminMode.php)) blendet nur Menüpunkte aus. Die Seiten selbst zeigen in beiden Modi dieselben technischen Details. | Der Expertenmodus ist nur eine Menüfrage. |
|
||
| U5 | Begriffe aus dem Innenleben stehen in der Oberfläche: Vormerkung/Hold, Akte, Repräsentation, Ursprungskanal, Buchungsmodell, Echo-Verhalten, Exportmodus. | Setzt Systemkenntnis voraus |
|
||
| U6 | Sperren und Portalbelegungen liegen in eigenen Listen außerhalb der Vorgänge. Ein Klick im Kalender führt je nach Herkunft auf unterschiedliche Seiten. | Kein einheitlicher Einstieg |
|
||
|
||
### 2.4 Was fachlich brauchbar ist und erhalten bleibt [Befund]
|
||
|
||
- **Angebotskette:** [SendOffer](../../app/Actions/SendOffer.php), [AcceptOffer](../../app/Actions/AcceptOffer.php), [ConfirmBooking](../../app/Actions/ConfirmBooking.php), [RejectOffer](../../app/Actions/RejectOffer.php), [ExpireReservations](../../app/Actions/ExpireReservations.php). Dazu gehören Konditions-Snapshot (`offer_terms`), Hash, signierte Links, Annahmeprotokoll und Sperrlogik `lockForTransition()`.
|
||
- **Verfügbarkeit:** `Booking::occupying()`, [CalendarClearance](../../app/Availability/CalendarClearance.php) (Frischeprüfung vor Annahme), Mindestaufenthalt, Preisberechnung `PriceCalculator`.
|
||
- **Kanäle:** Connector-System `app/Channels`, iCal-Regelwerk, [ReconcileChannelRepresentations](../../app/Actions/ReconcileChannelRepresentations.php) (Spiegelungen), Portal-Mail-Erkennung, Kanalaufgaben samt Erinnerungen, Export-Feeds.
|
||
- **Owner-Zuordnung:** `origin_channel_id` und `import_channel_id` an Buchungen und Belegungen, mit Konsistenzprüfung in [HasChannelProvenance](../../app/Models/Concerns/HasChannelProvenance.php).
|
||
- **Weitere:**
|
||
- versionierte Vertragsvorlagen und Anlagen
|
||
- Stornoregeln mit Staffeln und `Cancellation`-Datensatz (Initiator, Gebühr)
|
||
- Zahlungen, Mailprotokoll `BookingMessage`
|
||
- Postfach mit Fingerabdruck und Erinnerungsintervall, Tages- und Wochenberichte
|
||
- Mehrmandantenfähigkeit, Admin-Modi, 2FA
|
||
- etwa 525 Tests
|
||
|
||
---
|
||
|
||
## 3. Empfohlene Zielrichtung
|
||
|
||
### 3.1 Der Vorgang ist die bestehende Buchung, fachlich erweitert [Empfehlung]
|
||
|
||
| Option | Bewertung |
|
||
|---|---|
|
||
| **A – `Booking` wird der Vorgang.** Fachlich heißt er in der Oberfläche „Vorgang“, technisch wird er erweitert. | **Empfohlen.** Nummernkreis, Gast, Leistungen, Preis, Zahlungen, Aufgaben, Mails, Dokumente, Storno und Sperrlogik sind vorhanden. Erweiterungen sind additiv. Alle Tests, signierten Links und eingefrorenen Konditionsstände bleiben gültig. |
|
||
| B – neue Tabelle `cases` über `Booking` und `BlockedPeriod` | Damit entstünde genau die zusätzliche Struktur, die E-023 und E-028 ausschließen. Alle Beziehungen müssten umziehen, ohne fachlichen Gewinn. |
|
||
|
||
Daraus folgt:
|
||
1. **Jeder Anlass ist eine `Booking`-Zeile**, auch A3–A5 und **A6** (Eigennutzung, private Überlassung, Wartung).
|
||
- Die Art wird über zwei Merkmale geführt: **Vorgangsart** (A1–A6 bzw. ein „Typ“) und **Eingangsart** (Anfrage / verbindliche Buchung / interner Anlass).
|
||
- Der technische Name `Booking` bleibt; die Oberfläche sagt „Vorgang“.
|
||
2. **`BlockedPeriod` wird reiner Kalendernachweis:** importierte Fremdbelegungen, Spiegelungen, E-Mail-Schnellsperren und ungeklärte Einträge.
|
||
- Eigene Gastzuordnung und manuelle Zweck-Sperren entfallen dort und wandern in den Vorgang.
|
||
- Ein Nachweis verweist auf „seinen“ Vorgang (`linked_booking_id` besteht bereits).
|
||
3. **Belegung = Wirkung eines Vorgangs:** Die Kalenderlogik (`occupying`) gilt einheitlich für A1-Hold, verbindliche Buchung und A6. Für A6 kommt keine eigene Mechanik dazu.
|
||
4. **Unbekannte Werte sind erlaubt:**
|
||
- Gast, Personenzahl und Beträge sind optional.
|
||
- Die Oberfläche zeigt „noch nicht bekannt“.
|
||
- Eine Aktion, die den Wert braucht, wartet mit einer Aufgabe darauf.
|
||
|
||
### 3.2 Einstellungen in drei Ebenen [Empfehlung, folgt E-029]
|
||
|
||
1. **Vermieterstandard** (Tenant): Bearbeitung automatisch oder „ich gebe frei“, Haltefrist, Zuständigkeiten, Anreise-Info-Vorlauf, Bewertungsanfrage, Standardvorlagen je Dokumentart.
|
||
2. **Kanalabweichung je Eingangsart:** Für jeden Kanal kann je Eingangsart einzeln überschrieben werden. „Nicht gesetzt“ bedeutet „wie Standard“ und ist von 0, „nein“ und „manuell“ unterscheidbar. Im Datenmodell heißt das `null` bedeutet erben.
|
||
3. **Vorgang:** Beim Entstehen wird das **wirksame Profil eingefroren** (Snapshot). Der Bearbeiter kann es im Vorgang übersteuern, z. B. auf „Diesen Vorgang selbst prüfen“; das wird im Verlauf protokolliert.
|
||
|
||
**Ersetzt werden dadurch:**
|
||
- `Channel::booking_model` als Steuergröße,
|
||
- die Booleans `payment_tasks_inquiry/reservation`,
|
||
- die beiden Vorlagen-IDs am Kanal,
|
||
- die Prozessfelder an der Wohnung.
|
||
|
||
Preis, Belegung, Mindestaufenthalt und objektspezifische Vertragsdaten bleiben an der Wohnung (02_Abwicklungsprofile: „Objektkontext beeinflusst Preis, Belegung und Vorlagenauswahl“).
|
||
|
||
**Technischer Hinweis:** Kanäle sind heute je Wohnung angelegt. Ein Vermieter mit drei Wohnungen auf FeWo-direkt hat drei Kanalzeilen. Die Kanalabweichung wird deshalb in der Oberfläche **einmal je Portal** gepflegt und auf alle Wohnungen dieses Portals angewendet. Eine Abweichung je Wohnung wäre eine zusätzliche Ebene, die v0.10 nicht vorsieht; siehe Entscheidung B2.
|
||
|
||
### 3.3 Aktivitäten, Aufgaben, Automatik, Freigabe [Empfehlung]
|
||
|
||
Eine Workflow-Engine ist nicht nötig. Das Modell:
|
||
|
||
- **Aktivitätenkatalog im Code**, nicht konfigurierbar, etwa 15 Aktivitäten, z. B.:
|
||
- Gastdaten vervollständigen
|
||
- Angebot senden / Auskunft senden
|
||
- Buchung bestätigen / Buchungsunterlagen senden
|
||
- Andere Portale sperren
|
||
- Anzahlung überwachen / Restzahlung anfordern
|
||
- Anreise-Info senden
|
||
- Bewertung anfragen
|
||
- Portalstorno prüfen
|
||
|
||
Jede Aktivität hat eine **Anwendbarkeitsregel**, die sich aus Profil und Vorgangsart ergibt (z. B. „Zahlung überwachen“ nur bei eigener Zahlungszuständigkeit), eine **Voraussetzung** (benötigte Daten) und eine **Ausführung** (bestehende Actions).
|
||
|
||
- **Zustand je Aktivität:** offen, erledigt (intern), extern erledigt (mit Quelle), nicht anwendbar, wartet auf Daten, widersprüchlich. Das entspricht genau den Gate-Ergebnissen aus [Gates](Querschnitt/Gates_und_Nachweise.md). Die Gates G1–G5 werden **nicht** als Statusmaschine gebaut, sondern aus diesen Zuständen abgeleitet.
|
||
|
||
- **Automatik:**
|
||
- Ein Hintergrundlauf (Scheduler plus direkte Auslösung nach Ereignissen) führt anwendbare Aktivitäten aus, sobald die Voraussetzungen erfüllt sind und der Modus „automatisch“ ist. Das ist eine Verallgemeinerung des bestehenden [AutoOffer](../../app/Actions/AutoOffer.php) mit seinen „Blockern“.
|
||
- Fehlt etwas, entsteht **eine** verständliche Aufgabe („E-Mail-Adresse des Gastes fehlt“).
|
||
- Bei Modus „ich gebe frei“ bereitet das System das Ergebnis vollständig vor (Preis, Dokument, Mail) und legt eine **Freigabe-Aufgabe** mit Vorschau an.
|
||
|
||
- **Fortsetzung nach einer Aufgabe:** Beim Erledigen fragt das System nur, wenn es relevant ist: „Danach automatisch weitermachen?“ (Vorbelegung aus dem Profil). Die Wahl gilt für diesen Vorgang.
|
||
|
||
- **Verbindlichkeitsschutz:** Ein bereits verbindlicher Vorgang (eigene Annahme oder extern verbindlich) kann durch keine Einstellung und keinen Abbruch in „unverbindlich“ zurückfallen. „Beenden“ führt dann in den Stornoweg (§4.6).
|
||
|
||
- **Neutralitätsregel (Auftrag §3.2):** Automatische Prüfauslöser sind nur objektive Kriterien: fehlende oder widersprüchliche Daten, unzustellbare Adresse, Belegungskonflikt, Spam-Schutz. Nationalität oder Herkunft werden **nie** als Prüfkriterium verwendet. Das wird als Regel im Code dokumentiert und mit einem Test abgesichert.
|
||
|
||
- **Gespeicherter Verlauf:** Jede Aktivität, Übersteuerung, Änderung und jedes Portalereignis schreibt einen Ereigniseintrag (wer/was/wann/Quelle/Ursache). Die heutige abgeleitete Historie entfällt.
|
||
|
||
### 3.4 Was zurückgebaut oder ersetzt wird [Empfehlung]
|
||
|
||
| Bestand | Maßnahme |
|
||
|---|---|
|
||
| `RecordPortalBooking` und Formularabschnitt „Buchungsweg“ | Entfällt; die Erfassung läuft über „Neu“ (§4.2). |
|
||
| Knopf „Akte anlegen“, `OpenPortalFile` | Die Logik wandert in den automatischen Eingang; der Knopf entfällt. |
|
||
| `AssignOccupationGuest` (Gast an Belegung) | Entfällt; der Gast hängt am Vorgang. |
|
||
| Zerlegungslogik `PortalPrice` | Ersetzt durch „Gesamtpreis laut Portal“ als belegte Position. |
|
||
| `Channel::booking_model`, Zahlungs-Booleans, Vorlagen-IDs am Kanal | Ersetzt durch das Profil (§3.2). |
|
||
| `BookingProgress` (abgeleitete Schritte und Historie) | Ersetzt durch Aktivitäten und gespeicherten Verlauf. |
|
||
| `SetBookingStatus` als freie Statusumschaltung | Nur noch im Expertenmodus mit Pflichtbegründung; normale Wege laufen über Aktionen. |
|
||
| Vier Arbeitslisten | Eine Liste „Zu erledigen“; technische Systemmeldungen bleiben im Expertenmodus sichtbar. |
|
||
| Manuelle Sperren als eigene Ressource | A6-Vorgang mit Schnellerfassung. |
|
||
|
||
**Nicht gebaut werden:** Workflow-Designer, frei konfigurierbare Schritte, ein Nachweis-Enum je Feld, eine Risiko-Engine, Revenue Management und V02-Funktionen.
|
||
|
||
---
|
||
|
||
## 4. UX- und Bedienkonzept
|
||
|
||
### 4.1 Prinzipien
|
||
|
||
1. **Die Frage „Was ist zu tun?“ steht vorn.** Die Startseite zeigt die Liste „Zu erledigen“ mit wenigen Einträgen in Alltagssprache, jeweils mit **einem** Hauptknopf.
|
||
2. **Eine Vorgangsseite für alles.** Ganz oben steht der Stand in einem Satz, z. B. „Gebucht über FeWo-direkt · Anzahlung vom Portal eingezogen · Anreise in 12 Tagen“. Darunter folgen der Kasten „Als Nächstes“ und eine Zeitleiste mit dem Erledigten.
|
||
3. **Nur sinnvolle Knöpfe.** Aktionen erscheinen nur, wenn sie im aktuellen Stand anwendbar sind. Es gibt drei feste Sekundäraktionen: **Ändern**, **Nachricht an Gast**, **Beenden**.
|
||
4. **Das System entscheidet, was es entscheiden kann.** Vorlage, Anlagen, Fristen, Preise und Zuständigkeit ergeben sich aus dem Profil. Die Vermieterin sieht das Ergebnis in der Vorschau und kann es nur bei Bedarf ändern (Bereich „Anpassen“, standardmäßig zugeklappt).
|
||
5. **Unbekannt wird sichtbar gemacht.** Fehlende Angaben erscheinen als „noch nicht bekannt“ mit dem Hinweis, wofür sie gebraucht werden. Es gibt keine Pflichtfelder auf Vorrat.
|
||
6. **Klartext statt Interna.**
|
||
|
||
| Statt | Sagen wir |
|
||
|---|---|
|
||
| Hold | „Zeitraum reserviert bis …“ |
|
||
| Repräsentation | „im Kalender von …“ |
|
||
| Status `OfferSent` | „Angebot liegt beim Gast“ |
|
||
|
||
7. **Die Expertenansicht ist dieselbe Seite mit mehr Details.** Sie zeigt zusätzlich Kanalnachweise, Rohdaten, Versionen, Hashes, Regeln und Systemmeldungen. Es entstehen keine zwei Anwendungen: dieselben Seiten mit Abschnitten, die in der einfachen Ansicht ausgeblendet sind.
|
||
8. **Automatik bleibt sichtbar und steuerbar.**
|
||
- Jede Vorgangsseite zeigt „Wird automatisch bearbeitet“ oder „Sie geben jeden Schritt frei“, mit einem Umschalter für diesen Vorgang.
|
||
- Automatisch Erledigtes steht in der Zeitleiste mit „automatisch“ gekennzeichnet.
|
||
|
||
**Menü in der einfachen Ansicht (Vorschlag):**
|
||
- Start (Zu erledigen)
|
||
- Kalender
|
||
- Vorgänge
|
||
- Gäste
|
||
- Preise
|
||
|
||
Alles andere steht im Expertenmenü oder unter „Einstellungen“.
|
||
|
||
### 4.2 Benutzerweg: Neue Anfrage (A1, A2)
|
||
|
||
1. **Eingang**
|
||
- Eine Website-Anfrage erzeugt den Vorgang automatisch, wie heute.
|
||
- Telefon, E-Mail oder eine Portalanfrage erfasst die Vermieterin über **Neu → „Anfrage“**: Zeitraum, Personen (optional), Name und Kontakt (so weit bekannt), Kanal.
|
||
2. **Automatische Vorbereitung**
|
||
- Verfügbarkeit prüfen.
|
||
- Haltefrist laut Profil:
|
||
- Bei > 0 wird der Zeitraum reserviert und andere Portale werden gesperrt (automatisch oder als Aufgabe).
|
||
- Bei 0 wird nichts reserviert.
|
||
- Preis berechnen, Dokument vorbereiten (Angebot oder Auskunft).
|
||
3. **Modus automatisch:** Das System versendet und vermerkt in der Zeitleiste „Angebot automatisch gesendet“. Die Startseite meldet das nur zur Information.
|
||
4. **Modus „ich gebe frei“** (oder es fehlt etwas): Unter „Zu erledigen“ erscheint z. B.:
|
||
- **„Angebot an Frau Meier prüfen“** mit dem Knopf „Ansehen & senden“. Das öffnet die **Zusammenstellung** (§4.5).
|
||
- **„E-Mail-Adresse von Frau Meier fehlt“** mit dem Knopf „Eintragen“. Nach dem Speichern fragt das System: „Angebot jetzt automatisch senden?“
|
||
5. **Gast nimmt an** (Hold > 0): Der Vorgang wird gebucht, ohne zweite Freigabe (E-003). Bestätigung, Vertrag und Zahlungsplan laufen automatisch.
|
||
6. **Gast äußert Buchungswunsch** (Hold = 0): Erneute Prüfung, dann entweder automatische Bestätigung oder die Aufgabe „Buchungswunsch von Frau Meier bestätigen?“ mit „Bestätigen / Ablehnen“ (E-030).
|
||
7. **Ablauf oder Ablehnung:** Der Vorgang endet automatisch mit „ohne Buchung beendet“. Die Reservierung wird freigegeben, auf der Startseite erscheint nur ein Hinweis.
|
||
|
||
### 4.3 Benutzerweg: Externe Direktbuchung (A3–A5)
|
||
|
||
1. **Eingang:** Eine Portal-Mail oder eine sicher erkannte iCal-Reservierung erzeugt **automatisch** einen Vorgang „Gebucht über FeWo-direkt“. Mehrfachmeldungen werden zusammengeführt. Bei Portalen ohne Automatik erfasst die Vermieterin die Buchung über **Neu → „Buchung von einem Portal“**: Portal, Buchungsnummer, Zeitraum, Gesamtpreis laut Portal, Gast so weit bekannt.
|
||
2. **Unklare Kalendereinträge** werden nicht zum Vorgang. Sie erscheinen als Aufgabe „Unbekannte Belegung von FeWo-direkt 10.–17.07. – was ist das?“ mit den Antworten „Buchung“, „eigene Sperre/Spiegelung“, „ignorieren“.
|
||
3. **Folgeaufgaben gemäß Profil:**
|
||
- „Andere Portale sperren“, nur wo nötig
|
||
- „Gastdaten aus dem Portal ergänzen“
|
||
- „Buchungsunterlagen senden“ (A3/A4, mit Vorschau)
|
||
- „Zahlungen überwachen“, nur wenn wir zuständig sind; bei A4 steht „Zahlung über FeWo-direkt“ als extern verantwortet
|
||
4. **Keine Annahme, kein Angebot, kein eigener Preis.** Der Portalpreis steht als „Gesamtpreis laut Portal“ im Vorgang. Unbekannte Bestandteile stehen als „nicht übermittelt“.
|
||
5. **Storno oder Änderung im Portal erkannt:** Es entsteht die Aufgabe „FeWo-direkt meldet Stornierung – prüfen“. Ein Klick übernimmt die Stornierung in den Vorgang mit Initiator „Gast über Portal“ und den Folgen.
|
||
|
||
### 4.4 Benutzerweg: Eigene Nutzung, Besuch, Wartung (A6)
|
||
|
||
- **Neu → „Eigene Nutzung / Besuch“:** Zeitraum, Anlass, optional Gäste, Leistungen (Wäsche, Kurabgabe), Betrag (Miete 0 ist Standard). Optional wird eine Bestätigung an die Gäste gesendet. Zahlungen sind optional.
|
||
- **Neu → „Sperre (z. B. Wartung)“**, auch per Markieren eines Zeitraums im Kalender: nur Zeitraum und Grund. Es gibt weder Gast noch Dokument noch Zahlung. Portale werden gesperrt (automatisch oder als Aufgabe).
|
||
- **Ändern / Aufheben** auf derselben Vorgangsseite. Aufheben ist **keine** Stornierung, sondern „Sperre aufgehoben“; die Portale werden entsperrt.
|
||
|
||
### 4.5 Freigabe: die Zusammenstellung
|
||
|
||
**Eine** wiederverwendbare Ansicht für alle Dokumente: Angebot, Auskunft, Buchungsbestätigung, Buchungsunterlagen extern, A6-Bestätigung, Storno- und Änderungsbestätigung. Sie zeigt Gast, Zeitraum, Preis mit Quelle, Leistungen, Stornoregel, die gewählte Vorlage (Name, nicht ID) und die Anlagen sowie eine **PDF- und Mail-Vorschau**.
|
||
|
||
Knöpfe:
|
||
- **„Senden“**
|
||
- **„Anpassen“**: klappt Felder auf, mit Neuberechnung und neuer Vorschau
|
||
- **„Nicht senden“**: mit der Frage, ob die Aktivität entfällt oder später kommt
|
||
|
||
Für extern verbindliche Buchungen markiert die Zusammenstellung, wenn die gewählte Vorlage Pflichten enthält, die nicht nachweislich vereinbart sind (E-004). Sie sperrt nicht hart, verlangt aber eine bewusste Bestätigung.
|
||
|
||
### 4.6 Bestehende Vorgänge: Ändern und Beenden
|
||
|
||
- **„Ändern“** (Zeitraum, Personen, Leistungen, Preis):
|
||
- **vor der Verbindlichkeit:** neue Angebotsversion, wie heute;
|
||
- **danach:** Änderungserfassung mit Antragsteller, Grund und wirksam ab, mit automatischer Folgenanzeige vor dem Speichern:
|
||
- Kalender und Portalsperren,
|
||
- Preisdifferenz (A1/A2: neu berechnen und anzeigen; A3–A5: Portalbetrag eintragen),
|
||
- Zahlungsplan,
|
||
- neue Bestätigung ja/nein.
|
||
- **„Beenden“** fragt **eine** Sache: „Warum?“. Das System leitet den passenden Weg ab:
|
||
|
||
| Stand | Ergebnis |
|
||
|---|---|
|
||
| Unverbindlich | „ohne Buchung beendet“ (Absage an den Gast optional) |
|
||
| Verbindlich, eigene Buchung | Stornodialog mit Initiator (Gast / Vermieter), Stornokosten laut eingefrorener Regel, Erstattungsaufgabe |
|
||
| Verbindlich, extern (A3–A5) | Stornodialog plus Hinweis bzw. Aufgabe „Stornierung im Portal veranlassen/prüfen“; lokal wird nichts still gelöscht |
|
||
| A6 | „Sperre aufheben“ bzw. „Aufenthalt abgesagt“ |
|
||
|
||
---
|
||
|
||
## 5. Priorisierter Umsetzungsplan
|
||
|
||
### 5.1 Übersicht und Reihenfolge
|
||
|
||
```
|
||
Stufe 1 (Grundlagen) Stufe 2 (Kernfunktionen) Stufe 3 (Ergänzung)
|
||
┌──────────────┐ ┌────────────────────┐ ┌──────────────────────┐
|
||
│ 1 Vorgangs- │─▶│ 2 Geführte Vor- │─┬▶│ 3 Zusammenstellung & │─┬▶ 7 Hold 0 / Buchungswunsch
|
||
│ kern & │ │ gangsbearbeitung │ │ │ Dokumente │ │
|
||
│ Einstellung│ │ (Aufgaben, Auto- │ │ └──────────────────────┘ ├▶ 8 Externe Beträge & Zahlungsstände
|
||
└──────────────┘ │ matik, Seite) │ ├▶ 4 Ein Eingang für alle Kanäle (A2–A5) ┘
|
||
└────────────────────┘ ├▶ 5 Änderung, Storno, Abbruch
|
||
└▶ 6 A6 im Vorgang ──▶ 9 Aufenthalt & Abschluss
|
||
```
|
||
|
||
| # | Paket | Stufe | Abhängig von | Archetypen / Phasen | Größe |
|
||
|---|---|---|---|---|---|
|
||
| 1 | Vorgangskern und Einstellungen | Grundlage | – | alle / P01–P03 | groß |
|
||
| 2 | Geführte Vorgangsbearbeitung | Grundlage | 1 | alle / P01–P05 | groß |
|
||
| 3 | Zusammenstellung und Dokumente | Kern | 2 | A1–A4, A6 / P02–P03 | mittel |
|
||
| 4 | Ein Eingang für alle Kanäle | Kern | 2 (für Vollabnahme A3: 3) | A2–A5 / P01–P03 | groß |
|
||
| 5 | Änderung, Storno, kontrollierter Abbruch | Kern | 2, 3 | alle / X01–X04, X08 | mittel–groß |
|
||
| 6 | A6 im Vorgang | Kern | 2, 3 | A6 / P01–P05 | mittel |
|
||
| 7 | Angebotsweg Hold 0 und Buchungswunsch | Kern (spät) | 3 | A1, A2 / P01–P02 | mittel |
|
||
| 8 | Externe Beträge und Zahlungsstände | Ergänzung | 4 | A3–A5 / P03 | mittel |
|
||
| 9 | Aufenthalt und Abschluss | Ergänzung | 2, 6; Entscheidung B4 | alle / P04–P05 | mittel |
|
||
|
||
Die Pakete 4, 5 und 6 können nach 3 parallel laufen, wenn getrennte Agenten an getrennten Dateien arbeiten (siehe [ZUSAMMENARBEIT](../ZUSAMMENARBEIT.md)). Paket 7 kommt bewusst später: Der heutige A1-Weg mit Hold > 0 funktioniert. Paket 7 wird nur vorgezogen, wenn ein Vermieter bald Hold = 0 nutzen will (Entscheidung B5).
|
||
|
||
### 5.2 Paket 1: Vorgangskern und Einstellungen (konkret)
|
||
|
||
**Fachliches Ziel:** Jeder Anlass lässt sich als Vorgang führen, ohne erfundene Daten. Das System weiß für jeden Vorgang, **was für ein Fall er ist** und **welche Regeln für ihn gelten**.
|
||
|
||
**Veränderungen gegenüber dem Ist:**
|
||
- Gast, Personenzahl und Beträge des Vorgangs werden optional. Vorhandene Platzhalter-Gäste („Gast (Portal)“ ohne Kontaktdaten) werden vom Vorgang gelöst und gelöscht, sofern sie nirgends sonst hängen.
|
||
- Neue Merkmale am Vorgang: **Vorgangsart** (A1–A6) und **Eingangsart**. Bestehende Vorgänge werden aus `source`, Kanal und Status abgeleitet.
|
||
- **Einstellungshierarchie** nach §3.2:
|
||
- Vermieterstandards neu am Tenant.
|
||
- Kanalabweichung je Eingangsart mit „nicht gesetzt = erben“, bearbeitet je Portal.
|
||
- Wirksames Profil als eingefrorener Snapshot am Vorgang.
|
||
- Ein Profil-Resolver ersetzt alle vier Auswertungen von `booking_model`.
|
||
- Migration der Prozessfelder von der Wohnung an den Tenant. Weichen Wohnungen eines Vermieters voneinander ab, wird der häufigste Wert Standard und die Abweichung gemeldet (siehe B2).
|
||
- **Gespeicherter Verlauf** (Ereignisprotokoll). Bestehende Zeitstempel werden einmalig als Startereignisse übernommen.
|
||
- Zuständigkeitsschalter im Profil: Vertrag/Dokumente, Gastkommunikation, Zahlungseinzug, Mahnung, Storno/Erstattung, Kalenderpflege.
|
||
- **Oberfläche:** neue, einfache Einstellungsseite „So arbeite ich“ (Vermieterstandard) und „Abweichungen für dieses Portal“. Beide sind kurz, mit Klartext-Fragen statt Feldnamen.
|
||
|
||
**Bewusst noch nicht:** neue Vorgangsseite (Paket 2), automatische Portalvorgänge (Paket 4).
|
||
|
||
**Risiken:**
|
||
- `guest_id` nullable berührt alle Stellen, die `$booking->guest->…` lesen: Mails, PDFs, Tabellen, Exporte. Abhilfe: vorher alle Zugriffe ermitteln und gezielt absichern.
|
||
- Eine Fehlmigration der Einstellungen könnte das Verhalten bestehender Wohnungen ändern (z. B. automatische Angebote). Abhilfe: Trockenlauf mit Vorher/Nachher-Bericht je Vermieter.
|
||
|
||
**Abnahme:** §6, Paket 1.
|
||
|
||
### 5.3 Paket 2: Geführte Vorgangsbearbeitung (konkret)
|
||
|
||
**Fachliches Ziel:** Die Vermieterin sieht auf einen Blick, was vorliegt, was erledigt ist und was als Nächstes zu tun ist. Das System erledigt, was es darf, und fragt nur, wo es muss.
|
||
|
||
**Veränderungen:**
|
||
- Aktivitätenkatalog mit Anwendbarkeit, Voraussetzungen und Zuständen (§3.3). Bestehende Actions werden als Ausführung angebunden.
|
||
- **Automatiklauf** als Verallgemeinerung von `AutoOffer` und der Erinnerungs- und Zahlungs-Jobs:
|
||
- Er führt aus, was automatisch darf.
|
||
- Andernfalls erzeugt er eine Aufgabe in Alltagssprache (aus den heutigen „Blocker“-Texten).
|
||
- **Eine Liste „Zu erledigen“** als Startseite:
|
||
- Sie fasst Vorgangsaufgaben (heute `BookingTask`), Kanalaufgaben (heute `ChannelTask`) und klärungsbedürftige Belegungen zusammen.
|
||
- Technische Systemmeldungen (Sync-Fehler) erscheinen dort nur, wenn eine Handlung möglich ist; sonst stehen sie im Expertenmodus.
|
||
- Ob die Tabellen technisch zusammengelegt oder nur gemeinsam angezeigt werden, entscheidet der Agent; die fachliche Anforderung ist **eine** Liste.
|
||
- **Neue Vorgangsseite** nach §4.1: Stand in einem Satz, „Als Nächstes“, Zeitleiste aus dem Verlauf, Bereiche Gast / Preis & Zahlungen / Dokumente / Kalender & Portale, Umschalter „automatisch / ich gebe frei“. Kontextabhängige Knöpfe ersetzen die 17 Kopfaktionen.
|
||
- **Neu-Dialog** mit vier Einstiegen (Anfrage, Buchung von einem Portal, Eigene Nutzung/Besuch, Sperre). In diesem Paket wird er zunächst für Anfragen und die manuelle Portalbuchung umgesetzt (die Logik aus `RecordPortalBooking` wandert hierher, der Formularabschnitt „Buchungsweg“ entfällt).
|
||
- Ein Klick im Kalender führt immer auf den Vorgang (bzw. auf die Klärungsaufgabe bei unklaren Einträgen).
|
||
- Die einfache Ansicht blendet technische Abschnitte auf den Seiten aus, nicht nur Menüpunkte.
|
||
- Einfaches Menü nach §4.1.
|
||
|
||
**Risiken:**
|
||
- Größter Eingriff in die gewohnte Oberfläche. Abhilfe: Die alte Akte bleibt im Expertenmenü erreichbar, bis die Abnahme mit der Vermieterin erfolgt ist.
|
||
- Die Automatik darf keine doppelten Mails erzeugen. Abhilfe: bestehende Idempotenz (Zeitstempel je Aktivität) beibehalten.
|
||
|
||
### 5.4 Paket 3: Zusammenstellung und Dokumente
|
||
|
||
**Ziel:** Vor jedem Dokument sieht und ändert man dasselbe Bild, und das richtige Dokument kommt automatisch.
|
||
|
||
**Veränderungen:**
|
||
- Die Zusammenstellung nach §4.5 löst den Angebotsdialog ab.
|
||
- Dokumentarten: bindendes Angebot, Auskunft unter Vorbehalt (Text folgt in Paket 7), Buchungsbestätigung eigener Buchung, **Buchungsdokumentation extern verbindlich** (ohne Annahmelink, E-004), A6-Aufenthaltsbestätigung, interne Bestätigung.
|
||
- Vorlagen und Anlagen werden über das Profil je Dokumentart gewählt; `ConfirmBooking` wählt nicht mehr still.
|
||
- Vorlagenkonflikt-Hinweis für extern verbindliche Buchungen.
|
||
|
||
**Abhängigkeit:** Die Texte der neuen Dokumentarten liefert der Betreiber (§8.4). Bis dahin gibt es neutrale Arbeitsfassungen, die im Live-Modus gesperrt sind (wie heute bei `contractTextsReleased()`).
|
||
|
||
### 5.5 Paket 4: Ein Eingang für alle Kanäle
|
||
|
||
**Ziel:** Externe Direktbuchungen und Portalanfragen werden ohne Umweg zum Vorgang mit dem richtigen Profil, und Portalereignisse erreichen den Vorgang.
|
||
|
||
**Veränderungen:**
|
||
- Sicher erkannte Reservierungen (Portal-Mail oder iCal-Regel mit Ergebnis „Buchung“) erzeugen **automatisch** einen Vorgang (Logik aus `OpenPortalFile`).
|
||
- **Dublettenregel:** Portalreferenz, dann Kanal mit Zeitraum, dann vorhandene Spiegelung. Unsichere Fälle erzeugen eine Klärungsaufgabe.
|
||
- Pro Kanal gibt es einen Schalter „Vorgänge automatisch anlegen“ mit vorgeschaltetem **Beobachtungsmodus** (protokolliert nur, was entstehen würde).
|
||
- Der Portalpreis wird als „Gesamtpreis laut Portal“ mit Quelle übernommen; die `PortalPrice`-Zerlegung entfällt.
|
||
- **Portalstorno oder -änderung** (Mail-Typ Storno, verschwundener iCal-Eintrag eines gebuchten Vorgangs) erzeugt eine Aufgabe am Vorgang. Es gibt keine automatische Stornierung (E-019).
|
||
- **Sperrnachweis in drei Stufen** für Kanalaufgaben: veranlasst / im Zielportal gesehen (optional mit Notiz oder Bild) / wirksam bestätigt (E-018).
|
||
- Bestehende verknüpfte Portalbelegungen ohne Vorgang werden per Befehl mit Trockenlauf nachgezogen.
|
||
- `AssignOccupationGuest`, „Akte anlegen“ und die Liste „Ungeklärte Belegungen“ als eigene Seite entfallen.
|
||
|
||
**Risiken:** Eingriff in den 5-Minuten-Sync (siehe §7).
|
||
|
||
### 5.6 Paket 5: Änderung, Storno, kontrollierter Abbruch
|
||
|
||
**Ziel:** Jeder Vorgang lässt sich nachvollziehbar ändern und beenden, mit den richtigen Folgen und ohne Verbindlichkeiten zu ignorieren.
|
||
|
||
**Veränderungen:**
|
||
- Aktion „Ändern“ für gebuchte Vorgänge nach §4.6, mit Folgenvorschau: Kalender, Portalsperren, Preis, Zahlungsplan, neue Bestätigung.
|
||
- Aktion „Beenden“ mit der Weichenlogik aus §4.6.
|
||
- Der bestehende Stornoweg (`CancelBooking`, `Cancellation`, Stornoregel-Snapshot) wird um Ursache, Ausführenden und „wirksam ab“ ergänzt und für A3–A5 um die Portalaufgabe.
|
||
- `SetBookingStatus` wandert in den Expertenmodus und verlangt eine Begründung.
|
||
- No-show, Verlängerung und vorzeitige Abreise (X08) laufen als Sonderfälle von „Ändern“.
|
||
|
||
### 5.7 Paket 6: A6 im Vorgang
|
||
|
||
**Ziel:** Eigennutzung, private Überlassung und Wartung laufen im selben Vorgang, mit genau so vielen Schritten wie nötig.
|
||
|
||
**Veränderungen:**
|
||
- Neu-Einstiege „Eigene Nutzung / Besuch“ und „Sperre“ sowie ein Kalender-Schnellweg.
|
||
- Das A6-Profil schaltet Vertrag, Zahlungsmahnung, Bewertung und Marketing aus. Zahlung und Bestätigung sind optional.
|
||
- **Kurabgabe** als Leistung mit vom Vermieter gepflegtem Satz, nicht als Produktkonstante (Offene_Fragen; B1).
|
||
- Bestehende manuelle Sperren (`BlockedPeriod` mit Quelle manuell) werden per Migration mit Trockenlauf zu A6-Vorgängen. Exportfeeds und Kanalaufgaben bleiben unverändert wirksam.
|
||
|
||
### 5.8 Paket 7: Angebotsweg Hold 0 und Buchungswunsch
|
||
|
||
**Ziel:** E-026 und E-030 vollständig umsetzen.
|
||
|
||
**Veränderungen:**
|
||
- Bei Hold = 0 gibt es keine Reservierung und kein annehmbares Angebot. Stattdessen „Auskunft unter Vorbehalt“ mit signiertem Link **„Buchung anfragen“**, danach erneute Verfügbarkeits- und Kalenderprüfung (`CalendarClearance`) und Bestätigung automatisch oder per Freigabe.
|
||
- Bei Hold > 0 bleiben Angebotsfrist und Hold gleich lang, wie heute (P01: „dürfen nicht widersprüchlich enden“).
|
||
- Der heutige Widerspruch „Vorreservierung aus, aber Angebot erzeugt Hold“ (L5) wird beseitigt.
|
||
- Konfliktfall: Der Buchungswunsch kommt, nachdem der Zeitraum anderweitig vergeben wurde. Der Gast bekommt eine freundliche Absage oder Alternativen; die Vermieterin erhält einen Hinweis.
|
||
|
||
### 5.9 Paket 8: Externe Beträge und Zahlungsstände
|
||
|
||
**Ziel:** K01 und [Preise_und_Zahlungen](Querschnitt/Preise_und_Zahlungen.md) abbilden, ohne Scheingenauigkeit.
|
||
|
||
**Veränderungen:**
|
||
- Je Vorgang beliebig viele **Beträge mit Art, Quelle und Zeitpunkt**: Gastgesamtbetrag laut Portal, Übernachtung, Rabatt, Sammelposten „Gebühren und Steuern“, Vermieterprovision, angekündigte Auszahlung, tatsächlicher Eingang. Die Art „ungeklärt“ ist zulässig, widersprüchliche Werte bleiben nebeneinander stehen.
|
||
- Zahlungen erhalten Art und Quelle: Gast an uns / Gast über Portal (laut Portal bezahlt) / Portal-Auszahlung / Erstattung.
|
||
- Die Anzeige „offener Betrag“ unterscheidet nach Zuständigkeit.
|
||
- Erleichterte manuelle Erfassung aus der Portalansicht („Werte aus FeWo-direkt eintragen“).
|
||
|
||
### 5.10 Paket 9: Aufenthalt und Abschluss
|
||
|
||
**Ziel:** P04 und P05 vollständig nach Profil.
|
||
|
||
**Veränderungen:**
|
||
- Anreisedaten-Prüfung als Aktivität: nötige Kontaktdaten, Anreisezeit.
|
||
- Lokale Leistungen und Dienstleisteraufgaben (Reinigung, Schlüssel, Wäsche) als Aktivitäten im Vorgang, keine Personaldisposition.
|
||
- Externe Versandzuständigkeit (Portal-Anreisenachricht) als „extern verantwortet“.
|
||
- Abschluss nach dem Gate aus Entscheidung B4. **Nachläufer** (offene Forderung, Schaden, Auszahlungsdifferenz) bleiben als zugewiesene Aufgaben am abgeschlossenen Vorgang.
|
||
- Bewertung nur, wo anwendbar.
|
||
- Melde- und Abgabefelder nach rechtlicher Klärung (Offene_Fragen).
|
||
|
||
---
|
||
|
||
## 6. Fachliche Abnahmekriterien
|
||
|
||
Abgenommen wird auf der **Testumgebung** mit nachgestellten Fällen. Jedes Kriterium beschreibt beobachtbares Verhalten. Die Kennungen werden in den Abnahmeprotokollen verwendet.
|
||
|
||
### Paket 1: Vorgangskern und Einstellungen
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 1.1 | Bestehende Vorgänge nach Migration | Alle Website-Buchungen, Angebote, Annahmen und Verträge sind unverändert abrufbar. Ein noch offener Angebotslink funktioniert weiter. Jeder Vorgang zeigt eine Vorgangsart. |
|
||
| 1.2 | Portalvorgang ohne Gastdaten | Ein FeWo-direkt-Vorgang ohne bekannte Gastdaten zeigt „Gast: noch nicht bekannt“. Es gibt keinen Gast „Gast (Portal)“ und keine geschätzte Personenzahl. |
|
||
| 1.3 | Vermieterstandard | Die Vermieterin stellt „Reservierung bei Anfragen: 48 Stunden“ und „Angebote: ich gebe frei“ ein. Eine neue Website-Anfrage reserviert 48 Stunden und wartet auf Freigabe. |
|
||
| 1.4 | Kanalabweichung, „nicht gesetzt“ | Für FeWo-direkt-Anfragen ist keine Haltefrist gesetzt: Es gelten die 48 Stunden des Standards. Wird für FeWo-direkt ausdrücklich „0“ gesetzt, gilt 0. Die Einstellungsseite zeigt beide Fälle unterscheidbar („wie Standard (48 h)“ gegenüber „0 Stunden“). |
|
||
| 1.5 | Gemischter Kanal | Ein Portal liefert eine Anfrage und eine verbindliche Buchung. Die Vorgänge bekommen unterschiedliche Vorgangsarten und unterschiedliche Vorlagen bzw. Zuständigkeiten. |
|
||
| 1.6 | Profil eingefroren | Eine Einstellung wird nach Entstehen eines Vorgangs geändert. Der bestehende Vorgang behält sein Verhalten, ein neuer Vorgang nutzt die neue Einstellung. Beides ist im Verlauf erkennbar. |
|
||
| 1.7 | Verlauf | Jede Statusänderung, jeder Versand und jede Übersteuerung erscheint im Verlauf mit wer/wann/warum, auch nach erneutem Laden und unabhängig von späteren Datenänderungen. |
|
||
|
||
### Paket 2: Geführte Vorgangsbearbeitung
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 2.1 | **A1 automatisch** | Website-Anfrage bei Modus automatisch und Hold > 0: Ohne Klick wird reserviert, das Angebot versendet und die Portalsperre angestoßen. Die Startseite zeigt keine Pflichtaufgabe, die Zeitleiste zeigt alle Schritte als „automatisch“. |
|
||
| 2.2 | **A1 manuell** | Dieselbe Anfrage bei „ich gebe frei“: Auf der Startseite erscheint „Angebot an … prüfen“. Ein Klick zeigt das fertig vorbereitete Angebot, ein weiterer Klick sendet es. |
|
||
| 2.3 | **Fehlende Daten** | Website-Anfrage ohne E-Mail-Adresse (telefonisch erfasst) bei Modus automatisch: Der Vorgang hält an, die Aufgabe heißt „E-Mail-Adresse von … fehlt“. Nach dem Eintragen fragt das System „Automatisch weitermachen?“. Bei „Ja“ geht das Angebot ohne weiteren Klick hinaus, bei „Nein“ erscheint eine Freigabe-Aufgabe. |
|
||
| 2.4 | **A1 durchgängig** | Anfrage → Angebot → Annahme durch den Gast → Bestätigung, Vertrag und Zahlungsplan → Anzahlungserinnerung → Anreise-Info → Abreise → Bewertungsanfrage. Alles läuft in **einem** Vorgang ohne Medienbruch und ist in der Zeitleiste nachvollziehbar. |
|
||
| 2.5 | **Vereinfachte Bedienung** | Eine Person ohne Systemkenntnis (Abnahme mit der Vermieterin) beantwortet für drei vorbereitete Vorgänge ohne Hilfe: Wie ist der Stand? Was muss ich als Nächstes tun? Was kann ich entscheiden? Auf der Vorgangsseite erscheinen nur anwendbare Knöpfe. |
|
||
| 2.6 | Eine Liste | Alle Handlungsbedarfe (Freigaben, fehlende Daten, Portal sperren, unklare Belegung) stehen in „Zu erledigen“. Es gibt keine weitere Liste, die man im Normalbetrieb kennen muss. |
|
||
| 2.7 | Expertenansicht | In der Expertenansicht zeigt dieselbe Vorgangsseite zusätzlich Kanalnachweise, Rohdaten und Versionen. In der einfachen Ansicht sind diese Abschnitte nicht sichtbar. |
|
||
| 2.8 | Neutralität | Kein automatischer Prüfauslöser verwendet Nationalität, Land oder Namen. Ein ausländischer Gast mit vollständigen Daten läuft identisch durch. |
|
||
|
||
### Paket 3: Zusammenstellung und Dokumente
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 3.1 | Vorschau vor Versand | Vor jedem Dokumentversand ist dasselbe Prüfbild sichtbar: Gast, Zeitraum, Preis mit Quelle, Leistungen, Stornoregel, Vorlage, Anlagen, PDF und Mail. Eine Anpassung (z. B. Nachlass) aktualisiert die Vorschau sofort. |
|
||
| 3.2 | Richtige Vorlage automatisch | Website-Anfrage → bindendes Angebot mit Annahmelink. Verbindliche FeWo-direkt-Buchung → Buchungsdokumentation **ohne** Annahmelink mit der für dieses Portal und diese Eingangsart hinterlegten Vorlage. Beides geschieht ohne manuelle Vorlagenwahl. |
|
||
| 3.3 | Kein stiller Pflichtenzuwachs | Enthält die Vorlage für eine extern verbindliche Buchung eine nicht nachgewiesene Gebühr, weist die Zusammenstellung darauf hin und verlangt eine bewusste Bestätigung. |
|
||
|
||
### Paket 4: Ein Eingang für alle Kanäle
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 4.1 | **A3 – Destination Solutions** | Eine verbindliche DS-Buchung wird manuell über „Buchung von einem Portal“ erfasst (Portal, Nummer, Zeitraum, Gesamtpreis, Gast). Ergebnis: ein Vorgang „gebucht“ ohne Angebot und ohne Annahme. Aufgaben: „Andere Portale sperren“, „Buchungsunterlagen senden“ (Vorschau, Paket 3), Zahlungsplan und -überwachung durch uns, Gastkommunikation über unsere Mails. Der Preis ist der Portalpreis. |
|
||
| 4.2 | **A4 – FeWo-direkt, Eingang** | Eine FeWo-direkt-Buchungsmail erzeugt ohne Klick einen Vorgang. Ein späterer iCal-Eintrag desselben Falls erzeugt **keinen** zweiten Vorgang. Die Zahlung steht als „über FeWo-direkt“ und erzeugt keine eigenen Mahnungen. Fehlende Adresse erzeugt nur dann eine Aufgabe, wenn ein eigenes Dokument sie braucht. |
|
||
| 4.3 | Unklare Belegung | Ein iCal-Eintrag ohne Erkennung wird kein Vorgang. Es entsteht eine Aufgabe „Was ist das?“; die Antwort „Buchung“ legt den Vorgang an. |
|
||
| 4.4 | Portalstorno | Eine FeWo-direkt-Stornomail oder ein verschwundener iCal-Eintrag zu einem gebuchten Vorgang erzeugt die Aufgabe „Stornierung prüfen“. Der Vorgang bleibt gebucht, bis die Vermieterin übernimmt. |
|
||
| 4.5 | Sperrnachweis | Bei Portalen mit manueller Sperrpflicht erscheint „In Portal X sperren“. Erledigen erlaubt „gesperrt“ und optional „im Portal geprüft“ mit Notiz. Die Vorgangsseite zeigt den Nachweisgrad. |
|
||
| 4.6 | Beobachtungsmodus | Mit aktivem Beobachtungsmodus entstehen keine Vorgänge, aber ein Bericht listet, welche entstanden wären. |
|
||
| 4.7 | **A2 – Portalanfrage** | Eine unverbindliche Portalanfrage mit unvollständigen Daten wird als Anfrage erfasst. Das System fordert gezielt die fehlenden Daten an und läuft danach wie A1 (2.1 bis 2.3). |
|
||
|
||
### Paket 5: Änderung, Storno, kontrollierter Abbruch
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 5.1 | **Änderung nach Buchung (A1)** | Der Gast verlängert um 2 Nächte. Die Vermieterin wählt „Ändern“ und sieht vor dem Speichern: Kalender frei, Mehrpreis, neue Restzahlung, Portalsperren werden angepasst, neue Bestätigung (Vorschau). Nach dem Speichern sind Kalender, Portalexport bzw. Sperraufgaben, Zahlungsplan und Verlauf aktualisiert. |
|
||
| 5.2 | Änderung extern (A4) | Eine Datumsänderung einer FeWo-direkt-Buchung wird mit dem Portalbetrag eingetragen. Es gibt keine eigene Neuberechnung, der Kalender ist angepasst. |
|
||
| 5.3 | **Kontrollierter Abbruch, unverbindlich** | „Beenden“ bei einem offenen Angebot führt zu „ohne Buchung beendet“. Die Reservierung wird freigegeben, eine Absage an den Gast ist optional, im Verlauf steht der Grund. |
|
||
| 5.4 | **Kontrollierter Abbruch, verbindlich** | „Beenden“ bei einer gebuchten eigenen Buchung öffnet den Stornoweg: Wer storniert (Gast/Vermieter)? Grund? Stornokosten laut eingefrorener Regel, Erstattungsaufgabe. Der Vorgang lässt sich **nicht** ohne diese Angaben in „unverbindlich“ zurücksetzen. |
|
||
| 5.5 | Abbruch extern | „Beenden“ bei einer A3/A4-Buchung erzeugt zusätzlich „Stornierung im Portal veranlassen bzw. prüfen“. Der Vorgang ist erst „storniert“, wenn die Wirksamkeit bestätigt ist. |
|
||
| 5.6 | Storno durch Gast | Die Stornierung über den bestehenden Gast-Stornolink landet als Aufgabe im selben Vorgang und nutzt denselben Stornoweg. |
|
||
|
||
### Paket 6: A6 im Vorgang
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 6.1 | **A6 – Private Überlassung** | Familienbesuch, 5 Nächte, 3 Personen, Miete 0, Wäschepaket, Kurabgabe. Ergebnis: ein Vorgang mit Gästen, Leistungen und Gesamtbetrag, optional eine Aufenthaltsbestätigung (Vorschau), Zahlung erfassbar. Portale werden gesperrt. Es gibt keinen Mietvertrag, keine Bewertungsanfrage, keine Marketingmail. |
|
||
| 6.2 | **A6 – Wartungssperre** | Ein Zeitraum wird im Kalender markiert, „Sperre – Wartung“ gewählt: ein Vorgang mit Grund und Zeitraum, ohne Gast, Dokument oder Zahlung, mit Portalsperre. Er lässt sich verlängern (Portale angepasst) und aufheben (Portale entsperrt, Verlauf „Sperre aufgehoben“, **keine** Stornierung). |
|
||
| 6.3 | Bestandsmigration | Alle bisherigen manuellen Sperren erscheinen nach der Migration als A6-Vorgänge mit unverändertem Zeitraum. Der Kalenderexport ist vor und nach der Migration identisch. |
|
||
|
||
### Paket 7: Angebotsweg Hold 0 und Buchungswunsch
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 7.1 | Hold 0 | Website-Anfrage bei Haltefrist 0: Der Kalender bleibt frei. Der Gast erhält eine „Auskunft unter Vorbehalt“ mit „Buchung anfragen“, ohne Annahmewirkung. |
|
||
| 7.2 | Buchungswunsch, automatisch | Der Gast klickt „Buchung anfragen“, der Zeitraum ist frei, der Modus ist automatisch: Die Buchung wird bestätigt, Vertrag und Zahlungsplan folgen. |
|
||
| 7.3 | Buchungswunsch, manuell | Dasselbe bei „ich gebe frei“: Es entsteht die Aufgabe „Buchungswunsch bestätigen?“. |
|
||
| 7.4 | Zwischenzeitlich belegt | Der Zeitraum wurde inzwischen anderweitig gebucht: Es entsteht keine Buchung, der Gast bekommt eine Absage oder Alternativen, die Vermieterin einen Hinweis. |
|
||
|
||
### Paket 8: Externe Beträge und Zahlungsstände
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 8.1 | **A4 – Preis- und Zahlungsangaben** | Das Referenzbeispiel R09 lässt sich exakt erfassen: 840,00 / −42,00 / 181,51 als ungeklärte Sammelposition / 979,51 Gast gesamt / −84,82 „an FeWo-direkt“ / 894,69 und 900,20 als zwei Auszahlungsangaben mit Differenzhinweis / Rate 390,61 laut Portal bezahlt / Rate 588,90 fällig. Es entsteht keine erfundene Tagespreis- oder Provisionsaufteilung, keine Summe wird doppelt gezählt. |
|
||
| 8.2 | Bezahlt ist nicht eingegangen | „Laut Portal bezahlt“ wird getrennt vom Bankeingang angezeigt. Offene Beträge erscheinen nur bei der Partei, die sie einzieht. |
|
||
|
||
### Paket 9: Aufenthalt und Abschluss
|
||
|
||
| ID | Szenario | Erwartetes Ergebnis |
|
||
|---|---|---|
|
||
| 9.1 | Anreise | Fehlende Anreisedaten erzeugen rechtzeitig vor Anreise eine Aufgabe. Bei extern verantworteter Portal-Anreisenachricht erscheint „durch Portal (angekündigt)“ statt einer eigenen Mail. |
|
||
| 9.2 | Abschluss mit Nachläufer | Nach der Abreise mit offener Restforderung wird der Vorgang „abgeschlossen“. Die Forderung bleibt als zugewiesene Aufgabe sichtbar. |
|
||
|
||
---
|
||
|
||
## 7. Risiken und Absicherung
|
||
|
||
### 7.1 Wesentliche Risiken
|
||
|
||
| Risiko | Betroffen | Bewertung | Absicherung |
|
||
|---|---|---|---|
|
||
| Bestehende Angebote, Annahmen und Verträge werden ungültig | Signierte Links, `offer_hash`, PDF-Hashes, Annahmeprotokolle | hoch, falls Snapshot-Felder verändert werden | Eingefrorene Felder **nie** umschreiben, nur ergänzen. Abnahme 1.1 mit echten offenen Angebotslinks. |
|
||
| Doppelte oder fehlende Vorgänge durch den automatischen Eingang | 5-Minuten-Sync, Portal-Mails | hoch | Beobachtungsmodus je Kanal, Dublettenregel, idempotente Erzeugung (Schlüssel Kanal und Referenz), Schalter zum Abschalten je Kanal. |
|
||
| Fehlmigration der Einstellungen ändert das Automatikverhalten | AutoOffer, Erinnerungen | mittel | Trockenlauf mit Vorher/Nachher-Bericht je Vermieter. Automatik nach der Migration erst aktivieren, wenn der Bericht bestätigt ist. |
|
||
| Nullable Gast und Beträge erzeugen Fehler in Mails, PDFs und Tabellen | alle Stellen mit `$booking->guest->…`, `total` | mittel | Zugriffe vorab inventarisieren, Charakterisierungstests der Mails und PDFs vor dem Umbau. |
|
||
| Doppelte Mails durch den neuen Automatiklauf | Gastkommunikation | mittel | Idempotenz je Aktivität (Zeitstempel bzw. Verlauf), Testmodus der Mailzustellung (`Settings`) auf der Testumgebung. |
|
||
| Kalenderexport verändert sich durch die A6-Migration | Portal-Feeds, Fremdportale | hoch (Doppelbuchungsrisiko) | Feed-Vergleich vor und nach der Migration (Abnahme 6.3), Migration außerhalb der Saisonspitze. |
|
||
| UI-Umstellung überfordert die Nutzerin | Betrieb | mittel | Alte Akte im Expertenmenü bis zur Abnahme 2.5. Kurze Einweisung mit der Vermieterin. |
|
||
| Parallele Agenten im selben Ordner | Repository | mittel | Paketweise Branches, Dateizuständigkeit laut [ZUSAMMENARBEIT](../ZUSAMMENARBEIT.md), nur eigene Dateien stagen. |
|
||
| Strato: Migrationen auf MySQL/MariaDB, Dateiquote | Deployment | niedrig–mittel | Additive Migrationen, Datenbanksicherung vor jedem Deploy mit Migration ([BETRIEB](../BETRIEB.md)), Rollback-Weg laut [DEPLOYMENT](../DEPLOYMENT.md). |
|
||
| Nebenläufigkeit bei Annahme und Buchungswunsch | Doppelbuchung eigener Wege | niedrig (E-027) | Bestehende Sperrlogik `lockForTransition` wiederverwenden. Echte MariaDB-Nebenläufigkeitstests fehlen weiterhin; einmalig vor Paket 7 prüfen. |
|
||
|
||
### 7.2 Vorgehen zur Absicherung
|
||
|
||
1. **Vor Paket 1:** Bestandsaufnahme der Produktionsdaten, nur lesend über `deploy.sh artisan`: Zahl der Vorgänge je Status, Platzhalter-Gäste, Portalbelegungen mit und ohne Vorgang, manuelle Sperren, abweichende Wohnungseinstellungen. **[Annahme]** Auf Produktion gibt es nur wenige echte Vorgänge; das ist zu bestätigen.
|
||
2. **Je Paket:**
|
||
- Charakterisierungstests der berührten Bestandsabläufe zuerst, dann der Umbau.
|
||
- Migrationen nur additiv; destruktive Schritte (Spalte löschen) frühestens ein Paket später.
|
||
- Jede Datenmigration bekommt einen Artisan-Befehl mit `--dry-run` und Bericht.
|
||
3. **Schalter:** Neue Automatiken (automatischer Portaleingang, Automatiklauf) sind je Vermieter oder Kanal abschaltbar.
|
||
4. **Abnahme auf Test:** Ein Szenario-Seeder (nur Test und lokal) stellt die Fälle R01, R07, R08 und R09 nach. Die Abnahmetabellen aus §6 dienen als Protokoll. Erst danach folgt der Deploy auf Produktion, nach Freigabe.
|
||
5. **STATUS.md** wird nach jedem Paket aktualisiert. Die normative Prozessarchitektur bleibt unverändert, solange der Betreiber keine Änderung freigibt.
|
||
|
||
---
|
||
|
||
## 8. Offene Entscheidungen
|
||
|
||
### 8.1 Fachliche Entscheidungen des Betreibers
|
||
|
||
Diese Fragen sind weder durch v0.10 noch durch den Auftrag beantwortet. Jede hat eine Empfehlung, die als Vorgabe gilt, falls keine andere Entscheidung kommt.
|
||
|
||
| ID | Frage | Empfehlung | Benötigt für |
|
||
|---|---|---|---|
|
||
| **B1** | **Kurabgabe:** Soll die Anwendung sie berechnen, oder wird sie als normale Leistung mit vom Vermieter gepflegtem Satz geführt, mit manueller Personenzahl und Befreiungen? | Als Leistung mit gepflegtem Satz je Person und Nacht; Befreiungen manuell. Keine rechtliche Berechnungslogik im MVP. | Paket 6 |
|
||
| **B2** | **Prozess-Einstellungen je Wohnung:** Dürfen Haltefrist, Modus usw. je Wohnung eines Vermieters abweichen? v0.10 sieht das ohne Entscheidung nicht vor. | Nein. Vermieterstandard plus Portalabweichung reicht für 1–3 Wohnungen. | Paket 1 (Migration) |
|
||
| **B3** | **Änderung nach Verbindlichkeit (A1/A2):** Reicht es, wenn die Vermieterin eine mit dem Gast vereinbarte Änderung einträgt und das System eine aktualisierte Bestätigung sendet, oder braucht jede Änderung eine erneute Annahme durch den Gast (neuer Annahmelink)? | Eintragen plus aktualisierte Bestätigung als Standard. Optional „Änderung vom Gast bestätigen lassen“ für Preiserhöhungen. Rechtlich prüfen lassen. | Paket 5 |
|
||
| **B4** | **Abschluss-Gate:** Wann gilt ein Vorgang als abgeschlossen? | Automatisch nach der Abreise (A6: nach Ende), wenn keine Pflichtaufgabe mehr offen ist. Offene Forderungen und Schäden laufen als Nachläufer weiter und verhindern den Abschluss nicht. | Paket 9 |
|
||
| **B5** | **Priorität Hold = 0:** Will ein aktueller Vermieter zeitnah mit Haltefrist 0 arbeiten? | Wenn nein, bleibt Paket 7 in Stufe 2 hinten; wenn ja, wird es direkt nach Paket 3 umgesetzt. | Reihenfolge |
|
||
|
||
### 8.2 Technische Entscheidungen, die der Coding-Agent selbst trifft
|
||
|
||
- `Booking` bleibt technischer Träger des Vorgangs, ohne neue Vorgangstabelle (§3.1).
|
||
- Vorgangsart, Eingangsart und Profil-Snapshot liegen am Vorgang. Der Resolver liegt in einem eigenen Namensraum (z. B. `app/Process`).
|
||
- „Nicht gesetzt“ ist `null`. Einstellungen mit Klartext-Labels und Anzeige des geerbten Werts.
|
||
- Aktivitätenkatalog im Code, keine konfigurierbare Engine. Gate-Ergebnisse werden abgeleitet.
|
||
- Ereignisprotokoll als eigene Tabelle; nur Ergänzung, kein Event-Sourcing.
|
||
- Ob `BookingTask`, `ChannelTask` und Systemmeldungen technisch zusammengelegt oder nur in einer gemeinsamen Liste angezeigt werden.
|
||
- Dublettenschlüssel für Portalvorgänge, Beobachtungsmodus, Umfang der Charakterisierungstests.
|
||
- Wann veraltete Spalten gelöscht werden (frühestens im Folgepaket nach erfolgreicher Migration).
|
||
|
||
### 8.3 Portalspezifische Konfigurationsfragen (erst bei der Kanaleinrichtung)
|
||
|
||
Diese Fragen blockieren den Plan nicht. Sie bestimmen nur die Profilwerte des jeweiligen Kanals; alle Pakete sind so ausgelegt, dass „unbekannt“ erlaubt ist.
|
||
|
||
| Frage (Offene_Fragen) | Wirkt auf |
|
||
|---|---|
|
||
| DS-01, DS-02, DS-06 (Stornobedingungen, Basis „Mietpreis“, Änderungsweg) | Stornoregel bzw. Vorlage im DS-Profil (Pakete 3, 5) |
|
||
| DS-03, DS-04 (Gastgebühren, Detailtiefe) | Erfassungsmaske „Buchung von einem Portal“, Betragsarten (Pakete 4, 8) |
|
||
| DS-05, FW-07 (Sperrnachweis, iCal-Verzug) | Nachweisstufen und Erinnerungsintervalle (Paket 4) |
|
||
| FW-01 (Bedingungen vor Buchung) | Vorlagenwahl und Konflikthinweis im FeWo-direkt-Profil (Paket 3) |
|
||
| FW-02 bis FW-04 (Gebühren, Auszahlung, Export) | Betragsarten und Zuordnung (Paket 8) |
|
||
| FW-05 (Storno und Änderung im Konto) | Portalaufgaben beim Storno (Paket 5) |
|
||
| FW-06 (Gästedaten) | Aktivität „Gastdaten ergänzen“ (Pakete 4, 9) |
|
||
| Pro Portal: Liefert der Kanal verbindliche Buchungen, Anfragen oder beides? Erkennt die iCal-Regel sicher? | Eingangsart-Profil, Schalter „Vorgänge automatisch anlegen“ (Paket 4) |
|
||
|
||
### 8.4 Zulieferungen (keine Entscheidungen, aber Voraussetzungen)
|
||
|
||
- Texte der neuen Dokumentarten (Paket 3, Paket 7): Auskunft unter Vorbehalt und Knopf „Buchung anfragen“, Buchungsdokumentation extern verbindlich, A6-Aufenthaltsbestätigung. Offene_Fragen sieht hierfür eine rechtliche Prüfung vor.
|
||
- Kurabgabesätze des Vermieters (Paket 6, falls B1 wie empfohlen).
|
||
- Zeit für eine Bedienprobe mit der Vermieterin (Abnahme 2.5).
|
||
|
||
### 8.5 Nicht geprüfte Annahmen
|
||
|
||
- **[Annahme]** Auf Produktion liegen nur wenige echte Vorgänge und Portalbelegungen. Prüfung über die Bestandsaufnahme in §7.2.
|
||
- **[Annahme]** Portal-Mails von FeWo-direkt erlauben eine sichere Unterscheidung „Buchung“ / „Anfrage“ / „Storno“. Heute erkennt `PortalEmailType` diese Typen; die Zuverlässigkeit an echten Mails ist im Beobachtungsmodus zu bestätigen.
|
||
- **[Annahme]** Destination Solutions liefert weder iCal noch maschinenlesbare Mails; der Eingang ist manuell (R08). Liefert DS doch Mails, kann ein Parser später ergänzt werden.
|
||
|
||
---
|
||
|
||
## 9. Empfohlener Einstieg
|
||
|
||
**Zuerst Paket 1, „Vorgangskern und Einstellungen“**, unmittelbar gefolgt von **Paket 2, „Geführte Vorgangsbearbeitung“**.
|
||
|
||
Begründung:
|
||
1. **Alles hängt daran.** Jede weitere Funktion braucht dieselben drei Dinge: einen Vorgang, der unbekannte Werte zulässt, die Vorgangsart und das wirksame Profil. Ohne Paket 1 würde jedes Folgepaket erneut eigene Weichen nach `booking_model` oder Platzhalter-Gäste bauen, also genau die Parallelstrukturen, die abgebaut werden sollen.
|
||
2. **Geringes Betriebsrisiko bei hoher Wirkung.** Paket 1 ändert kaum sichtbares Verhalten, die Migrationen sind additiv, und der Erfolg lässt sich mit den Kriterien 1.1–1.7 eindeutig prüfen. Damit eignet es sich als Einstieg, bevor Sync oder Oberfläche angefasst werden.
|
||
3. **Die Bedienung folgt sofort.** Paket 2 ist der erste für die Vermieterin sichtbare Fortschritt: eine Liste „Zu erledigen“, eine geführte Vorgangsseite, Automatik oder Freigabe. Es sollte direkt danach beauftragt werden, damit die neue Fachlogik nicht in der alten Oberfläche versickert.
|
||
|
||
Für Paket 1 ist keine Betreiberentscheidung erforderlich außer **B2** (Einstellungen je Wohnung); die Empfehlung „Nein“ gilt als Vorgabe. Die übrigen Entscheidungen B1, B3, B4 und B5 werden erst für spätere Pakete benötigt.
|
||
|
||
[Zur Startseite](README.md) · [Gültige Entscheidungen](Entscheidungen.md) · [Offene Prüfungen](Offene_Fragen.md)
|