feat(protokoll): Audit-Log mit Filtern, Kettenpruefung und CSV (#027)

Das Protokoll war bisher nur in der Datenbank lesbar. Die Ansicht zeigt es
jeder Rolle mit lesbaren Aktionstexten, aufklappbarem Diff, Details und
Hashes; ein Test haelt fest, dass jede Aktion im Code einen Text hat.

Geblaettert wird ueber die ID statt OFFSET, weil das Protokoll waehrend
des Lesens waechst. Die Kettenpruefung liest jede Zeile und laeuft deshalb
nur auf Knopfdruck, mit 5 Minuten Zwischenspeicher; ein Bruch wird selbst
protokolliert. Der CSV-Export streamt in Stapeln, entschaerft Formeln und
steht selbst im Protokoll. protokollieren() reicht jeden Eintrag nach dem
Schreiben an Syslog weiter, ohne Details und Diff.

Kein Weg aendert oder loescht Eintraege; ein struktureller Test sichert
das ab, zusaetzlich zum Trigger.

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

src/app/api/protokoll.csv/route.ts

@@ -0,0 +1,69 @@
+import { NextResponse } from "next/server";
+import { CSV_BOM, csvZeile } from "@/lib/csv";
+import { PROTOKOLL_CSV_KOPF, protokollCsvWerte, protokollFilterAus } from "@/lib/protokoll-filter";
+import { RechteFehler, rechtErforderlich } from "@/server/auth/sitzungspflicht";
+import { protokollStapelweise } from "@/server/queries/protokoll";
+import { protokollieren } from "@/server/services/protokoll";
+
+/**
+ * Protokoll als CSV (#027) mit denselben Filtern wie die Seite. Jede Rolle darf lesen; der
+ * Handler prueft das selbst.
+ *
+ * Gestreamt: die Datenbank liefert Stapel zu 500 Zeilen, jeder Stapel geht sofort hinaus.
+ * Ein Protokoll mit Hunderttausenden Eintraegen muss so nie ganz in den Speicher.
+ */
+export async function GET(anfrage: Request) {
+  let benutzer;
+  try {
+    ({ benutzer } = await rechtErforderlich("lesen"));
+  } catch (fehler) {
+    if (fehler instanceof RechteFehler) return NextResponse.json({ fehler: fehler.message }, { status: 403 });
+    throw fehler;
+  }
+  const filter = protokollFilterAus(Object.fromEntries(new URL(anfrage.url).searchParams));
+
+  // Vor dem ersten Byte: wer das Protokoll mitnimmt, steht selbst darin – und scheitert das
+  // Schreiben, gibt es auch keinen Export.
+  await protokollieren({
+    akteur: { id: benutzer.id, name: benutzer.name },
+    aktion: "protokoll.exportiert",
+    ergebnis: "ERFOLG",
+    details: { filter: Object.fromEntries(Object.entries(filter).filter(([, wert]) => wert)) },
+  });
+
+  const kodierer = new TextEncoder();
+  const stapel = protokollStapelweise(filter);
+  const strom = new ReadableStream<Uint8Array>({
+    start(steuerung) {
+      steuerung.enqueue(kodierer.encode(CSV_BOM + csvZeile(PROTOKOLL_CSV_KOPF) + "\r\n"));
+    },
+    // pull statt Schleife in start: der naechste Stapel wird erst gelesen, wenn der Client
+    // den vorigen abgenommen hat (Gegendruck).
+    async pull(steuerung) {
+      try {
+        const { value, done } = await stapel.next();
+        if (done) {
+          steuerung.close();
+          return;
+        }
+        steuerung.enqueue(
+          kodierer.encode(value.map((z) => csvZeile(protokollCsvWerte(z)) + "\r\n").join("")),
+        );
+      } catch (fehler) {
+        steuerung.error(fehler);
+      }
+    },
+    async cancel() {
+      await stapel.return(undefined);
+    },
+  });
+
+  const tag = new Date().toISOString().slice(0, 10);
+  return new NextResponse(strom, {
+    headers: {
+      "Content-Type": "text/csv; charset=utf-8",
+      "Content-Disposition": `attachment; filename="sshkv-protokoll-${tag}.csv"`,
+      "Cache-Control": "no-store",
+    },
+  });
+}