M13 – E2E-Tests, Anleitung, PDF #18

New Issue

2026-09-24T20:44:44Z

florian.wilde commented

2026-09-24 20:44:44 +00:00

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

Quelle: docs/issues/018-e2e-anleitung-pdf.md — dort gepflegt, hierher gespiegelt.

**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 --- Quelle: `docs/issues/018-e2e-anleitung-pdf.md` — dort gepflegt, hierher gespiegelt.

florian.wilde added this to the v0.1.0 milestone 2026-09-24 20:44:44 +00:00

florian.wilde added the phase-1 docs test labels 2026-09-24 20:44:44 +00:00

florian.wilde referenced this issue

2026-09-24 21:34:45 +00:00

Phase 1: MVP #1

florian.wilde referenced this issue

2026-09-26 03:26:47 +00:00

feat(seed): sieben Vorlagen, Beispielbestand und Demo-Kunden #33

florian.wilde referenced this issue from a commit

2026-09-26 09:03:26 +00:00

feat(doku): Anleitung, PDF und Ende-zu-Ende-Abnahme

florian.wilde referenced a pull request that will close this issue