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:
1 parent
0689c0a591
commit
dba6292cd4
2 files changed
+157
-1
No files matched your search
+136
@@ -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
@@ -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.**
|
||||
|
||||
|
||||
Reference in new issue
Block a user