docs: Handbuchseite zum Erfassen und Beschreibung der Schnittstelle

Die Beschreibung sagt auch, was die Schnittstelle bewusst nicht kann —
Bereich setzen, Aufgaben loeschen, Zeitbloecke anfassen. Das ist eine
Entscheidung und kein Versehen, und wer davorsteht, soll es erfahren,
statt es fuer eine Luecke zu halten.

Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>

prisma/demo-seed.ts

@@ -489,6 +489,44 @@ async function main(): Promise<void> {
     })
   }
 
+  // --- API-Tokens -----------------------------------------------------------
+  // Erfundene Hashes: Mit diesen Zeilen laesst sich nichts aufrufen, sie
+  // zeigen nur, wie die Liste aussieht.
+  await db.apiToken.deleteMany({})
+  await db.apiToken.create({
+    data: {
+      benutzerId: benutzer.id,
+      name: 'Wartungsplaner-Import',
+      praefix: 'k7m2xq4b',
+      hash: 'demo-1',
+      rechte: 'erfassen',
+      erstelltAm: new Date(Date.UTC(2026, 0, 14, 9, 30)),
+      letzteNutzung: new Date(Date.UTC(2026, 2, 17, 5, 12)),
+    },
+  })
+  await db.apiToken.create({
+    data: {
+      benutzerId: benutzer.id,
+      name: 'Auswertung Homelab',
+      praefix: 'r3wp9dt4',
+      hash: 'demo-2',
+      rechte: 'lesen',
+      gueltigBis: new Date(Date.UTC(2026, 8, 30, 22, 0)),
+      erstelltAm: new Date(Date.UTC(2026, 1, 2, 18, 45)),
+    },
+  })
+  await db.apiToken.create({
+    data: {
+      benutzerId: benutzer.id,
+      name: 'Altes Skript',
+      praefix: 'z8n4vt6c',
+      hash: 'demo-3',
+      rechte: 'lesen,schreiben',
+      erstelltAm: new Date(Date.UTC(2025, 10, 3, 11, 0)),
+      widerrufenAm: new Date(Date.UTC(2026, 1, 20, 8, 15)),
+    },
+  })
+
   console.log(`Demo-Daten stehen bereit. Anmeldung: ${DEMO_EMAIL}`)
 }