feat(laeufe): Uebergabeprotokoll als PDF (#041)
Prüfung / pruefung (push) Waiting to run
Prüfung / e2e (push) Blocked by required conditions

Neben "Drucken" steht am Lauf "Als PDF", im Archiv an jedem Treffer "Protokoll
als PDF" — dasselbe Blatt als fertige Datei, zum Verschicken oder Abheften.
Unten darauf jetzt zwei Unterschriftsfelder mit Zeile fuer Ort, Datum und Namen;
wo eine Vier-Augen-Freigabe erteilt wurde, steht sie mit im Kopf.

Erzeugt wird es, indem der Server seine eigene Druckansicht ueber 127.0.0.1
laedt und druckt — mit dem Sitzungscookie des Anfragenden. Damit gibt es genau
eine Vorlage fuer Papier und Datei, und fuer das PDF gilt dieselbe Rechte- und
Mandantenpruefung wie fuer die Seite. Ein zweites Layout waere billiger und
wuerde frueher oder spaeter abweichen, ohne dass es jemandem auffaellt.

Ein eigener Browser-Kontext je PDF, kein geteilter: er traegt die fremde
Sitzung, und ein geteilter gaebe sie an das naechste PDF weiter. Gespeichert
wird nichts — ein abgelegtes PDF waere eine zweite Wahrheit neben dem Lauf.
Ein erzeugtes Passwort steht auch hier nie darauf, geprueft am extrahierten
Text des fertigen PDF und nicht an den Bytes: der Inhalt ist komprimiert, dort
nichts zu finden bewiese nichts.

Chromium bleibt optional, und die gemessene Zahl ist der Grund: das
Laufzeitbild waechst von 370 MB auf 1,52 GB, Alpines chromium kostet allein
1,13 GB. Er kommt nur mit `--build-arg MIT_PDF=1` beziehungsweise
`deploy/install.sh --mit-pdf` mit. Fehlt er, erscheint der Knopf gar nicht
erst — ein Knopf, der zuverlaessig in eine Fehlermeldung fuehrt, ist schlimmer
als keiner. Ein direkter Aufruf bekommt 503 mit einer Meldung, die sagt, was
fehlt und wo es steht; ein leeres PDF gibt es in keinem Fall.

Meine Schaetzung lag um das Dreieinhalbfache daneben: "+328 MB" war das
.apk-Paket, nicht das Bild, und stand schon im Dockerfile-Kommentar, bevor ich
gebaut hatte. Jetzt steht die gemessene Zahl an drei Stellen.

1545 Vitest-Tests (vorher 1526): 15 in tests/pdf.test.ts, die den Handler echt
fahren, 3 in tests/pdf-grenze.test.ts fuer die Obergrenze mit gestelltem
Browser, einer in tests/archiv.test.ts. Dazu drei E2E-Ablaeufe; volle Suite
gruen mit 118 bestanden. Ein Blatt wurde wirklich erzeugt und angesehen.

Sechs Gegenproben, alle angeschlagen — darunter ein echtes Passwort auf dem
Blatt und die Freigabe des Zaehlers aus dem finally genommen, der Fall, in dem
ein Fehlschlag die PDF-Erzeugung bis zum Neustart leise stilllegt.

Closes #41

Co-Authored-By: Claude Opus 5 (1M context) <noreply@anthropic.com>
This commit is contained in:
Florian Wilde
2026-10-25 11:14:25 +01:00
co-authored by Claude Opus 5
parent d30bb6d235
commit f3950847f3
25 changed files with 1577 additions and 31 deletions
+22 -1
View File
@@ -1,5 +1,5 @@
import Link from "next/link";
import { Archive, CalendarDays, CheckCircle2 } from "lucide-react";
import { Archive, CalendarDays, CheckCircle2, FileDown } from "lucide-react";
import type { LaufStatus } from "@/generated/prisma/enums";
import type { ArchivZeile, TrefferFeld } from "@/server/queries/archiv";
@@ -66,10 +66,12 @@ export function ArchivTreffer({
zeile,
begriff,
kundenEbene,
mitPdf,
}: {
zeile: ArchivZeile;
begriff: string;
kundenEbene: boolean;
mitPdf: boolean;
}) {
const angaben = [
`${zeile.vorlagenName} v${zeile.version}`,
@@ -110,6 +112,25 @@ export function ArchivTreffer({
<p className="mt-2 text-xs break-words text-nebentext">{angaben.join(" · ")}</p>
{/*
* **Das Blatt direkt aus der Liste**, ohne Umweg ueber den Lauf: wer im
* Archiv sucht, sucht meist genau dieses eine Protokoll — fuer die
* Ablage, fuer den Kunden, fuer die Pruefung. Ein `a` und kein `Link`,
* weil es ein PDF ist und kein Navigationsziel; sonst erzeugte Next
* beim Vorabladen eines je Zeile (#041).
*/}
{mitPdf ? (
<a
href={`/api/laeufe/${zeile.id}/protokoll.pdf`}
target="_blank"
rel="noopener"
className="mt-3 inline-flex min-h-9 items-center gap-1.5 rounded-pille border border-linie px-3 text-xs text-nebentext hover:bg-flaeche-hoch hover:text-text"
>
<FileDown className="size-3.5" strokeWidth={1.75} aria-hidden="true" />
Protokoll als PDF
</a>
) : null}
{zeile.fundstellen.length > 0 ? (
<ul className="mt-3 flex flex-col gap-2">
{zeile.fundstellen.map((stelle, nummer) => (