Files
fewo-stommer/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md
T
2026-11-01 18:41:38 +01:00

25 KiB
Raw Blame History

id, typ, titel, status, version, stand
id typ titel status version stand
ERG-P1P2 umsetzungsergebnis Umsetzungsergebnis Paket 1 und Paket 2 zur-pruefung 0.10 2026-11-01

Umsetzungsergebnis: Paket 1 (Vorgangskern und Einstellungen) und Paket 2 (Geführte Vorgangsbearbeitung)

Grundlage: UMSETZUNGSPLAN_v0.10.md mit der Betreiberentscheidung B2 (Einstellungshierarchie Vermieter → Kanal/Buchungstyp → Vorgang, Wohnungsabweichung nur im Expertenbereich, Bestandswerte nicht vereinheitlichen).

Wo der Stand liegt: Branch feature/vorgang, Commit 3a728c3 und ein Folgecommit mit dieser Dokumentation.

  • Nicht nach develop gemergt.
  • Nicht ausgeliefert.
  • Keine produktiven Daten verändert.
  • Die normative Prozessarchitektur v0.10 ist unverändert. Ihre Dateien liegen weiterhin uncommittet im Arbeitsverzeichnis des Betreibers und wurden nicht angefasst.

1. Implementierungsstand

Paket Stand Kurzbegründung
1 – Vorgangskern und Einstellungen Vollständig umgesetzt Alle sieben Abnahmekriterien sind mit Tests abgesichert. Die Migration ist an einer Kopie der lokalen Datenbank geprüft. Alte Spalten bleiben bewusst stehen, sie werden aber nicht mehr gelesen (siehe §7).
2 – Geführte Vorgangsbearbeitung Weitgehend umgesetzt Arbeitsübersicht, neue Vorgangsseite, Automatik und Freigabe, Fortsetzen nach Aufgaben, kontrolliertes Beenden, Expertenmodus und Menü sind fertig. Offen:
• Bedienprobe mit der Vermieterin (Kriterium 2.5)
• Durchgangstest A1 von der Anfrage bis zur Bewertung in einem Stück (2.4)
• Sichtprüfung im Browser

2. Tatsächlich umgesetzte Funktionen

2.1 Ein Vorgang für jeden Anlass (Paket 1)

Der Vorgang:

  • Die bestehende Buchung ist jetzt technisch der Vorgang. Die Oberfläche heißt „Vorgänge“, die Liste und der Kalender sprechen von „Vorgang öffnen“.
  • Jeder Vorgang kennt
    • seine Eingangsart: Anfrage, verbindliche Buchung oder eigene Nutzung/Sperre,
    • seine Vorgangsart A1–A6,
    • ein beim Eingang eingefrorenes Abwicklungsprofil.

Unbekanntes bleibt unbekannt:

  • Gast, Personenzahl, Preis, Anzahlung und Fälligkeit dürfen leer sein.
  • Die Seite zeigt dann „Gast noch nicht bekannt“ bzw. „Der Gesamtpreis ist noch nicht bekannt“.
  • Zahlungserinnerungen entstehen erst, wenn ein Preis bekannt ist.
  • Platzhalter-Gäste („Gast (Portal)“ ohne E-Mail) werden nicht mehr angelegt. Vorhandene löst die Migration vom Vorgang.

Ein Weg für Buchungen, die beim Portal schon fest sind (A3–A5):

  • „Portalbuchung übernehmen“ ersetzt den Parallelweg „Portal-Buchung erfassen“ (RecordPortalBooking, Formularabschnitt „Buchungsweg“) und die eigene Logik von „Akte anlegen“.
  • Es gibt kein Angebot und keine zweite Annahme. Der Vorgang ist sofort verbindlich und belegt den Kalender.
  • Der Portalpreis wird als eine belegte Position „Gesamtpreis laut Portal“ übernommen. Die bisherige Zerlegung in eigene Positionen mit „Abweichung Portalpreis“ entfällt.
  • Ein Vorname aus dem Portalkalender wird nur als Notiz festgehalten, nicht als Gast.

Owner bzw. Ursprungskanal: Die Zuordnung (origin_channel_id, import_channel_id) bleibt unverändert erhalten und bestimmt, welche Portaleinstellungen gelten.

