Files

26 KiB
Raw Permalink Blame History

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: , “ 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).