Files
2026-11-03 12:13:09 +01:00

60 KiB
Raw Permalink Blame History

id, typ, titel, status, version, stand
id typ titel status version stand
PLAN-010 umsetzungsplan Umsetzungsplan zur Prozessarchitektur v0.10 entwurf-zur-freigabe 0.10 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, E-023, E-024.
    • Das Profil richtet sich nach Kanal und Eingangsart. Die Partnerherkunft ist nur ein kaufmännisches Merkmal. Quellen: E-012, Profile.
    • 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) für Portalbelegungen und A6, (3) paralleler Erfassungsweg RecordPortalBooking mit Abschnitt „Buchungsweg“ in BookingForm. Eine Portalreservierung wird nur per Klick über OpenPortalFile zum Vorgang. Strukturelle Kernlücke
L2 Unbekannt ist nicht 0, keine Platzhalter bookings.guest_id ist NOT NULL (Migration). 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, OfferTerms::templateFor, Booking::wantsPaymentTasks, CalendarClearance. 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). 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: ohne Vorreservierung kein Hold). SendOffer 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 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 löscht verschwundene Spiegeleinträge. ProcessPortalMail 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) 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, 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 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 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) 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, AcceptOffer, ConfirmBooking, RejectOffer, ExpireReservations. Dazu gehören Konditions-Snapshot (offer_terms), Hash, signierte Links, Annahmeprotokoll und Sperrlogik lockForTransition().
  • Verfügbarkeit: Booking::occupying(), CalendarClearance (Frischeprüfung vor Annahme), Mindestaufenthalt, Preisberechnung PriceCalculator.
  • Kanäle: Connector-System app/Channels, iCal-Regelwerk, ReconcileChannelRepresentations (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.
  • 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. 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 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). 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 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, nur eigene Dateien stagen.
Strato: Migrationen auf MySQL/MariaDB, Dateiquote Deployment niedrig–mittel Additive Migrationen, Datenbanksicherung vor jedem Deploy mit Migration (BETRIEB), Rollback-Weg laut DEPLOYMENT.
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 · Gültige Entscheidungen · Offene Prüfungen