Gespeicherter Verlauf:

  • Jede Änderung des Vorgangs wird als Ereignis mit Zeit, handelnder Person (Bearbeiterin, „Gast“, „System“, „System (automatisch)“) und gegebenenfalls Grund gespeichert. Erfasst werden:
    • Eingang, Statuswechsel, Angebotsversionen, Reservierungsverlängerung, Zeitraum
    • Gastzuordnung, Bestätigung, Anreise-Info, Bewertungsbitte
    • Zahlungen, Mails, Aufgaben, Umschaltung der Bearbeitung, Archiv
  • Der Verlauf ändert sich nicht, wenn sich der Vorgang später ändert.
  • Der bisherige, aus Zeitstempeln abgeleitete Verlauf wurde bei der Migration als Startereignisse übernommen.

2.2 Einstellungen in Ebenen (Paket 1, Entscheidung B2)

Ebene Wo Was
Vermieterstandard System › So arbeite ich (neue Seite) Bearbeitung (automatisch / jeden Schritt freigeben), Reservierung bei Anfragen, Gültigkeit des Angebots, wer Unterlagen, Zahlungen und Gastnachrichten übernimmt, Vorlauf der Anreise-Info
Abweichung je Portal und Buchungstyp Portal bearbeiten › „Anfragen über dieses Portal“ / „Feste Buchungen über dieses Portal“ Nur was abweicht; leere Felder zeigen „wie Standard: …“. Die Vertragsvorlage je Buchungstyp ist ebenfalls hier.
Abweichung je Wohnung Wohnung bearbeiten › „Abweichende Abwicklung dieser Wohnung“ (nur Expertenansicht) Für tatsächlich abweichende Wohnungen und für die übernommenen Altwerte
Vorgang Vorgangsseite › Schalter „Läuft automatisch“ / „Sie geben frei“ Gilt nur für diesen Vorgang und wird im Verlauf festgehalten

Grundsätze:

  • „Nicht gesetzt“ erbt immer von der Ebene darüber. Ein ausdrücklich gesetztes „nein“ oder „manuell“ ist ein eigener Wert und kein leerer.
  • Der Vorgang friert das wirksame Profil beim Eingang ein. Spätere Änderungen der Einstellungen gelten nur für neue Vorgänge.
  • Ändert sich, was den Vorgang ausmacht (Eingangsart, Kanal, Wohnung), wird das Profil neu bestimmt und im Verlauf vermerkt.
  • Ausnahme: Die Vertragsvorlage wird erst beim Erstellen des Dokuments bestimmt, weil das Dokument selbst seinen Stand festschreibt.

Der Befehl php artisan process:settings-report zeigt je Vermieter alle Standards und alle Abweichungen von Wohnungen und Portalen (nur lesend).

2.3 Geführte Bearbeitung (Paket 2)

Startseite „Zu erledigen“: Das ist eine Liste für alles, was zu tun ist, jeweils mit einem Knopf:

  • der nächste Schritt jedes offenen Vorgangs, z. B. „Angebot prüfen und senden“, „E-Mail-Adresse des Gastes eintragen“, „Gesamtpreis laut Portal eintragen“, „Stornierung im Portal veranlassen bzw. prüfen“
  • Portal sperren bzw. freigeben
  • unbekannte Kalenderbelegungen („was ist das?“)
  • ungelesene Systemmeldungen

Dringendes steht oben. Die bisherigen Einzellisten (Aufgaben, Portal-Aufgaben, Postfach, Ungeklärte Belegungen) sind nur noch im Expertenmenü.

Vorgangsseite:

  • Ganz oben steht der Stand in einem Satz, z. B. „Gebucht über FeWo-direkt · fest gebucht · Anreise in 12 Tagen“.
  • Darunter der Kasten „Als Nächstes“ in großer Schrift, mit dem Hinweis, ob der Vorgang automatisch läuft und was gegebenenfalls fehlt.
  • Danach folgen
    • „Ablauf“: alle Aktivitäten mit erledigt / übernimmt das Portal / zu tun / wartet / später,
    • „Verlauf“,
    • Gast, Aufenthalt, Preis und Zahlungen, Dokumente.

Knöpfe:

  • Oben stehen nur
    • der nächste Schritt als großer Hauptknopf,
    • der Schalter Automatik / Freigabe,
    • „Beenden …“ bzw. „Stornieren …“.
  • Alles andere, was gerade möglich ist, liegt unter „Weitere Möglichkeiten“.
  • Statt 17 gleichrangiger Knöpfe erscheinen nur noch die, die zum Stand passen.

