Files
Laufzettel/docs/issues/018-e2e-anleitung-pdf.md
T
Florian WildeandClaude Opus 5 49ce06f206
Prüfung / pruefung (push) Canceled after 0s
Prüfung / e2e (push) Canceled after 0s
feat: Projektgerüst, gehärteten Betriebsstand und Prozess aufsetzen
Legt die Grundlage, auf der alle weiteren Meilensteine nur noch Fachlichkeit
ergänzen: Next 16 mit App Router und TypeScript strict, Tailwind 4, Prisma 7,
Vitest 5, Playwright, ESLint, Prettier und die Hooks für Lint und Commits.

Zwei Dinge sind bewusst so gebaut und durch Tests festgehalten:

Die Datenbank ist im Betriebsstand von außen nicht erreichbar. Sie hat kein
ports:-Mapping und hängt allein im Netz "intern", das ohne Gateway läuft; nur
"web" kommt zusätzlich nach draußen. tests/betriebsstand.test.ts schlägt an,
falls ein Port-Mapping zurückkehrt. Geprüft, nicht behauptet: docker compose up
startet den Stack, 5432 ist vom Host aus zu, aus "web" offen.

pnpm pruefe:doku hält Dokumentation und Code zusammen — Version im Changelog,
Issue-Dateien gegen ihre Übersicht, keine Verweise auf fehlende Dateien, keine
fehlenden Bilder. Das Skript wurde gegen vier eingebaute Fehler gegengeprüft.

Drei Versions-Obergrenzen sind nötig und in CLAUDE.md begründet: eslint bleibt
auf 9.x, weil eslint-plugin-react keinen Nachfolger für eslint 10 hat und das
Regelwerk sonst beim Laden abbricht; typescript bleibt auf 6.0.x, weil
typescript-eslint TypeScript 7 noch nicht unterstützt; prisma ist exakt auf
7.10.0 gepinnt, weil sein latest-Tag auf einen 8.0-RC zeigt, der von
@prisma/client aber nicht.

Auth.js entfällt entgegen der ursprünglichen Vorgabe: v5 steht dauerhaft auf
Beta, das Projekt ist im Wartungsmodus und sein Prisma-Adapter deckt Prisma 7
nicht ab. Stattdessen openid-client und jose, wie in ProxLedger.

Dieser erste Commit geht direkt auf main, weil es noch keinen Branch gibt, von
dem abzuzweigen wäre. Ab #006 läuft jedes Issue über einen eigenen Branch.

Closes #5

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
2026-09-24 23:33:49 +02:00

2.8 KiB
Raw Blame History

#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