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.

web/app/(app)/admin/system/page.tsx

@@ -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>
   )
 }

web/app/(app)/dokumente/[documentNumber]/export/page.tsx

@@ -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>
+  )
+}

web/app/(app)/dokumente/[documentNumber]/page.tsx

@@ -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 ? (

web/app/(app)/export/Approvals.tsx

@@ -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>
+  )
+}

web/app/(app)/export/actions.ts

@@ -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) }
+  }
+}

web/app/(app)/faelle/[caseNumber]/export/page.tsx

@@ -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>
+  )
+}

web/app/(app)/faelle/[caseNumber]/page.tsx

@@ -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">

web/app/(app)/uebersicht/page.tsx

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