Ergebnisdokument Pakete 1 und 2, Projektstand ergänzt
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m48s
Deploy FeWo mit PipelineManager / deploy (push) Successful in 3m48s
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
3a728c3255
commit
987c67d4d3
2 files changed
+299
-1
No files matched your search
@@ -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: <br>• Bedienprobe mit der Vermieterin (Kriterium 2.5) <br>• Durchgangstest A1 von der Anfrage bis zur Bewertung in einem Stück (2.4) <br>• 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)
|
||||
+3
-1
@@ -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.
|
||||
|
||||
|
||||
Reference in new issue
Block a user