From 987c67d4d33383aa415127f2d68677a16a0cbb38 Mon Sep 17 00:00:00 2001 From: Lars Date: Sun, 1 Nov 2026 16:28:02 +0100 Subject: [PATCH] =?UTF-8?q?Ergebnisdokument=20Pakete=201=20und=202,=20Proj?= =?UTF-8?q?ektstand=20erg=C3=A4nzt?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- .../UMSETZUNGSERGEBNIS_P1_P2.md | 296 ++++++++++++++++++ docs/STATUS.md | 4 +- 2 files changed, 299 insertions(+), 1 deletion(-) create mode 100644 docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md diff --git a/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md b/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md new file mode 100644 index 0000000..f07ee1e --- /dev/null +++ b/docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md @@ -0,0 +1,296 @@ +--- +id: ERG-P1P2 +typ: umsetzungsergebnis +titel: Umsetzungsergebnis Paket 1 und Paket 2 +status: zur-pruefung +version: "0.10" +stand: 2026-11-01 +--- + +# Umsetzungsergebnis: Paket 1 (Vorgangskern und Einstellungen) und Paket 2 (Geführte Vorgangsbearbeitung) + +**Grundlage:** [UMSETZUNGSPLAN_v0.10.md](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](../BETRIEB.md), [DEPLOYMENT](../DEPLOYMENT.md)). + +--- + +## 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. + +**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](../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](README.md) · [Umsetzungsplan](UMSETZUNGSPLAN_v0.10.md) diff --git a/docs/STATUS.md b/docs/STATUS.md index 400dd2c..dfe6319 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,6 +1,8 @@ # Projektstand -**Buchungsprozess – Übergabe an eine neue Session (30.10.2026):** Die Portal-Erweiterungen des Buchungsprozesses (Portal-Direktbuchung erfassen, „Akte anlegen“, Statuswechsel von Hand, Menü) wurden neben dem Angebotsablauf statt auf ihm gebaut und sind für den Betreiber nicht brauchbar. **Vor jeder Arbeit am Buchungsprozess `docs/UEBERGABE-BUCHUNGSPROZESS.md` lesen** (Anforderungen, Stand, Mängelliste, empfohlenes Vorgehen) und das Konzept dort mit dem Betreiber abstimmen, bevor Code entsteht. +**Vorgangskern und geführte Vorgangsbearbeitung – Pakete 1 und 2 der Prozessarchitektur v0.10 (01.11.2026, Branch `feature/vorgang`, nicht ausgeliefert):** Die Buchung ist der einheitliche Vorgang (Eingangsart, Vorgangsart A1–A6, eingefrorenes Abwicklungsprofil, gespeicherter Verlauf `booking_events`); Gast, Personen und Preis dürfen unbekannt sein, keine Platzhalter-Gäste mehr. Einstellungen in Ebenen: System › **So arbeite ich** (Vermieterstandard) → Abweichung der Wohnung (Expertenansicht) → Abweichung je Portal und Buchungstyp → Vorgang (`App\Process\ProcessSettings`). Ein Übernahmeweg für beim Portal feste Buchungen (`TakeOverExternalBooking`, Portalpreis als eine Position) ersetzt „Portal-Buchung erfassen“ und die Logik von „Akte anlegen“. Startseite **„Zu erledigen“**, neue Vorgangsseite (Stand in einem Satz, „Als Nächstes“, Ablauf, Verlauf, Hauptknopf, Automatik/Freigabe, „Beenden“ nur über Storno), „Neu“-Dialog mit drei Einstiegen, Status von Hand nur im Expertenmodus. Migration übernimmt bisheriges Verhalten unverändert (Bericht `php artisan process:settings-report`). **634 Tests grün**, Pint. Ergebnis, Abnahmekriterien und offene Punkte: [docs/Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md](Prozessarchitektur/UMSETZUNGSERGEBNIS_P1_P2.md). Vor dem Deployment: Migration auf dem Testsystem (MariaDB) prüfen, Bedienprobe mit der Vermieterin. + +**Buchungsprozess – Übergabe an eine neue Session (30.10.2026, durch v0.10 und `feature/vorgang` weitgehend überholt):** Die Portal-Erweiterungen des Buchungsprozesses (Portal-Direktbuchung erfassen, „Akte anlegen“, Statuswechsel von Hand, Menü) wurden neben dem Angebotsablauf statt auf ihm gebaut und sind für den Betreiber nicht brauchbar. **Vor jeder Arbeit am Buchungsprozess `docs/UEBERGABE-BUCHUNGSPROZESS.md` lesen** (Anforderungen, Stand, Mängelliste, empfohlenes Vorgehen) und das Konzept dort mit dem Betreiber abstimmen, bevor Code entsteht. **Hauptadresse und Abspielgeschwindigkeit (30.10.2026):** Weitere Adressen einer Website (z. B. www.stommer.info) leiten jetzt dauerhaft (301, nur GET/HEAD) auf die Hauptadresse (`Site.domain`) um (`ResolveTheme::toMainAddress`). Vorher lud die Seite unter www Skripte, Schriften und Videos von der Adresse ohne www – der Browser blockierte sie als fremde Herkunft: kein JavaScript (Titelvideo, Menü-Pfeile), Ersatzschrift. `Site::origin()` nimmt verbindlich das Feld `domain`. Videos haben eine **Abspielgeschwindigkeit** (Webseite › Videos, 0,5×–1×), die überall gilt, wo das Video läuft.