Automatische Vorbereitung, manuelle Freigabe:

  • Im Modus „automatisch“ sendet das System das Angebot (wie bisher über die Freigaberegeln des automatischen Angebots).
  • Bei Portalbuchungen, die automatisch laufen, sendet es die Buchungsunterlagen, sobald Gast-E-Mail und Preis bekannt sind.
  • Im Modus „freigeben“ ist alles vorbereitet. Der Hauptknopf öffnet das fertige Angebot: oben Preis, Gast, Vorlage und Nachricht, alles andere unter einem zugeklappten „Anpassen“.

Fortsetzen nach einer Aufgabe: Fehlen Daten (z. B. die E-Mail), hält der Vorgang mit einer verständlichen Aufgabe an. Beim Eintragen wählt die Bearbeiterin „Automatisch weitermachen“ oder „Nur speichern – den nächsten Schritt gebe ich selbst frei“. Die Vorbelegung kommt aus dem Profil.

Kontrolliertes Beenden:

  • „Beenden“ verlangt immer einen Grund, der im Verlauf landet.
  • Bei einer Anfrage oder einem Angebot gilt: ohne Buchung beendet, der Zeitraum ist frei.
  • Bei einer verbindlichen Buchung gibt es nur den Stornoweg mit „Wer storniert?“ (Gast/Vermieter), Stornokosten-Aufgabe und optionaler Gastmail.
  • Bei einer extern verbindlichen Buchung (A3–A5) entsteht zusätzlich die Aufgabe „Stornierung im Portal veranlassen bzw. prüfen“.
  • Die Statusumschaltung von Hand gibt es nur noch im Expertenmodus, mit Pflichtgrund im Verlauf. Eine verbindliche Buchung kann damit nicht mehr zur Anfrage zurückgesetzt werden.

„Neu“-Dialog: Er fragt zuerst „Was möchten Sie eintragen?“:

  1. eine Anfrage (Telefon/E-Mail/Portalnachricht, optional mit Portal → A2),
  2. eine beim Portal fest gebuchte Buchung (A3–A5, alle Angaben außer Portal und Zeitraum optional),
  3. eigene Nutzung/Sperre. Diese verweist bis zu Paket 6 auf „Sperrzeiten“.

Bei einer telefonischen Anfrage ist die E-Mail-Adresse nicht mehr Pflicht.

Expertenansicht:

  • Es ist dieselbe Seite. Zusätzlich gibt es „Technische Angaben“ (Status, Vorgangsart, Eingangsart, eingefrorenes Profil mit Herkunft jedes Werts, Prüfsummen, Quelle, Kampagne) und das Menü „Experte“ (Angebotslink, Vertragstext, Status von Hand).
  • Das Menü der einfachen Ansicht hat nur noch: Start, Belegungsplan, Vorgänge, Gäste, Sperrzeiten, Preise & Angebote.

Begriffe:

  • Statt „Akte“ heißt es überall „Vorgang“.
  • Statt „Akte anlegen“ heißt es „Als Buchung übernehmen“.
  • Statt „Vormerkung“ heißt es „Reservierung“.
  • Statt „Anfragen & Buchungen“ heißt es „Vorgänge“.

3. Abnahmekriterien

Legende:

  • ✅ erfüllt und durch automatisierte Tests belegt
  • ◐ teilweise
  • ○ offen

Paket 1

