26 KiB
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:
- Er legt den Ausgangszustand im isolierten Speicher an (§3).
- Er löst Ereignisse über dieselben Einstiegspunkte aus wie Controller, Kommandos und Connectors.
- Er liest danach den Ablauf über
ProcessRunner::activities, also dieselbe Methode wieViewBooking.
| 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/Testerliegt keine Klasse, dieProcessModuleimplementiert oder Actions,PriceCalculatoroderAvailabilityCheckerableitet.
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.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: , “ 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,CacheManagerundFilesystemManagerdurch Unterklassen ersetzt. Deren Auflösung eines nicht erlaubten Namens schreibt zuerst einen Eintragviolationin dasEffectLedgerund wirft dann. Httperhält als letzte Fake-Regel einen Rückruf, der aufzeichnet und dann wirft.SandboxMailboxReaderund derbeforeExecuting-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_contentsauf absolute Pfade.
disable_functions lässt sich auf Shared Hosting nicht je Anfrage setzen.
Abdeckung:
- Statischer Test
SideEffectPathsTest(MusterMailTestModeGateTest): Inapp/sind diese Funktionen verboten, außer in einer Positivliste [Befund: heute nurBackupDatabase(getPdo,unlink) undListGuests(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
.envliegt zwar im Release, ihre DB-Werte werden aber nicht übernommen. Ein nativer Zugriff bräuchte also Code, der die.envselbst liest. Das verbietet der statische Test (env()nur inconfig/, 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_sqliteauf 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-templatebeim Deployment.
-
MariaDB-Ausweichlösung nur bei nachgewiesener technischer Trennung:
- 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);
- die Sandbox-Anfrage kennt nur diese Zugangsdaten;
- ein Pool von N Datenbanken mit exklusiver Belegung je Lauf (
flock-Platz = Datenbank); Leeren nur der belegten Datenbank mit dem Sandbox-Benutzer; - 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 sindorderByRaw('due_on is null')(zweimal, darunterCaseActivities), eineCASE WHEN-Sortierung im Posteingang undwhereRaw('lower(domain) = ?'); alle sind auf SQLite und MariaDB gültig. Die Datumsfilter laufen überwhereDate, 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 vonroutes/console.phpaus, nichtchannels:syncoderchannels: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:
- Kopf:
- Modell und Version, Variante, Modulversionen;
- Kanal und Eingangsart;
- Release-Kennung (Datei, die
scripts/deploy.shim Release ablegt, neu in U-D); - Startzeit (simuliert), Szenario und Eingaben.
- Wirksame Konfiguration mit Herkunft (Vermieter, Wohnung, Kanal, Entwurf).
- Zeitleiste je Ereignis:
- ausgeführte Schritte mit Ergebnis;
- übersprungene mit Grund;
- wartende Schritte mit „wartet auf … bis …“;
- Prüfungen, Statuswechsel, Aufgaben.
- Simulierte Seiteneffekte aus dem
EffectLedger: Mails mit Vorschau, Kalenderhalt, Sperraufgaben, Dokumente, KI-Aufrufe, Exportänderungen. Links erscheinen nur als Text. - 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_daysmit Eintrag indocs/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).
- neuer Schlüssel
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). |