7.4 KiB
Management-Zusammenfassung: Kontrolliert modulare Prozessarchitektur
Stand: 04.11.2026, Review V2 · Planungsergebnis, nach den Korrekturen K1–K10 implementierungsreif. Es wurden kein Code, keine Migration und keine Buchung oder Kanalkonfiguration geändert.
Dokumente:
- 01 Architekturbewertung – Soll-Ist, korrigierte Aussagen, Architekturcheck
- 02 Fachmodul-Architektur – Modulgrenzen, Vertrag, Versionierung, Runner, Kanalereignisse
- 03 Kanalkonfigurator – Modellwahl, Verantwortungsmatrix, Konfiguration am Schritt
- 04 Prozess-Tester – Sandbox-Anfrage, Sicherheits- und Negativtests
- 05 Änderungsanalyse und Tests – Verhaltensvergleich, Bestandsfälle, N1–N7
- 06 Migrations- und Umsetzungsplan – Pakete, Deploymentweg, Entscheidungsmatrix
Kennzeichnung: [Befund], [Vorschlag], [Entschieden], [Entscheidung offen].
Architektur V2 (angenommen)
- Fachmodule mit Vertrag: Sie rufen die bestehenden Actions auf.
- Der Katalog ist ein Startumfang. Ob etwas Parameter, Modulerweiterung oder neues Modul wird, entscheiden Kriterien, keine Sollzahl.
- Jedes Vertragsfeld nennt, womit es geprüft wird.
- Prozessmodelle (
a1.offer,a4.portal_booking…): zentral im Code, versioniert, mit festen Erweiterungspunkten und den bestimmenden Verantwortungen des Archetyps. - Kanalkonfigurator: Das Modell wählt der Vermieter je Kanal × Eingangsart. Alles Weitere stellt er am Schritt ein: an/aus, Ausführende im zulässigen Rahmen, Ausführungsart, Fristen, Nachweis. Dazu gibt es eine Vorschau.
- Ein Ablaufkern (
ProcessRunner) ersetzt die verdrahteten Inhalte vonCaseActivitiesundCaseAutomation.- Ein Schritt läuft, wenn seine fachlichen Voraussetzungen erfüllt sind. Ein wartender Schritt hält nur die Schritte auf, die von ihm abhängen.
- Der Zustand bleibt aus den Falldaten abgeleitet; es gibt keine zweite Wahrheit.
- Prozess-Tester in einer eigenen Sandbox-Anfrage: Dort ist nur ein Speicher je Lauf konfiguriert, alle Außenwege sind gesperrt oder simuliert.
- Kanalereignisse als zusätzlicher Eingang für künftige APIs, abgebildet auf den vorhandenen Eingang. iCal und Mail bleiben unverändert.
Was die Überarbeitung korrigiert hat
| Korrektur | |
|---|---|
| K1 | Runner nach fachlichen Abhängigkeiten statt „erster offener Schritt“. Belegt am Szenario fehlende Anschrift → Klärungsreservierung → Rückfrage → Fristablauf → spätere Antwort → Angebot (02 §7.6). Auslöser bleiben die vorhandenen; die heute verteilten Direktaufrufe laufen über den Runner. |
| K2 | Vier Stufen: Parameter / Modulerweiterung / neues Modul / neuer Erweiterungspunkt. Prüffälle Loyalty und Adressprüfung ohne Eingriff in andere Archetypen. |
| K3 | Vier Ebenen: Vertragsdaten, Prozessdefinition, Implementierung, Fehlerkorrektur. Regeln R1–R6; Bestandsfall-Tests mit eingefrorenen v0.11-Fällen prüfen bei jedem Release Preise, Stornokosten, Fälligkeiten, Vertragstext und Ablauf. |
| K4 | Meldung → zugeordnete Portalinformation → bestätigte Erledigung → zulässige Vertragsänderung (M1–M4). Die Vertrauensstufe einer Quelle ist kein Nachweis. Ereignisverträge für Buchung, Storno, Änderung, Zahlung, Auszahlung. |
| K5 | Das Umschalten in der Admin-Anfrage ist nicht ausreichend sicher und wird ersetzt durch die eigene Sandbox-Anfrage („standardmäßig gesperrt“). 15 Negativtests. Die Grenze native PHP-Aufrufe ist benannt und durch einen statischen Test abgedeckt. |
| K6 | Verantwortungsmatrix A1–A6. Archetypbestimmend sind Vertragsabschluss, Inkasso und Vertragsdokumentation. Variabel am Schritt sind Kommunikation, ergänzende Unterlagen, Anreiseinformation und lokale Leistungen. |
| K7 | Weg: Entwicklungszweig → Regression → Merge develop → Push → automatisches Deployment stommer.info → technische Prüfung → fachliche Abnahme. Kein main. |
| K8 | Loyalty nur im Tester; für echte Buchungen technisch nicht aktivierbar. |
| K9 | Verhaltensvergleich in acht Dimensionen. Ein Fehlerregister verhindert, dass bekannte Fehler zur Norm werden. Jede beabsichtigte Abweichung hat eine Begründung und einen Test. |
| K10 | Ereignisse ergänzen, statt den Eingang umzubauen: 2 kleine Änderungen in PortalIntake. Die Duplikatregeln bleiben eine Implementierung. |
Korrigiert wurden auch zu weit gehende Aussagen des ersten Entwurfs (01 §2.8):
- „alle Actions unverändert“: tatsächlich ändern sich Aufrufstellen, nicht die Fachlogik;
- „jede Schicht verhindert jeden Schaden“;
trust= Nachweis;- Merge nach
main.
Was erhalten bleibt [Befund]
- Fachlogik der Actions,
PriceCalculator, Faktenaufnahme mit Herkunft, Datenbeschaffung, Nachrichteneingang mit KI; - Mail-Schranke, Vererbung und Einfrieren der Einstellungen;
- iCal- und Mail-Eingang samt E-019-Regeln;
- Datenmodelle (neue Angaben in vorhandenen JSON-Spalten);
- die Testsuite.
Neu ist eine Tabelle für Testberichte. Eine Spalte für deren Aufbewahrungsfrist kommt hinzu, falls die Frist wie die übrigen am Mandanten geführt wird.
Aufwand (Schätzung)
34–45 Entwicklertage (vorher 32–41) zuzüglich 1–2 Tage Betreiberzeit.
- Mehraufwand: Bestandsaufnahme U-0, abhängigkeitsbasierter Runner, Verantwortungsmatrix, Sandbox-Anfrage, Negativtests.
- Minderaufwand: kein Umbau des Kanaleingangs.
- Größte Unsicherheit: der Umfang des Fehlerregisters aus dem Verhaltensvergleich.
Verbleibende Risiken
- Verhaltensabweichung im Umbau, besonders bei Mails, die einander ersetzen (Rückfrage statt Eingangsbestätigung). Gegenmaßnahme: Verhaltensvergleich mit Kommunikationsdimension.
- Gemeinsame Actions und Bestandsfälle. Gegen Fehler in Code, der Vertragsdaten schreibt, schützt nur die Testabdeckung. Gegenmaßnahme: Bestandsfall-Tests,
readsContractData. - Server-Voraussetzungen:
pdo_sqlite(V1) oder ein getrennter DB-Benutzer (V6). Ist beides nicht gegeben, ist der Tester auf diesem Server nicht verfügbar. - Native PHP-Aufrufe am Framework vorbei sind zur Laufzeit nicht abfangbar. Sie werden nur über den statischen Test ausgeschlossen.
- Parallele Feature-Zweige: Konflikte in
CaseActivities/ViewBooking(Klärung in U-0).
Entscheidungen
Entschieden sind E1–E9, D3/D4/D6 sowie – mit dem Implementierungsauftrag vom 04.11.2026 – O1–O5 (06 §9.2):
- O1: Vertragsdokumentation bleibt archetypbestimmend.
- O2: FeWo-direkt: Anfrage A2, Buchung zunächst nur A4; Destination Solutions A3; gesteuert über das Kanalprofil.
- O3: Testberichte 30 Tage, im Löschkonzept.
- O4: Zugeordnete Portal-Storno-/Änderungsmeldungen setzen betroffene automatische Außenwirkungen aus.
- O5: Abschluss bei Portal-Inkasso nur nach finanzieller Klärung.
Zusätzliche technische Anforderungen: T1 harte/weiche Abhängigkeiten (02 §7), T2 tatsächliche Sicherheitsgrenzen des Testers (04 §3), T3 historische Modellversionen (02 §5.3, 06 §10).
Umsetzungsstand
Umgesetzt auf feature/prozessarchitektur-v2 (U-0 bis U-E), Abweichungen und Einschränkungen in 06 §10, Ergebnisse im Abschlussbericht (../Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md) und im Abnahmeprotokoll (../Abnahme/ARCHITEKTUR_MODULAR_ABNAHME.md).