ID Ergebnis Nachweis / Anmerkung
1.1 ✅ Test CaseCoreTest::test_the_migration_keeps_behaviour_of_existing_cases_and_differing_properties: Angebotsversion, Prüfsumme und Zahlungsverhalten des Altvorgangs bleiben unverändert; abweichende Wohnungswerte bleiben als Abweichung; Platzhalter-Gast ist gelöst, Verlauf übernommen. Offene Angebotslinks bleiben gültig, weil Version, Gültigkeit und Hash unberührt sind. Die Migration lief zusätzlich fehlerfrei an einer Kopie der lokalen Datenbank. Nicht geprüft: echte Bestandsdaten von Test/Produktion und MariaDB (siehe §6).
1.2 ✅ test_a_portal_booking_without_guest_data_stays_unknown_instead_of_getting_a_placeholder, PortalBookingTest (Kalenderübernahme ohne Gast und Preis)
1.3 ✅ test_landlord_defaults_apply_to_a_new_request
1.4 ✅ test_a_channel_value_that_is_not_set_inherits_and_a_set_value_wins_even_when_it_is_no; die Oberfläche zeigt „wie Standard: …“ gegenüber dem gesetzten Wert. Hinweis: „Haltefrist 0“ entspricht heute „Anfrage reserviert nichts“. Den eigentlichen Hold-0-Weg (Auskunft unter Vorbehalt) baut Paket 7.
1.5 ✅ test_one_mixed_portal_handles_requests_and_bindings_differently: gleiches Portal, Anfrage wird A2 mit Anfragevorlage und eigener Zahlung, feste Buchung wird A4 mit Portalvorlage und Portalzahlung
1.6 ✅ test_the_profile_is_frozen_with_the_case
1.7 ✅ test_the_history_is_stored_and_does_not_change_with_the_case (mit handelnder Person) und Gast-Aktionen mit Akteur „Gast“

Paket 2

ID Ergebnis Nachweis / Anmerkung
2.1 ✅ GuidedCaseHandlingTest::test_an_automatic_request_gets_its_offer_without_a_click_and_leaves_nothing_to_do; die Reservierung wirkt wie bisher über den Kalenderexport, Portale mit manueller Sperrpflicht erhalten wie bisher Portal-Aufgaben
2.2 ✅ test_a_manual_request_is_prepared_and_waits_for_release_in_the_work_list
2.3 ✅ test_missing_data_stops_the_case_with_a_task_and_it_continues_automatically_afterwards sowie die manuelle Fortsetzung test_after_completing_a_task_the_landlord_may_keep_releasing_by_hand
2.4 ◐ Die Einzelschritte sind getestet: Angebot, Annahme, Bestätigung, Zahlungsaufgaben, Anreise-Info, Bewertungsbitte (bestehende Tests, angepasst). Ein durchgehender Szenariotest „Anfrage bis Bewertung in einem Vorgang“ fehlt noch.
2.5 ◐ Technisch geprüft: Stand, nächster Schritt und nur passende Knöpfe (test_the_case_page_shows_the_state_the_next_step_and_only_fitting_buttons). Die Bedienprobe mit der Vermieterin steht aus, ebenso eine Sichtprüfung im Browser.
2.6 ✅ test_the_work_list_brings_everything_to_do_into_one_list. Einschränkung: Systemmeldungen bleiben in der Liste, bis sie im Postfach (Expertenmenü) als gelesen markiert sind.
2.7 ✅ test_the_expert_view_shows_technical_details_on_the_same_page und die Menütests der einfachen Ansicht. Die technische Ausblendung ist auf der Vorgangsseite umgesetzt, nicht auf allen anderen Seiten.
2.8 ✅ test_nationality_is_never_a_reason_to_stop. Prüfauslöser sind nur fehlende Daten, Belegung, Kalenderfrische, Vertragstexte und Spam-Schutz; Land oder Name werden nirgends ausgewertet.

Weitere Szenarien, die mit abgesichert sind:

  • kontrolliertes Beenden einer Anfrage (Pflichtgrund)
  • Storno einer Portalbuchung mit Portalaufgabe
  • „Neu“-Dialog für Portalbuchungen
  • Nachtragen des Portalpreises
  • Statusumschaltung nur im Expertenmodus, keine Rückstufung zur Anfrage

