# 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 `). 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//input.json 4 Token ausgeben: HMAC(run, tenant, user, input-hash, Ablauf 5 min) – zustandslos 5 Browser ruft POST /_sandbox/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 → /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 `/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 `/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 `/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 `/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: , “ 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 `` 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 ``. | 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 `/files`; `Storage::build(['root' => base_path()])` → durch statischen Test verboten, zur Laufzeit erkannt über Ledger-Prüfung der Dateiliste außerhalb `` (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). |