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

Neun Kapitel unter docs/anleitung/ fuer Technik und Verwaltung, mit 35
Bildern aus `pnpm docs:screenshots` und einem Fehlerbehebungskapitel aus
echten Meldungen. `pnpm docs:pdf` macht daraus 72 Seiten A4 — hell
gedruckt, mit Deckblatt, Inhaltsverzeichnis und Seitenzahlen, ohne neue
Abhaengigkeit.

Die Ablaeufe pruefen ihre Voraussetzungen, bevor der erste startet:
antwortet ein gebauter Stand, steht der Seed-Bestand, und liest der
Server dieselbe Datenbank wie der Testprozess. Jeder Ablauf legt an, was
er braucht, und raeumt es weg. Vier neue kommen dazu: Hauptablauf,
Onboarding mit Vergleich der Zwischenablage, Rollen und 390 px auf
achtzehn Seiten.

Drei Fehler kamen dabei heraus. Das Projekt „handy" pruefte 412 px statt
der verlangten 390. Ein angemeldeter Benutzer ohne Recht erfuhr nie,
warum er abgewiesen wurde — die Meldung stand auf einer Seite, die ihn
sofort weiterleitet; jetzt gibt es /kein-zugriff. Und der
Verzeichnis-Ablauf schrieb die Attributzuordnung der ersten vorhandenen
Quelle um, in einer echten Installation also der produktiven.

101 Ablaeufe in INTERN und 97 in DIENSTLEISTUNG, beide ohne Fehlschlag.

Closes #18

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>

tests/e2e/vorlagen-editor.spec.ts

@@ -1,5 +1,7 @@
 import { expect, test, type Page } from "@playwright/test";
 import "dotenv/config";
+import { prisma } from "@/lib/db";
+import { anmelden } from "./helfer";
 
 /**
  * Der Vorlagen-Editor durch die Oberflaeche (#010).
@@ -10,31 +12,20 @@ import "dotenv/config";
  * angehaengtem React gelingt — anlegen, tippen, sortieren, speichern — und
  * anschliessend, ob es wirklich in der Datenbank steht: durch Neuladen.
  *
- * Voraussetzung: ein **gebauter** Stand laeuft (`pnpm build && pnpm start`) und
- * `SEED_ADMIN_EMAIL`/`SEED_ADMIN_PASSWORD` sind gesetzt. Gegen `pnpm dev`
- * schlaegt das hier fehl, und das ist richtig so — siehe CLAUDE.md,
- * „Oberflaeche pruefen“.
+ * Voraussetzungen prueft `tests/e2e/global-setup.ts` vor dem ersten Ablauf: ein
+ * **gebauter** Stand antwortet, der Seed-Bestand steht, und der Server liest
+ * dieselbe Datenbank wie dieser Lauf. Gegen `pnpm dev` schlaegt das hier fehl,
+ * und das ist richtig so — siehe CLAUDE.md, „Oberflaeche pruefen“.
  *
- * Der Ablauf legt seine eigene Vorlage an und **archiviert** sie am Ende. Nicht
- * loescht: eine veroeffentlichte Version laesst sich nicht mehr entfernen, auch
- * nicht ueber einen Kaskadenloeschvorgang — der Trigger aus #009 verweigert das
- * ausdruecklich, und genau das ist die Zusage, an der das ganze Archiv haengt.
- * Wer diese Tests oft laufen laesst, braucht deshalb eine Wegwerf-Datenbank
- * (kommt mit #018).
+ * Der Ablauf legt seine eigene Vorlage an, **archiviert** sie ueber die
+ * Oberflaeche — das ist der Weg, den die Anwendung kennt, geloescht wird dort
+ * nichts — und raeumt sie hinterher ueber die Datenbank weg. Ohne diesen
+ * Nachlauf blieb nach jedem Durchgang eine archivierte „ZZ E2E Editor“-Vorlage
+ * stehen; in der Entwicklungsdatenbank lagen davon zuletzt ueber hundert (#018).
  */
 
 const NAME = `ZZ E2E Editor ${Date.now()}`;
 
-async function anmelden(seite: Page) {
-  const email = process.env["SEED_ADMIN_EMAIL"];
-  const passwort = process.env["SEED_ADMIN_PASSWORD"];
-  if (!email || !passwort) throw new Error("SEED_ADMIN_EMAIL und SEED_ADMIN_PASSWORD fehlen.");
-  await seite.goto("/anmelden");
-  await seite.fill('input[name="email"]', email);
-  await seite.fill('input[name="passwort"]', passwort);
-  await Promise.all([seite.waitForURL("**/"), seite.click('button[type="submit"]')]);
-}
-
 /** Legt die Vorlage an und fuehrt in ihren Entwurf. Gibt die Adresse des Editors zurueck. */
 async function entwurfAnlegen(seite: Page, name: string): Promise<string> {
   await seite.goto("/vorlagen");
@@ -176,3 +167,33 @@ test.describe("Vorlagen-Editor", () => {
     await aufraeumen(page, name);
   });
 });
+
+test.afterAll(async () => {
+  /*
+   * Aufgeraeumt wird ueber die Datenbank, weil die Anwendung fuer eine Vorlage
+   * bewusst keinen Loeschweg kennt — archivieren ist das Gegenteil von
+   * Aufraeumen. Die veroeffentlichte Version steht dem nicht im Weg: der Trigger
+   * aus #009 schuetzt Abschnitte und Schritte einer veroeffentlichten Version,
+   * und beim Kaskadenloeschen ist die Version bereits fort, wenn sie fallen.
+   *
+   * An diesen Vorlagen haengt kein Lauf — dieser Ablauf startet keinen. Haengte
+   * einer, verweigerte der Fremdschluessel das Loeschen, und das waere richtig.
+   */
+  const vorlagen = await prisma.vorlage.findMany({
+    where: { name: { startsWith: "ZZ E2E Editor" } },
+    select: { id: true, versionen: { select: { id: true } } },
+  });
+  if (vorlagen.length === 0) {
+    await prisma.$disconnect();
+    return;
+  }
+  const kennungen = vorlagen.flatMap((vorlage) => [
+    vorlage.id,
+    ...vorlage.versionen.map((version) => version.id),
+  ]);
+  // Das Protokoll haelt Anlegen und Veroeffentlichen fest; `entitaetId` ist kein
+  // Fremdschluessel, die Zeilen bleiben also sonst als Waisen stehen.
+  await prisma.protokoll.deleteMany({ where: { entitaetId: { in: kennungen } } });
+  await prisma.vorlage.deleteMany({ where: { id: { in: vorlagen.map((zeile) => zeile.id) } } });
+  await prisma.$disconnect();
+});