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 cb0eabb266
commit f1106a57d6
31 changed files with 2429 additions and 13 deletions
+21
View File
@@ -0,0 +1,21 @@
import { de } from '@/lib/i18n/de'
/**
* Was eine Druckansicht zeigt, wenn es nichts zu zeigen gibt.
*
* Bewusst **kein `notFound()`**: die Wurzel hat ein `loading.tsx`, und dessen
* Skelett bleibt in dieser Gruppe stehen, statt durch die Nicht-gefunden-Seite
* ersetzt zu werden — die Ansicht bliebe leer. Für ein Blatt, das gedruckt
* wird, ist ein leeres Blatt der schlechteste Ausgang: es sieht aus wie ein
* Fehler im Papier, nicht wie eine Auskunft.
*
* Sie sagt nicht, ob es die Akte gibt. Existenz ist auch eine Information.
*/
export function NotAvailable() {
return (
<main className="print-sheet">
<h1>{de.errors.notFound.title}</h1>
<p className="print-note">{de.errors.notFound.body}</p>
</main>
)
}
@@ -0,0 +1,180 @@
import type { Metadata } from 'next'
import { db } from '@/lib/db'
import { loadDocumentSections } from '@/lib/documents/service'
import { loadVisibleDocument } from '@/lib/documents/service'
import { resolvePhotoUrls } from '@/lib/files/service'
import { permissionsForPrint } from '@/lib/export/printAccess'
import { Sheet } from '@/components/documents/Sheet'
import { de } from '@/lib/i18n/de'
import { NotAvailable } from '../../../NotAvailable'
import { isInputField, fillPlaceholders } from '@/lib/templates/fields'
export const dynamic = 'force-dynamic'
export async function generateMetadata({
params,
}: {
params: Promise<{ documentNumber: string }>
}): Promise<Metadata> {
const { documentNumber } = await params
return { title: documentNumber, robots: { index: false, follow: false } }
}
/**
* Druckansicht eines einzelnen Dokuments.
*
* Kein Verlauf, keine Kopfdatentabelle einer Akte — das Dokument selbst, so
* wie seine Vorlage es vorsieht. Ein Aktenblatt kommt als Aktenblatt heraus,
* ein Vertrag als Vertrag. Siehe docs/08-suche-und-export.md.
*/
export default async function PrintDocumentPage({
params,
searchParams,
}: {
params: Promise<{ documentNumber: string }>
searchParams: Promise<{ token?: string }>
}) {
const { documentNumber } = await params
const { token } = await searchParams
const zugang = await permissionsForPrint(token)
if (!zugang) return <NotAvailable />
const { permissions, displayName } = zugang
const doc = await loadVisibleDocument(permissions, documentNumber)
if (!doc) return <NotAvailable />
const [sections, template, foundationLevels, levels] = await Promise.all([
loadDocumentSections(permissions, doc),
db.documentTemplate.findUnique({
where: { id: doc.templateId },
select: { sheetTitle: true, sheetSubtitle: true, name: true },
}),
db.foundationClearance.findMany({ orderBy: { sortOrder: 'asc' } }),
db.clearanceLevelConfig.findMany({ orderBy: { level: 'asc' } }),
])
const photoUrls = await resolvePhotoUrls(
permissions,
sections.map((section) => ({
fieldKey: section.fieldKey,
visible: section.visible,
value: section.visible ? section.value : null,
type: section.field.type,
})),
)
const levelName = new Map(levels.map((l) => [l.level, l.name]))
const werte = Object.fromEntries(
sections.filter((s) => s.visible).map((s) => [s.fieldKey, s.value]),
)
// Das Aktenblatt bringt sein eigenes Aussehen mit und braucht keinen
// Berichtsrahmen darum.
if (doc.layout === 'DOSSIER') {
return (
<Sheet
sections={sections}
title={template?.sheetTitle ?? de.app.name}
subtitle={template?.sheetSubtitle ?? template?.name ?? doc.title}
documentNumber={doc.documentNumber}
issuedAt={doc.createdAt}
foundationLevels={foundationLevels}
footerNote={de.document.footerNote}
photoUrls={photoUrls}
/>
)
}
return (
<main className="print-sheet">
<section className="print-cover">
<span className="print-stamp">
{doc.classification} · {levelName.get(doc.classification) ?? de.common.unknown}
</span>
<h1 style={{ marginTop: '4mm' }}>{doc.title}</h1>
<p style={{ fontFamily: 'var(--font-mono, monospace)', margin: 0 }}>
{doc.documentNumber}
</p>
<table className="print-meta">
<tbody>
<tr>
<th>{de.case.status}</th>
<td>{de.document.statusNames[doc.status] ?? doc.status}</td>
</tr>
<tr>
<th>{de.document.kind}</th>
<td>{doc.templateKey}</td>
</tr>
<tr>
<th>{de.export.retrievedBy}</th>
<td>{displayName}</td>
</tr>
<tr>
<th>{de.export.asOf}</th>
<td>
{new Date().toLocaleString('de-DE')} · {de.clearance.label}{' '}
{permissions.clearanceLevel}
</td>
</tr>
</tbody>
</table>
</section>
{doc.retractedAt ? (
<p className="print-stamp" style={{ marginBottom: '4mm' }}>
{de.document.statusNames.RETRACTED}
</p>
) : null}
{sections.map((section) => {
const field = section.field
if (!isInputField(field)) {
if (field.type === 'pagebreak') {
return <div key={field.key} style={{ breakAfter: 'page' }} />
}
const text = fillPlaceholders(field.text ?? '', werte)
return field.type === 'heading' ? (
<h3 key={field.key}>{text || field.label}</h3>
) : (
<p key={field.key} style={{ whiteSpace: 'pre-wrap' }}>
{text}
</p>
)
}
if (field.type === 'signature') {
return (
<div key={field.key} style={{ marginTop: '10mm', breakInside: 'avoid' }}>
<div style={{ borderTop: '1pt solid #000', width: '70mm' }} />
<p className="print-note">{fillPlaceholders(field.label, werte)}</p>
</div>
)
}
return (
<div key={field.key} style={{ marginBottom: '3mm', breakInside: 'avoid' }}>
<p className="print-label">{field.label}</p>
{!section.visible ? (
<p style={{ margin: '1mm 0' }}>
<span className="print-redacted">&nbsp;</span>{' '}
<span className="print-note">
{de.export.redactedAt(
section.value.requiredLevel,
levelName.get(section.value.requiredLevel) ?? '',
)}
</span>
</p>
) : (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>
{String(section.value ?? '—')}
</p>
)}
</div>
)
})}
</main>
)
}
@@ -0,0 +1,267 @@
import type { Metadata } from 'next'
import { db } from '@/lib/db'
import { visibleEntryWhere } from '@/lib/access/caseFilter'
import { visibleAttachmentWhere } from '@/lib/access/attachmentFilter'
import { loadVisibleCase } from '@/lib/cases/service'
import { loadSections } from '@/lib/cases/sectionService'
import { permissionsForPrint } from '@/lib/export/printAccess'
import { isInputField, fillPlaceholders } from '@/lib/templates/fields'
import { de } from '@/lib/i18n/de'
import { NotAvailable } from '../../../NotAvailable'
import type { RenderedSection } from '@/lib/sections/render'
export const dynamic = 'force-dynamic'
export async function generateMetadata({
params,
}: {
params: Promise<{ caseNumber: string }>
}): Promise<Metadata> {
const { caseNumber } = await params
return { title: caseNumber, robots: { index: false, follow: false } }
}
/**
* Druckansicht einer Fallakte.
*
* Sie ist die einzige Vorlage für den PDF-Export: kein zweites Layout von Hand
* in einer PDF-Bibliothek. Der Playwright-Dienst ruft genau diese Seite auf.
*
* **Ein Export darf nie sauberer aussehen als die Akte ist.** Deshalb:
* gesperrte Felder erscheinen als Balken mit Vermerk statt zu fehlen,
* geänderte Einträge sind als geändert gekennzeichnet, zurückgezogene stehen
* als Grabstein mit Begründung. Siehe docs/08-suche-und-export.md.
*/
export default async function PrintCasePage({
params,
searchParams,
}: {
params: Promise<{ caseNumber: string }>
searchParams: Promise<{ token?: string }>
}) {
const { caseNumber } = await params
const { token } = await searchParams
const zugang = await permissionsForPrint(token)
if (!zugang) return <NotAvailable />
const { permissions, displayName } = zugang
const akte = await loadVisibleCase(permissions, caseNumber)
if (!akte) return <NotAvailable />
const [sections, entries, anhaenge, levels, autoren] = await Promise.all([
loadSections(permissions, akte.id, akte.templateId),
db.caseEntry.findMany({
where: { AND: [visibleEntryWhere(permissions), { caseId: akte.id }] },
orderBy: [{ createdAt: 'asc' }, { id: 'asc' }],
select: {
id: true,
type: true,
body: true,
authorId: true,
createdAt: true,
version: true,
editedAt: true,
editVisible: true,
retractedAt: true,
retractionReason: true,
},
}),
db.attachment.findMany({
where: { AND: [visibleAttachmentWhere(permissions), { caseId: akte.id }] },
orderBy: { createdAt: 'asc' },
select: { id: true, originalName: true, sha256: true, sizeBytes: true, scanStatus: true },
}),
db.clearanceLevelConfig.findMany({ orderBy: { level: 'asc' } }),
db.user.findMany({ select: { id: true, displayName: true } }),
])
const levelName = new Map(levels.map((l) => [l.level, l.name]))
const nameVon = new Map(autoren.map((a) => [a.id, a.displayName]))
const stand = new Date()
return (
<main className="print-sheet">
<section className="print-cover">
<span className="print-stamp">
{akte.classification} · {levelName.get(akte.classification) ?? de.common.unknown}
</span>
<h1 style={{ marginTop: '4mm' }}>{akte.title}</h1>
<p style={{ fontFamily: 'var(--font-mono, monospace)', margin: 0 }}>{akte.caseNumber}</p>
<table className="print-meta">
<tbody>
<Zeile label={de.case.status} value={de.case.statusNames[akte.status] ?? akte.status} />
<Zeile label={de.case.type} value={akte.templateKey} />
<Zeile
label={de.case.createdBy}
value={nameVon.get(akte.createdById) ?? akte.createdById}
/>
<Zeile
label={de.case.dueAt}
value={akte.dueAt ? akte.dueAt.toLocaleDateString('de-DE') : '—'}
/>
<Zeile label={de.export.retrievedBy} value={displayName} />
<Zeile
label={de.export.asOf}
value={`${stand.toLocaleString('de-DE')} · ${de.clearance.label} ${permissions.clearanceLevel}`}
/>
</tbody>
</table>
<p className="print-note" style={{ marginTop: '4mm' }}>
{de.export.coverNote}
</p>
</section>
<h2>{de.section.heading}</h2>
<PrintSections sections={sections} levelName={levelName} />
<h2>{de.case.timeline}</h2>
{entries.length === 0 ? (
<p className="print-note">{de.entry.empty}</p>
) : (
entries.map((eintrag) => (
<div key={eintrag.id} className="print-entry">
<p className="print-label">
{de.entry.types[eintrag.type] ?? eintrag.type} ·{' '}
{nameVon.get(eintrag.authorId) ?? eintrag.authorId} ·{' '}
{eintrag.createdAt.toLocaleString('de-DE')}
{eintrag.editVisible && eintrag.editedAt
? ` · ${de.export.editedAt(eintrag.version, eintrag.editedAt.toLocaleDateString('de-DE'))}`
: ''}
</p>
{eintrag.retractedAt ? (
<p style={{ margin: '1mm 0', fontStyle: 'italic' }}>
{de.entry.retracted(
eintrag.retractedAt.toLocaleDateString('de-DE'),
nameVon.get(eintrag.authorId) ?? eintrag.authorId,
eintrag.retractionReason ?? '',
)}
</p>
) : (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>{eintrag.body}</p>
)}
</div>
))
)}
<h2>{de.attachment.heading}</h2>
{anhaenge.length === 0 ? (
<p className="print-note">{de.attachment.empty}</p>
) : (
<table className="print-meta">
<thead>
<tr>
<th>{de.export.fileName}</th>
<th>{de.export.fileSize}</th>
<th>{de.export.fileHash}</th>
</tr>
</thead>
<tbody>
{anhaenge.map((anhang) => (
<tr key={anhang.id}>
<td>{anhang.originalName}</td>
<td>{anhang.sizeBytes}</td>
{/* Der Hash macht nachprüfbar, dass die Datei zum Ausdruck
gehört — deshalb steht er im Verzeichnis. */}
<td style={{ fontFamily: 'monospace', fontSize: '7pt', wordBreak: 'break-all' }}>
{anhang.sha256}
</td>
</tr>
))}
</tbody>
</table>
)}
</main>
)
}
function Zeile({ label, value }: { label: string; value: string }) {
return (
<tr>
<th>{label}</th>
<td>{value}</td>
</tr>
)
}
/**
* Die Abschnitte im Druck. Ein gesperrtes Feld wird als Balken ausgegeben, mit
* dem Vermerk, ab welcher Stufe es lesbar wäre — sonst merkt der Empfänger
* nicht, dass er eine gekürzte Fassung in der Hand hält.
*/
function PrintSections({
sections,
levelName,
}: {
sections: RenderedSection[]
levelName: Map<number, string>
}) {
const werte = Object.fromEntries(
sections.filter((s) => s.visible).map((s) => [s.fieldKey, s.value]),
)
return (
<div>
{sections.map((section) => {
const field = section.field
if (!isInputField(field)) {
if (field.type === 'pagebreak') {
return <div key={field.key} style={{ breakAfter: 'page' }} />
}
const text = fillPlaceholders(field.text ?? '', werte)
return field.type === 'heading' ? (
<h3 key={field.key}>{text || field.label}</h3>
) : (
<p key={field.key} style={{ whiteSpace: 'pre-wrap' }}>
{text}
</p>
)
}
return (
<div key={field.key} style={{ marginBottom: '3mm', breakInside: 'avoid' }}>
<p className="print-label">{field.label}</p>
{!section.visible ? (
<p style={{ margin: '1mm 0' }}>
<span className="print-redacted">&nbsp;</span>{' '}
<span className="print-note">
{de.export.redactedAt(
section.value.requiredLevel,
levelName.get(section.value.requiredLevel) ?? '',
)}
</span>
</p>
) : section.segments ? (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>
{section.segments.map((segment, index) =>
segment.kind === 'text' ? (
<span key={index}>{segment.text}</span>
) : (
// Balken statt Auslassung, mit der Stufe daneben: der
// Empfaenger soll sehen, dass hier etwas fehlt.
<span key={index}>
<span
className="print-redacted"
style={{ width: `${segment.blockLength}ch` }}
>
&nbsp;
</span>
<span className="print-note"> [{segment.requiredLevel}]</span>
</span>
),
)}
</p>
) : (
<p style={{ margin: '1mm 0', whiteSpace: 'pre-wrap' }}>
{String(section.value ?? '—')}
</p>
)}
</div>
)
})}
</div>
)
}