314 lines
26 KiB
Markdown
314 lines
26 KiB
Markdown
# 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). |
|