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
+383
View File
@@ -0,0 +1,383 @@
import { differenceInCalendarDays, endOfMonth, endOfWeek, startOfDay } from 'date-fns'
import type { FristTyp, NachforderungStatus, VermoegensArt, VorgangKategorie } from '@prisma/client'
import type {
Ampelstufe,
FristEintrag,
FristenAmpelDaten,
NachforderungEintrag,
NachforderungenDaten,
WartendEintrag,
WartetAufAndereDaten,
} from '@/lib/dashboard/typen'
/**
* Die Rechenregeln hinter dem Dashboard - ohne Datenbank, ohne React.
*
* Alles, was hier steht, laesst sich in tests/dashboard.test.ts pruefen.
* laden.ts holt nur die Datensaetze und reicht sie hier durch; die
* Bewertung "ist das dringend?" faellt an genau einer Stelle.
*/
/** Ab so vielen Tagen ohne Rueckmeldung wird eine Sachstandsanfrage faellig. */
export const WARTEZEIT_DRINGEND_TAGE = 21
/** Wie viele Ausschlussfristen zeigt die Warnung hoechstens? */
const AUSSCHLUSSFRISTEN_MAX = 3
/**
* Datumsfelder ohne Uhrzeit (@db.Date) kommen als UTC-Mitternacht aus der
* Datenbank. Wer sie unbesehen mit einem lokalen "heute" vergleicht,
* verschiebt eine Frist um einen Tag. Deshalb: auf den lokalen Tagesanfang
* ziehen, und zwar anhand der UTC-Bestandteile.
*/
export function tagAusDatenbank(datum: Date): Date {
return new Date(datum.getUTCFullYear(), datum.getUTCMonth(), datum.getUTCDate())
}
/** Tage von heute bis zum Datum. Negativ = liegt in der Vergangenheit. */
export function tageBisTag(datum: Date, heute: Date): number {
return differenceInCalendarDays(datum, startOfDay(heute))
}
// -----------------------------------------------------------------------------
// 1. Fristen-Ampel
// -----------------------------------------------------------------------------
export type FristRoh = {
id: string
titel: string
datum: Date
typ: FristTyp
rechtsgrundlage: string | null
ausschlussfrist: boolean
vorgangId: string | null
}
/**
* Konventionen aus docs/KONVENTIONEN.md:
* rot = ueberfaellig, orange = diese Woche, gelb = dieser Monat,
* gruen = weiter in der Zukunft.
*
* "Diese Woche" endet am Sonntag, "dieser Monat" am Monatsletzten - nicht
* "in 7 Tagen" bzw. "in 30 Tagen". Wer montags auf das Dashboard schaut,
* will wissen, was bis Sonntag liegen bleibt.
*/
export function fristStufe(datum: Date, heute: Date): Ampelstufe {
const tag = startOfDay(datum)
const heuteTag = startOfDay(heute)
if (tag < heuteTag) return 'rot'
if (tag <= endOfWeek(heuteTag, { weekStartsOn: 1 })) return 'orange'
if (tag <= endOfMonth(heuteTag)) return 'gelb'
return 'gruen'
}
/** "seit 3 Tagen ueberfaellig" - der Text, der neben der Farbe stehen muss. */
export function fristLage(tage: number): string {
if (tage < -1) return `seit ${Math.abs(tage)} Tagen überfällig`
if (tage === -1) return 'seit gestern überfällig'
if (tage === 0) return 'heute fällig'
if (tage === 1) return 'morgen fällig'
return `in ${tage} Tagen fällig`
}
/**
* Die Verfallwarnung. Eine Ausschlussfrist kennt keine Nachsicht: laeuft
* sie ab, ist der Anspruch weg - bei der Aufwandspauschale nach § 1878 BGB
* z.B. das ganze Jahresgeld.
*/
export function verfallwarnung(frist: { tage: number; rechtsgrundlage: string | null }): string {
const grundlage = frist.rechtsgrundlage ? `${frist.rechtsgrundlage}: ` : ''
if (frist.tage < 0) {
const tage = Math.abs(frist.tage)
return (
`${grundlage}Diese Ausschlussfrist ist seit ${tage} ${tage === 1 ? 'Tag' : 'Tagen'} ` +
`abgelaufen. Läuft der Anspruch ab, ist er ersatzlos weg. Bitte umgehend beim Gericht ` +
`bzw. bei der Behörde nachfragen.`
)
}
return (
`${grundlage}Ausschlussfrist – keine Verlängerung, keine Nachfrist. ` +
`Läuft der Anspruch ab, ist er ersatzlos weg.`
)
}
export function fristenEinordnen(fristen: FristRoh[], heute: Date): FristenAmpelDaten {
const eintraege: FristEintrag[] = fristen.map((frist) => {
const datum = tagAusDatenbank(frist.datum)
const tage = tageBisTag(datum, heute)
return {
id: frist.id,
titel: frist.titel,
datum,
typ: frist.typ,
rechtsgrundlage: frist.rechtsgrundlage,
ausschlussfrist: frist.ausschlussfrist,
vorgangId: frist.vorgangId,
tage,
stufe: fristStufe(datum, heute),
}
})
// Frueheste zuerst - damit steht die aelteste ueberfaellige ganz oben.
eintraege.sort((a, b) => a.datum.getTime() - b.datum.getTime())
return {
ueberfaellig: eintraege.filter((e) => e.stufe === 'rot'),
dieseWoche: eintraege.filter((e) => e.stufe === 'orange'),
diesenMonat: eintraege.filter((e) => e.stufe === 'gelb'),
weitereOffen: eintraege.filter((e) => e.stufe === 'gruen').length,
ausschlussfristen: eintraege.filter((e) => e.ausschlussfrist).slice(0, AUSSCHLUSSFRISTEN_MAX),
gesamtOffen: eintraege.length,
}
}
// -----------------------------------------------------------------------------
// 2. Wartet auf andere
// -----------------------------------------------------------------------------
export type WartendRoh = {
id: string
titel: string
kategorie: VorgangKategorie
gegenstelle: string | null
aktenzeichen: string | null
naechsterSchritt: string | null
letzterKontaktAm: Date | null
erstelltAm: Date
}
/**
* Sortiert nach Tagen seit dem letzten Kontakt, laengste Wartezeit zuerst.
* Ist nie ein Kontakt vermerkt worden, zaehlt das Anlegedatum - sonst
* rutschte ausgerechnet der Vorgang nach unten, um den sich noch nie
* jemand gekuemmert hat.
*/
export function wartendeEinordnen(vorgaenge: WartendRoh[], heute: Date): WartetAufAndereDaten {
const eintraege: WartendEintrag[] = vorgaenge.map((vorgang) => {
const bezug = vorgang.letzterKontaktAm
? tagAusDatenbank(vorgang.letzterKontaktAm)
: startOfDay(vorgang.erstelltAm)
const tageOhneRueckmeldung = Math.max(0, -tageBisTag(bezug, heute))
return {
id: vorgang.id,
titel: vorgang.titel,
kategorie: vorgang.kategorie,
gegenstelle: vorgang.gegenstelle,
aktenzeichen: vorgang.aktenzeichen,
naechsterSchritt: vorgang.naechsterSchritt,
letzterKontaktAm: vorgang.letzterKontaktAm
? tagAusDatenbank(vorgang.letzterKontaktAm)
: null,
tageOhneRueckmeldung,
dringend: tageOhneRueckmeldung >= WARTEZEIT_DRINGEND_TAGE,
}
})
eintraege.sort((a, b) => b.tageOhneRueckmeldung - a.tageOhneRueckmeldung)
return {
eintraege,
gesamt: eintraege.length,
dringende: eintraege.filter((e) => e.dringend).length,
}
}
// -----------------------------------------------------------------------------
// 3. Nachforderungen
// -----------------------------------------------------------------------------
/** Diese Zustaende sind aus meiner Sicht abgearbeitet. */
const NACHFORDERUNG_ERLEDIGT: NachforderungStatus[] = [
'UEBERSANDT',
'ANERKANNT',
'NICHT_VORHANDEN',
]
export type NachforderungRoh = {
id: string
bezeichnung: string
status: NachforderungStatus
fristBis: Date | null
reihenfolge: number
antragId: string
antragTraeger: string | null
antragAktenzeichen: string | null
}
export function nachforderungenAuswerten(
zeilen: NachforderungRoh[],
heute: Date,
): NachforderungenDaten {
const offenRoh = zeilen.filter((z) => !NACHFORDERUNG_ERLEDIGT.includes(z.status))
const offen: NachforderungEintrag[] = offenRoh.map((zeile) => {
const fristBis = zeile.fristBis ? tagAusDatenbank(zeile.fristBis) : null
return {
id: zeile.id,
bezeichnung: zeile.bezeichnung,
status: zeile.status,
fristBis,
tageBisFrist: fristBis ? tageBisTag(fristBis, heute) : null,
}
})
// Zuerst, was eine Frist hat, und davon das Dringendste.
offen.sort((a, b) => {
if (a.tageBisFrist === null && b.tageBisFrist === null) return 0
if (a.tageBisFrist === null) return 1
if (b.tageBisFrist === null) return -1
return a.tageBisFrist - b.tageBisFrist
})
const erster = zeilen[0]
return {
antragId: erster?.antragId ?? null,
traeger: erster?.antragTraeger ?? null,
aktenzeichen: erster?.antragAktenzeichen ?? null,
gesamt: zeilen.length,
erledigt: zeilen.filter((z) => NACHFORDERUNG_ERLEDIGT.includes(z.status)).length,
offen,
ueberfaellig: offen.filter((o) => o.tageBisFrist !== null && o.tageBisFrist < 0).length,
}
}
// -----------------------------------------------------------------------------
// 6. Kennzahlen: Vermoegen und Heimkosten
// -----------------------------------------------------------------------------
export type PostenRoh = {
id: string
art: VermoegensArt
wertstaende: { stichtag: Date; wertCent: bigint }[]
}
export type VermoegenslageRoh = {
stichtag: Date | null
aktivaCent: bigint
verbindlichkeitenCent: bigint
nettoCent: bigint
postenGesamt: number
postenOhneWert: number
}
/**
* Vermoegen zum letzten Stichtag: je Posten zaehlt der juengste Wertstand,
* Verbindlichkeiten werden abgezogen.
*
* Der ausgewiesene Stichtag ist der juengste tatsaechlich verwendete - die
* Posten koennen zu unterschiedlichen Terminen bewertet worden sein, und
* genau das muss die Kachel sagen duerfen.
*/
export function vermoegenBerechnen(posten: PostenRoh[]): VermoegenslageRoh {
let aktivaCent = 0n
let verbindlichkeitenCent = 0n
let stichtag: Date | null = null
let postenOhneWert = 0
for (const p of posten) {
let juengster: { stichtag: Date; wertCent: bigint } | null = null
for (const wert of p.wertstaende) {
if (juengster === null || wert.stichtag.getTime() > juengster.stichtag.getTime()) {
juengster = wert
}
}
if (juengster === null) {
postenOhneWert += 1
continue
}
if (p.art === 'VERBINDLICHKEIT') {
verbindlichkeitenCent += juengster.wertCent
} else {
aktivaCent += juengster.wertCent
}
const tag = tagAusDatenbank(juengster.stichtag)
if (stichtag === null || tag.getTime() > stichtag.getTime()) stichtag = tag
}
return {
stichtag,
aktivaCent,
verbindlichkeitenCent,
nettoCent: aktivaCent - verbindlichkeitenCent,
postenGesamt: posten.length,
postenOhneWert,
}
}
export type HeimkostenmonatRoh = {
jahr: number
monat: number
pflegeEigenanteilCent: bigint
unterkunftVerpflegungCent: bigint
investitionskostenCent: bigint
ausbildungsumlageCent: bigint
zusatzleistungenCent: bigint
pflegekasseCent: bigint
leistungszuschlagCent: bigint
renteCent: bigint
sonstigeEinkuenfteCent: bigint
sozialhilfeCent: bigint
eigenmittelCent: bigint
}
export type HeimkostenlageRoh = {
jahr: number
monat: number
gesamtkostenCent: bigint
deckungCent: bigint
deckungsluecke: bigint
}
/**
* Deckungsluecke = Kostenseite minus Deckungsseite, genau nach der
* Gruppierung im Schema. Bleibt etwas uebrig, muss es jemand zahlen - das
* ist die Zahl, mit der ich beim Bezirk vorstellig werde.
*/
export function heimkostenlageBerechnen(monat: HeimkostenmonatRoh): HeimkostenlageRoh {
const gesamtkostenCent =
monat.pflegeEigenanteilCent +
monat.unterkunftVerpflegungCent +
monat.investitionskostenCent +
monat.ausbildungsumlageCent +
monat.zusatzleistungenCent
const deckungCent =
monat.pflegekasseCent +
monat.leistungszuschlagCent +
monat.renteCent +
monat.sonstigeEinkuenfteCent +
monat.sozialhilfeCent +
monat.eigenmittelCent
return {
jahr: monat.jahr,
monat: monat.monat,
gesamtkostenCent,
deckungCent,
deckungsluecke: gesamtkostenCent - deckungCent,
}
}
export const MONATSNAMEN = [
'Januar',
'Februar',
'März',
'April',
'Mai',
'Juni',
'Juli',
'August',
'September',
'Oktober',
'November',
'Dezember',
] as const
export function monatsname(monat: number): string {
return MONATSNAMEN[monat - 1] ?? String(monat)
}
+336
View File
@@ -0,0 +1,336 @@
import 'server-only'
import { startOfDay } from 'date-fns'
import type { Modul } from '@prisma/client'
import { centZuZahl, db, nichtGeloescht } from '@/lib/db'
import {
fristenEinordnen,
heimkostenlageBerechnen,
nachforderungenAuswerten,
tagAusDatenbank,
tageBisTag,
vermoegenBerechnen,
wartendeEinordnen,
type NachforderungRoh,
} from '@/lib/dashboard/bewertung'
import type {
BelegeDaten,
DashboardDaten,
FristenAmpelDaten,
KennzahlenDaten,
NachforderungenDaten,
PosteingangDaten,
WartetAufAndereDaten,
} from '@/lib/dashboard/typen'
/**
* Alles, was das Dashboard "Heute" braucht - in einem Rutsch.
*
* Die Abfragen laufen nebeneinander in einem Promise.all. Keine Schleife
* fragt je Datensatz nach; wo eine Beziehung gebraucht wird (juengster
* Wertstand je Vermoegensposten), holt Prisma sie in derselben Runde mit.
*
* Wer ein Modul nicht lesen darf, bekommt dafuer null zurueck statt
* leerer Listen - die Kachel entfaellt dann ganz, statt faelschlich "0"
* zu behaupten.
*/
/** Wie viele Zeilen zeigt eine Kachel hoechstens? Der Rest steht im Modul. */
const KACHEL_ZEILEN = 5
/** Sicherung gegen ausufernde Abfragen bei sehr langen Akten. */
const FRISTEN_MAX = 200
export type Lesepruefung = (modul: Modul) => boolean
export async function dashboardLaden(
betreute: { id: string; vorname: string; nachname: string },
darfLesen: Lesepruefung,
jetzt: Date = new Date(),
): Promise<DashboardDaten> {
const heute = startOfDay(jetzt)
const betreuteId = betreute.id
const darfFristen = darfLesen('FRISTEN')
const darfVorgaenge = darfLesen('VORGAENGE')
const darfSozialhilfe = darfLesen('SOZIALHILFE')
const darfDokumente = darfLesen('DOKUMENTE')
const darfFinanzen = darfLesen('FINANZEN')
const darfGesundheit = darfLesen('GESUNDHEIT')
const [
fristenRoh,
wartendRoh,
nachforderungenRoh,
posteingang,
posteingangAnzahl,
belegeOhneBuchung,
belegeOhneBuchungGesamt,
buchungenOhneBeleg,
buchungenOhneBelegGesamt,
postenRoh,
heimkostenRoh,
jahresberichtRoh,
] = await Promise.all([
// 1. Fristen - alle offenen, die Einordnung passiert danach im Speicher.
darfFristen
? db.frist.findMany({
where: { betreuteId, status: 'OFFEN', ...nichtGeloescht },
orderBy: { datum: 'asc' },
take: FRISTEN_MAX,
select: {
id: true,
titel: true,
datum: true,
typ: true,
rechtsgrundlage: true,
ausschlussfrist: true,
vorgangId: true,
},
})
: null,
// 2. Vorgaenge, bei denen jemand anderes am Zug ist.
darfVorgaenge
? db.vorgang.findMany({
where: { betreuteId, status: 'WARTET_AUF_DRITTE', ...nichtGeloescht },
orderBy: { letzterKontaktAm: 'asc' },
select: {
id: true,
titel: true,
kategorie: true,
gegenstelle: true,
aktenzeichen: true,
naechsterSchritt: true,
letzterKontaktAm: true,
erstelltAm: true,
},
})
: null,
// 3. Nachforderungen: alle Zeilen, damit "x von y" stimmt.
darfSozialhilfe
? db.nachforderung.findMany({
where: { antrag: { betreuteId, ...nichtGeloescht }, ...nichtGeloescht },
orderBy: [{ reihenfolge: 'asc' }, { erstelltAm: 'asc' }],
select: {
id: true,
bezeichnung: true,
status: true,
fristBis: true,
reihenfolge: true,
antragId: true,
antrag: { select: { traeger: true, aktenzeichen: true } },
},
})
: null,
// 4. Ungeprüfter Posteingang.
darfDokumente
? db.dokument.findMany({
where: { betreuteId, posteingangStatus: 'NEU', ...nichtGeloescht },
orderBy: [{ eingangAm: 'desc' }, { erstelltAm: 'desc' }],
take: KACHEL_ZEILEN,
select: { id: true, titel: true, art: true, absender: true, eingangAm: true },
})
: null,
darfDokumente
? db.dokument.count({
where: { betreuteId, posteingangStatus: 'NEU', ...nichtGeloescht },
})
: null,
// 5a. Rechnungen und Quittungen, an denen keine Buchung haengt.
darfDokumente && darfFinanzen
? db.dokument.findMany({
where: {
betreuteId,
art: { in: ['RECHNUNG', 'QUITTUNG'] },
belegFuer: { none: { geloeschtAm: null } },
...nichtGeloescht,
},
orderBy: [{ eingangAm: 'desc' }, { erstelltAm: 'desc' }],
take: KACHEL_ZEILEN,
select: { id: true, titel: true, art: true, eingangAm: true },
})
: null,
darfDokumente && darfFinanzen
? db.dokument.count({
where: {
betreuteId,
art: { in: ['RECHNUNG', 'QUITTUNG'] },
belegFuer: { none: { geloeschtAm: null } },
...nichtGeloescht,
},
})
: null,
// 5b. Buchungen ohne Beleg und ohne Begruendung - Belegzwang.
darfFinanzen
? db.buchung.findMany({
where: { betreuteId, belegId: null, belegFehltBegruendung: null, ...nichtGeloescht },
orderBy: { datum: 'desc' },
take: KACHEL_ZEILEN,
select: {
id: true,
datum: true,
betragCent: true,
richtung: true,
kategorie: true,
gegenstelle: true,
},
})
: null,
darfFinanzen
? db.buchung.count({
where: { betreuteId, belegId: null, belegFehltBegruendung: null, ...nichtGeloescht },
})
: null,
// 6a. Vermoegen: je Posten der juengste Wertstand.
darfFinanzen
? db.vermoegensposten.findMany({
where: { betreuteId, ...nichtGeloescht },
select: {
id: true,
art: true,
wertstaende: {
orderBy: { stichtag: 'desc' },
take: 1,
select: { stichtag: true, wertCent: true },
},
},
})
: null,
// 6b. Der zuletzt erfasste Heimkostenmonat.
darfGesundheit
? db.heimkostenmonat.findFirst({
where: { betreuteId },
orderBy: [{ jahr: 'desc' }, { monat: 'desc' }],
})
: null,
// 6c. Der naechste Jahresbericht.
darfFristen
? db.frist.findFirst({
where: {
betreuteId,
status: 'OFFEN',
systemSchluessel: { startsWith: 'jahresbericht-' },
...nichtGeloescht,
},
orderBy: { datum: 'asc' },
select: { id: true, titel: true, datum: true },
})
: null,
])
// --- Einordnen -----------------------------------------------------------
const fristen: FristenAmpelDaten | null = fristenRoh
? fristenEinordnen(fristenRoh, heute)
: null
const wartet: WartetAufAndereDaten | null = wartendRoh
? (() => {
const alle = wartendeEinordnen(wartendRoh, heute)
return { ...alle, eintraege: alle.eintraege.slice(0, KACHEL_ZEILEN) }
})()
: null
const nachforderungen: NachforderungenDaten | null = nachforderungenRoh
? nachforderungenAuswerten(
nachforderungenRoh.map<NachforderungRoh>((zeile) => ({
id: zeile.id,
bezeichnung: zeile.bezeichnung,
status: zeile.status,
fristBis: zeile.fristBis,
reihenfolge: zeile.reihenfolge,
antragId: zeile.antragId,
antragTraeger: zeile.antrag.traeger,
antragAktenzeichen: zeile.antrag.aktenzeichen,
})),
heute,
)
: null
const posteingangDaten: PosteingangDaten | null =
posteingang && posteingangAnzahl !== null
? {
anzahl: posteingangAnzahl,
neueste: posteingang.map((d) => ({
id: d.id,
titel: d.titel,
art: d.art,
absender: d.absender,
eingangAm: d.eingangAm ? tagAusDatenbank(d.eingangAm) : null,
})),
}
: null
const belege: BelegeDaten | null =
buchungenOhneBeleg && buchungenOhneBelegGesamt !== null
? {
belegeOhneBuchung: (belegeOhneBuchung ?? []).map((d) => ({
id: d.id,
titel: d.titel,
art: d.art,
eingangAm: d.eingangAm ? tagAusDatenbank(d.eingangAm) : null,
})),
belegeOhneBuchungGesamt: belegeOhneBuchungGesamt ?? 0,
buchungenOhneBeleg: buchungenOhneBeleg.map((b) => ({
id: b.id,
datum: tagAusDatenbank(b.datum),
betragCent: centZuZahl(b.betragCent) ?? 0,
richtung: b.richtung,
kategorie: b.kategorie,
gegenstelle: b.gegenstelle,
})),
buchungenOhneBelegGesamt,
}
: null
const vermoegenRoh = postenRoh ? vermoegenBerechnen(postenRoh) : null
const heimkosten = heimkostenRoh ? heimkostenlageBerechnen(heimkostenRoh) : null
const kennzahlen: KennzahlenDaten = {
vermoegen: vermoegenRoh
? {
stichtag: vermoegenRoh.stichtag,
aktivaCent: centZuZahl(vermoegenRoh.aktivaCent) ?? 0,
verbindlichkeitenCent: centZuZahl(vermoegenRoh.verbindlichkeitenCent) ?? 0,
nettoCent: centZuZahl(vermoegenRoh.nettoCent) ?? 0,
postenGesamt: vermoegenRoh.postenGesamt,
postenOhneWert: vermoegenRoh.postenOhneWert,
}
: null,
heimkosten: heimkosten
? {
jahr: heimkosten.jahr,
monat: heimkosten.monat,
gesamtkostenCent: centZuZahl(heimkosten.gesamtkostenCent) ?? 0,
deckungCent: centZuZahl(heimkosten.deckungCent) ?? 0,
deckungsluecke: centZuZahl(heimkosten.deckungsluecke) ?? 0,
}
: null,
jahresbericht: jahresberichtRoh
? {
id: jahresberichtRoh.id,
titel: jahresberichtRoh.titel,
datum: tagAusDatenbank(jahresberichtRoh.datum),
tage: tageBisTag(tagAusDatenbank(jahresberichtRoh.datum), heute),
}
: null,
}
return {
betreuteId,
name: `${betreute.vorname} ${betreute.nachname}`.trim(),
heute,
fristen,
wartet,
nachforderungen,
posteingang: posteingangDaten,
belege,
kennzahlen,
}
}
+209
View File
@@ -0,0 +1,209 @@
import type {
BuchungKategorie,
BuchungRichtung,
DokumentArt,
FristTyp,
NachforderungStatus,
VorgangKategorie,
} from '@prisma/client'
/**
* Die Form, in der das Dashboard seine Daten an die Kacheln reicht.
*
* Hier stehen bewusst keine BigInt mehr: Cent-Betraege sind bereits ueber
* centZuZahl() in Number gewandelt, damit die Kacheln die Werte auch an
* Client Components weitergeben koennen, ohne dass die Serialisierung
* bricht. Datumswerte sind auf den lokalen Tagesanfang normalisiert - ein
* @db.Date kommt als UTC-Mitternacht aus der Datenbank und wuerde sonst je
* nach Zeitzone einen Tag zu frueh oder zu spaet angezeigt.
*/
export type Ampelstufe = 'rot' | 'orange' | 'gelb' | 'gruen'
export const AMPEL_BESCHRIFTUNG: Record<Ampelstufe, string> = {
rot: 'überfällig',
orange: 'diese Woche fällig',
gelb: 'diesen Monat fällig',
gruen: 'im Plan',
}
// -----------------------------------------------------------------------------
// 1. Fristen-Ampel
// -----------------------------------------------------------------------------
export type FristEintrag = {
id: string
titel: string
datum: Date
typ: FristTyp
rechtsgrundlage: string | null
ausschlussfrist: boolean
vorgangId: string | null
/** Tage bis zum Termin. Negativ bedeutet: so viele Tage ueberfaellig. */
tage: number
stufe: Ampelstufe
}
export type FristenAmpelDaten = {
ueberfaellig: FristEintrag[]
dieseWoche: FristEintrag[]
diesenMonat: FristEintrag[]
/** Offene Fristen, die weiter in der Zukunft liegen. */
weitereOffen: number
/**
* Ausschlussfristen - unabhaengig davon, in welchem Topf sie liegen.
* Sie verfallen ersatzlos und bekommen deshalb eine eigene Warnung.
*/
ausschlussfristen: FristEintrag[]
gesamtOffen: number
}
// -----------------------------------------------------------------------------
// 2. Wartet auf andere
// -----------------------------------------------------------------------------
export type WartendEintrag = {
id: string
titel: string
kategorie: VorgangKategorie
gegenstelle: string | null
aktenzeichen: string | null
naechsterSchritt: string | null
letzterKontaktAm: Date | null
/** Tage seit dem letzten Kontakt - ersatzweise seit dem Anlegen. */
tageOhneRueckmeldung: number
/** Ab WARTEZEIT_DRINGEND_TAGE Tagen: sichtbar hervorheben. */
dringend: boolean
}
export type WartetAufAndereDaten = {
eintraege: WartendEintrag[]
gesamt: number
dringende: number
}
// -----------------------------------------------------------------------------
// 3. Nachforderungen des Bezirks
// -----------------------------------------------------------------------------
export type NachforderungEintrag = {
id: string
bezeichnung: string
status: NachforderungStatus
fristBis: Date | null
/** Tage bis zur gesetzten Frist, negativ = ueberschritten. */
tageBisFrist: number | null
}
export type NachforderungenDaten = {
antragId: string | null
traeger: string | null
aktenzeichen: string | null
gesamt: number
/** Uebersandt, anerkannt oder mit Begruendung als nicht vorhanden gemeldet. */
erledigt: number
offen: NachforderungEintrag[]
/** Wie viele davon haben eine bereits abgelaufene Frist? */
ueberfaellig: number
}
// -----------------------------------------------------------------------------
// 4. Ungeprüfter Posteingang
// -----------------------------------------------------------------------------
export type PosteingangEintrag = {
id: string
titel: string
art: DokumentArt
absender: string | null
eingangAm: Date | null
}
export type PosteingangDaten = {
anzahl: number
neueste: PosteingangEintrag[]
}
// -----------------------------------------------------------------------------
// 5. Unverbuchte Belege
// -----------------------------------------------------------------------------
export type BelegOhneBuchung = {
id: string
titel: string
art: DokumentArt
eingangAm: Date | null
}
export type BuchungOhneBeleg = {
id: string
datum: Date
betragCent: number
richtung: BuchungRichtung
kategorie: BuchungKategorie
gegenstelle: string | null
}
export type BelegeDaten = {
belegeOhneBuchung: BelegOhneBuchung[]
belegeOhneBuchungGesamt: number
buchungenOhneBeleg: BuchungOhneBeleg[]
buchungenOhneBelegGesamt: number
}
// -----------------------------------------------------------------------------
// 6. Kennzahlen
// -----------------------------------------------------------------------------
export type Vermoegenslage = {
/** Juengster Stichtag, aus dem sich die Summe speist. */
stichtag: Date | null
aktivaCent: number
verbindlichkeitenCent: number
nettoCent: number
postenGesamt: number
/** Posten ohne einen einzigen Wertstand - die fehlen in der Summe. */
postenOhneWert: number
}
export type Heimkostenlage = {
jahr: number
monat: number
gesamtkostenCent: number
deckungCent: number
/** Positiv = ungedeckt, negativ = Ueberdeckung. */
deckungsluecke: number
}
export type Berichtslage = {
id: string
titel: string
datum: Date
tage: number
}
export type KennzahlenDaten = {
vermoegen: Vermoegenslage | null
heimkosten: Heimkostenlage | null
jahresbericht: Berichtslage | null
}
// -----------------------------------------------------------------------------
// Das Ganze
// -----------------------------------------------------------------------------
/**
* Ein Feld ist null, wenn der angemeldete Benutzer das zugehoerige Modul
* nicht lesen darf. Die Kachel entfaellt dann ganz - sie zeigt nicht "0".
*/
export type DashboardDaten = {
betreuteId: string
name: string
heute: Date
fristen: FristenAmpelDaten | null
wartet: WartetAufAndereDaten | null
nachforderungen: NachforderungenDaten | null
posteingang: PosteingangDaten | null
belege: BelegeDaten | null
kennzahlen: KennzahlenDaten
}