Files

314 lines
26 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# 04 – Prozess-Tester „Ablauf testen“: gleiche Logik, standardmäßig gesperrt, nachweisbare Isolation
Stand: 04.11.2026, **Review V2** (K5, E4, E8, E9 eingearbeitet) · Kennzeichnung: **[Befund]**, **[Vorschlag]**, **[Entschieden]**, **[Entscheidung offen]**
---
## 1. Zweck und Abgrenzung [Vorschlag]
Der Vermieter spielt mit der gerade bearbeiteten Kanalkonfiguration einen **synthetischen Vorgang** durch. Die Konfiguration darf ungespeichert sein. Er sieht Schritt für Schritt:
- welche Module liefen und mit welchem Ergebnis;
- was übersprungen wurde und warum;
- was als Nächstes kommt;
- welche Aufgaben offen sind;
- welche Wirkungen **simuliert** wurden.
| | Prozess-Tester | Integrationstest |
|---|---|---|
| Frage | Verhält sich **mein** Ablauf mit **meiner** Konfiguration so, wie ich will? | Funktioniert die Verbindung zu Portal, Postfach, KI, Mailserver wirklich? |
| Fachlogik | echt: dieselben Module, Actions, Preisberechnung | echt |
| Daten | synthetisch, eigener Speicher je Lauf | echt (Testsystem) oder Testkonto beim Anbieter |
| Außenverbindungen | **alle simuliert**, Antworten laut Szenario | echt |
| Wer, wo | Vermieter, im Konfigurator, auch auf dem Produktivsystem | Entwickler/Betreiber: PHPUnit, Prüfknöpfe (`AiConnection::check`, `Operations::checkMailbox`), Abnahme auf stommer.info |
| Aussage zur Schadensfreiheit | ja, das ist sein Zweck (§3) | nein; er wirkt absichtlich nach außen |
---
## 2. Dieselbe fachliche Logik [Vorschlag]
### 2.1 Prinzip
Der Tester enthält **keine** Fachregeln. Er ist ein Treiber mit drei Aufgaben:
1. Er legt den Ausgangszustand im isolierten Speicher an (§3).
2. Er löst Ereignisse über **dieselben Einstiegspunkte** aus wie Controller, Kommandos und Connectors.
3. Er liest danach den Ablauf über `ProcessRunner::activities`, also dieselbe Methode wie `ViewBooking`.
| Szenario-Ereignis | Einstiegspunkt im Betrieb |
|---|---|
| Anfrage über die Webseite | `CreateReservation::handle` |
| Anfrage oder Buchung per Portal-Mail | `ProcessPortalMail::handle(PortalMail)` mit synthetischer `PortalMail` |
| Portalbuchung über iCal | `SyncChannel::handle` mit `ScriptedConnector` |
| Portalbuchung über künftige API | `ChannelEventHandler::handle(IncomingBooking)` (`02` §8) |
| Gast ergänzt Angaben per Formular | dieselbe Action wie `GuestDataController` (`ContributeCaseFacts`, `FactSource::GuestLink`) |
| Gast antwortet per E-Mail | `ReceiveInboundMessage` → `MessageMatcher` → `ExtractMessageFacts` mit Skript-Antwort der KI |
| Vermieter gibt frei / sendet | Modul-`run` bzw. dieselbe Action wie die Kopfaktion in `ViewBooking` |
| Gast nimmt an / lehnt ab | `AcceptOffer`, `RejectOffer` |
| Zeit vergeht | simulierte Uhr + dieselben Handler: `ExpireReservations`, `bookings:auto-offers`-Logik, `RequestCaseData::remindDue`, `SendBookingReminders`, `PrepareStays`, `RequestReviews` |
| Portal meldet Zahlung/Auszahlung | `RecordPortalAmounts` bzw. `PaymentReported`/`PayoutReported` |
| Ausfall | Effekt-Port wirft den echten Fehlertyp (`TransportException`, `AccessRejected`, `ChannelSyncException`) |
### 2.2 Nachweis der Gleichheit
- **`ProcessTesterParityTest`:** Jedes Szenario läuft zusätzlich ohne Tester auf der normalen Testdatenbank, über dieselben Actions. Verglichen werden Ablauf, Status und Effektliste; jede Abweichung lässt den Test fehlschlagen.
- **Vorschau gegen Wirklichkeit:** Die Vorschau (`ProcessRunner::plan`) wird gegen die Ablaufliste eines danach eingehenden echten Vorgangs geprüft (K03).
- **Architekturtest:** Unter `app/Process/Tester` liegt keine Klasse, die `ProcessModule` implementiert oder Actions, `PriceCalculator` oder `AvailabilityChecker` ableitet.
---
## 3. Technische Isolation (K5)
### 3.1 Bewertung des bisherigen Entwurfs
Der bisherige Entwurf schaltete **innerhalb der Admin-Anfrage** die Standardverbindung auf `sandbox` um und stellte sie im `finally` zurück. Die Behauptung, jede Schicht verhindere für sich jeden Schaden, wird **zurückgenommen**. Das Umschalten innerhalb einer normalen Anfrage ist nicht ausreichend sicher:
| Schwachstelle | Warum sie in der Admin-Anfrage besteht [Befund] |
|---|---|
| Bereits aufgelöste Dienste und Zwischenspeicher | Der Container hält Singletons mit echten Daten: `TenantContext`, `Settings`, `SystemSettings` (Cache `rememberForever`), statisch `DocumentCompositionFields::$compositions`. Im Lauf würden sie echte Werte liefern, danach Sandbox-Werte weitertragen. |
| Wiederverwendete Verbindungen | Objekte, die vor dem Umschalten eine `Connection` erhalten haben (Query Builder, Relationen geladener Modelle), schreiben weiter auf die echte Verbindung. |
| Sitzung, Authentifizierung, Livewire | `SESSION_DRIVER=database`, `CACHE_STORE=database`. Die Middleware schreibt am Anfragenende über die Standardverbindung. Livewire hydriert Komponenten mit Modellen der echten Verbindung. |
| Ausnahmen und Verschachtelung | Ein Fehler im `finally` selbst, eine offene Transaktion der Admin-Anfrage oder ein `rescue()` innerhalb einer Action, das den Wächter-Fehler verschluckt (`rescue` ist mehrfach im Einsatz, z. B. `TakeOverExternalBooking`, `SyncChannel`) |
| Gleichzeitige Läufe | Mehrere Läufe eines Mandanten in parallelen Anfragen teilen eine Sandbox-Datei, wenn nicht je Lauf getrennt. Ein gemeinsames Zurücksetzen wäre unsicher. |
| Signierte Links | `SendOffer` erzeugt `temporarySignedRoute('offers.show', …)` mit dem echten `APP_KEY`. Eine Sandbox-Buchung `id = 17` erzeugt einen Link, der in der echten Anwendung die echte Buchung `17` öffnet, sobald er aus dem Bericht kopiert wird. |
| Verschlüsselte Felder | `encrypted`-Casts (`CaseFact::value`, `BlockedPeriod::ical_raw`, `Mailbox::password`). Mit dem echten Schlüssel könnte der Lauf echte Geheimnisse entschlüsseln, falls sie in die Sandbox gelangen. |
**Korrektur:** Der Lauf findet in einer **eigenen Sandbox-Anfrage** statt. Diese wird von Anfang an im Sandbox-Modus gestartet. Die echte Datenbank ist in ihr **nicht konfiguriert**, und es gibt nichts wiederherzustellen, weil der PHP-Prozess der Anfrage endet. Laravel Octane oder ein anderer langlebiger Prozess wird nicht eingesetzt [Befund: `composer.json`]; jede Anfrage beginnt mit frischem Anwendungszustand.
### 3.1a Umsetzung T2 (entschieden): eigener Prozess, anwendungsseitige Isolation
Umgesetzt ist die Sandbox nicht als eigene HTTP-Anfrage, sondern als **eigener PHP-Prozess** (`php artisan process:sandbox-run <lauf>`). Die Admin-Anfrage startet ihn über die `Process`-Fassade mit der Umgebungsvariable `FEWO_SANDBOX_RUN`; `bootstrap/app.php` ruft dann `SandboxBootstrapper::configure` direkt nach dem Laden der Konfiguration auf.
| Ebene | Was erreicht ist | Was nicht erreichbar ist (Shared Hosting) |
|---|---|---|
| Betriebssystem | eigener Prozess mit eigenem Speicher; Umgebungsvariablen für Datenbank, Mail, Dienste werden dem Kindprozess entzogen | kein eigener Systembenutzer, kein Netzwerk- oder Dateisystem-Sandboxing: der Prozess könnte mit nativem Code `shared/.env` lesen |
| Anwendung | Konfiguration ersetzt (nur `sandbox`, `array`, `sync`), Manager zeichnen Verstöße auf und werfen, Wächter auf jeder Sandbox-Verbindung, Netz nur mit Szenario-Antwort, eigener App-Schlüssel, `SystemSettings` werden nicht angewendet | – |
| Code | `SideEffectPathsTest` verbietet native Wege (PDO, Sockets, curl, `mail()`, Dateien per Pfad, Programme, `env()`) in `app/` | Code in `vendor/` wird nicht geprüft |
**Voraussetzungen**, sonst ist der Tester gesperrt (keine Ausweichlösung): `pdo_sqlite`, Vorlage der Testdatenbank, erlaubtes `proc_open`, PHP-CLI (`FEWO_SANDBOX_PHP`, sonst `/opt/RZphp84/bin/php-cli`). Geprüft in der Anfrage, die den Lauf starten würde (`ProcessSandbox::requirements()`).
### 3.2 Ablauf eines Testschritts
```
Admin-Anfrage (normal, angemeldet) Sandbox-Anfrage (eigener Bootvorgang)
─────────────────────────────────── ─────────────────────────────────────────
1 Berechtigung prüfen (Policy)
2 Schnappschuss LESEN: Mandant, Wohnung,
Saisons, Angebote, Extras, Vorlagen,
Kanal + Entwurfskonfiguration, anonymi-
sierte Sperrzeiten – als Klartext-JSON
(keine Gäste, Buchungen, Nachrichten,
Zugangsdaten, Schlüssel)
3 Laufverzeichnis anlegen:
storage/app/sandbox/<run-uuid>/input.json
4 Token ausgeben: HMAC(run, tenant, user,
input-hash, Ablauf 5 min) – zustandslos
5 Browser ruft POST /_sandbox/run/<run> ──▶ 6 SandboxBootstrapper (afterBootstrapping
LoadConfiguration): Pfad + Token prüfen
OHNE Datenbank; sonst 404
7 Konfiguration ersetzen (§3.3) – bevor ein
Provider bootet oder eine Verbindung entsteht
8 Token als verbraucht markieren (Datei)
9 Vorlage kopieren → <run>/db.sqlite,
input.json einspielen (Eloquent, Sandbox-Schlüssel)
10 Szenario bis zum gewählten Schritt ausführen
11 report.json schreiben; Antwort = Bericht
12 report.json lesen, in process_test_runs ◀──
speichern (echte DB, normaler Kontext)
13 Laufverzeichnis löschen
```
- **Interaktiv** (E9): Jeder Klick „Weiter“ startet eine **neue** Sandbox-Anfrage mit demselben Schnappschuss und der Ereignisliste bis zu diesem Punkt. Die Läufe sind deterministisch (feste Uhr, Skript-Antworten). Zwischen Anfragen wird kein Zustand gehalten.
- Die Sandbox-Anfrage hat **keinen** Zugang zur echten Datenbank. Den Schnappschuss liest die Admin-Anfrage **lesend**; den Bericht speichert die Admin-Anfrage. Kein Modul hat darauf Einfluss.
### 3.3 Standardmäßig gesperrt: Konfiguration der Sandbox-Anfrage
Der `SandboxBootstrapper` ersetzt die Konfiguration vollständig, nicht teilweise. Was nicht ausdrücklich erlaubt ist, existiert in der Anfrage nicht.
| Bereich | Einstellung in der Sandbox-Anfrage | Folge eines unerlaubten Zugriffs |
|---|---|---|
| Datenbank | `database.connections` = **nur** `sandbox` (SQLite, Pfad `<run>/db.sqlite`); `database.default = sandbox`; Redis-Konfiguration leer | `DB::connection('mysql')` → `InvalidArgumentException: Database connection [mysql] not configured` → Abbruch |
| Zusätzlich | `beforeExecuting` auf `sandbox` prüft, dass der PDO-Dateipfad gleich `<run>/db.sqlite` ist | `SandboxViolation` |
| Mail | `mail.mailers` = nur `array`; `mail.default = array`; `EnforceMailTestMode` bleibt aktiv (Sandbox-Mandant im Testbetrieb, Testadresse `tester@sandbox.invalid`) | anderer Mailer → „not defined“ → Abbruch |
| HTTP | `Http::preventStrayRequests()`; `Http::fake` nur mit Szenario-Antworten (KI, iCal, künftige API, n8n-Webhook von `CreateChannelTasks`) | `StrayRequestException` → Abbruch |
| IMAP | `MailboxReader` an `SandboxMailboxReader` gebunden (wirft); `config('fewo.mailbox')` leer | `SandboxViolation` |
| Connectors | `ChannelRegistry` an Szenario-Connectors gebunden | unbekannter Connector → Abbruch |
| Dateien | alle Disks (`local`, `public`, `private`) mit Wurzel `<run>/files/` | Schreiben bleibt im Laufverzeichnis |
| Cache, Rate-Limiter, Sperren | `cache.default = array`, nur Store `array` | anderer Store → „not defined“ |
| Sitzung | `session.driver = array`; die Sandbox-Route nutzt keine Session-, Auth- oder Livewire-Middleware | – |
| Warteschlange | `queue.default = sync`, nur `sync` [Befund: keine `ShouldQueue`-Klassen in `app/`] | – |
| Scheduler | Die Sandbox-Anfrage ruft nie `schedule:run`. Zeitsprünge rufen die Handler direkt auf (§4). Die Route `ChannelController` mit `Artisan::call('schedule:run')` ist im Sandbox-Modus nicht registriert. | Route 404 |
| Logging | `logging.default` = Datei `<run>/log.txt` (kommt in den Bericht, dann gelöscht) | – |
| App-Schlüssel | `app.key` = zufälliger Schlüssel je Lauf | Signierte Links und verschlüsselte Werte aus der Sandbox sind in der echten Anwendung ungültig |
| Geheimnisse | KI-Schlüssel, Postfach-Passwörter, Webhook-Geheimnisse, SMTP-Zugang: Konfigurationswerte leer, nicht im Schnappschuss | – |
| Routen | Nur die Sandbox-Route ist im Sandbox-Modus erreichbar. Gast-Links (`offers.show`, Datenlink) werden im Bericht als Text ohne Verweis gezeigt. | – |
| iCal-Export | Der echte Feed liest die echte Datenbank und ist unberührt. Der Tester berechnet den Feed der Sandbox vorher/nachher („würde im Export von FeWo-direkt erscheinen“). | – |
| Künftige APIs/Webhooks | Ausgehend nur über `Http` (Regel und statischer Test, §3.5); eingehende Webhook-Routen sind im Sandbox-Modus nicht registriert | `StrayRequestException` bzw. 404 |
| Zeit | `Date::setTestNow()` auf die Szenariozeit | – |
**Verhalten bei Fehlern:** Jede Ausnahme des Laufs wird im Treiber gefangen und als „Lauf abgebrochen: <Klasse>, <Ort>“ in den Bericht geschrieben.
Actions fangen Fehler teilweise selbst ab [Befund]: 18 `rescue()`-Aufrufe, `catch (Throwable)` in `CaseAutomation::advance` und `SendPendingAutoOffers`. Ein Verstoß könnte so verschluckt werden. Deshalb **zeichnet die Sperre den Verstoß auf, bevor sie wirft**:
- Im Sandbox-Modus sind `DatabaseManager`, `MailManager`, `CacheManager` und `FilesystemManager` durch Unterklassen ersetzt. Deren Auflösung eines nicht erlaubten Namens schreibt zuerst einen Eintrag `violation` in das `EffectLedger` und wirft dann.
- `Http` erhält als letzte Fake-Regel einen Rückruf, der aufzeichnet und dann wirft.
- `SandboxMailboxReader` und der `beforeExecuting`-Wächter zeichnen ebenso auf.
Ein Lauf mit mindestens einem `violation`-Eintrag gilt **immer** als abgebrochen, auch wenn die Action danach weiterlief.
### 3.4 Gleichzeitige Läufe, Ressourcen, Aufräumen
| Anforderung | Umsetzung | Prüfbar durch |
|---|---|---|
| Isolation je Lauf | eigenes Verzeichnis `<run-uuid>` mit eigener SQLite-Datei; kein gemeinsamer Sandbox-Speicher | Test: zwei Läufe parallel, keine gegenseitige Sicht |
| Gleichzeitige Läufe | Plätze als Dateisperren (`flock`) unter `storage/app/sandbox/slots/`: höchstens 1 Lauf je Mandant, 3 je Server; sonst „Tester ist gerade belegt“ | Test mit gehaltener Sperre |
| Berechtigung | Admin-Anfrage: Policy (Administratoren des Mandanten, E8). Sandbox-Anfrage: Token gebunden an Lauf, Mandant, Benutzer und Eingabe-Hash, 5 min gültig, einmal verwendbar (Marker-Datei) | Tests: fremder Mandant, abgelaufen, wiederverwendet, veränderte Eingabe → abgewiesen |
| Ressourcen | Laufzeit 20 s (eigene Prüfung im Treiber, unter `max_execution_time`), höchstens 60 Ereignisse, SQLite-Datei höchstens 20 MB, Laufverzeichnis höchstens 30 MB | Test je Grenze |
| Aufräumen | Die Admin-Anfrage löscht nach dem Speichern des Berichts. Bei jedem neuen Lauf werden Verzeichnisse älter als 1 h gelöscht (kein neuer Scheduler-Eintrag). Der Deploy legt das Verzeichnis außerhalb der Releases an (Strato-Dateiquote, `BETRIEB.md`). | Test: abgebrochener Lauf hinterlässt Verzeichnis, nächster Lauf räumt es |
| Wiederherstellung | entfällt, weil die Sandbox-Anfrage endet. Die Admin-Anfrage wechselt nie in den Sandbox-Modus. | Test: Admin-Anfrage hat nach dem Lauf unveränderte Konfiguration und Container-Bindungen |
### 3.5 Grenzen und wie sie abgedeckt werden
Nicht zur Laufzeit abfangbar sind **native PHP-Aufrufe**, die am Framework vorbeigehen:
- `new PDO(...)` mit fest codierten Zugangsdaten;
- `fsockopen`, `curl_*`, `mail()`, `stream_socket_client`;
- `file_put_contents` auf absolute Pfade.
`disable_functions` lässt sich auf Shared Hosting nicht je Anfrage setzen.
Abdeckung:
- **Statischer Test `SideEffectPathsTest`** (Muster `MailTestModeGateTest`): In `app/` sind diese Funktionen verboten, außer in einer Positivliste [Befund: heute nur `BackupDatabase` (`getPdo`, `unlink`) und `ListGuests` (`php://output`); beide sind in der Sandbox-Anfrage nicht erreichbar]. Neue Außenwege müssen Framework-Fassaden nutzen.
- **Zugangsdaten:** Die Sandbox-Anfrage enthält keine Zugangsdaten der echten Datenbank in der Konfiguration. Die `.env` liegt zwar im Release, ihre DB-Werte werden aber nicht übernommen. Ein nativer Zugriff bräuchte also Code, der die `.env` selbst liest. Das verbietet der statische Test (`env()` nur in `config/`, Larastan-/Grep-Regel).
**Ehrliche Aussage:** Der Tester ist schadensfrei für alle Effektwege über Laravel-Fassaden und für jeden nicht konfigurierten Dienst. Native Aufrufe sind durch Code-Regel und statischen Test ausgeschlossen, nicht durch die Laufzeit. Diese Grenze steht im Bericht und in `BETRIEB.md`.
### 3.6 Sandbox-Datenbank (E4) [Entschieden: SQLite bevorzugt]
- **SQLite:** Voraussetzung ist `pdo_sqlite` auf dem Server (V1).
- **[Befund]** Die gesamte Testsuite (683 Feature-Tests) läuft auf SQLite; die Fachlogik ist dort lauffähig.
- Die Vorlage (migriert, leer) erzeugt `process:sandbox-template` beim Deployment.
- **MariaDB-Ausweichlösung** nur bei nachgewiesener technischer Trennung:
1. eigene Strato-Datenbank(en) für den Tester mit **eigenem Datenbankbenutzer**, der auf die Betriebsdatenbank **keine** Rechte hat (Strato vergibt je Datenbank einen eigenen Benutzer; vor der Umsetzung zu prüfen, V6);
2. die Sandbox-Anfrage kennt nur diese Zugangsdaten;
3. ein Pool von N Datenbanken mit exklusiver Belegung je Lauf (`flock`-Platz = Datenbank); Leeren nur der belegten Datenbank mit dem Sandbox-Benutzer;
4. Negativtest auf dem Server: Der Sandbox-Benutzer kann die Betriebsdatenbank weder lesen noch schreiben.
Ist (1) oder (4) nicht erfüllbar, ist der Tester auf diesem Server **nicht verfügbar**. Eine ungeschützte gemeinsame Sandbox gibt es nicht.
- **Rohabfragen [Befund]:** 8 Fundstellen mit Roh-SQL. 4 liegen in `BackupDatabase` (im Tester nicht erreichbar). Übrig sind `orderByRaw('due_on is null')` (zweimal, darunter `CaseActivities`), eine `CASE WHEN`-Sortierung im Posteingang und `whereRaw('lower(domain) = ?')`; alle sind auf SQLite und MariaDB gültig. Die Datumsfilter laufen über `whereDate`, das das Framework je Datenbank übersetzt. Paket U-D bestätigt das mit dem Paritätstest auf beiden Datenbanken.
---
## 4. Ereignis- und Zeitsimulation [Vorschlag; E9 entschieden]
- **Simulierte Uhr:** `Date::setTestNow()`. Start ist „jetzt“ oder die Szenariozeit, etwa „Freitag 18 Uhr“ für Klärungsfristen am Wochenende.
- **Zeitsprung** (`advance(hours: 25)`): führt die vorgangsrelevanten Handler in der Reihenfolge von `routes/console.php` aus, nicht `channels:sync` oder `channels:fetch-mail`.
- **[Entschieden E9]** Vordefinierte Szenarien mit veränderbaren Eingaben: Zeitraum, Personen, fehlende Felder, „Gast ist Stammgast“, Ausfallart, Antwortzeitpunkt. Schrittweise Ausführung. **Keine** frei programmierbaren Ereignisfolgen.
---
## 5. Szenarienkatalog (Startumfang)
| # | Szenario | Prüft |
|---|---|---|
| S01 | Vollständige Anfrage (A1/A2) | Angebotsreservierung, Angebot, Annahme, Bestätigung |
| S02 | Fehlende Anschrift (`02` §7.6) | Klärungsreservierung **und** Rückfrage unabhängig; Angebot wartet |
| S03 | Gast antwortet über Formular | `GuestLink`-Fakten, Angebot wird bereit |
| S04 | Gast antwortet per E-Mail nach Ablauf der Klärungsreservierung | Zuordnung, Skript-KI, Angebot bei freiem bzw. belegtem Zeitraum |
| S05 | Frist läuft ab | Klärung: Anfrage bleibt offen; Angebot: `Expired`, Kalender frei |
| S06 | Angebot wird angenommen | `AcceptOffer` → `ConfirmBooking`, Sperraufgaben |
| S07 | Portalbuchung über iCal und Mail (A3/A4) | Duplikaterkennung, `binding.portal` |
| S08 | A4: Portal-Inkasso, Anreiseinformation durch Portal | variable Verantwortung, Nachweisstufen, Abschlussprüfung |
| S09 | Loyalty-Status (nur Tester) | `guest.loyalty_status` mit synthetischen Vorgängen |
| S10 | Loyalty-Rabatt (nur Tester) | `Discount`-Zeile vor Preisfestlegung, keine nach Verbindlichkeit |
| S11 | Optionaler Schritt aus | „übersprungen (Konfiguration)“ |
| S12 | Ausfall von Mail, KI oder iCal | definierte Zustände: Aufgabe, Hinweis, kein Absturz |
| S13 | Portal meldet Stornierung | Aufgabe, keine Stornierung, Mail-Sperre aufgehoben, Außenwirkungen ausgesetzt (O4) |
---
## 6. Testbericht [Vorschlag; E8 entschieden]
Inhalt:
1. **Kopf:**
- Modell und Version, Variante, Modulversionen;
- Kanal und Eingangsart;
- Release-Kennung (Datei, die `scripts/deploy.sh` im Release ablegt, neu in U-D);
- Startzeit (simuliert), Szenario und Eingaben.
2. **Wirksame Konfiguration** mit Herkunft (Vermieter, Wohnung, Kanal, Entwurf).
3. **Zeitleiste** je Ereignis:
- ausgeführte Schritte mit Ergebnis;
- übersprungene mit Grund;
- wartende Schritte mit „wartet auf … bis …“;
- Prüfungen, Statuswechsel, Aufgaben.
4. **Simulierte Seiteneffekte** aus dem `EffectLedger`: Mails mit Vorschau, Kalenderhalt, Sperraufgaben, Dokumente, KI-Aufrufe, Exportänderungen. Links erscheinen nur als Text.
5. **Ergebnis:** Endzustand, offene Punkte, nächster Schritt, Hinweise, gegebenenfalls „Lauf abgebrochen“ mit Grund.
**Speicherung:**
- Tabelle `process_test_runs`: Mandant, Kanal, Benutzer, Szenario, Konfigurationsschnappschuss, Modellversionen, Release, Bericht (JSON), Ergebnis. Das ist die einzige Migration.
- Berichte enthalten nur synthetische Gastdaten, aber Konfiguration und Benutzerkennung.
- **[Entschieden E8]** Die Aufbewahrung wird in das Löschkonzept eingebunden:
- neuer Schlüssel `fewo.retention.process_test_run_days` mit Eintrag in `docs/LOESCHKONZEPT.md`, `SystemSettings`, `TenantConfig`;
- Löschung durch das bestehende `AnonymizeGuests`;
- nach Projektregel nur gegenüber der `.env`-Grundlinie verkürzbar.
- **Der Wert ist nicht festgelegt** (O3).
**Reproduzierbarkeit:** „Erneut ausführen“ startet mit dem gespeicherten Schnappschuss. Bei neuerem Release zeigt der Bericht die Unterschiede zum vorigen Lauf.
---
## 7. Sicherheitstests (Pflicht, Gruppe `sandbox`)
In PHPUnit stellt eine **eigene SQLite-Datei** die echte Betriebsdatenbank dar. Ihr Datei-Hash vor und nach dem Lauf ist der stärkste verfügbare Nachweis.
### 7.1 Positivtests
| Test | Prüft |
|---|---|
| `SandboxIsolationTest` | Für S01–S13: Hash der Betriebs-Datei vor/nach identisch; nur die Admin-Anfrage schreibt `process_test_runs` (+1) |
| `SandboxRequestConfigTest` | Konfiguration der Sandbox-Anfrage enthält nur die erlaubten Verbindungen, Mailer, Stores und Disks (§3.3) |
| `ProcessTesterParityTest` | Gleichheit Tester ↔ echter Ablauf (§2.2) |
| `ModuleContractTest` | Jedes Modul erzeugt nur deklarierte Effekte (`02` §3.2) |
| `SandboxTenantTest` | Schnappschuss enthält nur Daten des eigenen Mandanten |
### 7.2 Negativtests (absichtlich unzulässige Zugriffe)
Ein Testmodul `HostileModule` wird nur im Test registriert. Jeder Fall erwartet: Lauf abgebrochen, Bericht nennt den Grund, Hash der Betriebs-Datei unverändert, kein Mail-Transport aufgerufen, keine Datei außerhalb `<run>`.
| Fall | Unzulässiger Zugriff |
|---|---|
| N-DB1 | `DB::connection('mysql')` / Name der Betriebsverbindung |
| N-DB2 | `DB::connection()->getPdo()` und Abfrage auf eine Tabelle, die nur in der Betriebsdatenbank existiert |
| N-DB3 | Verbindung zur Laufzeit über `config([...])` neu anlegen mit Pfad der Betriebs-Datei → Wächter `beforeExecuting` |
| N-DB4 | Fehler innerhalb `rescue()` verschluckt → Lauf trotzdem abgebrochen (Ledger) |
| N-NET1 | `Http::get('https://example.org')` ohne Szenario-Antwort |
| N-NET2 | Aufruf des n8n-Webhooks über `CreateChannelTasks` mit gesetzter URL |
| N-IMAP | `MailboxReader::fetch` |
| N-MAIL | `Mail::mailer('smtp')->send(...)` |
| N-FILE | `Storage::disk('local')->put` → liegt unter `<run>/files`; `Storage::build(['root' => base_path()])` → durch statischen Test verboten, zur Laufzeit erkannt über Ledger-Prüfung der Dateiliste außerhalb `<run>` (Vergleich `storage/` vor/nach) |
| N-CACHE | `Cache::store('database')` |
| N-SIGN | im Lauf erzeugter `offers.show`-Link ist in der normalen Anwendung ungültig (403) |
| N-TOKEN | Token wiederverwendet, abgelaufen, anderer Mandant, veränderte Eingabe → 404/403, kein Lauf |
| N-PAR | zwei Läufe gleichzeitig: zweiter wartet oder wird abgewiesen; keine gemeinsame Datei |
| N-ABORT | Abbruch durch Laufzeitgrenze → Verzeichnis wird beim nächsten Lauf geräumt |
| N-STATIC | `SideEffectPathsTest`: neue native Netz-, Mail-, PDO- oder Dateifunktion in `app/` außerhalb der Positivliste → Test rot |
Ein bestandener Happy-Path-Test gilt **nicht** als Nachweis der Schadensfreiheit. Freigabekriterium sind die Negativtests.
---
## 8. Abnahmekriterien Tester (N6)
| # | Kriterium (auf stommer.info) |
|---|---|
| T01 | Aus dem Konfigurator lässt sich mit der aktuellen, auch ungespeicherten Konfiguration jedes Szenario starten und schrittweise weiterführen. |
| T02 | Der Bericht enthält Modell, Version, Kanal, Eingangsart, wirksame Konfiguration, ausgeführte, wartende und übersprungene Schritte mit Gründen, simulierte Effekte, Ergebnis und offene Punkte. |
| T03 | Nach einer Testreihe hat sich die Betriebsdatenbank nicht verändert, außer `process_test_runs`. Prüfung per `CHECKSUM TABLE` aller fachlichen Tabellen vorher/nachher im Abnahmeprotokoll; `sessions`, `cache` und `cache_locks` werden getrennt betrachtet, weil sie durch die Bedienung selbst wechseln. |
| T04 | Weder im Testpostfach noch beim Mail-Anbieter ist eine Mail aus Testläufen angekommen. Der Export-Feed jedes Kanals ist byte-gleich vor und nach der Testreihe. |
| T05 | Ein Lauf mit gleichem Schnappschuss liefert denselben Bericht. |
| T06 | Ausfall von Mail, KI oder iCal führt zum selben definierten Zustand wie im echten Vorgang (S12, Paritätstest). |
| T07 | Die Negativtests N-DB1 bis N-STATIC sind in der CI grün; N-DB1, N-NET1 und N-TOKEN werden zusätzlich auf stommer.info über einen nur im Testbetrieb registrierten Prüflauf ausgelöst (Ergebnis: abgebrochen, T03 unverändert). |