Ansprechpartner am Vorgang hinterlegen

Ein namentlich adressiertes Schreiben landet bei der Person, die den
Vorgang kennt, statt in der Poststelle. Am Vorgang laesst sich jetzt ein
Kontakt aus dem Verzeichnis als Ansprechpartner benennen; die
Sachstandsanfrage redet ihn an, und sein Name steht ueber der Behoerde.

Die Sachstandsanfrage konnte das schon - sie bekam den Namen nur nie
uebergeben. entwurf.ts lud einen der verknuepften Kontakte und verwarf
ihn wieder. Wer angeredet wird, ist jetzt eine Entscheidung und kein
Zufall.

Aufbau:
- Migration: ansprechpartnerId am Vorgang (SetNull - ein Vorgang darf
  nicht daran haengen, dass es den Kontakt noch gibt) und anrede am
  Kontakt.
- Die Anrede als reine Funktion in kontakte/anrede.ts. Geraten wird nie:
  ohne hinterlegte Anrede wird mit vollem Namen angeredet. Ein leerer
  Name mit gesetzter Anrede faellt auf die allgemeine Anrede zurueck -
  "Sehr geehrte Frau ," darf nie herausgehen.
- Der Wechsel des Ansprechpartners steht mit NAMEN im Protokoll. Zwei
  cuids nebeneinander waeren protokolliert, aber nicht nachvollziehbar,
  und nachvollziehbar war die Anforderung.
- Der Ansprechpartner wird gegen die Akte geprueft, bevor er gespeichert
  wird - sein Name steht anschliessend im Briefkopf.

Nebenbei behoben: Der Schreiben-Editor verwarf die empfaengerAnschrift
aus dem Entwurf, sein State startete immer leer. Jetzt kommt die
Anschrift des Ansprechpartners im Formular an.

Geprueft: neun Einheitstests fuer die Anrede, fuenf End-to-End-Tests von
der Auswahl bis zum Protokolleintrag.

Refs #9

src/lib/kontakte/anrede.ts

@@ -0,0 +1,61 @@
+import type { KontaktAnrede } from '@prisma/client'
+
+/**
+ * Die Briefanrede eines Ansprechpartners.
+ *
+ * Ein namentlich adressiertes Schreiben landet bei der Person, die den
+ * Vorgang kennt, statt in der Poststelle. Beim Bezirk Oberfranken ist das
+ * der Unterschied zwischen zwei Wochen und zwei Monaten.
+ *
+ * Zwei Regeln, die hier nicht verhandelbar sind:
+ *
+ * 1. Es wird nie geraten. Ohne hinterlegte Anrede wird mit dem vollen
+ *    Namen angeredet ("Sehr geehrte(r) Anna Schmitt,"). Eine falsch
+ *    geratene Anrede faellt dem Empfaenger sofort auf und kostet genau
+ *    die Aufmerksamkeit, die man gewinnen wollte.
+ * 2. Ohne Ansprechpartner bleibt es bei "Sehr geehrte Damen und Herren,".
+ *    Ein halb gefuellter Name darf nie zu "Sehr geehrte Frau ," werden -
+ *    lieber unpersoenlich als offensichtlich automatisch.
+ */
+
+export const ANREDE_BESCHRIFTUNG: Record<KontaktAnrede, string> = {
+  OHNE: 'keine Angabe',
+  FRAU: 'Frau',
+  HERR: 'Herr',
+}
+
+export const ALLGEMEINE_ANREDE = 'Sehr geehrte Damen und Herren,'
+
+/**
+ * Der Nachname aus einem vollen Namen.
+ *
+ * Titel und Vornamen fallen weg: "Dr. Anna Schmitt" wird zu "Schmitt".
+ * Doppelnamen mit Bindestrich bleiben ganz, weil sie ein Wort sind.
+ */
+export function nachnameAus(name: string): string {
+  const teile = name.trim().split(/\s+/).filter(Boolean)
+  return teile.length > 0 ? teile[teile.length - 1]! : ''
+}
+
+export type Ansprechpartner = {
+  name: string
+  anrede: KontaktAnrede
+}
+
+/**
+ * Die Anredezeile fuer ein Schreiben, einschliesslich Komma.
+ *
+ * Ohne Ansprechpartner - oder mit einem, dessen Name leer ist - die
+ * allgemeine Anrede.
+ */
+export function anredeZeile(ansprechpartner: Ansprechpartner | null): string {
+  if (!ansprechpartner) return ALLGEMEINE_ANREDE
+
+  const name = ansprechpartner.name.trim()
+  if (!name) return ALLGEMEINE_ANREDE
+
+  if (ansprechpartner.anrede === 'FRAU') return `Sehr geehrte Frau ${nachnameAus(name)},`
+  if (ansprechpartner.anrede === 'HERR') return `Sehr geehrter Herr ${nachnameAus(name)},`
+
+  return `Sehr geehrte(r) ${name},`
+}

