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(),
}))
}