From adea82a0e7f051fd505894ed33379d190cada7d3 Mon Sep 17 00:00:00 2001
From: Gulum <gulum@rismer.de>
Date: Sat, 6 Jun 2026 07:21:27 +0200
Subject: [PATCH] QA-1: document e2e usage (mock/live modes, viewports) in web
 README

---
 gerbil-manager-web/README.md | 18 ++++++++++++++++++
 1 file changed, 18 insertions(+)

diff --git a/gerbil-manager-web/README.md b/gerbil-manager-web/README.md
index 4359625..b3e1ab8 100644
--- a/gerbil-manager-web/README.md
+++ b/gerbil-manager-web/README.md
@@ -39,3 +39,21 @@ Erwartet die laufende GerbilManagerWebAPI unter `http://localhost:5179`
 npm run build
 npm run preview
 ```
+
+## E2E-Tests (QA-1, Playwright)
+
+```bash
+npm run e2e                # Mock-Modus: startet Vite auf :5199, API wird gemockt
+npx playwright test --project=phone   # nur Smartphone-Viewport (390px)
+```
+
+- **Mock-Modus (Standard):** kein Backend nötig. `e2e/mock-api.ts` fängt alle
+  API-Aufrufe ab (DATA-2-Vertrag: Gridify-Paging, camelCase, 409-Konflikte)
+  mit frischem Datenbestand pro Test (`e2e/mock-data.ts`).
+- **Live-Modus:** dieselbe Suite gegen den echten Stack —
+  `$env:E2E_BASE_URL = 'http://localhost:5173'; npm run e2e`
+  (vorher AppHost starten). Tests, die Mock-Seed-Daten voraussetzen,
+  überspringen sich selbst; die übrigen legen eigene Datensätze an.
+- Beide Viewports (Smartphone 390px, Laptop 1280px) laufen für jede Spec;
+  alle Assertions prüfen die deutschen Oberflächentexte direkt aus
+  `src/strings/de.ts`.