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>
This commit is contained in:
Harlekin
2026-09-03 10:01:57 +02:00
co-authored by Claude Opus 5
parent 71c20f4b95
commit d0adcd7795
33 changed files with 2549 additions and 19 deletions
+61
View File
@@ -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.