Files
betreuungs-cockpit/src/server/actions/betreute.ts
T
Florian Wilde 22b3a9b9e9 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
2026-08-22 02:16:22 +02:00

226 lines
7.1 KiB
TypeScript

'use server'
import { redirect } from 'next/navigation'
import { revalidatePath } from 'next/cache'
import { z } from 'zod'
import { db, nichtGeloescht } from '@/lib/db'
import { sealen, oeffnen } from '@/lib/crypto/feld'
import { aenderungErmitteln, protokollieren } from '@/lib/audit'
import { erfordereBenutzer, erfordereZugang } from '@/lib/auth/sitzung'
import {
BETREUTE_GEHEIME_FELDER,
BetreuteSchema,
formularLesen,
} from '@/lib/validierung/betreute'
/**
* Stammdaten der betreuten Person anlegen und aendern.
*
* Das Bestellungsdatum ist hier das wichtigste Feld: aus ihm leiten sich
* das Betreuungsjahr und damit fast alle gesetzlichen Fristen ab. Wird es
* gesetzt oder geaendert, werden die Pflichtfristen neu abgeleitet.
*/
export type BetreuteZustand = {
fehler?: string
felder?: Record<string, string>
/** Rohwerte, damit ein langes Formular nach einem Fehler nicht leer ist. */
werte?: Record<string, string>
}
/** Teilt die geprueften Daten in Klartextfelder und zu verschluesselnde. */
function aufteilen(daten: z.infer<typeof BetreuteSchema>) {
const geheim: Record<string, string | null> = {}
const offen: Record<string, unknown> = {}
for (const [name, wert] of Object.entries(daten)) {
if ((BETREUTE_GEHEIME_FELDER as readonly string[]).includes(name)) {
geheim[name] = wert as string | null
} else {
offen[name] = wert
}
}
return { offen, verschluesselt: sealen('Betreute', geheim) }
}
function felderAusFehler(fehler: z.ZodError): Record<string, string> {
const flach = fehler.flatten().fieldErrors
const ergebnis: Record<string, string> = {}
for (const [feld, meldungen] of Object.entries(flach)) {
if (meldungen?.[0]) ergebnis[feld] = meldungen[0]
}
return ergebnis
}
function werteMerken(formular: FormData): Record<string, string> {
const werte: Record<string, string> = {}
for (const [name, wert] of formular.entries()) {
if (typeof wert === 'string') werte[name] = wert
}
return werte
}
// -----------------------------------------------------------------------------
// Anlegen
// -----------------------------------------------------------------------------
export async function betreuteAnlegen(
_vorher: BetreuteZustand,
formular: FormData,
): Promise<BetreuteZustand> {
const benutzer = await erfordereBenutzer()
// Nur Betreuer und Administratoren duerfen eine Betreuung anlegen.
if (benutzer.rolle === 'MITLESER') {
return { fehler: 'Als Mitleser kannst du keine Betreuung anlegen.' }
}
const gelesen = BetreuteSchema.safeParse(formularLesen(formular))
if (!gelesen.success) {
return {
fehler: 'Bitte prüfe die markierten Felder.',
felder: felderAusFehler(gelesen.error),
werte: werteMerken(formular),
}
}
const { offen, verschluesselt } = aufteilen(gelesen.data)
const betreute = await db.$transaction(async (tx) => {
const angelegt = await tx.betreute.create({
data: { ...offen, ...verschluesselt } as never,
})
// Der Anlegende bekommt sofort vollen Zugang - sonst saehe er die
// gerade angelegte Person nicht.
await tx.betreuungsZugang.create({
data: { userId: benutzer.id, betreuteId: angelegt.id, rolle: 'BETREUER' },
})
await protokollieren({
tx,
aktion: 'ERSTELLT',
entitaet: 'Betreute',
entitaetId: angelegt.id,
bezeichnung: `${angelegt.vorname} ${angelegt.nachname}`,
betreuteId: angelegt.id,
userId: benutzer.id,
userEmail: benutzer.email,
userName: benutzer.name,
})
return angelegt
})
// Aus dem Bestellungsdatum die gesetzlichen Pflichtfristen ableiten.
await pflichtfristenAbleitenWennMoeglich(betreute.id)
revalidatePath('/', 'layout')
redirect('/heute')
}
// -----------------------------------------------------------------------------
// Aendern
// -----------------------------------------------------------------------------
export async function betreuteAendern(
_vorher: BetreuteZustand,
formular: FormData,
): Promise<BetreuteZustand> {
const betreuteId = String(formular.get('betreuteId') ?? '')
if (!betreuteId) return { fehler: 'Es fehlt die Angabe, wer geändert werden soll.' }
const { benutzer, betreute } = await erfordereZugang(betreuteId, 'STAMMDATEN', 'schreiben')
const gelesen = BetreuteSchema.safeParse(formularLesen(formular))
if (!gelesen.success) {
return {
fehler: 'Bitte prüfe die markierten Felder.',
felder: felderAusFehler(gelesen.error),
werte: werteMerken(formular),
}
}
const { offen, verschluesselt } = aufteilen(gelesen.data)
// Fuer das Protokoll wird der Klartext verglichen, nicht der Umschlag -
// der aendert sich bei jedem Speichern, auch wenn der Inhalt gleich ist.
const vorherOffen = oeffnen('Betreute', betreute as unknown as Record<string, unknown>)
const nachher = { ...offen, ...gelesen.data }
const bestellungGeaendert =
betreute.bestellungAm?.getTime() !== (gelesen.data.bestellungAm?.getTime() ?? undefined)
await db.$transaction(async (tx) => {
await tx.betreute.update({
where: { id: betreuteId },
data: { ...offen, ...verschluesselt } as never,
})
await protokollieren({
tx,
aktion: 'GEAENDERT',
entitaet: 'Betreute',
entitaetId: betreuteId,
bezeichnung: `${gelesen.data.vorname} ${gelesen.data.nachname}`,
betreuteId,
userId: benutzer.id,
userEmail: benutzer.email,
userName: benutzer.name,
aenderung: aenderungErmitteln(vorherOffen, nachher),
})
})
// Aendert sich das Bestellungsdatum, verschiebt sich das gesamte
// Betreuungsjahr - die Pflichtfristen muessen neu abgeleitet werden.
if (bestellungGeaendert) {
await pflichtfristenAbleitenWennMoeglich(betreuteId)
}
revalidatePath('/', 'layout')
redirect('/stammdaten')
}
/**
* Ruft die Fristenableitung auf, sobald das Fristenmodul vorhanden ist.
*
* Der dynamische Import haelt die Stammdaten unabhaengig: fehlt das Modul
* (frueher Bauzustand), wird die Ableitung uebersprungen, statt dass das
* Speichern der Stammdaten scheitert.
*/
async function pflichtfristenAbleitenWennMoeglich(betreuteId: string): Promise<void> {
try {
const modul = await import('@/lib/fristen/pflichtfristen')
await modul.pflichtfristenSchreiben(betreuteId)
} catch (fehler) {
console.warn('[stammdaten] Pflichtfristen konnten nicht abgeleitet werden:', fehler)
}
}
// -----------------------------------------------------------------------------
// Papierkorb
// -----------------------------------------------------------------------------
export async function betreuteInPapierkorb(betreuteId: string): Promise<void> {
const { benutzer, betreute } = await erfordereZugang(betreuteId, 'STAMMDATEN', 'schreiben')
await db.betreute.update({
where: { id: betreuteId, ...nichtGeloescht },
data: { geloeschtAm: new Date() },
})
await protokollieren({
aktion: 'GELOESCHT',
entitaet: 'Betreute',
entitaetId: betreuteId,
bezeichnung: `${betreute.vorname} ${betreute.nachname}`,
betreuteId,
userId: benutzer.id,
userEmail: benutzer.email,
userName: benutzer.name,
})
revalidatePath('/', 'layout')
}