Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
9.9 KiB
Abschlussbericht: Kontrolliert modulare Prozessarchitektur V2
Stand: 04.11.2026 · Grundlage: Architekturdokumente docs/Prozessarchitektur/Architektur/00–06 (750c1ed), Implementierungsauftrag vom 04.11.2026 mit den Entscheidungen O1–O5 und den Anforderungen T1–T3.
Dieser Bericht nennt nur Nachgewiesenes. Was nicht geprüft werden konnte, steht unter „Offen“.
1. Repository und Bereitstellung
| Umsetzungszweig | feature/prozessarchitektur-v2 (von feature/aufenthalt @ 750c1ed, Code-Stand = develop 7e4e208) |
| Commits | 98df5e9 U-0 · 7e22e12 U-A/U-B · d695566 Analysebefehle, O4 · c255783 U-C · 0689c0a U-D/U-E/O5 · Dokumentation (siehe Git-Historie) |
Merge nach develop, Deployment |
siehe §8 (wird nach dem Deployment ergänzt) |
main |
unverändert, kein Produktivdeployment |
2. Implementierte Funktionen
-
Prozesskern (U-A):
ProcessRunnermit harten und weichen Abhängigkeiten, Neubewertung nach jedem Schritt, Auslösern aus der Moduldefinition und Aussetzen nach O4.CaseActivitiesundCaseAutomationsind Fassaden darüber.- Die Automatik von
CreateReservation,TakeOverExternalBooking,SubmitBookingWishundbookings:auto-offersläuft über den Runner.
-
Fachmodule: 25 registrierte Module (
config/process.php,MODULMATRIX.md), davon 2 nur im Tester (Loyalty). Jedes hat eineModuleDefinitionals Vertrag. -
Prozessmodelle:
a1.offer(Variantenstandard,loyalty= nur Tester),a1.information,a2.offer,a2.information,a3/a4/a5.portal_booking,a6.internal, jeweils Version 1. Jedes mit Erweiterungspunkten, festen und variablen Verantwortungen und festgelegten Einstellungen. -
Prozessplan:
- wird beim Eingang in
bookings.profile.planeingefroren (Modell, Version, Variante, Modulversionen, Schritteinstellungen, Bezeichnungen); - Bestandsfälle ohne Plan erhalten beim Lesen den abgeleiteten Plan (keine Datenänderung).
- wird beim Eingang in
-
Preis-Erweiterungspunkt (U-B):
CasePricinginSendOffer::quoteFor. Ohne Beiträge ist das Ergebnis gleichPriceCalculator; für verbindliche Fälle gibt es nie Beiträge. -
Loyalty-Nachweis (U-B):
guest.loyalty_statusundpricing.loyalty_discount. Für echte Vorgänge technisch nicht aktivierbar (Konfigurator und Plan weisen ab). -
Kanalkonfigurator (U-C): Kanal › Ablauf. Je Eingangsart werden die zulässigen Modelle nach Kanalprofil angeboten (O2). Die Schritte stehen nach Phasen, mit:
- Schalter (nur optionale Schritte);
- Ausführungsart;
- Ausführenden im Rahmen des Modells;
- Fristen mit Herkunft „hier gesetzt / geerbt“ und Zurücksetzen;
- Vorschau und „Ablauf testen“ mit dem ungespeicherten Entwurf.
Gespeichert wird über
ConfigureChannelProcess. Die flache Liste im Kanalformular entfällt. -
Prozess-Tester (U-D): Szenarien
- vollständige Anfrage;
- fehlende Anschrift mit später Antwort (Link oder E-Mail);
- Portalanfrage;
- Stammgast;
- Mailausfall;
- Portalbuchung mit Duplikat, Beträgen und Storno-Meldung.
Die Szenarien laufen schrittweise in einem eigenen PHP-Prozess. Der Bericht wird gespeichert und nach 30 Tagen gelöscht.
-
Kanalereignisse (U-E):
IncomingBooking,BookingCancelledByChannel,BookingChangedByChannel,PaymentReported,PayoutReportedmitProvenance, dazuChannelEventHandlerund die SchnittstellenDeliversEvents/ReceivesWebhooks. iCal und Mail bleiben unverändert. -
Entscheidungen:
- O1 und O2 über Verantwortungsmatrix und Kanalprofile;
- O3: Löschfrist 30 Tage;
- O4:
OutwardSuspension; - O5: Klärungsart beim kaufmännischen Abschluss.
-
Analyse:
process:check(Katalog; mit--casesdie eingefrorenen Pläne aller Vorgänge;--matrix), läuft in der CI;process:impact <modul>;process:fingerprint(Prüfsummen vor/nach Deployment).
3. Geänderte bestehende Anwendungskomponenten
| Datei | Änderung |
|---|---|
Process/CaseActivities, Process/CaseAutomation |
Fassaden über ProcessRunner (Ableitung in Module verschoben) |
Process/CaseRecorder |
friert den Plan mit ein |
Process/ProcessSettings, ProcessProfile |
Festlegungen des gewählten Modells (Herkunft „Ablaufmodell“) |
Process/CaseClosure |
O5: Klärungsart bei offener Portal-Auszahlung |
Actions/CreateReservation, TakeOverExternalBooking, SubmitBookingWish, Console/SendPendingAutoOffers |
Automatik über den Runner |
Actions/SendOffer |
Preis über CasePricing |
Actions/SendBookingReminders, RequestReviews |
O4; Bewertungsbitte je Kanal abschaltbar |
Actions/AnonymizeGuests, Support/SystemSettings, config/fewo.php |
Löschfrist Testberichte (O3), PHP-Programm des Testers |
Channels/Intake/PortalIntake, Actions/TakeOverExternalBooking, Models/IntakeObservation |
Quelle api, reportToCase |
Filament/.../ChannelResource, EditChannel, ChannelForm, HandlesWishAndStay, effective-settings |
Seiten Ablauf/Ablauf testen, Kanalprofil, Klärungsart |
Providers/AppServiceProvider, bootstrap/app.php |
Registerdienst; Sandbox-Bootstrap nur im Testprozess; keine Betreibereinstellungen im Testprozess |
config/channels.php |
Kanalprofile (O2) |
pipeline.toml |
process:check in der CI, process:sandbox-template nach migrate |
Fachlogik der übrigen Actions, PriceCalculator, Fakteneingang, Datenbeschaffung, Posteingang/KI, Mail-Schranke, SyncChannel, ProcessPortalMail: unverändert.
4. Migrationen
Eine neue Tabelle process_test_runs (2026_11_07_100000). Keine Änderung bestehender Tabellen oder Daten. Bestandsvorgänge erhalten keinen Plan geschrieben; er wird beim Lesen abgeleitet.
5. Testresultate (lokal, SQLite)
| Lauf | Ergebnis |
|---|---|
Ausgangsstand U-0 (7e4e208 + Testwerkzeug) |
772 Tests, 771 grün; 1 im Gesamtlauf instabil (TenantBrandRenderingTest, einzeln grün; F-003) |
| nach U-A | 785/785 |
| nach U-C | 820/820 |
| nach U-D/U-E/O5 (Endstand vor dem Merge) | 856/856 (Laufzeit 6,3 min) |
process:check |
25 Module, 8 Modelle, ohne Befund |
npm run build |
erfolgreich |
Verhaltensvergleich v0.11 → V2:
- 11 Abläufe mit 39 Ereignissen und 198 Zustandskonstellationen in acht Dimensionen sind gleich.
- Abweichungen gibt es nur bei I-004/I-005, den Korrekturen der Fehler F-001/F-002.
- 12 eingefrorene Bestandsfälle liefern gleiche Stornokosten, Fälligkeiten und Vertragstext-Hashes. Die einzige Abweichung ist I-005 im Detailtext. Die Automatik ändert keine Vertragsdaten.
6. Sicherheitsnachweise des Prozess-Testers (T2)
-
15 Negativtests (
ProcessTesterSecurityTest):- andere Datenbankverbindung;
- neue Verbindung auf die Betriebsdatei;
- umgeleitete Sandbox-Verbindung;
- Betriebstabellen;
- Netz, Webhook, IMAP, fremder Mailer, Dateiablage außerhalb, fremder Cache;
- Umgebung und Zugangsdaten mit eigenem Schlüssel und ohne echte Vorgänge;
- signierter Link außerhalb ungültig;
- Laufbefehl ohne vorbereiteten Lauf;
- zweiter Lauf desselben Vermieters;
- Aufräumen abgebrochener Läufe.
Jeder Verstoß wird aufgezeichnet und bricht den Lauf ab. Der Prüfsummenvergleich der „Betriebsdatenbank“ (eigene SQLite-Datei) ergibt jeweils keine Änderung.
-
Statischer Wächter
SideEffectPathsTest: keine nativen Netz-, Mail-, Datenbank-, Datei- oder Programmaufrufe und keinenv()inapp/außerhalb einer begründeten Positivliste. -
Restrisiko: Auf Shared Hosting gibt es keine Trennung auf Betriebssystemebene (
04§3.1a,BETRIEB.md§7b). Nativer Code könnteshared/.envlesen; das verhindert nur der statische Wächter.
7. Bekannte Einschränkungen
Siehe 06 §10:
- API- und iCal-Sperre derselben Buchung stehen bis zur Klärung nebeneinander (ein Vorgang).
- Die E-Mail-Antwort im Tester wird als ausgewertete Angaben eingespielt.
- „So arbeite ich“ ist noch nicht auf die Schrittansicht umgestellt.
ActivityDetails::EVENT_TYPESbleibt als zweite Liste bestehen (I-001 entfällt).
8. Bereitstellung auf stommer.info
Bereitgestellt am 04.11.2026.
- Vor dem Merge geprüft:
origin/developunverändert auf7e4e208, keine parallelen Änderungen; aktives Release20261103170806-7e4e208d; keine ausstehenden Migrationen; beide Mandanten im Testbetrieb. - Merge und Push: Merge nach
develop(--no-ff, Merge-Commit79f3344, Bereitstellungsstand9f63059). Push7e4e208..9f63059; das automatische Deployment hat das Release20261104150804-9f630594aktiviert. - Technische Prüfung des Releases:
- Migration
2026_11_07_100000_create_process_test_runs_table: Ran. process:check --cases: 25 Module, 8 Modelle, ohne Befund (auch die eingefrorenen Pläne aller Vorgänge).- Testvorlage
shared/storage/app/sandbox/template.sqlitebeim Deployment erzeugt. process:fingerprintgleich wie vor dem Deployment: 10 Buchungen, 7 Kanäle, 13 Sperren;h_bookingsab8b708e0479aeb3bd902b3fd538462b,h_overridesb3ea60a060bea2b417fc78bba5dd852b,h_blocksd6305a420d17c1928cfce54f0c94bb8b. Bestehende Buchungen, Kanalprofile und Sperren sind unverändert.
- Migration
- Nicht per SSH prüfbar: ob das Web-PHP (Handler
x-httpd-php84)proc_openerlaubt. Das zeigt die Seite Kanal › Ablauf › „Ablauf testen“ nach der Anmeldung: Ist es gesperrt, nennt sie den Grund, und der Tester bleibt gesperrt (Abnahmeblocker nach T2). - Nächster Schritt: fachliche Abnahme nach Drehbuch Teil B.
9. Offene Fehler, Risiken, Entscheidungen
- F-003: instabiler Test
TenantBrandRenderingTest(nicht prozessbezogen). - Risiko: Ob
proc_openim Web-PHP von Strato erlaubt ist, zeigt erst das Testsystem. Ist es gesperrt, bleibt der Tester gesperrt, und die Hosting-Voraussetzung ist ein Abnahmeblocker (T2). - Verbleibende fachliche Entscheidungen:
- keine neuen aus der Umsetzung;
- für eine spätere produktive Loyalty: Berechtigung, Staffel, Kombination und Umbuchung (E5–E7);
- Freigabe weiterer Modelle für FeWo-direkt (O2) nach Klärung FW-01 bis FW-07.