From dba6292cd4df1f666d3b451048f100614ddfc1b5 Mon Sep 17 00:00:00 2001 From: Lars Date: Wed, 4 Nov 2026 15:41:24 +0100 Subject: [PATCH] =?UTF-8?q?Dokumentation=20V2:=20Entscheidungen=20O1?= =?UTF-8?q?=E2=80=93O5,=20T1=E2=80=93T3,=20Umsetzungsstand,=20Abschlussber?= =?UTF-8?q?icht,=20Abnahmeprotokoll,=20Betrieb,=20L=C3=B6schkonzept,=20Sta?= =?UTF-8?q?tus,=20Modulmatrix?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit Co-Authored-By: Claude Opus 5.5 --- .../ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md | 136 ++++++++++++++++++ docs/STATUS.md | 22 ++- 2 files changed, 157 insertions(+), 1 deletion(-) create mode 100644 docs/Prozessarchitektur/Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md diff --git a/docs/Prozessarchitektur/Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md b/docs/Prozessarchitektur/Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md new file mode 100644 index 0000000..bdf75dd --- /dev/null +++ b/docs/Prozessarchitektur/Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md @@ -0,0 +1,136 @@ +# 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):** + - `ProcessRunner` mit harten und weichen Abhängigkeiten, Neubewertung nach jedem Schritt, Auslösern aus der Moduldefinition und Aussetzen nach O4. + - `CaseActivities` und `CaseAutomation` sind Fassaden darüber. + - Die Automatik von `CreateReservation`, `TakeOverExternalBooking`, `SubmitBookingWish` und `bookings:auto-offers` läuft über den Runner. +- **Fachmodule:** 25 registrierte Module (`config/process.php`, `MODULMATRIX.md`), davon 2 nur im Tester (Loyalty). Jedes hat eine `ModuleDefinition` als Vertrag. +- **Prozessmodelle:** `a1.offer` (Varianten `standard`, `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.plan` eingefroren (Modell, Version, Variante, Modulversionen, Schritteinstellungen, Bezeichnungen); + - Bestandsfälle ohne Plan erhalten beim Lesen den abgeleiteten Plan (keine Datenänderung). +- **Preis-Erweiterungspunkt (U-B):** `CasePricing` in `SendOffer::quoteFor`. Ohne Beiträge ist das Ergebnis gleich `PriceCalculator`; für verbindliche Fälle gibt es nie Beiträge. +- **Loyalty-Nachweis (U-B):** `guest.loyalty_status` und `pricing.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`, `PayoutReported` mit `Provenance`, dazu `ChannelEventHandler` und die Schnittstellen `DeliversEvents`/`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 `--cases` die eingefrorenen Pläne aller Vorgänge; `--matrix`), läuft in der CI; + - `process:impact `; + - `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 kein `env()` in `app/` 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önnte `shared/.env` lesen; 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_TYPES` bleibt als zweite Liste bestehen (I-001 entfällt). + +## 8. Bereitstellung auf stommer.info + +Wird nach Merge, Push und Deployment mit Revision, Migrationsstatus, Prüfsummen und den Ergebnissen der technischen Prüfung ergänzt. + +## 9. Offene Fehler, Risiken, Entscheidungen + +- **F-003:** instabiler Test `TenantBrandRenderingTest` (nicht prozessbezogen). +- **Risiko:** Ob `proc_open` im 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. diff --git a/docs/STATUS.md b/docs/STATUS.md index 9561664..4ffc20e 100644 --- a/docs/STATUS.md +++ b/docs/STATUS.md @@ -1,6 +1,26 @@ # Projektstand -## Aktueller Stand (03.11.2026) +## Aktueller Stand (04.11.2026): Modulare Prozessarchitektur V2 + +**Umgesetzt auf `feature/prozessarchitektur-v2` (Pakete U-0 bis U-E, Entscheidungen O1–O5, Anforderungen T1–T3):** + +- **Prozesskern:** Fachmodule mit Verträgen, versionierte Prozessmodelle A1–A6 und ein beim Eingang eingefrorener Prozessplan. +- **Ablaufsteuerung:** `ProcessRunner` mit harten und weichen Abhängigkeiten. `CaseActivities` und `CaseAutomation` sind Fassaden darüber. +- **Kanalkonfigurator:** Kanal › Ablauf mit Modellwahl nach Kanalprofil, Einstellungen am Schritt und Vorschau. +- **Prozess-Tester:** „Ablauf testen“ läuft in einem eigenen, abgeschotteten PHP-Prozess. Ohne die Voraussetzungen auf dem Server ist er gesperrt. +- **Weitere Bausteine:** Kanalereignisse für künftige Portal-Schnittstellen sowie die Befehle `process:check`, `process:impact` und `process:fingerprint`. +- **O4:** Gemeldete Portal-Stornierungen und -Änderungen setzen automatische Nachrichten aus. +- **O5:** Kaufmännischer Abschluss bei Portal-Inkasso nur nach finanzieller Klärung. + +Dokumente: + +- [Abschlussbericht](Prozessarchitektur/Implementierungsstände/ABSCHLUSSBERICHT_PROZESSARCHITEKTUR_V2.md) +- [Abnahmeprotokoll und Drehbuch](Prozessarchitektur/Abnahme/ARCHITEKTUR_MODULAR_ABNAHME.md) +- [Architektur 00–06](Prozessarchitektur/Architektur/00_MANAGEMENT_ZUSAMMENFASSUNG.md), [Umsetzungsstand und Abweichungen](Prozessarchitektur/Architektur/06_MIGRATIONS_UND_UMSETZUNGSPLAN.md) +- [Bestandsaufnahme U-0](Prozessarchitektur/Implementierungsstände/U0_BESTANDSAUFNAHME_PROZESSARCHITEKTUR_V2.md) +- Betrieb: `BETRIEB.md` §7b + +## Stand (03.11.2026) **Prozessarchitektur v0.11: integrierter MVP umgesetzt (Pakete U1–U6), automatisiert getestet, noch nicht auf dem Testsystem.**