src/lib/schreiben/entwurf.ts

@@ -201,8 +201,19 @@ export async function entwurfBauen(eingabe: EntwurfEingabe): Promise<SchreibenEn
 
     const vorgang = await db.vorgang.findFirst({
       where: { id: eingabe.vorgangId, betreuteId: eingabe.betreuteId, ...nichtGeloescht },
+      // Der benannte Ansprechpartner, nicht irgendeiner der verknuepften
+      // Kontakte: Wer angeredet wird, ist eine Entscheidung und kein Zufall.
       include: {
-        kontakte: { select: { name: true, organisation: true }, take: 1 },
+        ansprechpartner: {
+          select: {
+            name: true,
+            anrede: true,
+            organisation: true,
+            strasse: true,
+            plz: true,
+            ort: true,
+          },
+        },
       },
     })
     if (!vorgang) throw new Error('Diesen Vorgang gibt es nicht (mehr).')
@@ -222,15 +233,31 @@ export async function entwurfBauen(eingabe: EntwurfEingabe): Promise<SchreibenEn
         aktenzeichenGericht: betreute.aktenzeichenGericht,
         betreuungsgericht: betreute.betreuungsgericht,
       },
+      ansprechpartner: vorgang.ansprechpartner,
       heute,
     })
 
+    // Ist ein Ansprechpartner benannt, kommt seine Anschrift gleich mit -
+    // sie steht im Kontaktverzeichnis und muesste sonst abgetippt werden.
+    const anschrift = vorgang.ansprechpartner
+      ? [
+          vorgang.ansprechpartner.strasse,
+          [vorgang.ansprechpartner.plz, vorgang.ansprechpartner.ort]
+            .filter(Boolean)
+            .join(' ')
+            .trim() || null,
+        ]
+          .filter(Boolean)
+          .join('\n')
+      : ''
+
     return {
       ...gemeinsam,
       text: anfrage.text,
       betreff: anfrage.betreff,
-      empfaengerName: vorgang.gegenstelle ?? '',
-      empfaengerAnschrift: '',
+      empfaengerName:
+        vorgang.ansprechpartner?.name ?? vorgang.gegenstelle ?? '',
+      empfaengerAnschrift: anschrift,
     }
   }
 

src/lib/validierung/kontakte.ts

@@ -1,5 +1,5 @@
 import { z } from 'zod'