4. Wesentliche Architekturentscheidungen

  1. Booking bleibt der technische Träger des Vorgangs. Es gibt keine neue Tabelle. Neu sind die Spalten intake, case_type, profile (JSON, eingefroren) und processing_mode (Übersteuerung im Vorgang). Damit bleiben alle signierten Links, Angebots-Snapshots, Prüfsummen und Beziehungen gültig.
  2. Einstellungen als Katalog (App\Enums\ProcessSetting) mit Auflösung in App\Process\ProcessSettings:
    • Grundeinstellung → tenants.process_defaults → properties.process_overrides → channels.process_overrides[inquiry|booking].
    • Es gibt drei Zuständigkeiten (Unterlagen, Zahlungen, Gastnachrichten). Sie ersetzen die Zahlungsschalter und Vorlagenfelder am Kanal und die Weichen über booking_model.
    • booking_model beschreibt nur noch, was ein Portal liefert. Es dient als Vorgabe der Eingangsart, wenn sie nicht anders bekannt ist, und als Merkmal „Sofortbuchung“ für die Kalenderprüfung.
  3. Vorgangsart aus Eingangsart und Zuständigkeit:
    • Anfrage → A1 (direkt) bzw. A2 (über Portal)
    • feste Buchung → A3 (alles bei uns), A4 (Portal kassiert) bzw. A5 (Portal macht auch die Unterlagen)
    • eigene Nutzung → A6
  4. Aktivitäten statt Statusmaschine:
    • App\Process\CaseActivities leitet aus Profil und Daten ab, welche Aktivitäten gelten und wo sie stehen: erledigt, übernimmt das Portal, zu tun, Problem, wartet, später, entfällt.
    • Die Gates G1–G5 sind damit Prüfregeln und kein gespeicherter Zustand.
    • Das ersetzt BookingProgress, das die Prozessart aus dem Kanal ableitete.
  5. Eine Automatik (App\Process\CaseAutomation) verallgemeinert das bisherige automatische Angebot um das Senden der Unterlagen fester Portalbuchungen. Sie fasst Vorgänge mit migriertem Profil nicht an, damit sich das Verhalten bestehender Vorgänge nicht ändert.
  6. Verlauf über Modell-Hooks (App\Process\CaseRecorder, CaseLog): Die Fakten schreibt das Modell selbst. Aktionen ergänzen handelnde Person und Grund. Damit ist der Verlauf vollständig, ohne dass jede Aktion daran denken muss.
  7. Konsolidiert bzw. entfernt:
    • RecordPortalBooking, BookingProgress und die Portalpreis-Zerlegung entfallen.
    • Der Knopf „Akte anlegen“ heißt jetzt „Als Buchung übernehmen“ und nutzt denselben Übernahmeweg wie die manuelle Erfassung.
    • Die getrennten Aktionen „Ablehnen“ und „Stornieren“ sind in „Beenden“ zusammengefasst.
  8. Bewusst noch nicht konsolidiert, weil es in spätere Pakete gehört:
    • Gastzuordnung an Portalbelegungen (AssignOccupationGuest, Paket 4)
    • automatische Vorgangsanlage aus dem 5-Minuten-Abgleich (Paket 4)
    • A6 im Vorgang (Paket 6)

5. Datenmigrationen und Kompatibilität

2026_11_01_090000_create_case_core (Schema, nur additiv):

  • bookings: guest_id, guests, quote, total, deposit und balance_due_on dürfen leer sein.
  • bookings: neue Spalten intake, case_type, profile, processing_mode.
  • neu: tenants.process_defaults, properties.process_overrides, channels.process_overrides
  • neue Tabelle booking_events

2026_11_01_090100_move_process_settings_and_backfill_cases (Daten, nur Abfragen, keine Modelle):

Bestand Was passiert Schutz
Prozessfelder der Wohnungen (Modus, Vorreservierung, Haltezeit, Anreise-Info) Sind sie bei allen Wohnungen eines Vermieters gleich, werden sie Vermieterstandard. Unterscheiden sie sich, wird nichts vereinheitlicht: Jede Wohnung behält ihren Wert als Abweichung, der Standard bleibt die Grundeinstellung. Verhalten jeder Wohnung unverändert; Bericht php artisan process:settings-report
Portal-Schalter (Zahlungsaufgaben Anfrage/Reservierung, zwei Vorlagen) werden Abweichungen je Eingangsart wie bisher, nur dass „feste Buchung“ jetzt nach Eingang statt nach Kanalmodell gilt
Bestehende Vorgänge Eingangsart, Vorgangsart und eingefrorenes Profil mit genau dem bisherigen Verhalten (Herkunft „aus dem bisherigen Stand übernommen“) Neue Automatik ausgeschlossen; Angebots- und Vertragsstände, Hashes, Links unverändert
Verlauf aus Zeitstempeln, Zahlungen, Mails und erledigten Aufgaben nur Einfügen
Platzhalter-Gäste (Vorname „Gast“, Nachname „(Portal)“, keine E-Mail) vom Vorgang und von der Kalenderbelegung gelöst, dann gelöscht Gäste mit echtem Namen bleiben unangetastet

