slop game oder so

2026-09-24 17:57:54 +02:00
commit 4c997eee21
166 changed files with 14976 additions and 0 deletions
@@ -0,0 +1,103 @@
+# Tests
+
+Das Projekt hat drei Testebenen:
+
+| Ebene | Werkzeug | Ort | Umfang |
+|---|---|---|---|
+| Backend, Assets, Deployment | pytest | `tests/*.py` | Routen, API inkl. Validierung, Rate-Limit, Tokens, Datenbank, Konfiguration, Moderation, Passenger-Import, Upload-Paket, Asset-Lizenzen, Inhaltsprüfung |
+| Spiellogik (JavaScript) | Vitest | `tests/js/*.test.js` | Wellen, Punkte, Combo-Eingabe, Abklingzeiten, Gegner-KI, Waffen, Formatierung, Einstellungen, API-Client, Audio, Tastaturhelfer, Konfiguration |
+| End-to-End | Playwright (pytest) | `tests/e2e/test_smoke.py` | Seite lädt, Disclaimer, Spielstart, Schießen, Pause, Orbital-Befehle per Tastatur, Game Over mit Highscore, Spiel ohne Asset-Dateien, keine JavaScript-Fehler |
+
+## Vorbereitung
+
+```bash
+python -m venv .venv
+# Windows: .\.venv\Scripts\Activate.ps1   –   Linux/macOS: source .venv/bin/activate
+python -m pip install -r requirements-dev.txt
+npm install            # nur für Vitest und ESLint (Node.js 22 ab 22.13 oder 24)
+```
+
+## Python-Tests (inkl. End-to-End)
+
+```bash
+pytest                      # alles
+pytest -m "not e2e"         # ohne Browser
+pytest -m e2e               # nur End-to-End
+pytest tests/test_api_highscores.py -k rate_limit   # gezielt
+```
+
+Die End-to-End-Tests starten den Flask-Server selbst (zufälliger Port, temporäre
+Datenbank). Als Browser nehmen sie das installierte **Microsoft Edge** oder
+**Google Chrome**, ein zusätzlicher Download ist nicht nötig. Ist keiner vorhanden:
+
+```bash
+python -m playwright install chromium
+GLORY_E2E_BROWSER=chromium pytest -m e2e        # PowerShell: $env:GLORY_E2E_BROWSER="chromium"; pytest -m e2e
+```
+
+`GLORY_E2E_BROWSER` erzwingt einen Kanal (`msedge`, `chrome` oder `chromium`). Findet
+Playwright gar keinen Browser, werden die E2E-Tests **übersprungen** (mit
+Begründung in der Ausgabe) statt fehlzuschlagen.
+
+Hinweis: Die E2E-Tests warten per `page.evaluate` statt `page.wait_for_function`.
+Letzteres nutzt intern `eval`, und das blockiert die strenge Content-Security-Policy
+der App zu Recht. So wird mit der echten CSP getestet.
+
+## JavaScript-Tests
+
+```bash
+npm test               # einmalig
+npm run test:watch     # bei Änderungen neu
+```
+
+Die getestete Logik in `app/static/js/logic/` importiert kein Phaser und läuft direkt
+in Node. Systeme mit Browser-Abhängigkeit (Audio, Einstellungen, API-Client) werden mit
+kleinen Attrappen getestet (Fake-`AudioContext`, Fake-`fetch`, Speicher statt
+`localStorage`).
+
+## Linting
+
+```bash
+ruff check .
+ruff format --check .      # „ruff format .“ formatiert
+npm run lint               # ESLint für app/static/js, tests/js, scripts
+```
+
+Hinweis für Windows PowerShell 5.1: Befehle nicht mit `&&` verketten (das kennt erst
+PowerShell 7), sondern nacheinander ausführen. Ist die venv nicht aktiviert, jeden
+Befehl über `.\.venv\Scripts\python.exe -m …` aufrufen, z. B.
+`.\.venv\Scripts\python.exe -m pytest` oder `.\.venv\Scripts\python.exe -m ruff check .`.
+
+`ruff` prüft mit `target-version = "py310"`, dass kein Code neuere Python-Features
+braucht, als cPanel-Hosts typischerweise anbieten.
+
+## Was wo getestet wird
+
+| Anforderung | Tests |
+|---|---|
+| Alle Routen | `tests/test_routes.py` |
+| Highscore-API, Validierung, ungültige Eingaben | `tests/test_api_highscores.py`, `tests/test_validation.py` |
+| Rate-Limiting | `tests/test_api_highscores.py` (`test_rate_limit_*`), `tests/test_models.py` |
+| Datenbank-Initialisierung | `tests/test_models.py` |
+| `passenger_wsgi.py` importiert die App (auch aus fremdem Arbeitsverzeichnis) | `tests/test_passenger_wsgi.py` |
+| Wellengenerierung | `tests/js/waves.test.js`, `tests/js/waveDirector.test.js` |
+| Punkteberechnung | `tests/js/scoring.test.js` |
+| Tastenkombinationen der Orbital-Befehle | `tests/js/comboInput.test.js`, E2E `test_orbital_commands_via_keyboard` |
+| Gegner-KI | `tests/js/steering.test.js`, `tests/js/enemyAi.test.js` |
+| Seite lädt, Disclaimer, Spielstart, keine JS-Fehler | E2E `test_page_loads_disclaimer_then_game_starts` |
+| Spielbar mit Platzhaltern | E2E `test_game_runs_with_placeholders_when_assets_are_missing` |
+| Assets dokumentiert, keine fremden Namen | `tests/test_assets.py` |
+| Eigene Befehlscodes (nicht aus anderen Spielen) | `tests/js/config.test.js` |
+| Moderation (CLI, Sperrliste) | `tests/test_moderation.py` |
+| Upload-Paket für cPanel (vollständig, ohne Geheimnisse, startet entpackt) | `tests/test_deploy_zip.py` |
+| Proxy-Header, Schlüssel erst bei Bedarf | `tests/test_routes.py`, `tests/test_config.py` |
+
+## Neue Tests schreiben
+
+- Neue Spiellogik möglichst in `app/static/js/logic/` ohne Phaser-Import anlegen und
+  in `tests/js/` testen.
+- Backend-Fixtures (`app`, `client`, `issue_token`, `valid_payload`) stehen in
+  `tests/conftest.py`. `issue_token(started_ago=…)` simuliert eine bereits laufende
+  Runde, ohne zu warten.
+- Für E2E-Tests den Hilfsbefehl `_accept_disclaimer_and_start(page)` nutzen. Der
+  Spielzustand ist über `window.gloryDefense` (Phaser-Game-Instanz) erreichbar.