Dokumentation V2: Entscheidungen O1–O5, T1–T3, Umsetzungsstand, Abschlussbericht, Abnahmeprotokoll, Betrieb, Löschkonzept, Status, Modulmatrix

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
LarsandClaude Opus 5.5 committed 2026-11-04 15:41:24 +01:00
1 parent 0689c0a591
commit dba6292cd4
2 files changed
+157 -1

No files matched your search

@@ -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 <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 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.
+21 -1
View File
@@ -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.**