Files
Laufzettel/src/components/archiv/archiv-treffer.tsx
T
Florian WildeandClaude Opus 5 f3950847f3
Prüfung / pruefung (push) Waiting to run
Prüfung / e2e (push) Blocked by required conditions
feat(laeufe): Uebergabeprotokoll als PDF (#041)
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>
2026-10-25 11:14:25 +01:00

164 lines
6.0 KiB
TypeScript

import Link from "next/link";
import { Archive, CalendarDays, CheckCircle2, FileDown } from "lucide-react";
import type { LaufStatus } from "@/generated/prisma/enums";
import type { ArchivZeile, TrefferFeld } from "@/server/queries/archiv";
/**
* Eine Zeile der Trefferliste (#015).
*
* Sie zeigt **warum** sie da ist: bei jeder Fundstelle steht, in welchem Feld
* der Begriff steht, und der Ausschnitt zeigt ihn im Satz. Ein Treffer ohne
* sichtbaren Grund laesst den Suchenden jeden Lauf einzeln aufklappen.
*
* Karte statt Tabellenzeile: ein Treffer bringt bis zu vier Ausschnitte mit, die
* am Handy umbrechen muessen — in einer Tabelle waere davon nichts lesbar.
*/
const STATUS_TEXT: Readonly<Record<LaufStatus, string>> = {
OFFEN: "offen",
IN_ARBEIT: "in Arbeit",
ABGESCHLOSSEN: "abgeschlossen",
ARCHIVIERT: "archiviert",
};
const FELD_TEXT: Readonly<Record<TrefferFeld, string>> = {
TITEL: "Titel",
NOTIZ: "Notiz",
WERT: "Wert",
KOMMENTAR: "Kommentar",
};
const PILLE = "rounded-pille bg-flaeche-hoch px-2.5 py-1 text-xs text-nebentext";
const DATUM = new Intl.DateTimeFormat("de-DE", { day: "2-digit", month: "2-digit", year: "numeric" });
/**
* Hebt den Suchbegriff im Ausschnitt hervor.
*
* Verglichen wird ueber `indexOf` und nicht ueber einen regulaeren Ausdruck: der
* Begriff kommt aus der Adresszeile, und `.` oder `(` waeren dort sonst
* Sonderzeichen. Ohne Begriff — die Liste zeigt dann ohnehin keine Fundstellen —
* bleibt der Text unveraendert.
*/
function Hervorgehoben({ text, begriff }: { text: string; begriff: string }) {
if (!begriff) return <>{text}</>;
const teile: React.ReactNode[] = [];
const klein = text.toLowerCase();
const gesucht = begriff.toLowerCase();
let stelle = 0;
for (let fund = klein.indexOf(gesucht); fund !== -1; fund = klein.indexOf(gesucht, stelle)) {
if (fund > stelle) teile.push(text.slice(stelle, fund));
teile.push(
<mark key={fund} className="bg-akzent-flaeche text-akzent">
{text.slice(fund, fund + begriff.length)}
</mark>,
);
stelle = fund + begriff.length;
}
if (stelle < text.length) teile.push(text.slice(stelle));
return <>{teile}</>;
}
export function ArchivTreffer({
zeile,
begriff,
kundenEbene,
mitPdf,
}: {
zeile: ArchivZeile;
begriff: string;
kundenEbene: boolean;
mitPdf: boolean;
}) {
const angaben = [
`${zeile.vorlagenName} v${zeile.version}`,
zeile.geraetName,
zeile.mitarbeiterName,
zeile.abteilungName,
zeile.ticket,
zeile.abgeschlossenVon ? `abgeschlossen von ${zeile.abgeschlossenVon}` : null,
zeile.abgeschlossenVon === null && zeile.zugewiesenAn ? `zugewiesen an ${zeile.zugewiesenAn}` : null,
].filter((angabe): angabe is string => Boolean(angabe));
return (
<li className="rounded-karte border border-linie bg-flaeche">
<div className="p-4">
<div className="flex flex-wrap items-center gap-2">
{zeile.archiviertAm ? (
<Archive className="size-[18px] shrink-0 text-nebentext" strokeWidth={1.75} aria-hidden="true" />
) : (
<CheckCircle2
className="size-[18px] shrink-0 text-erledigt"
strokeWidth={1.75}
aria-hidden="true"
/>
)}
<Link
href={`/laeufe/${zeile.id}`}
className="font-medium break-words underline-offset-4 hover:underline"
>
<Hervorgehoben text={zeile.titel} begriff={begriff} />
</Link>
<span className={PILLE}>{STATUS_TEXT[zeile.status]}</span>
{kundenEbene ? <span className={PILLE}>{zeile.kundeName}</span> : null}
<span className={`${PILLE} flex items-center gap-1`}>
<CalendarDays className="size-3" strokeWidth={2} aria-hidden="true" />
{DATUM.format(zeile.abgelegtAm)}
</span>
</div>
<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) => (
<li
// Zwei Fundstellen koennen im selben Feld liegen und denselben
// Ausschnitt tragen; die Position ist hier der einzige
// verlaessliche Schluessel.
key={`${stelle.feld}-${nummer}`}
className="flex flex-col gap-1 border-l-2 border-linie pl-3 sm:flex-row sm:items-baseline sm:gap-2"
>
<span className={`${PILLE} w-fit shrink-0`}>{FELD_TEXT[stelle.feld]}</span>
<span className="min-w-0 text-sm break-words text-nebentext">
<Hervorgehoben text={stelle.ausschnitt} begriff={begriff} />
</span>
</li>
))}
</ul>
) : null}
{zeile.weitereFundstellen > 0 ? (
<p className="mt-2 pl-3 text-xs text-nebentext">
{zeile.weitereFundstellen === 1
? "eine weitere Fundstelle in diesem Lauf"
: `${zeile.weitereFundstellen} weitere Fundstellen in diesem Lauf`}
</p>
) : null}
</div>
</li>
);
}