Phase 8 abgeschlossen: Export als PDF, Wasserzeichen, Vier-Augen-Freigabe

Die Druckansicht ist die einzige Vorlage für den Export: kein zweites Layout von Hand in einer PDF-Bibliothek. Der Playwright-Dienst ruft genau diese Seite auf und bekommt dafür ein signiertes, kurzlebiges Zeichen statt eines Sitzungscookies. Es gilt nur, solange der Auftrag läuft, ist an den Anfragenden gebunden, und die Stufe wird beim Einlösen frisch aufgelöst und auf die im Zeichen vermerkte gedeckelt. Der Export darf nie sauberer aussehen als die Akte: gesperrte Felder erscheinen als Balken mit Vermerk statt zu fehlen, geänderte Einträge tragen ihre Version, zurückgezogene stehen als Grabstein. Wasserzeichen mit Name, Zeitstempel und Stufe auf jeder Seite. Die Stufe steckt im Zwischenspeicherschlüssel. Ohne sie bekäme ein Leser der Stufe 1 das PDF, das für Stufe 4 gerendert wurde. Ab Stufe 3 wartet der Auftrag auf Freigabe durch ein zweites Augenpaar — und der Anfragende darf sich nicht selbst freigeben, auch nicht mit dem Recht dazu. Offene Freigaben stehen auf der Übersicht. Dazu Einzeldokumente als PDF (Aktenblatt bleibt Aktenblatt), ZIP-Sammelexport mit eigenem achtzigzeiligem Schreiber statt einer Abhängigkeit, und der JSON-Vollabzug ohne Stufenfilterung — die einzige Stelle, an der die Klassifizierung nicht greift, deshalb hinter einem eigenen Admin-Endpunkt. Zwei Funde unterwegs, beide in docs/13 festgehalten: Die Druckansicht warf notFound(), und das Skelett aus dem Wurzel-loading.tsx blieb im Browser stehen — der PDF-Dienst hätte leere Blätter gedruckt. Gefunden nur, weil der e2e-Test auf den Inhalt prüft und nicht auf den Statuscode. Sie rendert die Auskunft jetzt selbst. Und die Entdopplung der Anhänge verwies auf Dateien, ohne nachzusehen, ob sie noch daliegen. Nach einem geleerten /tmp zeigte jeder weitere Upload desselben Inhalts stumm ins Leere. 178 Tests im Web-Paket, 17 in der Datenbank, 7 im Worker, 44 e2e. Fallakte bei 119,8 von 120 kB — das Budget ist aufgebraucht. Co-Authored-By: Claude Opus 5 <noreply@anthropic.com>
2026-09-03 10:01:57 +02:00
parent 71c20f4b95
commit d0adcd7795
33 changed files with 2549 additions and 19 deletions
@@ -0,0 +1,40 @@
+-- Phase 8: Export.
+--
+-- Der Auftrag steht in der Datenbank, nicht im Speicher eines Prozesses: das
+-- Rendern dauert, und ein Neustart des Web-Containers soll einen laufenden
+-- Export nicht spurlos verschlucken.
+
+CREATE TYPE "ExportKind"   AS ENUM ('CASE', 'DOCUMENT', 'BUNDLE', 'DATABASE');
+CREATE TYPE "ExportStatus" AS ENUM (
+  'PENDING_APPROVAL', 'QUEUED', 'RUNNING', 'READY', 'FAILED', 'REJECTED'
+);
+
+CREATE TABLE "ExportJob" (
+    "id"              TEXT           NOT NULL,
+    "kind"            "ExportKind"   NOT NULL,
+    "targetId"        TEXT,
+    "requestedById"   TEXT           NOT NULL,
+    "clearanceAtTime" INTEGER        NOT NULL,
+    "status"          "ExportStatus" NOT NULL DEFAULT 'QUEUED',
+    "cacheKey"        TEXT           NOT NULL,
+    "storageKey"      TEXT,
+    "sizeBytes"       INTEGER,
+    "error"           TEXT,
+    "approvedById"    TEXT,
+    "approvedAt"      TIMESTAMP(3),
+    "rejectedById"    TEXT,
+    "rejectReason"    TEXT,
+    "createdAt"       TIMESTAMP(3)   NOT NULL DEFAULT CURRENT_TIMESTAMP,
+    "startedAt"       TIMESTAMP(3),
+    "finishedAt"      TIMESTAMP(3),
+
+    CONSTRAINT "ExportJob_pkey" PRIMARY KEY ("id")
+);
+
+CREATE INDEX "ExportJob_status_createdAt_idx"        ON "ExportJob"("status", "createdAt");
+CREATE INDEX "ExportJob_requestedById_createdAt_idx" ON "ExportJob"("requestedById", "createdAt" DESC);
+CREATE INDEX "ExportJob_cacheKey_status_idx"         ON "ExportJob"("cacheKey", "status");
+
+-- Ein Auftrag wird nie gelöscht: er ist der Beleg dafür, wer wann was
+-- ausgeleitet hat, und ergänzt das Zugriffsprotokoll um den Ausgang.
+CREATE RULE export_job_no_delete AS ON DELETE TO "ExportJob" DO INSTEAD NOTHING;
@@ -845,6 +845,67 @@ model SavedView {
  @@index([userId, sortOrder])
 }

