Integration Test Suite: Kommunikation, Sync & Messaging automatisiert testen

jreinemann-euris commented

2026-05-16 17:17:31 +00:00

(Migrated from github.com)

Ziel

Einen wiederholbaren Integrations-Testscript erstellen, der das Kommunikationssystem (WebSocket, Inventory Sync, Messaging) automatisiert gegen einen laufenden Server testet – ohne manuellen Testclient.

Motivation

Manuelle Tests der WebSocket-Kommunikation sind fehleranfällig und zeitaufwändig
Nach jeder größeren Änderung an Server/Client-Logik soll ein Generaltest ausführbar sein
Live-Debugging mit einem interaktiven Test-Client ist als Alternative möglich, aber schlechter reproduzierbar

Lösungsansatz: Automatisierter Simulationsscript

Ein Kotlin/JVM-Script (oder Shell-Script mit websocat/curl) das folgendes simuliert:

Szenarien

Auth-Flow: Alice und Bob registrieren/loggen sich mit separaten JWTs ein
Inventory Sync: Alice lädt ein Inventar hoch → Bob fragt das geteilte Inventar ab → Konsistenz prüfen
Messaging (Chat-Simulation):
- Alice sendet 3 Nachrichten an Bob
- Bob antwortet während Alice "offline" ist (WebSocket getrennt)
- Alice reconnectet → Offline-Nachrichten müssen zugestellt werden
Online/Offline-Perioden: Verbindungsabbrüche und Reconnect mit JWT-Refresh simulieren
Parallele Sessions: Alice logt sich von zwei Geräten gleichzeitig ein → Nachrichten müssen auf beiden ankommen

Output

[PASS] Auth: Alice login
[PASS] Auth: Bob login
[PASS] Inventory Sync: Alice → Bob
[FAIL] Messaging: Offline delivery (Bob did not receive 2 messages after reconnect)
...
ERGEBNIS: 8/10 Tests bestanden

Akzeptanzkriterien

Script ist von der Kommandozeile ausführbar: ./gradlew :test:integrationTest oder ./run-integration-tests.ps1
Script benötigt laufenden lokalen Server (localhost:8080)
Alle 5 Szenarien sind implementiert
Klare PASS/FAIL-Ausgabe pro Szenario
Script kann gelegentlich als Regressionstest wiederholt werden (idempotent – erzeugt/löscht eigene Testdaten)

Technische Hinweise

Kann als separates Test-Modul :integration-test im Gradle-Projekt leben
Alternativ: PowerShell-Script mit Invoke-WebRequest und websocat für WebSocket-Tests
Testdaten (User, Inventar) werden am Anfang angelegt und am Ende bereinigt

Abgrenzung

Kein dauerhaft laufender interaktiver Test-Client (zu viel Wartungsaufwand). Der Script ist ein einmaliger, wiederholbarer Durchlauf.

## Ziel Einen wiederholbaren **Integrations-Testscript** erstellen, der das Kommunikationssystem (WebSocket, Inventory Sync, Messaging) automatisiert gegen einen laufenden Server testet – ohne manuellen Testclient. ## Motivation - Manuelle Tests der WebSocket-Kommunikation sind fehleranfällig und zeitaufwändig - Nach jeder größeren Änderung an Server/Client-Logik soll ein Generaltest ausführbar sein - Live-Debugging mit einem interaktiven Test-Client ist als Alternative möglich, aber schlechter reproduzierbar ## Lösungsansatz: Automatisierter Simulationsscript Ein Kotlin/JVM-Script (oder Shell-Script mit `websocat`/`curl`) das folgendes simuliert: ### Szenarien 1. **Auth-Flow**: Alice und Bob registrieren/loggen sich mit separaten JWTs ein 2. **Inventory Sync**: Alice lädt ein Inventar hoch → Bob fragt das geteilte Inventar ab → Konsistenz prüfen 3. **Messaging (Chat-Simulation)**: - Alice sendet 3 Nachrichten an Bob - Bob antwortet während Alice "offline" ist (WebSocket getrennt) - Alice reconnectet → Offline-Nachrichten müssen zugestellt werden 4. **Online/Offline-Perioden**: Verbindungsabbrüche und Reconnect mit JWT-Refresh simulieren 5. **Parallele Sessions**: Alice logt sich von zwei Geräten gleichzeitig ein → Nachrichten müssen auf beiden ankommen ### Output ``` [PASS] Auth: Alice login [PASS] Auth: Bob login [PASS] Inventory Sync: Alice → Bob [FAIL] Messaging: Offline delivery (Bob did not receive 2 messages after reconnect) ... ERGEBNIS: 8/10 Tests bestanden ``` ## Akzeptanzkriterien - [ ] Script ist von der Kommandozeile ausführbar: `./gradlew :test:integrationTest` oder `./run-integration-tests.ps1` - [ ] Script benötigt laufenden lokalen Server (`localhost:8080`) - [ ] Alle 5 Szenarien sind implementiert - [ ] Klare PASS/FAIL-Ausgabe pro Szenario - [ ] Script kann gelegentlich als Regressionstest wiederholt werden (idempotent – erzeugt/löscht eigene Testdaten) ## Technische Hinweise - Kann als separates Test-Modul `:integration-test` im Gradle-Projekt leben - Alternativ: PowerShell-Script mit `Invoke-WebRequest` und `websocat` für WebSocket-Tests - Testdaten (User, Inventar) werden am Anfang angelegt und am Ende bereinigt ## Abgrenzung Kein dauerhaft laufender interaktiver Test-Client (zu viel Wartungsaufwand). Der Script ist ein einmaliger, wiederholbarer Durchlauf.

Integration Test Suite: Kommunikation, Sync & Messaging automatisiert testen #60