Files

74 lines
11 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# V2.1 – Abnahme: Fälle A–H und kritische Selbstprüfung
Stand: 05.11.2026, Branch `feature/prozessarchitektur-v2-1`. Grundlage: [01 Lücken](01_KONFIGURATIONSLUECKEN.md), [02 Zielbild](02_FACHLICHES_ZIELBILD.md). Alle Nachweise sind automatisierte Tests; „Tester“ meint den isolierten Prozess-Tester (Kanal › Ablauf › Ablauf testen).
## 1. Was V2.1 ergänzt
| Bereich | Umsetzung |
|---|---|
| Kanalfähigkeiten | `Capability`, `ChannelCapabilities`: bestätigt / abgeleitet / vorgeschlagen / unbekannt. Sie entscheiden, welche Modelle zulässig sind. |
| Erklärte Einschränkungen | `Restriction`: was fehlt, welche Variante erlaubt ist, was zu ändern ist, Grund (fachlich / technisch / Fähigkeit). |
| Abgleich alter Werte | Gespeicherte Einstellungen gegen `fixes()` des Modells: ausdrückliche Bestätigung, Eintrag in `settings.process_history`. |
| Ausführungsvarianten | `Execution` (automatisch, Freigabe, von Hand, Portal, Dienstleister, extern, nicht nötig), je Modul mit `why` (Begründung der Pflicht) und `condition`. |
| Dokumente entkoppelt | `contract_delivery` (wie bisher / automatisch / von Hand / nur intern ablegen), `booking_notice` (aus / automatisch / automatisch, außer das Portal bestätigt) als eigener Schritt. |
| Portalbestätigung | Modul `portal.confirmation`: Belegung sofort gesichert, gästebezogene Schritte warten, Frist, genau eine Aufgabe bei Ausbleiben, Wiederaufnahme per Portalmail oder Bestätigung im Vorgang. |
| Kommunikation | `config/communication.php`, `CommunicationRules`, `IntentClassifier`, `MessageIntake`: Medium × Absicht × Wirkung; Vermieter dürfen nur einschränken. |
| Nichtlineare Ansicht | Konfigurator zeigt je Schritt „braucht zuerst“, „soll nach“, „läuft unabhängig“, „nur wenn“, „So darf das erfüllt werden“; keine Nummerierung. Quelle: dieselben Moduldefinitionen wie der `ProcessRunner`. |
| Tester | Neue Szenarien: Portalbestätigung (sofort / verspätet / ausbleibend), Nachricht über WhatsApp/Chat, allgemeine Frage ohne Vorgang. |
| Erweiterungspunkt | `guest.address_check` (nur Tester) als Variante `address_check` des A1-Angebotsmodells. |
Modellversionen: a3/a4/a5 Version 1 bleiben für laufende Vorgänge erhalten, Version 2 enthält die neuen Module (`config/process.php`, `compatible`). Die Standardwerte der neuen Einstellungen reproduzieren das V2-Verhalten (Golden-Master- und Laufende-Vorgänge-Tests unverändert grün).
## 2. Nachweisfälle
| Fall | Konfiguration | Module / Regeln | Ausführung | Vorschau & Tester | Wirkung auf andere Archetypen | Tests |
|---|---|---|---|---|---|---|
| **A** Destination Solutions heute | Kanal mit Fähigkeit „Portal kassiert nicht“ (bestätigt) → Modell A3, Zahlungen eigen | A3 v2, `documents.send`, `payments.internal` | Eigene Zahlungsabwicklung und Dokumentation wie bisher | Vorschau zeigt A3-Schritte; Tester `portal_booking` | keine | `ChannelCapabilityTest`, `BehaviourComparisonTest` |
| **B** Destination Solutions künftig | Fähigkeit „Portal kassiert“ bestätigen (mit Bestätigung des Abgleichs) → A4 | A4 v2, `money.portal_payout` statt interner Zahlung | Neue Vorgänge laufen als A4; laufende behalten ihren eingefrorenen Plan; **keine neue A4-Logik** | Vorschau und Tester zeigen A4; nicht erfüllte Modelle bleiben sichtbar mit Erklärung | A3/A5 unverändert | `ChannelCapabilityTest` (Wechsel, Abgleich `payments = portal`, Historie) |
| **C** Portalbestätigung als Voraussetzung | `await_portal_confirmation = ja`, Wartezeit, `booking_notice` | `portal.confirmation`, harte Abhängigkeit von `documents.send` und `documents.booking_notice` | Belegung sofort gesichert; Unterlagen/Information warten; nach Frist **eine** Aufgabe, nichts wird automatisch gesendet; Mail oder Bestätigung im Vorgang setzt fort | Szenario „Bestätigungsmail: sofort / verspätet / ausbleibend“ | nur Modelle, die das Modul enthalten (A3–A5 v2) | `DocumentsAndPortalConfirmationTest`, `ProcessTesterTest` |
| **D** Alternative Dokumentenverarbeitung | `contract_delivery = intern`, `booking_notice = automatisch` | `documents.send` (v2), `documents.booking_notice` | Vertrag erstellt und abgelegt, nicht gesendet; Gast erhält nur die Buchungsinformation; spätere Versendung von Hand möglich; Unterdrückung, wenn das Portal selbst informiert und bestätigt hat | Tester über Entwurf der Einstellungen | wie C | `DocumentsAndPortalConfirmationTest` |
| **E** Kommunikation über verschiedene Medien | Medium in `config/communication.php` aktiv, Vermieter kann einschränken | `MessageIntake`, `IntentClassifier`, `MessageMatcher` (E-Mail unverändert) | Antwort mit überprüftem Bezug wird dem Vorgang zugeordnet, Herkunft (`medium`, Kanal der Buchung) bleibt, Aufgabe „Posteingang prüfen“, nichts wird automatisch übernommen | Szenario „Nachricht über WhatsApp oder Chat“ | keine | `MessageMediumIntentTest`, `ProcessTesterTest` |
| **F** Auskunft ohne Buchungsanfrage | wie E | Wirkungen `answer_information`, `handoff_inquiry`, sonst `review` | Es entsteht weder Vorgang noch Reservierung, Angebot oder Buchung (strukturell: kein Wirkungstyp legt einen Vorgang an) | Szenario „Allgemeine Frage im Chat“ | keine | `MessageMediumIntentTest`, `ProcessTesterTest` |
| **G** Nichtlineare Datenbeschaffung | A1-Standard | `hold`, `guest.details`, `guest.data_request` unabhängig; `offer.binding` hart von den Angaben abhängig | Klärungsreservierung steht sofort, Datenbeschaffung läuft; das Angebot wartet („erst wenn alle Angaben da sind“) | Ansicht „braucht zuerst / läuft unabhängig“ | keine | `ExtensionAndIndependentStepsTest`, `ProcessRunnerTest` |
| **H** Neuer Zusatzschritt | Variante `address_check` (nur Tester) am Erweiterungspunkt `after_guest_identified` | `guest.address_check` | Nur Hinweis, hält nichts auf; echte Vorgänge können die Variante nicht erhalten | Tester-Entwurf | nur A1-Angebot hat die Variante; Standardabläufe aller Modelle unverändert (Test) | `ExtensionAndIndependentStepsTest` |
## 3. Regression (Phase 3)
Bestehende Suites unverändert grün: Prozesskern, Golden Master, laufende Vorgänge, Sandbox-Sicherheit (`ProcessTesterSecurityTest`, `SideEffectPathsTest`), Posteingang (`GuestMailInboxTest`), Dokumente (`DocumentCompositionTest`). Schwerpunkte:
| Thema | Absicherung |
|---|---|
| Vertragsverbindlichkeit, Angebotsversionen, Preisfestlegung | unveränderte Module; Loyalty-Nachweis und Angebots-Tests grün |
| Reservierungsfristen | Halte-Logik unverändert; Portalbestätigung berührt `occupying()` nicht (Test: Belegung bleibt während des Wartens) |
| Portalbestätigungen, Idempotenz | Mail zweimal → ein Vorgang; Aufgabe „Portalbestätigung fehlt“ nur einmal; zweiter Lauf von `bookings:advance-waiting` ohne Wirkung |
| Nachrichten: Zuordnung, Dubletten, Widersprüche | gleiche externe Kennung → einmal gespeichert; Absender/Name/Zeitraum allein ordnen nie zu; abweichende Vorgangsnummer → `review` |
| Bestehende Buchungen | Einstellungen mit V2-Standardwerten; eingefrorene Pläne (Version 1 bleibt) |
| Versand | Mail-Gate `EnforceMailTestMode` unverändert; keine neuen Versandwege; Medien-Antworten werden nicht gesendet |
| Mandantentrennung | `communication_rules` je Mandant, `InboundMessage` mandantengebunden (`BelongsToTenant`) |
| Sandbox | Szenarien nutzen nur die Sandbox-Datenbank; Sicherheitstests grün |
## 4. Offene Fachfragen (bewusst nicht entschieden)
Siehe `01_KONFIGURATIONSLUECKEN.md` F1–F7: Einwilligung für WhatsApp je Absender, Ausbleiben-Frist (48 h ist ein Vorschlag, einstellbar), Inkasso bei Destination Solutions, Storno/Erstattung je Modell, DS-/FW-Prüfungen. Kein Provideranschluss für WhatsApp/Chat; sie sind Testfälle der Architektur und standardmäßig **ausgeschaltet** (`config/communication.php`).
## 5. Kritische Selbstprüfung
1. **Konfigurierbarkeit wiederhergestellt oder nur weitere starre Modelle?** Wiederhergestellt, soweit fachlich zulässig: Innerhalb eines Archetyps stellt der Betreiber Ausführungsvariante, Dokumentenbehandlung, Wartebedingung, Zuständigkeit und Kommunikationswege ein; das Modell folgt aus den Kanalfähigkeiten. Neue Modelle (a3–a5 v2) enthalten nur zusätzliche Module, keine neuen Sonderabläufe.
2. **DS auf anderes Modell?** Ja (Fall B): Fähigkeit bestätigen → A4, mit erklärtem Abgleich alter Werte. Ohne neue A4-Logik.
3. **Dokumente unabhängig?** Ja: Vertrag erstellen/ablegen/senden, Buchungsinformation und Ergänzungsunterlagen getrennt; Pflichtgrenzen (Vertragsinhalt, Freigabe der Dokumentarten) bleiben.
4. **Auf Portal-Mail oder überprüften Eingang warten?** Ja (Fall C): Portal-Mail, die dem Vorgang deterministisch zugeordnet ist, oder Bestätigung des Vermieters.
5. **Medien mit unterschiedlichen Befugnissen je Absicht?** Ja: Wirkungen je Medium × Absicht; Vermieter dürfen nur einschränken.
6. **WhatsApp löst Auskunft aus, ohne Buchungskanal zu sein?** Ja (Fall F): `answer_information` / `handoff_inquiry`; kein Wirkungstyp erzeugt Vorgang oder Buchung.
7. **Künftiger KI-Chat?** Ja, als Adapter: Er liefert `IncomingMessage` mit überprüftem Bezug; Klassifikation und Regeln liegen im Kern. Der Chat-Anschluss ist nicht gebaut; die Absichtserkennung kann später hinter derselben Schnittstelle (`IntentClassifier`) durch ein Modell ersetzt werden.
8. **Unabhängige Schritte schreiten fort?** Ja (Fall G, `ProcessRunner`: harte Abhängigkeit hält nur den abhängigen Schritt).
9. **Tatsächliches Verhalten oder starre Liste?** Ansicht aus denselben Definitionen wie die Ausführung; Phasen gruppiert, Abhängigkeiten, Unabhängigkeit, Bedingungen und Ausführungsvarianten sichtbar. Einschränkung: keine grafische Darstellung (bewusst, kein BPMN-Editor).
10. **Im Tester durchspielbar?** Ja, drei neue Szenarien; Entwurfseinstellungen werden ohne Speichern getestet. Die geforderte Szenarienliste ist damit nicht vollständig als einzelne Szenarien abgebildet: Dokumentvarianten und eingefrorene Konfiguration laufen über den Entwurf bestehender Szenarien (siehe Abschnitt 6).
11. **Änderungen beeinflussen andere Archetypen?** Nein: Version 1 der Modelle bleibt, neue Module bedingt/aus als Standard, Standardabläufe unverändert (Test), `process:impact` zeigt die betroffenen Modelle.
12. **Verständlich und wirtschaftlich?** Die neuen Einstellungen sind Auswahlfelder an dem Schritt, den sie betreffen, mit Standard „wie bisher“; Einschränkungen werden in Klartext erklärt. Für Vermieter mit nur einer Website ändert sich nichts. Aufwand der Konfiguration lohnt sich vor allem für Portalkanäle; das ist so gewollt.
## 6. Bekannte Grenzen und Restpunkte
- Dokumentvarianten, Stammdaten-Abgleich, eingefrorene Konfiguration und unabhängige Aktivitäten sind als Tests, nicht als eigene Tester-Szenarien abgebildet (der Tester spielt die Szenarien mit beliebigen Entwurfseinstellungen durch).
- Eingehende Nachrichten anderer Medien werden gespeichert und entschieden; ein Posteingangs-Bildschirm zeigt `medium`, `intent` und `decision` nicht gesondert an.
- Keine Antwort wird über WhatsApp/Chat gesendet.