Laufzettel/docs/issues/018-e2e-anleitung-pdf.md

#018 M13 – E2E-Tests, Anleitung, PDF

Status: offen Meilenstein: v0.1.0 Labels: phase-1, test, docs Geschätzt: 14 h Tatsächlich: –

Ziel

Nachweis, dass die Abläufe wirklich durchlaufen, und eine Anleitung, mit der ein Techniker ohne Einweisung arbeiten kann.

Aufgaben

• Playwright-Hauptablauf: anmelden → „PC Neuinstallation“ für PC-001 starten → Schritte abhaken → Wert eintragen → einen Schritt „nicht zutreffend“ mit Notiz → abschließen → archivieren → im Archiv finden → Schreibschutz greift
• Derselbe Hauptablauf mit SEED_MODE=SERVICE gegen MUS-PC-001, mit Kundenwahl im Start-Dialog
• Playwright-QR-Ablauf: /t/LZ-7K3F9Q ohne Anmeldung → Login → Geräteseite → „Vorlage zuweisen“ → Lauf erscheint unter „Zugewiesen“ → „Starten“ setzt IN_ARBEIT; dazu unregistrierter Tag → Registrierformular → Geräteseite; unbekannter Tag → Hinweis
• Playwright-Onboarding-Ablauf: Vorlage starten → Vorname und Nachname eingeben → UPN, sam und Mail werden vorgeschlagen → Abteilung „Buchhaltung“ wählen → im Schritt „Konto anlegen“ steht der fertige New-ADUser-Befehl → Kopieren liefert exakt diesen Text (Clipboard auslesen)
• Playwright-Mobilprüfung: auf allen Hauptseiten bei 390 × 844 ist scrollWidth <= clientWidth
• Playwright-Rollenprüfung: LESER sieht keine Schreib-Knöpfe und wird serverseitig abgewiesen
• pnpm docs:screenshots: Playwright-Skript, Desktop 1440 × 900 und Handy 390 × 844, Seed-Daten, dunkles Design, mit Markierungen (Rahmen, Nummern) für die beschriebenen Stellen; Ablage docs/anleitung/bilder/
• pnpm docs:pdf: Anleitung als PDF über Chromium (page.pdf, A4, printBackground), Ablage docs/anleitung/laufzettel-anleitung.pdf
• docs/anleitung/ auf Deutsch, getrennt für Techniker und Admins: Erste Schritte · Vorlagen bauen · Läufe abarbeiten (Desktop und Handy) · QR-Tags drucken und registrieren · Mitarbeiter und Abteilungen · Betriebsmodus · Admin: Verzeichnis, Benutzer, Einstellungen · Fehlerbehebung
• README.md vollständig: Setup, alle Umgebungsvariablen, Betrieb mit Docker Compose, authentik-Anbindung inkl. Gruppen für Rollen, Seed, Sicherungshinweis für die Datenbank

Akzeptanzkriterien

• Alle Playwright-Abläufe grün, in INTERN und in DIENSTLEISTUNG
• Der Kopier-Knopf liefert exakt den erwarteten Befehlstext, zeichengenau geprüft
• Keine Hauptseite scrollt bei 390 px horizontal
• pnpm docs:screenshots erzeugt alle in der Anleitung verlinkten Bilder reproduzierbar neu
• pnpm pruefe:doku meldet kein fehlendes Bild
• Das PDF enthält alle Kapitel mit Bildern, Umlaute korrekt, keine abgeschnittenen Seiten
• Die README beschreibt authentik so, dass ein Dritter die Anbindung ohne Rückfrage hinbekommt