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
This commit is contained in:
Florian Wilde
2026-08-22 02:16:22 +02:00
parent dcd3a8ce71
commit 22b3a9b9e9
134 changed files with 30753 additions and 17 deletions
+116
View File
@@ -0,0 +1,116 @@
import { formatDatum } from '@/lib/utils'
import { heuteAlsTag, plusTage, tageZwischen } from '@/lib/fristen/datum'
import {
absenderBlock,
anschriftBlock,
bestellungsAbsatz,
betreffZeile,
datumsZeile,
grussformel,
type Briefkopf,
type Empfaenger,
} from '@/lib/vertraege/anschreiben'
/**
* Anforderung des Rueckkaufswerts beim Versicherer.
*
* Warum das ein eigener Knopf ist: Der Bezirk verlangt fuer die Hilfe zur
* Pflege zu jedem Versicherungsvertrag den Rueckkaufswert zu einem
* Stichtag - und zwar schriftlich von der Gesellschaft, nicht aus der
* Jahresmitteilung geschaetzt. Die Antwort dauert regelmaessig drei bis
* sechs Wochen. Wer die Anfrage vergisst, haelt am Ende das ganze
* Verfahren auf.
*
* Deshalb: Brief erzeugen, Datum der Anfrage festhalten, Wiedervorlage in
* vier Wochen. Die Wiedervorlage legt die Server Action als Frist an.
*/
export const RUECKKAUFSWERT_WIEDERVORLAGE_TAGE = 28
export function wiedervorlageAm(angefragtAm: Date = heuteAlsTag()): Date {
return plusTage(angefragtAm, RUECKKAUFSWERT_WIEDERVORLAGE_TAGE)
}
export type RueckkaufswertAnfrage = {
kopf: Briefkopf
empfaenger: Empfaenger
vertragsbezeichnung: string
vertragsnummer: string | null
/** Zu welchem Tag soll der Wert mitgeteilt werden? */
stichtag: Date
/** Datum des Schreibens. */
heute?: Date
}
/**
* Erzeugt das Anschreiben als Freitext.
*
* Abgefragt wird bewusst mehr als nur der Rueckkaufswert: Die
* beitragsfreie Versicherungssumme ist die Alternative zur Kuendigung -
* der Vertrag bleibt bestehen, es wird nur nichts mehr eingezahlt. Bei
* einer Sterbegeldversicherung ist das haeufig die bessere Loesung als der
* Rueckkauf, und ohne die Zahl laesst sich das nicht vergleichen.
*/
export function rueckkaufswertAnschreiben(anfrage: RueckkaufswertAnfrage): string {
const heute = anfrage.heute ?? heuteAlsTag()
const kopf = anfrage.kopf
return [
absenderBlock(kopf),
'',
anschriftBlock(anfrage.empfaenger),
'',
datumsZeile(kopf.betreuerOrt, heute),
'',
betreffZeile(
'Auskunft über Rückkaufswert und beitragsfreie Versicherungssumme',
anfrage.vertragsnummer,
kopf.betreuteName,
kopf.betreuteGeburtsdatum,
),
'',
'Sehr geehrte Damen und Herren,',
'',
bestellungsAbsatz(kopf),
'',
`für ein laufendes Verfahren auf Hilfe zur Pflege beim überörtlichen ` +
`Sozialhilfeträger benötige ich zu dem oben genannten Vertrag ` +
`(${anfrage.vertragsbezeichnung}) folgende Auskünfte, jeweils zum Stichtag ` +
`${formatDatum(anfrage.stichtag)}:`,
'',
'1. den Rückkaufswert einschließlich bereits zugeteilter Überschussanteile,',
'2. die beitragsfreie Versicherungssumme bei sofortiger Beitragsfreistellung,',
'3. die Höhe der laufenden Beiträge und den Zahlungsrhythmus,',
'4. Beginn, vereinbartes Ende und die Kündigungsfrist des Vertrages,',
'5. ob der Vertrag abgetreten, verpfändet oder mit einem unwiderruflichen ' +
'Bezugsrecht belegt ist,',
'6. ob eine Verwertungsausschlussvereinbarung besteht.',
'',
`Ich bitte um schriftliche Mitteilung an die oben genannte Anschrift. Da im ` +
`Verfahren beim Sozialhilfeträger eine Frist läuft, wäre ich für eine Antwort ` +
`bis zum ${formatDatum(wiedervorlageAm(heute))} dankbar.`,
'',
'Für Rückfragen stehe ich gerne zur Verfügung.',
'',
grussformel(kopf.betreuerName),
'',
'Anlage: Kopie der Bestellungsurkunde',
].join('\n')
}
/**
* Wie lange ist die letzte Anfrage her? Grundlage fuer den Hinweis
* "Erinnerung faellig".
*/
export function anfrageStatus(
angefragtAm: Date | null,
heute: Date = heuteAlsTag(),
): { offen: boolean; erinnerungFaellig: boolean; tageSeitAnfrage: number | null } {
if (!angefragtAm) return { offen: false, erinnerungFaellig: false, tageSeitAnfrage: null }
const tage = tageZwischen(angefragtAm, heute)
return {
offen: true,
erinnerungFaellig: tage >= RUECKKAUFSWERT_WIEDERVORLAGE_TAGE,
tageSeitAnfrage: tage,
}
}