Phase 3 abgeschlossen: Vorlagen, Abschnitte, Schwärzung, Diff

Eine Vorlage ist eine geordnete Liste von Bausteinen: Eingabefelder und feste
Textbausteine mit Platzhaltern. Damit trägt dieselbe Struktur den
Vorfallsbericht und den Sonderarbeitsvertrag. Die Startvorlagen bilden jetzt
den echten Bericht der Abteilung ab, samt Berichtsart, Gefahreneinschätzung
und Foundation-Freigabe - letztere als gewöhnliches Feld ohne Wirkung auf den
Zugriff.

Abschnitte werden gerendert und bearbeitet, Entwürfe alle zwei Sekunden lokal
gesichert. Gespeichert wird auf Knopfdruck: ein Abschnitt ist der Sachstand
der Akte, kein Chatbeitrag. Die geladene Version geht mit; weicht sie ab, gibt
es kein stilles Überschreiben, sondern beide Fassungen nebeneinander mit
"Meine übernehmen" und "Fremde übernehmen".

Felder über der Stufe des Lesers werden serverseitig durch einen Platzhalter
ersetzt, Schwärzungen im Fliesstext kommen als Segmente. Beides so, dass der
echte Wert den Server nicht verlässt - nicht als Ausblenden im Client.

Der Wortdiff ist selbst geschrieben statt eingekauft: ein Dutzend Zeilen gegen
30 kB im Bündel für etwas, das nur serverseitig läuft.

Beim Bauen des Vorlagen-Editors riss das Bündel-Budget auf 127,9 kB, weil zod
über das Vorlagenmodul in den Client geriet. Typen und Validierung sind jetzt
getrennt: fields.ts ohne zod für Client und Server, schema.ts nur
serverseitig. Wieder bei 111,9 kB von 120.

85 Tests, 22 E2E.
This commit is contained in:
Harlekin
2026-09-02 12:52:53 +02:00
parent 30c3d28726
commit d2174f472b
18 changed files with 1498 additions and 93 deletions
+65
View File
@@ -0,0 +1,65 @@
/**
* Wortdiff für die Fassungsvergleiche an Abschnitten und Verlaufseinträgen.
*
* Bewusst ohne Paket: eine längste gemeinsame Teilfolge über Wörter ist ein
* Dutzend Zeilen, und die Alternative wären 30 kB im Bündel für etwas, das
* ausschliesslich serverseitig läuft. Siehe docs/09-performance-und-ux.md.
*/
export type DiffPart = { kind: 'gleich' | 'entfernt' | 'neu'; text: string }
function tokenize(text: string): string[] {
// Wörter samt folgendem Leerraum, damit sich der Text verlustfrei
// zusammensetzen lässt.
return text.match(/\S+\s*|\s+/g) ?? []
}
export function wordDiff(before: string, after: string): DiffPart[] {
const a = tokenize(before)
const b = tokenize(after)
// Längste gemeinsame Teilfolge, klassisch über eine Tabelle.
const lengths: number[][] = Array.from({ length: a.length + 1 }, () =>
new Array<number>(b.length + 1).fill(0),
)
for (let i = a.length - 1; i >= 0; i--) {
for (let j = b.length - 1; j >= 0; j--) {
lengths[i]![j] = a[i] === b[j] ? lengths[i + 1]![j + 1]! + 1 : Math.max(lengths[i + 1]![j]!, lengths[i]![j + 1]!)
}
}
const parts: DiffPart[] = []
const push = (kind: DiffPart['kind'], text: string) => {
const last = parts.at(-1)
if (last && last.kind === kind) last.text += text
else parts.push({ kind, text })
}
let i = 0
let j = 0
while (i < a.length && j < b.length) {
if (a[i] === b[j]) {
push('gleich', a[i]!)
i++
j++
} else if (lengths[i + 1]![j]! >= lengths[i]![j + 1]!) {
push('entfernt', a[i]!)
i++
} else {
push('neu', b[j]!)
j++
}
}
while (i < a.length) push('entfernt', a[i++]!)
while (j < b.length) push('neu', b[j++]!)
return parts
}
/** Grobe Kennzahl für das Protokoll, ohne den Text zu doppeln. */
export function diffSummary(before: string, after: string): { entfernt: number; neu: number } {
const parts = wordDiff(before, after)
return {
entfernt: parts.filter((p) => p.kind === 'entfernt').reduce((n, p) => n + p.text.length, 0),
neu: parts.filter((p) => p.kind === 'neu').reduce((n, p) => n + p.text.length, 0),
}
}