+/// Ein Exportauftrag.
+///
+/// Der Export laeuft im Hintergrund, weil das Rendern auf einem Heimserver
+/// spuerbar CPU kostet. Der Klick erzeugt diesen Auftrag, die Oberflaeche
+/// wartet auf das Ereignis `export.ready`.
+///
+/// `cacheKey` ist sha256 ueber Ziel, Stand, Stufe des Abrufers und
+/// Vorlagenversion: dieselbe Akte wird oft mehrfach exportiert, und zwei
+/// Abrufer verschiedener Stufen bekommen **nicht** dasselbe PDF.
+model ExportJob {
+  id              String       @id @default(uuid(7))
+  kind            ExportKind
+  /// Fallakte oder Dokument. Leer beim Voll- und Sammelexport.
+  targetId        String?
+  requestedById   String
+  /// Die Stufe des Abrufers zum Zeitpunkt der Anfrage. Sie steckt im
+  /// Schluessel und im Wasserzeichen.
+  clearanceAtTime Int
+  status          ExportStatus @default(QUEUED)
+  cacheKey        String
+  /// Pfad unterhalb von FILES_DIR, sobald fertig.
+  storageKey      String?
+  sizeBytes       Int?
+  error           String?
+
+  /// Vier-Augen-Prinzip ab Stufe 3, siehe docs/08-suche-und-export.md.
+  approvedById String?
+  approvedAt   DateTime?
+  rejectedById String?
+  rejectReason String?
+
+  createdAt  DateTime  @default(now())
+  startedAt  DateTime?
+  finishedAt DateTime?
+
+  @@index([status, createdAt])
+  @@index([requestedById, createdAt(sort: Desc)])
+  @@index([cacheKey, status])
+}
+
+enum ExportKind {
+  /// eine Fallakte mit Verlauf und Anhangsverzeichnis
+  CASE
+  /// ein einzelnes Dokument, ohne Verlauf
+  DOCUMENT
+  /// mehrere Akten als ZIP, nur mit Recht 'admin'
+  BUNDLE
+  /// vollstaendiger JSON-Abzug, nur mit Recht 'admin'
+  DATABASE
+}
+
+enum ExportStatus {
+  /// wartet auf die Freigabe durch ein zweites Augenpaar
+  PENDING_APPROVAL
+  QUEUED
+  RUNNING
+  READY
+  FAILED
+  REJECTED
+}
+
 /// Lebenszeichen der Dienste, die nicht im Web-Container laufen. Der Worker
 /// schreibt hier seinen Gateway-Zustand hinein, damit /api/health ihn pruefen
 /// kann, ohne Discord zu befragen. Siehe docs/11-betrieb.md.