-import type { KontaktArt, KontaktRolle } from '@prisma/client'
+import type { KontaktAnrede, KontaktArt, KontaktRolle } from '@prisma/client'
 
 /**
  * Eingabepruefung fuer Kontakte und Kontaktprotokolle.
@@ -101,6 +101,13 @@ export const KONTAKT_ROLLEN = [
   'SONSTIGES',
 ] as const satisfies readonly KontaktRolle[]
 
+/** Anreden fuer die Briefanrede - Reihenfolge der Auswahlliste. */
+export const KONTAKT_ANREDEN = [
+  'OHNE',
+  'FRAU',
+  'HERR',
+] as const satisfies readonly KontaktAnrede[]
+
 export const KONTAKT_ROLLE_BESCHRIFTUNG: Record<KontaktRolle, string> = {
   RECHTSPFLEGER: 'Rechtspfleger',
   RICHTER: 'Richter',
@@ -177,6 +184,7 @@ export const KontaktSchema = z.object({
   rolle: z.enum(KONTAKT_ROLLEN, {
     errorMap: () => ({ message: 'Bitte eine Rolle aus der Liste wählen.' }),
   }),
+  anrede: z.enum(KONTAKT_ANREDEN).default('OHNE'),
   telefon: optionalerText(50),
   mobil: optionalerText(50),
   fax: optionalerText(50),
@@ -198,6 +206,7 @@ export function kontaktFormularLesen(formular: FormData): Record<string, unknown
   for (const feld of [
     'name',
     'organisation',
+    'anrede',
     'rolle',
     'telefon',
     'mobil',

src/lib/validierung/vorgaenge.ts

@@ -19,6 +19,14 @@ const optionalerText = (max = 200) =>
     .transform((wert) => (wert === '' ? null : wert))
     .nullable()
 
+/** Ein Verweis auf einen anderen Datensatz - leer heisst "keiner". */
+const optionaleId = z
+  .string()
+  .trim()
+  .transform((wert) => (wert === '' ? null : wert))
+  .nullable()
+  .default(null)
+
 const optionalesDatum = z
   .string()
   .trim()
@@ -90,6 +98,7 @@ export const VorgangSchema = z.object({
   beschreibung: optionalerText(4000),
   gegenstelle: optionalerText(150),
   aktenzeichen: optionalerText(80),
+  ansprechpartnerId: optionaleId,
   verantwortlich: optionalerText(120),
   naechsterSchritt: optionalerText(300),
   faelligAm: optionalesDatum,

src/lib/version.ts

@@ -17,7 +17,7 @@
  */
 
 /** Muss zur "version" in der package.json passen. */
-export const VERSION = '1.8.0'
+export const VERSION = '1.9.0'
 
 /**
  * Kurzer Git-Stand, beim Bauen hineingereicht:

src/lib/vorgaenge/sachstandsanfrage.ts

@@ -1,4 +1,5 @@
 import { differenceInCalendarDays } from 'date-fns'
+import { anredeZeile, type Ansprechpartner } from '@/lib/kontakte/anrede'
 import { formatDatum } from '@/lib/utils'
 
 /**
@@ -36,8 +37,12 @@ export type SachstandsanfrageEingabe = {
     aktenzeichenGericht?: string | null
     betreuungsgericht?: string | null
   }
-  /** Ansprechpartner bei der Gegenstelle, wenn bekannt. */
-  ansprechpartner?: string | null
+  /**
+   * Ansprechpartner bei der Gegenstelle, wenn am Vorgang benannt.
+   * Bestimmt die Anrede - ohne ihn bleibt es bei "Sehr geehrte Damen
+   * und Herren".
+   */
+  ansprechpartner?: Ansprechpartner | null
   /** Für den Test überschreibbar. */
   heute?: Date
 }
@@ -69,13 +74,15 @@ export function sachstandsanfrageErzeugen(
       .filter(Boolean)
       .join(' · ')
 
-  const anrede = eingabe.ansprechpartner
-    ? `Sehr geehrte(r) ${eingabe.ansprechpartner},`
-    : 'Sehr geehrte Damen und Herren,'
+  const anrede = anredeZeile(eingabe.ansprechpartner ?? null)
 
   const zeilen: string[] = []
 
-  if (eingabe.gegenstelle) zeilen.push(eingabe.gegenstelle, '')
+  // Der Name steht ueber der Stelle, nicht darunter: So sortiert die
+  // Poststelle den Brief zur Person und nicht ins allgemeine Fach.
+  if (eingabe.ansprechpartner?.name.trim()) zeilen.push(eingabe.ansprechpartner.name.trim())
+  if (eingabe.gegenstelle) zeilen.push(eingabe.gegenstelle)
+  if (eingabe.ansprechpartner?.name.trim() || eingabe.gegenstelle) zeilen.push('')
   zeilen.push(formatDatum(heute), '')
   zeilen.push(`Betreff: ${betreff}`, '')
   zeilen.push(anrede, '')