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
+128
View File
@@ -0,0 +1,128 @@
import type { SozialhilfeBewertung, VertragArt, VertragStatus, ZahlRhythmus } from '@prisma/client'
/**
* Beschriftungen und Einordnungen fuer Versicherungen und Vertraege.
*/
export const VERTRAG_ART_BESCHRIFTUNG: Record<VertragArt, string> = {
LEBENSVERSICHERUNG: 'Lebensversicherung',
STERBEGELDVERSICHERUNG: 'Sterbegeldversicherung',
BESTATTUNGSVORSORGE: 'Bestattungsvorsorgevertrag',
RENTENVERSICHERUNG_PRIVAT: 'Private Rentenversicherung',
UNFALLVERSICHERUNG: 'Unfallversicherung',
HAFTPFLICHT: 'Privathaftpflicht',
HAUSRAT: 'Hausratversicherung',
WOHNGEBAEUDE: 'Wohngebäudeversicherung',
KRANKENZUSATZ: 'Krankenzusatzversicherung',
PFLEGEZUSATZ: 'Pflegezusatzversicherung',
RECHTSSCHUTZ: 'Rechtsschutzversicherung',
STERBEKASSE: 'Sterbekasse',
STROM: 'Stromvertrag',
GAS: 'Gasvertrag',
WASSER: 'Wasserversorgung',
TELEFON_INTERNET: 'Telefon und Internet',
RUNDFUNKBEITRAG: 'Rundfunkbeitrag',
MITGLIEDSCHAFT: 'Mitgliedschaft',
ABONNEMENT: 'Abonnement',
SONSTIGES: 'Sonstiges',
}
export const VERTRAG_STATUS_BESCHRIFTUNG: Record<VertragStatus, string> = {
AKTIV: 'aktiv',
BEITRAGSFREI: 'beitragsfrei gestellt',
RUHEND: 'ruhend',
GEKUENDIGT: 'gekündigt',
ABGETRETEN: 'abgetreten',
VERWERTET: 'verwertet',
ABGELAUFEN: 'abgelaufen',
}
export const RHYTHMUS_BESCHRIFTUNG: Record<ZahlRhythmus, string> = {
MONATLICH: 'monatlich',
VIERTELJAEHRLICH: 'vierteljährlich',
HALBJAEHRLICH: 'halbjährlich',
JAEHRLICH: 'jährlich',
EINMALIG: 'einmalig',
}
/** Wie oft im Jahr wird gezahlt? Fuer den Jahresbeitrag in der Uebersicht. */
export const RHYTHMUS_JAHRESFAKTOR: Record<ZahlRhythmus, number> = {
MONATLICH: 12,
VIERTELJAEHRLICH: 4,
HALBJAEHRLICH: 2,
JAEHRLICH: 1,
EINMALIG: 0,
}
export function jahresbeitragCent(
beitragCent: bigint | null | undefined,
rhythmus: ZahlRhythmus | null | undefined,
): bigint | null {
if (beitragCent === null || beitragCent === undefined || !rhythmus) return null
const faktor = RHYTHMUS_JAHRESFAKTOR[rhythmus]
if (faktor === 0) return null
return beitragCent * BigInt(faktor)
}
export const BEWERTUNG_BESCHRIFTUNG: Record<SozialhilfeBewertung, string> = {
UNGEPRUEFT: 'ungeprüft',
VERWERTBAR: 'verwertbar',
GESCHUETZT: 'geschützt',
STRITTIG: 'strittig',
}
export const BEWERTUNG_ERKLAERUNG: Record<SozialhilfeBewertung, string> = {
UNGEPRUEFT: 'Noch nicht eingeordnet. Vor dem nächsten Schreiben an den Bezirk nachholen.',
VERWERTBAR:
'Der Vertrag lässt sich zu Geld machen und ist vor der Sozialhilfe einzusetzen. ' +
'Das heißt nicht, dass gekündigt werden muss — erst rechnen, dann handeln.',
GESCHUETZT:
'Aus meiner Sicht Schonvermögen, etwa eine angemessene Bestattungsvorsorge ' +
'(§ 90 Abs. 3 SGB XII) oder ein Vertrag unterhalb der Vermögensfreigrenze. ' +
'Die Begründung gehört daneben.',
STRITTIG: 'Der Träger sieht es anders als ich. Schriftwechsel dokumentieren.',
}
/**
* Vertragsarten, bei denen eine Verwertung genehmigungspflichtig sein
* kann. Das ist bewusst eine Pruefliste, keine Entscheidung: Ob § 1850 BGB
* greift, haengt am Einzelfall und beantwortet der Rechtspfleger, nicht
* diese Anwendung.
*/
export const GENEHMIGUNG_PRUEFEN_BEI: VertragArt[] = [
'LEBENSVERSICHERUNG',
'RENTENVERSICHERUNG_PRIVAT',
'STERBEGELDVERSICHERUNG',
'BESTATTUNGSVORSORGE',
'STERBEKASSE',
]
/**
* Vertragsarten, die einen Rueckkaufswert haben koennen. Nur bei diesen
* ergibt die Anforderung beim Versicherer Sinn.
*/
export const MIT_RUECKKAUFSWERT: VertragArt[] = [
'LEBENSVERSICHERUNG',
'RENTENVERSICHERUNG_PRIVAT',
'STERBEGELDVERSICHERUNG',
'BESTATTUNGSVORSORGE',
'STERBEKASSE',
]
export function kannRueckkaufswertHaben(art: VertragArt): boolean {
return MIT_RUECKKAUFSWERT.includes(art)
}
export function genehmigungPruefen(art: VertragArt): boolean {
return GENEHMIGUNG_PRUEFEN_BEI.includes(art)
}
/** Wertquellen fuer Rueckkaufswerte - Pflichtangabe an jedem Wertstand. */
export const WERTQUELLEN_VERTRAG = [
'Rückkaufswertmitteilung der Gesellschaft',
'Jahresstandmitteilung',
'telefonische Auskunft',
'eigene Schätzung',
] as const
export const RECHTSGRUNDLAGE_GENEHMIGUNG = '§ 1850 BGB'