Nicht eindeutig überführbare Fälle:

  • Personenzahl übernommener Portalbuchungen: Altfälle aus „Akte anlegen“ tragen die damals angenommene Zahl 2. Sie lässt sich nicht von einer echten 2 unterscheiden und bleibt daher stehen. Vor dem Produktivgang sollte man diese Vorgänge prüfen.
  • Preise übernommener Portalbuchungen: Dort stehen weiterhin unsere damalige Berechnung und gegebenenfalls die Zeile „Abweichung Portalpreis“. Altdaten wurden nicht umgeschrieben, weil Vertrags- und Angebotsstände auf ihnen beruhen können.
  • Echte Bestandsdaten: Auf Test und Produktion ist der Bestand nicht gesichtet worden. Die lokale Datenbank enthält keine Vorgänge. Vor dem Deployment empfehle ich die Bestandsaufnahme aus Plan §7.2.

Alte Spalten:

  • properties.hold_hours, offer_mode, pre_reservation_enabled, arrival_info_days_before
  • channels.payment_tasks_*, contract_template_reservation_id

Sie bleiben stehen, werden aber nicht mehr gelesen. Löschen frühestens im Folgepaket nach erfolgreicher Migration auf Produktion. channels.contract_template_id und properties.contract_template_id bleiben ebenfalls stehen. Die Wohnungsvorlage wird weiterhin als Wohnungsebene gelesen.

Rückweg: down() leert die neuen Spalten und den Verlauf. Gelöschte Platzhalter-Gäste und geleerte Felder lassen sich nicht automatisch zurückholen. Deshalb gilt wie üblich: Datenbanksicherung vor dem Deployment (BETRIEB, DEPLOYMENT).


6. Prüfergebnisse

Ausgeführte Prüfungen:

  • Vollständige Testsuite: 634 Tests, 3408 Assertions, alle grün (Ausgangsstand vorher: 614 Tests grün).
  • Neue Testdateien:
    • tests/Feature/CaseCoreTest.php (9 Tests, Paket 1)
    • tests/Feature/GuidedCaseHandlingTest.php (11 Tests, Paket 2)
    • tests/Feature/PortalBookingTest.php, neu geschrieben für den gemeinsamen Übernahmeweg (15 Tests)
  • Angepasste Tests: Sie prüften früheres, jetzt bewusst geändertes Verhalten, etwa Vorlagenwahl nach Kanalmodell, Zahlungsschalter am Kanal, Benennung „Buchung nicht möglich“, Aktionen „Ablehnen“/„Stornieren“ und Menü der einfachen Ansicht. Betroffen: AutoOfferTest, BookingAdminTest, BookingFileTest, CancellationPolicyTest, ContractDocumentTest, ContractTemplateTest, SelfServiceTest, AdminModeTest.
  • Formatierung: vendor/bin/pint ist sauber.
  • Migration an einer Kopie der lokalen SQLite-Datenbank fehlerfrei; Einstellungsbericht geprüft.

Während der Arbeit gefunden und behoben:

  • Ein Vorgang eines anderen Vermieters ließ sich beim Speichern nicht auflösen, wenn ein anderer Mandant aktiv war (Mandantenfilter auf der Wohnung).
  • Die Stornomitteilung, die Konfliktmeldung, das Vertrags-PDF und „Nächste Aufenthalte“ setzten immer einen Gast voraus.

Verbleibende Risiken:

  • MariaDB/MySQL nicht geprüft: Die Spaltenänderungen auf „leer erlaubt“ (->change()) sind nur mit SQLite getestet. Vor dem Produktivgang: auf dem Testsystem migrieren und prüfen.
  • Gast-Pflicht an weiteren Stellen: Einige Gast-Mails und -Seiten lesen $booking->guest ohne Absicherung. Sie sind nur bei Vorgängen mit Gast erreichbar. Neue Wege ohne Gast (Paket 4/6) müssen das beachten.
  • Keine Sichtprüfung im Browser: Die Oberfläche ist nur über Livewire-Tests geprüft, die Darstellung (Abstände, Schriftgröße für die Vermieterin) nicht.
  • Änderung für neue Vorgänge: Bei Portalen mit gemischten Eingängen gilt jetzt für neue feste Buchungen die Einstellung „Feste Buchungen“ (Vorlage, Zahlung) statt der Anfrageeinstellung. Das ist fachlich gewollt (1.5); für bestehende Vorgänge ändert sich nichts.

