Eigene Vorlagen fuer Anschreiben

Wer zum dritten Mal denselben Brief tippt, tippt ihn beim vierten Mal falsch. Neu unter Einstellungen -> Schreibvorlagen: eigene Texte hinterlegen, beim freien Schreiben auswaehlen, Platzhalter fuellen sich aus den Daten, die ohnehin im System stehen. Aufbau: - Die Ersetzung als reine Funktionen in schreiben/platzhalter.ts. Drei Faelle, keiner davon still: Wert einsetzen, sichtbare Luecke [Aktenzeichen des Gerichts], unbekannter Platzhalter markiert. Ein Tippfehler in der Vorlage darf das Schreiben nicht verhindern - aber er muss ins Auge springen. - Die Bestellungsabsatz-Warnung ist zweistufig: Der erste Speicherversuch ohne ihn kommt mit einer Rueckfrage zurueck, erst die Bestaetigung speichert. Ohne den Nachweis der Vertretungsmacht kommt keine Auskunft, und das faellt erst nach vier Wochen auf. Ein ausformulierter Absatz zaehlt so viel wie der Platzhalter, ein halber Nachweis ("Beschluss der Eigentuemerversammlung") nicht. - Vier mitgelieferte Vorlagen bleiben Code und damit unveraenderlich; "Als Kopie uebernehmen" legt eine eigene Fassung an. Fuer Rueckkaufswert und Kuendigung fuehrt die Oberflaeche weiter zuerst zu den fallbezogenen Erzeugern - die rechnen Kuendigungstermine aus, was eine Vorlage nicht kann. - Vorlagen haengen an der betreuten Person, nicht am Benutzer: Sie beziehen sich auf ihren Fall, liegen im Papierkorb wie alles andere und sind im Vollexport ihrer Akte enthalten. Der Editor haelt Betreff und Text als eigenen State. Beim Wechsel der Vorlage ueberlebte der alte Entwurf die Navigation, die Vorlage kam nie im Textfeld an - ein key auf dem Editor setzt ihn neu auf. Gefunden hat das erst der End-to-End-Test. Geprueft: dreizehn Einheitstests fuer die Ersetzung, sechs End-to-End-Tests fuer Warnung, Kopie, Aufloesung und Papierkorb. Refs #7
2026-08-23 13:41:51 +02:00
parent 0a8878d8d2
commit f8d7752c27
21 changed files with 1443 additions and 13 deletions
@@ -0,0 +1,143 @@
+/**
+ * Platzhalter in Schreibvorlagen.
+ *
+ * Rein und ohne Datenbank. Der Vertrag ist einfach: {{name}} wird ersetzt,
+ * und zwar nach drei Regeln, die alle demselben Grundsatz folgen -
+ * NICHTS geht stillschweigend schief:
+ *
+ * 1. Bekannter Platzhalter, Daten vorhanden  -> Wert eingesetzt.
+ * 2. Bekannter Platzhalter, Daten fehlen     -> sichtbare Luecke
+ *    "[Aktenzeichen]". Eine stille Leerstelle wuerde erst der Empfaenger
+ *    bemerken - oder niemand.
+ * 3. Unbekannter Platzhalter                 -> markiert als
+ *    "[Unbekannter Platzhalter: {{xyz}}]". Kein Abbruch: Ein Tippfehler
+ *    in einer Vorlage darf das Schreiben nicht verhindern, aber er muss
+ *    ins Auge springen. Falsch ausgefuellt ist schlimmer als
+ *    offensichtlich leer.
+ */
+
+export type PlatzhalterName =
+  | 'betreute_name'
+  | 'betreute_geburtsdatum'
+  | 'betreute_anschrift'
+  | 'betreuer_name'
+  | 'betreuungsgericht'
+  | 'aktenzeichen_gericht'
+  | 'bestellung_datum'
+  | 'bestellungsabsatz'
+  | 'vertrag_gesellschaft'
+  | 'vertrag_nummer'
+  | 'vertrag_bezeichnung'
+  | 'stichtag'
+  | 'datum_heute'
+
+export type PlatzhalterBeschreibung = {
+  name: PlatzhalterName
+  beschriftung: string
+  /** Woher der Wert kommt - steht in der Hilfe neben dem Editor. */
+  quelle: string
+}
+
+/**
+ * Die verfuegbaren Platzhalter, in der Reihenfolge der Anzeige.
+ *
+ * Diese Liste steht beim Bearbeiten NEBEN dem Editor - niemand soll
+ * Platzhalternamen raten muessen.
+ */
+export const PLATZHALTER: readonly PlatzhalterBeschreibung[] = [
+  { name: 'betreute_name', beschriftung: 'Name der betreuten Person', quelle: 'Stammdaten' },
+  { name: 'betreute_geburtsdatum', beschriftung: 'Geburtsdatum', quelle: 'Stammdaten' },
+  { name: 'betreute_anschrift', beschriftung: 'Anschrift (Heim)', quelle: 'Stammdaten' },
+  { name: 'betreuer_name', beschriftung: 'Dein Name', quelle: 'Dein Zugang' },
+  { name: 'betreuungsgericht', beschriftung: 'Betreuungsgericht', quelle: 'Stammdaten' },
+  { name: 'aktenzeichen_gericht', beschriftung: 'Aktenzeichen des Gerichts', quelle: 'Stammdaten' },
+  { name: 'bestellung_datum', beschriftung: 'Datum der Bestellung', quelle: 'Stammdaten' },
+  {
+    name: 'bestellungsabsatz',
+    beschriftung: 'Der ganze Bestellungsabsatz',
+    quelle: 'Aus Gericht, Aktenzeichen und Bestellungsdatum gebaut',
+  },
+  { name: 'vertrag_gesellschaft', beschriftung: 'Gesellschaft', quelle: 'Vertrag, falls gewählt' },
+  { name: 'vertrag_nummer', beschriftung: 'Vertragsnummer', quelle: 'Vertrag, falls gewählt' },
+  { name: 'vertrag_bezeichnung', beschriftung: 'Vertragsbezeichnung', quelle: 'Vertrag, falls gewählt' },
+  { name: 'stichtag', beschriftung: 'Stichtag', quelle: 'Beim Erzeugen gewählt' },
+  { name: 'datum_heute', beschriftung: 'Heutiges Datum', quelle: 'Beim Erzeugen' },
+]
+
+const BEKANNT = new Set<string>(PLATZHALTER.map((p) => p.name))
+
+/** Die sichtbare Luecke, wenn Daten fehlen: "[Aktenzeichen des Gerichts]". */
+function luecke(name: PlatzhalterName): string {
+  const eintrag = PLATZHALTER.find((p) => p.name === name)
+  return `[${eintrag?.beschriftung ?? name}]`
+}
+
+export type PlatzhalterWerte = Partial<Record<PlatzhalterName, string | null>>
+
+export type ErsetzungsErgebnis = {
+  text: string
+  /** Bekannte Platzhalter ohne Daten - als Luecke eingesetzt. */
+  luecken: PlatzhalterName[]
+  /** Unbekannte Platzhalter - markiert im Text. */
+  unbekannte: string[]
+}
+
+/** Findet alle {{...}}-Vorkommen. Grosszuegig beim Namen: auch Tippfehler
+ *  sollen gefunden (und dann markiert) werden. */
+const MUSTER = /\{\{\s*([a-zA-Z0-9_äöüÄÖÜß-]+)\s*\}\}/g
+
+export function platzhalterErsetzen(
+  vorlage: string,
+  werte: PlatzhalterWerte,
+): ErsetzungsErgebnis {
+  const luecken = new Set<PlatzhalterName>()
+  const unbekannte = new Set<string>()
+
+  const text = vorlage.replace(MUSTER, (treffer, roh: string) => {
+    const name = roh.trim()
+
+    if (!BEKANNT.has(name)) {
+      unbekannte.add(name)
+      return `[Unbekannter Platzhalter: {{${name}}}]`
+    }
+
+    const wert = werte[name as PlatzhalterName]
+    if (wert === null || wert === undefined || wert.trim() === '') {
+      luecken.add(name as PlatzhalterName)
+      return luecke(name as PlatzhalterName)
+    }
+
+    return wert
+  })
+
+  return { text, luecken: [...luecken], unbekannte: [...unbekannte] }
+}
+
+/** Welche Platzhalter benutzt eine Vorlage? Fuer die Anzeige in der Liste. */
+export function benutztePlatzhalter(vorlage: string): string[] {
+  const gefunden = new Set<string>()
+  for (const treffer of vorlage.matchAll(MUSTER)) {
+    gefunden.add(treffer[1]!.trim())
+  }
+  return [...gefunden]
+}
+
+/**
+ * Fehlt der Bestellungsabsatz?
+ *
+ * Erfuellt ist die Pruefung durch den Platzhalter {{bestellungsabsatz}}
+ * ODER durch einen von Hand geschriebenen Absatz, der erkennbar die
+ * Bestellung nachweist (Beschluss + Betreuer im selben Text). Wer den
+ * Absatz ausformuliert hat, soll nicht gegaengelt werden.
+ *
+ * Die Warnung ist eine Warnung, kein Verbot: Ein Schreiben an die eigene
+ * Hausverwaltung braucht keinen Bestellungsnachweis. Aber wer ihn
+ * weglaesst, soll es wissentlich tun.
+ */
+export function bestellungsabsatzFehlt(vorlage: string): boolean {
+  if (/\{\{\s*bestellungsabsatz\s*\}\}/.test(vorlage)) return false
+  const klein = vorlage.toLowerCase()
+  const nennBestellung =
+    klein.includes('beschluss') && (klein.includes('betreuer') || klein.includes('betreuung'))
+  return !nennBestellung
+}