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/components/vorgaenge/vorgangs-formular.tsx

@@ -0,0 +1,227 @@
+'use client'
+
+import { useActionState } from 'react'
+import Link from 'next/link'
+import { AlertCircle } from 'lucide-react'
+import type { VorgangKategorie, VorgangStatus } from '@prisma/client'
+import { Button } from '@/components/ui/button'
+import { Checkbox } from '@/components/ui/checkbox'
+import { Input } from '@/components/ui/input'
+import { Select } from '@/components/ui/select'
+import { Textarea } from '@/components/ui/textarea'
+import { Feld, Feldgruppe } from '@/components/feld'
+import { Rechtshinweis } from '@/components/rechtshinweis'
+import { vorgangAendern, vorgangAnlegen } from '@/server/actions/vorgaenge'
+import {
+  KATEGORIE_BESCHRIFTUNG,
+  PRIORITAET_BESCHRIFTUNG,
+  VORGANG_KATEGORIEN,
+  VORGANG_STATUS,
+  type Formularzustand,
+} from '@/lib/validierung/vorgaenge'
+import { GENEHMIGUNG_WARNUNG } from '@/lib/vorgaenge/genehmigungskette'
+import { VORGANG_STATUS_BESCHRIFTUNG } from '@/lib/vorgaenge/zeitstrahl'
+
+/** Date -> "2026-08-22" für <input type="date">. */
+function alsFeldwert(datum: Date | null | undefined): string {
+  if (!datum) return ''
+  return datum.toISOString().slice(0, 10)
+}
+
+export type VorgangsFormularWerte = {
+  titel: string
+  kategorie: VorgangKategorie
+  status: VorgangStatus
+  prioritaet: number
+  beschreibung: string | null
+  gegenstelle: string | null
+  aktenzeichen: string | null
+  verantwortlich: string | null
+  naechsterSchritt: string | null
+  faelligAm: Date | null
+  letzterKontaktAm: Date | null
+  genehmigungspflichtig: boolean
+}
+
+export function VorgangsFormular({
+  modus,
+  betreuteId,
+  vorgangId,
+  vorlageSchluessel,
+  werte,
+  abbrechenHref,
+}: {
+  modus: 'anlegen' | 'aendern'
+  betreuteId: string
+  vorgangId?: string
+  vorlageSchluessel?: string | null
+  werte: VorgangsFormularWerte
+  abbrechenHref: string
+}) {
+  const [zustand, aktion, laeuft] = useActionState<Formularzustand, FormData>(
+    modus === 'anlegen' ? vorgangAnlegen : vorgangAendern,
+    {},
+  )
+
+  return (
+    <form action={aktion} className="space-y-8">
+      <input type="hidden" name="betreuteId" value={betreuteId} />
+      {vorgangId && <input type="hidden" name="vorgangId" value={vorgangId} />}
+      {modus === 'anlegen' && (
+        <input type="hidden" name="vorlageSchluessel" value={vorlageSchluessel ?? ''} />
+      )}
+
+      <Feldgruppe titel="Worum geht es?">
+        <Feld
+          id="titel"
+          beschriftung="Titel"
+          erklaerung="So, dass du den Vorgang in einem Jahr wiedererkennst."
+          fehler={zustand.felder?.titel}
+          pflicht
+          className="sm:col-span-2"
+        >
+          <Input name="titel" defaultValue={werte.titel} required maxLength={200} />
+        </Feld>
+
+        <Feld id="kategorie" beschriftung="Kategorie" fehler={zustand.felder?.kategorie} pflicht>
+          <Select name="kategorie" defaultValue={werte.kategorie}>
+            {VORGANG_KATEGORIEN.map((wert) => (
+              <option key={wert} value={wert}>
+                {KATEGORIE_BESCHRIFTUNG[wert]}
+              </option>
+            ))}
+          </Select>
+        </Feld>
+
+        <Feld id="status" beschriftung="Status" fehler={zustand.felder?.status}>
+          <Select name="status" defaultValue={werte.status}>
+            {VORGANG_STATUS.map((wert) => (
+              <option key={wert} value={wert}>
+                {VORGANG_STATUS_BESCHRIFTUNG[wert]}
+              </option>
+            ))}
+          </Select>
+        </Feld>
+
+        <Feld
+          id="prioritaet"
+          beschriftung="Priorität"
+          erklaerung="Hoch heißt: das treibt gerade."
+          fehler={zustand.felder?.prioritaet}
+        >
+          <Select name="prioritaet" defaultValue={String(werte.prioritaet)}>
+            {[1, 2, 3].map((wert) => (
+              <option key={wert} value={wert}>
+                {PRIORITAET_BESCHRIFTUNG[wert]}
+              </option>
+            ))}
+          </Select>
+        </Feld>
+
+        <Feld id="verantwortlich" beschriftung="Verantwortlich" fehler={zustand.felder?.verantwortlich}>
+          <Input name="verantwortlich" defaultValue={werte.verantwortlich ?? ''} maxLength={120} />
+        </Feld>
+
+        <Feld
+          id="beschreibung"
+          beschriftung="Beschreibung"
+          erklaerung="Wird verschlüsselt gespeichert."
+          fehler={zustand.felder?.beschreibung}
+          className="sm:col-span-2"
+        >
+          <Textarea name="beschreibung" defaultValue={werte.beschreibung ?? ''} rows={5} />
+        </Feld>
+      </Feldgruppe>
+
+      <Feldgruppe
+        titel="Wer ist am Zug?"
+        beschreibung="Behörde, Aktenzeichen und der letzte Kontakt - daraus entsteht später die Sachstandsanfrage."
+      >
+        <Feld id="gegenstelle" beschriftung="Gegenstelle" fehler={zustand.felder?.gegenstelle}>
+          <Input
+            name="gegenstelle"
+            defaultValue={werte.gegenstelle ?? ''}
+            maxLength={150}
+            placeholder="z. B. Bezirk Oberfranken"
+          />
+        </Feld>
+
+        <Feld
+          id="aktenzeichen"
+          beschriftung="Aktenzeichen"
+          erklaerung="Das Zeichen, unter dem die Gegenstelle den Vorgang führt."
+          fehler={zustand.felder?.aktenzeichen}
+        >
+          <Input name="aktenzeichen" defaultValue={werte.aktenzeichen ?? ''} maxLength={80} />
+        </Feld>
+
+        <Feld
+          id="naechsterSchritt"
+          beschriftung="Nächster Schritt"
+          erklaerung="Der eine konkrete Handgriff, der als Nächstes ansteht."
+          fehler={zustand.felder?.naechsterSchritt}
+          className="sm:col-span-2"
+        >
+          <Input
+            name="naechsterSchritt"
+            defaultValue={werte.naechsterSchritt ?? ''}
+            maxLength={300}
+          />
+        </Feld>
+
+        <Feld id="faelligAm" beschriftung="Fällig am" fehler={zustand.felder?.faelligAm}>
+          <Input name="faelligAm" type="date" defaultValue={alsFeldwert(werte.faelligAm)} />
+        </Feld>
+
+        <Feld
+          id="letzterKontaktAm"
+          beschriftung="Letzter Kontakt am"
+          fehler={zustand.felder?.letzterKontaktAm}
+        >
+          <Input
+            name="letzterKontaktAm"
+            type="date"
+            defaultValue={alsFeldwert(werte.letzterKontaktAm)}
+          />
+        </Feld>
+      </Feldgruppe>
+
+      <div className="space-y-3">
+        <div className="flex items-start gap-3">
+          <Checkbox
+            id="genehmigungspflichtig"
+            name="genehmigungspflichtig"
+            defaultChecked={werte.genehmigungspflichtig}
+            className="mt-1"
+          />
+          <label htmlFor="genehmigungspflichtig" className="text-base font-medium">
+            Dieser Vorgang braucht eine Genehmigung des Betreuungsgerichts
+          </label>
+        </div>
+        <p className="text-sm text-muted-foreground">{GENEHMIGUNG_WARNUNG}</p>
+        <Rechtshinweis rechtsgrundlage="§ 1858 BGB" kurz />
+      </div>
+
+      {zustand.fehler && (
+        <p className="flex items-start gap-1.5 text-sm font-medium text-destructive" role="alert">
+          <AlertCircle className="mt-0.5 size-4 shrink-0" aria-hidden="true" />
+          {zustand.fehler}
+        </p>
+      )}
+      {zustand.erfolg && (
+        <p className="text-sm text-muted-foreground" role="status">
+          {zustand.erfolg}
+        </p>
+      )}
+
+      <div className="flex flex-wrap gap-3">
+        <Button type="submit" disabled={laeuft}>
+          {laeuft ? 'Speichert…' : modus === 'anlegen' ? 'Vorgang anlegen' : 'Speichern'}
+        </Button>
+        <Button type="button" variant="ghost" asChild>
+          <Link href={abbrechenHref}>Abbrechen</Link>
+        </Button>
+      </div>
+    </form>
+  )
+}