7. Offene Arbeiten und Entscheidungen

Für den vollständigen Abschluss von Paket 2:

  1. Bedienprobe mit der Vermieterin (2.5): drei vorbereitete Vorgänge auf dem Testsystem, Fragen nach Stand, nächstem Schritt und möglichen Entscheidungen. Rückmeldungen gehen in die Wortwahl und die Knopfanordnung ein.
  2. Durchgangstest A1 (2.4) als ein Szenario von der Anfrage bis zur Bewertung.
  3. Sichtprüfung im Browser (Startseite, Vorgangsseite, „Neu“-Dialog, „So arbeite ich“) und gegebenenfalls Schriftgröße und Abstände.
  4. Optional: Systemmeldungen in „Zu erledigen“ direkt quittieren können, ohne Umweg über das Postfach.

Vorgemerkt für Paket 8 – Preisangaben bei Portalbuchungen (Rückmeldung Betreiber, 01.11.2026): Heute gibt es nur den „Gesamtpreis laut Portal“; „Zusatzleistungen erfassen“ hält nur fest, welche Leistungen gebucht sind (für Vertragsanlagen), ohne Preis. Paket 8 muss laut Preise_und_Zahlungen und E-014/E-015 je Vorgang wahlweise abbilden:

  • nur einen Gesamtbetrag (bleibt der einfache Standard),
  • Einzelpositionen – Übernachtung, Rabatt, Einzel- und Sonderleistungen mit Preis, Gebühren/Steuern,
  • Sammelpositionen, die mehrere Posten zusammenfassen und später aufgeteilt werden können (Ursprungswert und Quelle bleiben sichtbar),
  • Provision des Vermittlers und angekündigte/tatsächliche Auszahlung getrennt vom Gastbetrag, ohne Doppelzählung.

Die Detailtiefe wird je Vorgang gewählt, nicht als Portaleinstellung, weil sie auch bei demselben Portal je Buchung schwankt (R09 FeWo-direkt). Prüfstein ist Abnahmekriterium 8.1.

Aufräumen nach erfolgreicher Migration auf Produktion: alte Prozessspalten an Wohnung und Kanal entfernen; Formularfeld „Was kommt über dieses Portal?“ gegebenenfalls in den Expertenbereich verschieben.

Fachliche Entscheidungen: Für die Pakete 1 und 2 ist keine neue nötig. B1, B3, B4 und B5 bleiben wie im Plan offen und wurden nicht vorweggenommen.

Dokumentation: UEBERGABE-BUCHUNGSPROZESS.md beschreibt den Stand vor dieser Umsetzung. Ihre Mängelliste §4 ist zu großen Teilen erledigt:

  • Akte, Platzhalter-Gäste, Parallelweg, Vorlagenwahl nach Kanalmodell
  • Statusumschaltung, nicht gespeicherter Verlauf, Menü

Offen ist noch „Zusammenstellung vor Bestätigen“ (Paket 3).


8. Nächste Empfehlung

  1. Zuerst die Abnahme dieses Stands auf dem Testsystem:
    • feature/vorgang nach develop mergen und automatisch auf Test ausliefern lassen (nach eurer Freigabe).
    • php artisan process:settings-report lesen.
    • Altvorgänge mit übernommenen Portalbuchungen sichten.
    • Bedienprobe mit der Vermieterin.
  2. Danach Paket 4 „Ein Eingang für alle Kanäle“ vor Paket 3: Der größte verbleibende Handgriff ist das Übernehmen erkannter Portalreservierungen, heute noch ein Klick je Belegung. Dazu kommen die Portalstorno-Aufgabe aus dem Abgleich und die Sperrnachweise. Der Übernahmeweg (TakeOverExternalBooking) und die Aufgabenliste stehen schon; Paket 4 muss nur noch den Abgleich anschließen, mit Beobachtungsmodus je Portal.
  3. Paket 3 (gemeinsame Zusammenstellung und Dokumentarten) folgt, sobald die Texte für „Buchungsdokumentation extern verbindlich“ vorliegen. Die Vorlagenwahl je Eingangsart ist dafür bereits vorbereitet.

Zur Startseite · Umsetzungsplan