docs: README, Datenschutztexte, Dockerfile und Sicherungsskripte

Damit ist Etappe 1 abgeschlossen und betriebsfertig dokumentiert. README mit beiden Betriebswegen. Docker Compose auf eigenem Server ist der Hauptweg; Vercel und Neon sind vollstaendig beschrieben, aber mit einer klaren Begruendung, warum ich davon abrate: beide Anbieter sind US-Unternehmen und unterliegen auch bei EU-Region potenziell dem CLOUD-Act. Bei Gesundheitsdaten einer nicht entscheidungsfaehigen Person ist das eine Abwaegung, die man bewusst treffen muss. Reverse-Proxy-Beispiele fuer Caddy, nginx und Traefik - der Proxy selbst ist nicht Teil des Compose-Setups, weil er auf dem Zielserver schon steht. Die Datenbank hat keine Portfreigabe. Sicherung: pg_dump schreibt direkt in die Verschluesselung, der Klartext landet nie auf der Platte. Danach eine Selbstpruefung - laesst sich die Datei nicht wieder entschluesseln, endet der Lauf mit Fehler statt mit einem stillen Scheinerfolg. Der jeweils erste Stand eines Monats bleibt dauerhaft stehen. Die README sagt ausdruecklich, was das Backup NICHT enthaelt: den Schluessel ENC_KEY_V1 und die Dateien im Objektspeicher. Dazu eine Anleitung, die Wiederherstellung einmal im Jahr zu ueben - mit dem letzten Schritt, in der Anwendung nachzusehen, ob die Diagnosen im Klartext erscheinen. Erst dann stimmt nicht nur die Datenbank, sondern auch der Schluessel. Verarbeitungsverzeichnis und Datenschutzhinweise als ausfuellbare Textbausteine. Die Hinweise sind in einfacher Sprache geschrieben - sie sollen der betreuten Person vorgelesen werden koennen. Die Seite /datenschutz liest denselben Text aus docs/, damit es nicht zwei Fassungen gibt, die auseinanderlaufen. Dockerfile in drei Stufen mit Tesseract, deutschen Sprachdaten und poppler-utils. Zeitzone Europe/Berlin ist gesetzt - ohne sie rechnet der Server in UTC und verschiebt Fristen um einen Tag. Etappe: 1 Phase: Fundament
2026-08-22 02:35:08 +02:00
parent 6b4df4c9cb
commit 3833a9dd8f
141 changed files with 30302 additions and 66 deletions
@@ -0,0 +1,104 @@
+'use server'
+
+import { z } from 'zod'
+import { db } from '@/lib/db'
+import { erfordereBenutzer } from '@/lib/auth/sitzung'
+import { passwortHashen, passwortPruefen } from '@/lib/crypto/hash'
+import { protokollieren } from '@/lib/audit'
+import { aufMindestdauerWarten } from '@/lib/auth/ratelimit'
+
+/**
+ * Passwortwechsel.
+ *
+ * Danach wird sitzungsGeneration hochgezaehlt. Das macht alle bestehenden
+ * Sitzungen ungueltig - auch die auf Geraeten, an denen man gerade nicht
+ * sitzt. Genau darum aendert man ja das Passwort.
+ *
+ * Die eigene Sitzung faellt dabei mit; der Benutzer meldet sich neu an.
+ * Das ist unbequem und trotzdem richtig: ein Wechsel, der offene Sitzungen
+ * stehen laesst, schuetzt vor nichts.
+ */
+
+const PASSWORT_MINDESTLAENGE = 12
+
+const PasswortSchema = z
+  .object({
+    aktuell: z.string().min(1, 'Bitte das bisherige Passwort eingeben.'),
+    neu: z
+      .string()
+      .min(
+        PASSWORT_MINDESTLAENGE,
+        `Bitte mindestens ${PASSWORT_MINDESTLAENGE} Zeichen. Vier zufällige Wörter sind ` +
+          `leichter zu merken und sicherer als ein kurzes Kunstwort.`,
+      )
+      .max(200),
+    wiederholung: z.string(),
+  })
+  .refine((daten) => daten.neu === daten.wiederholung, {
+    message: 'Die beiden neuen Passwörter stimmen nicht überein.',
+    path: ['wiederholung'],
+  })
+  .refine((daten) => daten.neu !== daten.aktuell, {
+    message: 'Das neue Passwort muss sich vom bisherigen unterscheiden.',
+    path: ['neu'],
+  })
+
+export type PasswortZustand = {
+  fehler?: string
+  felder?: Partial<Record<'aktuell' | 'neu' | 'wiederholung', string>>
+  erfolg?: boolean
+}
+
+export async function passwortAendern(
+  _vorher: PasswortZustand,
+  formular: FormData,
+): Promise<PasswortZustand> {
+  const begonnen = Date.now()
+  const benutzer = await erfordereBenutzer()
+
+  const gelesen = PasswortSchema.safeParse({
+    aktuell: formular.get('aktuell'),
+    neu: formular.get('neu'),
+    wiederholung: formular.get('wiederholung'),
+  })
+
+  if (!gelesen.success) {
+    const felder = gelesen.error.flatten().fieldErrors
+    return {
+      fehler: 'Bitte prüfe deine Eingaben.',
+      felder: {
+        aktuell: felder.aktuell?.[0],
+        neu: felder.neu?.[0],
+        wiederholung: felder.wiederholung?.[0],
+      },
+    }
+  }
+
+  const stimmt = await passwortPruefen(benutzer.passwortHash, gelesen.data.aktuell)
+  if (!stimmt) {
+    await aufMindestdauerWarten(begonnen)
+    return { fehler: 'Das bisherige Passwort stimmt nicht.', felder: { aktuell: ' ' } }
+  }
+
+  await db.user.update({
+    where: { id: benutzer.id },
+    data: {
+      passwortHash: await passwortHashen(gelesen.data.neu),
+      passwortGeaendertAm: new Date(),
+      // Beendet alle bestehenden Sitzungen, die eigene eingeschlossen.
+      sitzungsGeneration: { increment: 1 },
+    },
+  })
+
+  await protokollieren({
+    aktion: 'PASSWORT_GEAENDERT',
+    entitaet: 'User',
+    entitaetId: benutzer.id,
+    userId: benutzer.id,
+    userEmail: benutzer.email,
+    userName: benutzer.name,
+  })
+
+  await aufMindestdauerWarten(begonnen)
+  return { erfolg: true }
+}