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.
This commit is contained in:
Harlekin
2026-09-03 10:01:57 +02:00
parent a49f4b5956
commit 48fd0f39eb
31 changed files with 2429 additions and 13 deletions
+122
View File
@@ -0,0 +1,122 @@
import { db } from '@/lib/db'
import { writeAudit } from '@/lib/audit'
import { AccessError } from '@/lib/errors'
import type { EffectivePermissions } from '@/lib/auth/permissions'
/**
* Vollständiger JSON-Abzug als Umzugs- und Notfallformat.
*
* **Ohne Stufenfilterung**, nur mit Recht `admin`, immer protokolliert — so
* steht es in docs/08-suche-und-export.md. Das ist die eine Stelle im System,
* an der die Klassifizierung nicht greift, und sie ist deshalb absichtlich
* unbequem: kein Knopf an einer Akte, sondern eine eigene Seite im
* Adminbereich.
*
* Ausgelassen wird, was Zugang verschafft statt ihn zu dokumentieren:
* Sitzungen. Sie gehören niemandem ausser dem Browser, aus dem sie stammen.
*/
export async function exportDatabase(p: EffectivePermissions): Promise<Uint8Array> {
if (!p.isAdmin) throw new AccessError('no-permission')
const [
users,
roleMappings,
clearanceLevels,
foundationClearances,
statusTags,
templates,
cases,
caseSections,
caseSectionVersions,
caseEntries,
caseEntryVersions,
participants,
exclusions,
links,
personnel,
assignments,
documents,
documentSections,
documentSectionVersions,
attachments,
channels,
messages,
reactions,
auditLog,
] = await Promise.all([
db.user.findMany(),
db.roleMapping.findMany(),
db.clearanceLevelConfig.findMany(),
db.foundationClearance.findMany(),
db.personnelStatusTag.findMany(),
db.documentTemplate.findMany(),
db.case.findMany(),
db.caseSection.findMany(),
db.caseSectionVersion.findMany(),
db.caseEntry.findMany(),
db.caseEntryVersion.findMany(),
db.caseParticipant.findMany(),
db.caseExclusion.findMany(),
db.caseLink.findMany(),
db.personnelFile.findMany(),
db.personnelAssignment.findMany(),
db.document.findMany(),
db.documentSection.findMany(),
db.documentSectionVersion.findMany(),
db.attachment.findMany(),
db.channel.findMany(),
db.chatMessage.findMany(),
db.chatReaction.findMany(),
// Das Protokoll gehört dazu: ein Abzug ohne die Zugriffsspur wäre als
// Notfallformat wertlos.
db.auditLog.findMany({ orderBy: { id: 'desc' }, take: 50_000 }),
])
const abzug = {
exportedAt: new Date().toISOString(),
exportedBy: p.userId,
note: 'Vollstaendiger Abzug ohne Stufenfilterung. Vertraulich behandeln.',
users,
roleMappings,
clearanceLevels,
foundationClearances,
statusTags,
templates,
cases,
caseSections,
caseSectionVersions,
caseEntries,
caseEntryVersions,
participants,
exclusions,
links,
personnel,
assignments,
documents,
documentSections,
documentSectionVersions,
attachments,
channels,
messages,
reactions,
auditLog,
}
await db.$transaction(async (tx) => {
await writeAudit(tx, {
actorId: p.userId,
action: 'export.database',
targetType: 'Database',
targetId: 'all',
clearanceAtTime: p.clearanceLevel,
meta: { cases: cases.length, entries: caseEntries.length, users: users.length },
})
})
// `BigInt` kommt in AuditLog.id vor und ist in JSON nicht vorgesehen.
return new TextEncoder().encode(
JSON.stringify(abzug, (_key, wert: unknown) =>
typeof wert === 'bigint' ? wert.toString() : wert,
2),
)
}