11 KiB
V2.1 – Abnahme: Fälle A–H und kritische Selbstprüfung
Stand: 05.11.2026, Branch feature/prozessarchitektur-v2-1. Grundlage: 01 Lücken, 02 Zielbild. 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
- 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.
- DS auf anderes Modell? Ja (Fall B): Fähigkeit bestätigen → A4, mit erklärtem Abgleich alter Werte. Ohne neue A4-Logik.
- Dokumente unabhängig? Ja: Vertrag erstellen/ablegen/senden, Buchungsinformation und Ergänzungsunterlagen getrennt; Pflichtgrenzen (Vertragsinhalt, Freigabe der Dokumentarten) bleiben.
- Auf Portal-Mail oder überprüften Eingang warten? Ja (Fall C): Portal-Mail, die dem Vorgang deterministisch zugeordnet ist, oder Bestätigung des Vermieters.
- Medien mit unterschiedlichen Befugnissen je Absicht? Ja: Wirkungen je Medium × Absicht; Vermieter dürfen nur einschränken.
- WhatsApp löst Auskunft aus, ohne Buchungskanal zu sein? Ja (Fall F):
answer_information/handoff_inquiry; kein Wirkungstyp erzeugt Vorgang oder Buchung. - Künftiger KI-Chat? Ja, als Adapter: Er liefert
IncomingMessagemit ü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. - Unabhängige Schritte schreiten fort? Ja (Fall G,
ProcessRunner: harte Abhängigkeit hält nur den abhängigen Schritt). - 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).
- 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).
- Änderungen beeinflussen andere Archetypen? Nein: Version 1 der Modelle bleibt, neue Module bedingt/aus als Standard, Standardabläufe unverändert (Test),
process:impactzeigt die betroffenen Modelle. - 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,intentunddecisionnicht gesondert an. - Keine Antwort wird über WhatsApp/Chat gesendet.