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
+11
View File
@@ -69,6 +69,17 @@ export default async function SystemPage() {
<SystemState />
</div>
</Suspense>
<section className="mt-10">
<h2 className="font-condensed">{de.export.heading}</h2>
<p className="mt-2 max-w-(--container-measure) text-sm text-text-dim">
{de.export.databaseHint}
</p>
<p className="mt-3 flex flex-wrap gap-4 font-condensed text-xs">
<a href="/api/admin/export?kind=database">{de.export.database}</a>
<a href="/api/admin/export?kind=bundle">{de.export.bundle}</a>
</p>
</section>
</main>
)
}
@@ -0,0 +1,46 @@
import type { Metadata } from 'next'
import Link from 'next/link'
import { notFound } from 'next/navigation'
import { requireUser } from '@/lib/auth/current'
import { loadVisibleDocument } from '@/lib/documents/service'
import { APPROVAL_FROM_LEVEL } from '@/lib/export/service'
import { de } from '@/lib/i18n/de'
import { ExportPanel } from '@/components/export/ExportPanel'
export const metadata: Metadata = { title: de.export.heading }
export const dynamic = 'force-dynamic'
export default async function DocumentExportPage({
params,
}: {
params: Promise<{ documentNumber: string }>
}) {
const user = await requireUser()
const { documentNumber } = await params
const doc = await loadVisibleDocument(user.permissions, documentNumber)
if (!doc) notFound()
return (
<main className="mx-auto max-w-(--container-measure) px-6 py-10">
<p className="font-mono text-xs text-text-dim">{doc.documentNumber}</p>
<h1 className="mt-1 font-condensed">{de.export.heading}</h1>
<div className="mt-6">
<ExportPanel
target={{ kind: 'DOCUMENT', documentNumber: doc.documentNumber }}
topic={`user:${user.id}`}
/>
</div>
{doc.classification >= APPROVAL_FROM_LEVEL ? (
<p className="mt-4 text-2xs text-stamp-3">{de.export.waitingApprovalHint}</p>
) : null}
<nav className="mt-8 flex gap-4 font-condensed text-xs">
<Link href={`/dokumente/${doc.documentNumber}`}>{doc.documentNumber}</Link>
<Link href={`/dokumente/${doc.documentNumber}/druck`}>{de.export.print}</Link>
</nav>
</main>
)
}
@@ -212,6 +212,10 @@ export default async function DocumentPage({
</div>
</dl>
<p className="no-print mt-2 text-xs">
<Link href={`/dokumente/${doc.documentNumber}/export`}>{de.export.asPdf}</Link>
</p>
{besitzer ? (
<p className="mt-2 text-xs">
{'caseNumber' in besitzer ? (
+117
View File
@@ -0,0 +1,117 @@
'use client'
import { useState, useTransition } from 'react'
import { exportText } from '@/lib/i18n/export'
import { commonText } from '@/lib/i18n/common'
import { approveExportAction, rejectExportAction } from './actions'
type Auftrag = {
id: string
kind: string
label: string
requestedBy: string
clearanceAtTime: number
createdAt: string
}
/**
* Offene Exportfreigaben.
*
* Vier-Augen-Prinzip: hier steht nur, was **jemand anderes** angefragt hat.
* Die eigene Anfrage taucht gar nicht erst auf, und der Dienst weist sie auch
* dann zurück, wenn jemand die Kennung von Hand einsetzt.
*/
export function Approvals({ jobs }: { jobs: Auftrag[] }) {
const [ablehnung, setAblehnung] = useState<string | null>(null)
const [grund, setGrund] = useState('')
const [fehler, setFehler] = useState<string | null>(null)
const [pending, startTransition] = useTransition()
if (jobs.length === 0) {
return <p className="text-text-dim">{exportText.approvalsEmpty}</p>
}
return (
<div>
<ul className="border-t border-line">
{jobs.map((auftrag) => (
<li key={auftrag.id} className="border-b border-line py-2">
<div className="flex flex-wrap items-baseline gap-x-4 gap-y-1 text-2xs">
<span className="font-condensed text-text-dim">
{exportText.kinds[auftrag.kind] ?? auftrag.kind}
</span>
<span className="font-mono">{auftrag.label}</span>
<span className="grow text-text-dim">
{exportText.requestedBy} {auftrag.requestedBy}
</span>
<button
type="button"
disabled={pending}
onClick={() =>
startTransition(async () => {
const ergebnis = await approveExportAction({ id: auftrag.id })
if (ergebnis.error) setFehler(ergebnis.error)
})
}
className="border border-line bg-raised px-2 py-0.5 font-condensed text-accent"
>
{exportText.approve}
</button>
<button
type="button"
onClick={() => setAblehnung(auftrag.id)}
className="font-condensed text-text-dim"
>
{exportText.reject}
</button>
</div>
{ablehnung === auftrag.id ? (
<div className="mt-2">
<textarea
value={grund}
onChange={(event) => setGrund(event.target.value)}
rows={2}
placeholder={exportText.rejectReason}
aria-label={exportText.rejectReason}
className="block w-full max-w-sm border border-line bg-raised px-3 py-2 text-2xs"
/>
<div className="mt-1 flex gap-3 text-2xs">
<button
type="button"
disabled={pending || grund.trim().length < 10}
onClick={() =>
startTransition(async () => {
const ergebnis = await rejectExportAction({
id: auftrag.id,
reason: grund,
})
if (ergebnis.error) setFehler(ergebnis.error)
else {
setAblehnung(null)
setGrund('')
}
})
}
className="font-condensed text-stamp-4 disabled:text-text-dim"
>
{exportText.reject}
</button>
<button
type="button"
onClick={() => setAblehnung(null)}
className="font-condensed text-text-dim"
>
{commonText.cancel}
</button>
</div>
</div>
) : null}
</li>
))}
</ul>
{fehler ? <p className="mt-2 font-condensed text-2xs text-stamp-4">{fehler}</p> : null}
</div>
)
}
+87
View File
@@ -0,0 +1,87 @@
'use server'
import { revalidatePath } from 'next/cache'
import { z } from 'zod'
import { requireUser } from '@/lib/auth/current'
import { AccessError } from '@/lib/errors'
import {
approveExport,
rejectExport,
requestExport,
runExport,
type ExportTarget,
} from '@/lib/export/service'
import { de } from '@/lib/i18n/de'
export type ExportState = { jobId?: string; status?: string; error?: string }
function toMessage(error: unknown): string {
if (error instanceof AccessError) {
return de.actionErrors[error.code] ?? de.actionErrors.default!
}
console.error('[export] unerwartet', error)
return de.actionErrors.default!
}
const requestSchema = z.union([
z.object({ kind: z.literal('CASE'), caseNumber: z.string().min(1) }),
z.object({ kind: z.literal('DOCUMENT'), documentNumber: z.string().min(1) }),
])
/**
* Export anfordern.
*
* Der Auftrag läuft im Hintergrund weiter, nachdem die Antwort raus ist — das
* Rendern dauert, und niemand soll auf einen Fortschrittsbalken starren, der
* auf Playwright wartet. Siehe docs/09-performance-und-ux.md.
*/
export async function requestExportAction(
_prev: ExportState | null,
formData: FormData,
): Promise<ExportState> {
const user = await requireUser()
const parsed = requestSchema.safeParse(Object.fromEntries(formData))
if (!parsed.success) return { error: de.actionErrors.default! }
try {
const auftrag = await requestExport(user.permissions, parsed.data as ExportTarget)
if (auftrag.status === 'QUEUED') void runExport(auftrag.jobId)
return { jobId: auftrag.jobId, status: auftrag.status }
} catch (error) {
return { error: toMessage(error) }
}
}
const idSchema = z.object({ id: z.string().min(1) })
export async function approveExportAction(input: unknown): Promise<ExportState> {
const user = await requireUser()
const parsed = idSchema.safeParse(input)
if (!parsed.success) return { error: de.actionErrors.default! }
try {
await approveExport(user.permissions, parsed.data.id)
// Erst nach der Freigabe wird gerendert.
void runExport(parsed.data.id)
revalidatePath('/uebersicht')
return { jobId: parsed.data.id, status: 'QUEUED' }
} catch (error) {
return { error: toMessage(error) }
}
}
const rejectSchema = idSchema.extend({ reason: z.string().min(10).max(500) })
export async function rejectExportAction(input: unknown): Promise<ExportState> {
const user = await requireUser()
const parsed = rejectSchema.safeParse(input)
if (!parsed.success) return { error: de.actionErrors['reason-required']! }
try {
await rejectExport(user.permissions, parsed.data.id, parsed.data.reason)
revalidatePath('/uebersicht')
return { jobId: parsed.data.id, status: 'REJECTED' }
} catch (error) {
return { error: toMessage(error) }
}
}
@@ -0,0 +1,55 @@
import type { Metadata } from 'next'
import Link from 'next/link'
import { notFound } from 'next/navigation'
import { requireUser } from '@/lib/auth/current'
import { loadVisibleCase } from '@/lib/cases/service'
import { APPROVAL_FROM_LEVEL } from '@/lib/export/service'
import { de } from '@/lib/i18n/de'
import { ExportPanel } from '@/components/export/ExportPanel'
export const metadata: Metadata = { title: de.export.heading }
export const dynamic = 'force-dynamic'
/**
* Eigene Seite statt eines Knopfes an der Akte.
*
* Die Fallakte ist die dichteste Seite der Anwendung und hat kein Bündel
* übrig; ein Verweis kostet nichts, eine weitere Insel schon. Siehe
* docs/13-entscheidungen.md.
*/
export default async function CaseExportPage({
params,
}: {
params: Promise<{ caseNumber: string }>
}) {
const user = await requireUser()
const { caseNumber } = await params
const akte = await loadVisibleCase(user.permissions, caseNumber)
if (!akte) notFound()
return (
<main className="mx-auto max-w-(--container-measure) px-6 py-10">
<p className="font-mono text-xs text-text-dim">{akte.caseNumber}</p>
<h1 className="mt-1 font-condensed">{de.export.heading}</h1>
<p className="mt-3 text-sm text-text-dim">{de.export.coverNote}</p>
<div className="mt-6">
<ExportPanel
target={{ kind: 'CASE', caseNumber: akte.caseNumber }}
topic={`user:${user.id}`}
/>
</div>
{akte.classification >= APPROVAL_FROM_LEVEL ? (
<p className="mt-4 text-2xs text-stamp-3">{de.export.waitingApprovalHint}</p>
) : null}
<nav className="mt-8 flex gap-4 font-condensed text-xs">
<Link href={`/faelle/${akte.caseNumber}`}>{akte.caseNumber}</Link>
<Link href={`/faelle/${akte.caseNumber}/druck`}>{de.export.print}</Link>
</nav>
</main>
)
}
@@ -423,6 +423,7 @@ export default async function CasePage({
<nav className="mt-12 flex gap-4 border-b border-line pb-2 font-condensed text-xs">
<span className="text-text-dim">{de.case.timeline}</span>
<Link href={`/faelle/${akte.caseNumber}/aenderungen`}>{de.case.changes}</Link>
<Link href={`/faelle/${akte.caseNumber}/export`}>{de.export.heading}</Link>
</nav>
<section className="mt-6">
+59
View File
@@ -4,6 +4,8 @@ import { requireUser } from '@/lib/auth/current'
import { de } from '@/lib/i18n/de'
import { PERMISSIONS } from '@/lib/auth/permissions'
import { StampMark } from '@/components/StampMark'
import { pendingApprovals } from '@/lib/export/service'
import { Approvals } from '../export/Approvals'
export const metadata: Metadata = { title: de.overview.heading }
export const dynamic = 'force-dynamic'
@@ -32,8 +34,22 @@ export default async function OverviewPage() {
const granted = [...user.permissions.permissions].sort()
// Offene Exportfreigaben stehen hier, weil die Leitung diese Seite ohnehin
// öffnet. Eine Anfrage, die niemand sieht, ist keine Freigabe.
const offen = await pendingApprovals(user.permissions)
const beschriftet = await beschrifte(offen)
return (
<main className="mx-auto max-w-(--container-measure) px-6 py-10">
{beschriftet.length > 0 ? (
<section className="mb-10 border border-stamp-3 p-4">
<h2 className="font-condensed text-stamp-3">{de.export.approvals}</h2>
<div className="mt-3">
<Approvals jobs={beschriftet} />
</div>
</section>
) : null}
<h1 className="font-condensed">{de.overview.heading}</h1>
<p className="mt-2 text-text-dim">{de.overview.intro}</p>
@@ -93,3 +109,46 @@ export default async function OverviewPage() {
</main>
)
}
/**
* Der Freigabeliste fehlen die Namen: der Auftrag kennt nur Kennungen. Sie
* werden hier nachgeschlagen, damit die Leitung sieht, worum es geht — mehr
* als Aktenzeichen und Anfragender steht dort bewusst nicht.
*/
async function beschrifte(
jobs: Awaited<ReturnType<typeof pendingApprovals>>,
): Promise<
{ id: string; kind: string; label: string; requestedBy: string; clearanceAtTime: number; createdAt: string }[]
> {
if (jobs.length === 0) return []
const [faelle, dokumente, nutzer] = await Promise.all([
db.case.findMany({
where: { id: { in: jobs.filter((j) => j.kind === 'CASE').map((j) => j.targetId ?? '') } },
select: { id: true, caseNumber: true },
}),
db.document.findMany({
where: { id: { in: jobs.filter((j) => j.kind === 'DOCUMENT').map((j) => j.targetId ?? '') } },
select: { id: true, documentNumber: true },
}),
db.user.findMany({
where: { id: { in: jobs.map((j) => j.requestedById) } },
select: { id: true, displayName: true },
}),
])
const nummer = new Map<string, string>([
...faelle.map((f) => [f.id, f.caseNumber] as const),
...dokumente.map((d) => [d.id, d.documentNumber] as const),
])
const name = new Map(nutzer.map((n) => [n.id, n.displayName]))
return jobs.map((job) => ({
id: job.id,
kind: job.kind,
label: nummer.get(job.targetId ?? '') ?? '—',
requestedBy: name.get(job.requestedById) ?? job.requestedById,
clearanceAtTime: job.clearanceAtTime,
createdAt: job.createdAt.toISOString(),
}))
}
+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>
)
}
+94
View File
@@ -0,0 +1,94 @@
import { NextResponse } from 'next/server'
import { db } from '@/lib/db'
import { getCurrentUser } from '@/lib/auth/current'
import { AccessError } from '@/lib/errors'
import { exportDatabase } from '@/lib/export/database'
import { createZip } from '@/lib/export/zip'
import { absolutePath } from '@/lib/files/paths'
import { readFile } from 'node:fs/promises'
import { writeAudit } from '@/lib/audit'
export const runtime = 'nodejs'
export const dynamic = 'force-dynamic'
/**
* Die beiden Wege für Administratoren aus docs/08-suche-und-export.md:
*
* GET /api/admin/export?kind=database vollständiger JSON-Abzug
* GET /api/admin/export?kind=bundle ZIP mit den fertigen Exporten
*
* Beide nur mit Recht `admin`, beide protokolliert. Der JSON-Abzug ist die
* einzige Stelle im System, an der die Klassifizierung nicht greift — deshalb
* liegt er hinter einem eigenen Endpunkt und nicht hinter einem Knopf an einer
* Akte.
*/
export async function GET(request: Request): Promise<Response> {
const user = await getCurrentUser()
// Kein 403: wer das Recht nicht hat, für den gibt es den Endpunkt nicht.
if (!user?.permissions.isAdmin) return new NextResponse(null, { status: 404 })
const kind = new URL(request.url).searchParams.get('kind')
try {
if (kind === 'database') {
const abzug = await exportDatabase(user.permissions)
return datei(abzug, 'application/json', `afis-abzug-${heute()}.json`)
}
if (kind === 'bundle') {
const fertige = await db.exportJob.findMany({
where: { status: 'READY', storageKey: { not: null } },
orderBy: { finishedAt: 'desc' },
take: 100,
select: { id: true, storageKey: true, kind: true },
})
const eintraege: { name: string; content: Uint8Array }[] = []
for (const auftrag of fertige) {
try {
eintraege.push({
name: `${auftrag.kind.toLowerCase()}-${auftrag.id}.pdf`,
content: new Uint8Array(await readFile(absolutePath(auftrag.storageKey!))),
})
} catch {
// Eine fehlende Datei hält den Sammelexport nicht auf.
}
}
await db.$transaction(async (tx) => {
await writeAudit(tx, {
actorId: user.id,
action: 'export.pdf',
targetType: 'ExportJob',
targetId: 'bundle',
clearanceAtTime: user.permissions.clearanceLevel,
meta: { files: eintraege.length },
})
})
return datei(createZip(eintraege), 'application/zip', `afis-sammelexport-${heute()}.zip`)
}
return new NextResponse(null, { status: 404 })
} catch (error) {
if (error instanceof AccessError) return new NextResponse(null, { status: 404 })
console.error('[export] Adminexport fehlgeschlagen', error)
return NextResponse.json({ error: 'unbekannt' }, { status: 500 })
}
}
function heute(): string {
return new Date().toISOString().slice(0, 10)
}
function datei(inhalt: Uint8Array, typ: string, name: string): Response {
return new NextResponse(inhalt as unknown as BodyInit, {
headers: {
'Content-Type': typ,
'Content-Length': String(inhalt.byteLength),
'X-Content-Type-Options': 'nosniff',
'Cache-Control': 'private, no-store',
'Content-Disposition': `attachment; filename="${name}"`,
},
})
}
+63
View File
@@ -0,0 +1,63 @@
import { createReadStream } from 'node:fs'
import { stat } from 'node:fs/promises'
import { Readable } from 'node:stream'
import { NextResponse } from 'next/server'
import { db } from '@/lib/db'
import { getCurrentUser } from '@/lib/auth/current'
import { recordRead } from '@/lib/audit'
import { absolutePath } from '@/lib/files/paths'
export const runtime = 'nodejs'
export const dynamic = 'force-dynamic'
/**
* Herunterladen eines fertigen Exports.
*
* Nur der Auftraggeber selbst. Ein Export ist auf **seine** Stufe gekürzt und
* trägt **seinen** Namen im Wasserzeichen — ihn an jemand anderen auszuliefern
* hiesse, ein Dokument mit fremdem Namen zu verteilen.
*/
export async function GET(
_request: Request,
context: { params: Promise<{ id: string }> },
): Promise<Response> {
const user = await getCurrentUser()
if (!user) return new NextResponse(null, { status: 404 })
const { id } = await context.params
const auftrag = await db.exportJob.findFirst({
where: { id, requestedById: user.id, status: 'READY' },
select: { id: true, kind: true, targetId: true, storageKey: true },
})
if (!auftrag?.storageKey) return new NextResponse(null, { status: 404 })
let groesse: number
try {
groesse = (await stat(absolutePath(auftrag.storageKey))).size
} catch {
return new NextResponse(null, { status: 404 })
}
// Jeder Abruf wird protokolliert, nicht nur die Erzeugung: ein PDF kann
// mehrfach heruntergeladen und weitergegeben werden.
recordRead({
actorId: user.id,
action: 'export.download',
targetType: 'ExportJob',
targetId: auftrag.id,
clearanceAtTime: user.permissions.clearanceLevel,
meta: { kind: auftrag.kind, targetId: auftrag.targetId ?? undefined },
})
const stream = Readable.toWeb(createReadStream(absolutePath(auftrag.storageKey))) as ReadableStream
return new NextResponse(stream, {
headers: {
'Content-Type': 'application/pdf',
'Content-Length': String(groesse),
'X-Content-Type-Options': 'nosniff',
'Cache-Control': 'private, no-store',
'Content-Security-Policy': "default-src 'none'; sandbox",
'Content-Disposition': `attachment; filename="afis-export-${auftrag.id}.pdf"`,
},
})
}
+121 -4
View File
@@ -399,10 +399,120 @@
overflow-x: auto;
}
}
/* ---------------------------------------------------------------------
Die Druckansicht einer Akte.
Schwarz auf weiss wie das Aktenblatt, aber im Aufbau eines Berichts:
Deckblatt, Kopfdaten, Abschnitte, Verlauf, Anhangsverzeichnis. Das
Wasserzeichen setzt der PDF-Dienst in Kopf- und Fusszeile jeder Seite.
Ein Export darf nie sauberer aussehen als die Akte ist: geänderte
Einträge sind gekennzeichnet, zurückgezogene stehen als Grabstein, und
gesperrte Felder erscheinen als Balken mit Vermerk statt zu fehlen.
Siehe docs/08-suche-und-export.md.
--------------------------------------------------------------------- */
.print-sheet {
max-width: 180mm;
margin: 0 auto;
padding: 12mm 0;
background: #fff;
color: #000;
font-size: 10pt;
line-height: 1.45;
}
.print-sheet h1 {
font-size: 18pt;
font-weight: 900;
margin: 0 0 2mm;
color: #000;
}
.print-sheet h2 {
font-size: 12pt;
font-weight: 900;
margin: 8mm 0 2mm;
padding-bottom: 1mm;
border-bottom: 1.5pt solid #000;
color: #000;
break-after: avoid;
}
.print-sheet h3 {
font-size: 10pt;
font-weight: 900;
margin: 4mm 0 1mm;
color: #000;
break-after: avoid;
}
.print-cover {
border: 3pt solid #000;
padding: 8mm;
margin-bottom: 8mm;
}
.print-stamp {
display: inline-block;
border: 2pt solid #000;
padding: 1mm 3mm;
font-weight: 900;
letter-spacing: 1pt;
text-transform: uppercase;
}
.print-meta {
width: 100%;
border-collapse: collapse;
margin-top: 3mm;
}
.print-meta th,
.print-meta td {
border: 0.75pt solid #000;
padding: 1.5mm 2mm;
text-align: left;
vertical-align: top;
font-size: 9pt;
}
.print-meta th {
width: 38mm;
font-weight: 900;
}
/* Ein Eintrag soll nicht über den Seitenrand zerrissen werden. */
.print-entry {
break-inside: avoid;
padding: 2mm 0;
border-bottom: 0.5pt dotted #666;
}
.print-label {
font-size: 8pt;
font-weight: 900;
text-transform: uppercase;
color: #000;
}
.print-note {
font-size: 8pt;
color: #444;
}
/* Die Schwärzung im Druck: ein voller Balken, kein Weglassen. */
.print-redacted {
display: inline-block;
min-width: 30mm;
background: #000;
color: #000;
user-select: none;
}
}
/* Drucken: nur das Blatt, ohne Rahmenwerk der Anwendung. Der PDF-Export mit
Wasserzeichen und Deckblatt kommt in Phase 8, siehe docs/08. */
/* Drucken: nur das Blatt, ohne Rahmenwerk der Anwendung. Kopf- und Fusszeile
mit dem Wasserzeichen setzt der PDF-Dienst, siehe docs/08. */
@media print {
.no-print {
display: none !important;
@@ -422,11 +532,18 @@
min-height: auto;
}
.sheet-classbar {
/* Sonst druckt der Balken weiss auf weiss. */
.sheet-classbar,
.print-redacted,
.print-stamp {
/* Sonst drucken die Flächen weiss auf weiss. */
print-color-adjust: exact;
-webkit-print-color-adjust: exact;
}
.print-sheet {
max-width: none;
padding: 0;
}
}
@media (prefers-reduced-motion: reduce) {