Harlekin
d2174f472b
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.
74 lines
2.2 KiB
TypeScript
74 lines
2.2 KiB
TypeScript
import { z } from 'zod'
|
|
import { INPUT_TYPES, STATIC_TYPES, type TemplateField } from '@/lib/templates/fields'
|
|
|
|
/**
|
|
* Verbindliche Prüfung einer Vorlage. Läuft ausschliesslich serverseitig:
|
|
* eine Server Action ist ein Endpunkt, und was hier durchgeht, geht auch durch,
|
|
* wenn jemand den Editor umgeht.
|
|
*/
|
|
const key = z
|
|
.string()
|
|
.min(1)
|
|
.max(64)
|
|
// Der Schlüssel ist stabil und wird nie geändert: ein Abschnitt findet über
|
|
// ihn seinen Baustein wieder, auch über Vorlagenversionen hinweg.
|
|
.regex(/^[a-z][a-z0-9_]*$/, 'Kleinbuchstaben, Ziffern und Unterstrich')
|
|
|
|
const gemeinsam = {
|
|
key,
|
|
label: z.string().min(1).max(200),
|
|
help: z.string().max(500).optional(),
|
|
/** Feld erst ab dieser Stufe sichtbar, siehe docs/05-akten-und-vorlagen.md. */
|
|
minClearance: z.number().int().min(0).max(5).optional(),
|
|
}
|
|
|
|
const inputField = z.object({
|
|
...gemeinsam,
|
|
type: z.enum(INPUT_TYPES),
|
|
required: z.boolean().optional(),
|
|
requiredToClose: z.boolean().optional(),
|
|
options: z.array(z.string().min(1)).optional(),
|
|
columns: z.array(z.string().min(1)).optional(),
|
|
})
|
|
|
|
const staticBlock = z.object({
|
|
...gemeinsam,
|
|
type: z.enum(STATIC_TYPES),
|
|
text: z.string().max(20_000).optional(),
|
|
})
|
|
|
|
export const templateFieldSchema = z.union([inputField, staticBlock])
|
|
|
|
export const templateFieldsSchema = z
|
|
.array(templateFieldSchema)
|
|
.max(200)
|
|
.superRefine((fields, ctx) => {
|
|
const seen = new Set<string>()
|
|
for (const [index, field] of fields.entries()) {
|
|
if (seen.has(field.key)) {
|
|
ctx.addIssue({
|
|
code: 'custom',
|
|
path: [index, 'key'],
|
|
message: `Schlüssel doppelt vergeben: ${field.key}`,
|
|
})
|
|
}
|
|
seen.add(field.key)
|
|
|
|
if (
|
|
(field.type === 'select' || field.type === 'multiselect') &&
|
|
(!('options' in field) || !field.options?.length)
|
|
) {
|
|
ctx.addIssue({
|
|
code: 'custom',
|
|
path: [index, 'options'],
|
|
message: 'Auswahlfelder brauchen mindestens eine Option',
|
|
})
|
|
}
|
|
}
|
|
})
|
|
|
|
export function parseTemplateFields(raw: unknown): TemplateField[] {
|
|
const parsed = templateFieldsSchema.safeParse(raw)
|
|
return parsed.success ? (parsed.data as TemplateField[]) : []
|
|
}
|