Files
fewo-stommer/docs/Prozessarchitektur/V2.1/ABNAHME_V2_1.md
T

11 KiB
Raw Blame History

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

  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.