feat: Stammdaten, Ersteinrichtung, Zweitfaktor und Protokollansicht

Damit ist Etappe 1 fachlich vollstaendig.

Ersteinrichtung in drei Schritten, bewusst ausserhalb des
Anwendungsrahmens: der setzt Benutzer, zweiten Faktor UND eine betreute
Person voraus - beim allerersten Start gibt es nichts davon. Die Aktion
fuer den ersten Zugang sperrt sich selbst, sobald ein Benutzer existiert.

Zweiter Faktor: Das Geheimnis wird zuerst nur abgelegt, ohne
totpAktiviertAm. Erst ein echter Code aus der App schaltet ihn scharf.
Wer sich beim Abtippen vertut oder die falsche App nimmt, wuerde sich
sonst dauerhaft aussperren. Erst danach gibt es die
Wiederherstellungscodes - einmal angezeigt, danach nur noch als Hash.

Betreuungsjahr (src/lib/stammdaten/betreuungsjahr.ts): laeuft ab dem Tag
der Bestellung, nicht ab dem Kalenderjahr. Schrittweise vorwaerts
gerechnet statt ueber eine Differenz, damit Schaltjahre und der
29. Februar von selbst stimmen. Daran haengen Jahresbericht,
Rechnungslegung und die Ausschlussfrist der Aufwandspauschale.

Aendert sich das Bestellungsdatum, werden die Pflichtfristen neu
abgeleitet - ueber einen dynamischen Import, damit die Stammdaten auch
dann speicherbar bleiben, wenn das Fristenmodul fehlt.

Protokollansicht zeigt je Eintrag die geaenderten Felder als alt -> neu.
Die Aenderungen liegen verschluesselt, weil dort Diagnosen und
Kontostaende stehen koennen.

Seed legt bewusst keine echten Personendaten an, nur den ersten Zugang.
Mit SEED_DEMO=true kommt ein vollstaendiger Beispielfall dazu - Erika
Musterfrau, COPD GOLD III, Pflegegrad 3, Heimeinzug Januar 2026,
leerstehendes Haus, zwei Versicherungen, laufender Antrag beim Bezirk
mit acht Nachforderungen. Nur ausserhalb der Produktion.

Docker Compose ohne Reverse Proxy - der ist auf dem Zielserver
vorhanden. Die Datenbank hat keine Portfreigabe und ist nur ueber das
interne Netz erreichbar; die Anwendung horcht auf 127.0.0.1.

Etappe: 1
Phase: Fundament

src/lib/stammdaten/betreuungsjahr.ts

@@ -0,0 +1,100 @@
+import { addDays, addMonths, addYears, isAfter, isBefore } from 'date-fns'
+
+/**
+ * Das Betreuungsjahr.
+ *
+ * Es laeuft ab dem Tag der Bestellung, nicht ab dem 1. Januar. Wer am
+ * 14. Februar 2026 bestellt wurde, hat sein erstes Betreuungsjahr bis zum
+ * 13. Februar 2027. Daran haengen:
+ *
+ * - der Jahresbericht nach § 1863 Abs. 3 BGB, faellig zum Ende des Jahres,
+ * - die Vermoegensuebersicht bzw. Rechnungslegung (§§ 1859, 1865 BGB),
+ * - die Aufwandspauschale nach § 1878 BGB, die binnen sechs Monaten nach
+ *   Ablauf des Betreuungsjahres geltend gemacht werden muss. Diese Frist
+ *   ist eine Ausschlussfrist: laeuft sie ab, ist der Anspruch weg. Kein
+ *   Nachsehen, keine Wiedereinsetzung.
+ *
+ * Diese Datei ist bewusst frei von Datenbankzugriffen, damit sie sich
+ * ohne Aufwand testen laesst.
+ */
+
+export type Betreuungsjahr = {
+  /** Laufende Nummer, beginnend bei 1. */
+  nummer: number
+  beginn: Date
+  /** Letzter Tag des Jahres (Beginn + 1 Jahr - 1 Tag). */
+  ende: Date
+  /** Letzter Tag, an dem die Aufwandspauschale beantragt werden kann. */
+  pauschaleBis: Date
+}
+
+/**
+ * Liefert das Betreuungsjahr, in dem ein Stichtag liegt - standardmaessig
+ * heute. Gibt null zurueck, wenn kein Bestellungsdatum vorliegt oder der
+ * Stichtag davor liegt.
+ */
+export function betreuungsjahr(
+  bestellungAm: Date | null | undefined,
+  stichtag: Date = new Date(),
+): Betreuungsjahr | null {
+  if (!bestellungAm) return null
+  if (isBefore(stichtag, bestellungAm)) return null
+
+  let nummer = 1
+  let beginn = new Date(bestellungAm)
+
+  // Schrittweise vorwaerts statt ueber eine Differenzrechnung: so stimmen
+  // Schaltjahre und der 29. Februar von selbst.
+  for (;;) {
+    const naechsterBeginn = addYears(beginn, 1)
+    if (isBefore(stichtag, naechsterBeginn)) break
+    beginn = naechsterBeginn
+    nummer += 1
+    // Schutz vor einem Datumsfehler in den Stammdaten.
+    if (nummer > 200) return null
+  }
+
+  const ende = addDays(addYears(beginn, 1), -1)
+
+  return {
+    nummer,
+    beginn,
+    ende,
+    // Sechs Monate ab dem Ende des Betreuungsjahres.
+    pauschaleBis: addMonths(ende, 6),
+  }
+}
+
+/** Das n-te Betreuungsjahr, unabhaengig vom heutigen Datum. */
+export function betreuungsjahrNummer(
+  bestellungAm: Date | null | undefined,
+  nummer: number,
+): Betreuungsjahr | null {
+  if (!bestellungAm || nummer < 1) return null
+
+  const beginn = addYears(new Date(bestellungAm), nummer - 1)
+  const ende = addDays(addYears(beginn, 1), -1)
+
+  return { nummer, beginn, ende, pauschaleBis: addMonths(ende, 6) }
+}
+
+/** Alle bisher abgelaufenen Betreuungsjahre - Grundlage der Berichtswahl. */
+export function abgelaufeneBetreuungsjahre(
+  bestellungAm: Date | null | undefined,
+  stichtag: Date = new Date(),
+): Betreuungsjahr[] {
+  if (!bestellungAm) return []
+
+  const jahre: Betreuungsjahr[] = []
+  let nummer = 1
+
+  for (;;) {
+    const jahr = betreuungsjahrNummer(bestellungAm, nummer)
+    if (!jahr || isAfter(jahr.ende, stichtag)) break
+    jahre.push(jahr)
+    nummer += 1
+    if (nummer > 200) break
+  }
+
+  return jahre
+}