V2.1: Erweiterungspunkt-Nachweis, Fälle G/H, Abnahmeprotokoll, Status

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Sonnet 5.5 committed 2026-11-05 08:17:51 +01:00
1 parent fdf226535b
commit 0d51c673eb
7 files changed
+239 -2

No files matched your search

@@ -0,0 +1,73 @@
# 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.