feat: Dashboard Heute, Kontakte und Kontaktprotokoll
Das Dashboard beantwortet die Frage, was heute ansteht - nicht, welche Daten es gibt. Jede Kachel endet in einer Handlung: Fristen-Ampel, wartet auf andere (mit Tagen seit dem letzten Kontakt), offene Nachforderungen des Bezirks mit Fortschrittsbalken, ungepruefter Posteingang, unverbuchte Belege, Kennzahlen. Zwoelf Abfragen in einem Promise.all, kein N+1. Cent-Betraege werden beim Verlassen der Serverseite gewandelt. Kacheln zu Modulen, die ein Mitleser nicht freigegeben bekommen hat, entfallen ganz - sie zeigen nicht "0", denn das waere eine Aussage ueber Daten, die er nicht sehen darf. Kontaktprotokoll als Schnellerfassung: Datum vorbelegt, Art als grosse Knopfreihe, Dauer als Schnellwahl, ein Freitextfeld. Alles andere eingeklappt. Ziel sind unter 20 Sekunden am Handy. Das Haekchen "persoenlicher Kontakt zur betreuten Person" ist bewusst NICHT vorbelegt - es wandert in den Jahresbericht nach § 1863 BGB, und ein versehentlich gesetztes Haekchen waere dort eine falsche Angabe gegenueber dem Gericht. Aus demselben Grund gilt der Textbaustein "regelmaessiger persoenlicher Kontakt" erst ab persoenlichem Kontakt in mindestens 75 Prozent der Monate. Sonst schreibt die Auswertung ausdruecklich, dass kein persoenlicher Kontakt dokumentiert ist. Ein geschoenter Bericht hilft niemandem. Protokolldaten werden als 12:00 UTC gespeichert und durchgaengig in UTC gerechnet, sonst kippt die Zeitzone einzelne Besuchstage. 51 Tests. Etappe: 2 Phase: Alltag
This commit is contained in:
Florian Wilde
@@ -0,0 +1,358 @@
|
||||
import { describe, expect, it } from 'vitest'
|
||||
import {
|
||||
fristLage,
|
||||
fristStufe,
|
||||
fristenEinordnen,
|
||||
heimkostenlageBerechnen,
|
||||
nachforderungenAuswerten,
|
||||
tagAusDatenbank,
|
||||
vermoegenBerechnen,
|
||||
verfallwarnung,
|
||||
wartendeEinordnen,
|
||||
WARTEZEIT_DRINGEND_TAGE,
|
||||
type FristRoh,
|
||||
type HeimkostenmonatRoh,
|
||||
type NachforderungRoh,
|
||||
type PostenRoh,
|
||||
type WartendRoh,
|
||||
} from '@/lib/dashboard/bewertung'
|
||||
|
||||
/**
|
||||
* Das Dashboard entscheidet, was heute dringend ist. Diese Tests
|
||||
* beschreiben, was fachlich gelten soll - nicht, welche Funktion gerufen
|
||||
* wird.
|
||||
*/
|
||||
|
||||
/** Mittwoch, 19.08.2026. Die Woche endet am Sonntag, dem 23.08. */
|
||||
const HEUTE = new Date(2026, 7, 19)
|
||||
|
||||
/** Ein @db.Date kommt als UTC-Mitternacht aus der Datenbank. */
|
||||
function dbTag(text: string): Date {
|
||||
return new Date(`${text}T00:00:00.000Z`)
|
||||
}
|
||||
|
||||
function frist(teil: Partial<FristRoh> & { datum: Date }): FristRoh {
|
||||
return {
|
||||
id: 'f1',
|
||||
titel: 'Irgendeine Frist',
|
||||
typ: 'GESETZLICH',
|
||||
rechtsgrundlage: null,
|
||||
ausschlussfrist: false,
|
||||
vorgangId: null,
|
||||
...teil,
|
||||
}
|
||||
}
|
||||
|
||||
describe('Fristen-Ampel', () => {
|
||||
it('meldet ein Datum in der Vergangenheit als überfällig', () => {
|
||||
expect(fristStufe(dbTag('2026-08-10'), HEUTE)).toBe('rot')
|
||||
})
|
||||
|
||||
it('färbt orange, was bis zum Sonntag dieser Woche fällig wird', () => {
|
||||
expect(fristStufe(dbTag('2026-08-19'), HEUTE)).toBe('orange')
|
||||
expect(fristStufe(dbTag('2026-08-23'), HEUTE)).toBe('orange')
|
||||
})
|
||||
|
||||
it('färbt gelb, was noch in diesem Monat fällig wird', () => {
|
||||
expect(fristStufe(dbTag('2026-08-24'), HEUTE)).toBe('gelb')
|
||||
expect(fristStufe(dbTag('2026-08-31'), HEUTE)).toBe('gelb')
|
||||
})
|
||||
|
||||
it('lässt alles Spätere grün', () => {
|
||||
expect(fristStufe(dbTag('2026-09-01'), HEUTE)).toBe('gruen')
|
||||
})
|
||||
|
||||
it('stellt überfällige Fristen nach oben und nennt die Tage', () => {
|
||||
const daten = fristenEinordnen(
|
||||
[
|
||||
frist({ id: 'kommend', datum: dbTag('2026-08-28') }),
|
||||
frist({ id: 'alt', datum: dbTag('2026-07-30') }),
|
||||
frist({ id: 'aeltest', datum: dbTag('2026-06-01') }),
|
||||
],
|
||||
HEUTE,
|
||||
)
|
||||
|
||||
expect(daten.ueberfaellig.map((e) => e.id)).toEqual(['aeltest', 'alt'])
|
||||
expect(daten.ueberfaellig[0]?.tage).toBe(-79)
|
||||
expect(daten.diesenMonat.map((e) => e.id)).toEqual(['kommend'])
|
||||
})
|
||||
|
||||
it('zählt Fristen jenseits des Monats gesondert, statt sie zu verschweigen', () => {
|
||||
const daten = fristenEinordnen(
|
||||
[frist({ id: 'spaet', datum: dbTag('2027-03-01') })],
|
||||
HEUTE,
|
||||
)
|
||||
expect(daten.weitereOffen).toBe(1)
|
||||
expect(daten.gesamtOffen).toBe(1)
|
||||
expect(daten.ueberfaellig).toHaveLength(0)
|
||||
})
|
||||
|
||||
it('hebt Ausschlussfristen unabhängig vom Fälligkeitstopf hervor', () => {
|
||||
const daten = fristenEinordnen(
|
||||
[
|
||||
frist({ id: 'normal', datum: dbTag('2026-08-20') }),
|
||||
frist({
|
||||
id: 'pauschale',
|
||||
titel: 'Aufwandspauschale 2026',
|
||||
datum: dbTag('2026-12-31'),
|
||||
ausschlussfrist: true,
|
||||
rechtsgrundlage: '§ 1878 BGB',
|
||||
}),
|
||||
],
|
||||
HEUTE,
|
||||
)
|
||||
|
||||
expect(daten.ausschlussfristen.map((e) => e.id)).toEqual(['pauschale'])
|
||||
})
|
||||
|
||||
it('warnt bei einer Ausschlussfrist ausdrücklich vor dem ersatzlosen Verfall', () => {
|
||||
const text = verfallwarnung({ tage: 12, rechtsgrundlage: '§ 1878 BGB' })
|
||||
expect(text).toContain('§ 1878 BGB')
|
||||
expect(text).toContain('ersatzlos weg')
|
||||
})
|
||||
|
||||
it('sagt bei einer abgelaufenen Ausschlussfrist, wie lange sie schon abgelaufen ist', () => {
|
||||
const text = verfallwarnung({ tage: -3, rechtsgrundlage: null })
|
||||
expect(text).toContain('seit 3 Tagen abgelaufen')
|
||||
expect(text).toContain('ersatzlos weg')
|
||||
})
|
||||
|
||||
it('schreibt die Lage in Worten, damit Farbe nie die einzige Information ist', () => {
|
||||
expect(fristLage(-5)).toBe('seit 5 Tagen überfällig')
|
||||
expect(fristLage(-1)).toBe('seit gestern überfällig')
|
||||
expect(fristLage(0)).toBe('heute fällig')
|
||||
expect(fristLage(1)).toBe('morgen fällig')
|
||||
expect(fristLage(9)).toBe('in 9 Tagen fällig')
|
||||
})
|
||||
|
||||
it('verschiebt ein Datum ohne Uhrzeit nicht über die Zeitzone hinweg', () => {
|
||||
const tag = tagAusDatenbank(dbTag('2026-08-31'))
|
||||
expect(tag.getDate()).toBe(31)
|
||||
expect(tag.getMonth()).toBe(7)
|
||||
})
|
||||
})
|
||||
|
||||
describe('Wartet auf andere', () => {
|
||||
function vorgang(teil: Partial<WartendRoh>): WartendRoh {
|
||||
return {
|
||||
id: 'v1',
|
||||
titel: 'Antrag Hilfe zur Pflege',
|
||||
kategorie: 'SOZIALHILFE',
|
||||
gegenstelle: 'Bezirk Oberfranken',
|
||||
aktenzeichen: null,
|
||||
naechsterSchritt: null,
|
||||
letzterKontaktAm: null,
|
||||
erstelltAm: new Date(2026, 7, 1),
|
||||
...teil,
|
||||
}
|
||||
}
|
||||
|
||||
it('sortiert die längste Wartezeit nach oben', () => {
|
||||
const daten = wartendeEinordnen(
|
||||
[
|
||||
vorgang({ id: 'kurz', letzterKontaktAm: dbTag('2026-08-15') }),
|
||||
vorgang({ id: 'lang', letzterKontaktAm: dbTag('2026-06-01') }),
|
||||
],
|
||||
HEUTE,
|
||||
)
|
||||
expect(daten.eintraege.map((e) => e.id)).toEqual(['lang', 'kurz'])
|
||||
expect(daten.eintraege[0]?.tageOhneRueckmeldung).toBe(79)
|
||||
})
|
||||
|
||||
it(`hebt ab ${WARTEZEIT_DRINGEND_TAGE} Tagen ohne Rückmeldung hervor`, () => {
|
||||
const grenze = wartendeEinordnen(
|
||||
[vorgang({ letzterKontaktAm: dbTag('2026-07-29') })], // genau 21 Tage
|
||||
HEUTE,
|
||||
)
|
||||
expect(grenze.eintraege[0]?.tageOhneRueckmeldung).toBe(WARTEZEIT_DRINGEND_TAGE)
|
||||
expect(grenze.eintraege[0]?.dringend).toBe(true)
|
||||
expect(grenze.dringende).toBe(1)
|
||||
|
||||
const knapp = wartendeEinordnen([vorgang({ letzterKontaktAm: dbTag('2026-07-30') })], HEUTE)
|
||||
expect(knapp.eintraege[0]?.dringend).toBe(false)
|
||||
})
|
||||
|
||||
it('rechnet ab dem Anlegen, wenn nie ein Kontakt vermerkt wurde', () => {
|
||||
const daten = wartendeEinordnen([vorgang({ letzterKontaktAm: null })], HEUTE)
|
||||
expect(daten.eintraege[0]?.tageOhneRueckmeldung).toBe(18)
|
||||
expect(daten.eintraege[0]?.letzterKontaktAm).toBeNull()
|
||||
})
|
||||
})
|
||||
|
||||
describe('Nachforderungen des Trägers', () => {
|
||||
function zeile(teil: Partial<NachforderungRoh>): NachforderungRoh {
|
||||
return {
|
||||
id: 'n1',
|
||||
bezeichnung: 'Kontoauszüge der letzten 12 Monate',
|
||||
status: 'OFFEN',
|
||||
fristBis: null,
|
||||
reihenfolge: 0,
|
||||
antragId: 'a1',
|
||||
antragTraeger: 'Bezirk Oberfranken',
|
||||
antragAktenzeichen: 'HzP 12345',
|
||||
...teil,
|
||||
}
|
||||
}
|
||||
|
||||
it('zählt übersandte, anerkannte und begründet fehlende Unterlagen als erledigt', () => {
|
||||
const daten = nachforderungenAuswerten(
|
||||
[
|
||||
zeile({ id: '1', status: 'UEBERSANDT' }),
|
||||
zeile({ id: '2', status: 'ANERKANNT' }),
|
||||
zeile({ id: '3', status: 'NICHT_VORHANDEN' }),
|
||||
zeile({ id: '4', status: 'OFFEN' }),
|
||||
zeile({ id: '5', status: 'IN_BESCHAFFUNG' }),
|
||||
],
|
||||
HEUTE,
|
||||
)
|
||||
|
||||
expect(daten.gesamt).toBe(5)
|
||||
expect(daten.erledigt).toBe(3)
|
||||
expect(daten.offen.map((o) => o.id)).toEqual(['4', '5'])
|
||||
})
|
||||
|
||||
it('reiht die dringendste Frist zuoberst und meldet abgelaufene gesondert', () => {
|
||||
const daten = nachforderungenAuswerten(
|
||||
[
|
||||
zeile({ id: 'ohne', fristBis: null }),
|
||||
zeile({ id: 'spaet', fristBis: dbTag('2026-09-30') }),
|
||||
zeile({ id: 'abgelaufen', fristBis: dbTag('2026-08-10') }),
|
||||
],
|
||||
HEUTE,
|
||||
)
|
||||
|
||||
expect(daten.offen.map((o) => o.id)).toEqual(['abgelaufen', 'spaet', 'ohne'])
|
||||
expect(daten.offen[0]?.tageBisFrist).toBe(-9)
|
||||
expect(daten.ueberfaellig).toBe(1)
|
||||
})
|
||||
|
||||
it('nimmt Träger und Aktenzeichen aus dem Antrag mit', () => {
|
||||
const daten = nachforderungenAuswerten([zeile({})], HEUTE)
|
||||
expect(daten.traeger).toBe('Bezirk Oberfranken')
|
||||
expect(daten.aktenzeichen).toBe('HzP 12345')
|
||||
expect(daten.antragId).toBe('a1')
|
||||
})
|
||||
|
||||
it('kommt mit einer leeren Liste zurecht', () => {
|
||||
const daten = nachforderungenAuswerten([], HEUTE)
|
||||
expect(daten.gesamt).toBe(0)
|
||||
expect(daten.traeger).toBeNull()
|
||||
})
|
||||
})
|
||||
|
||||
describe('Vermögen zum letzten Stichtag', () => {
|
||||
function posten(teil: Partial<PostenRoh>): PostenRoh {
|
||||
return { id: 'p1', art: 'KONTO', wertstaende: [], ...teil }
|
||||
}
|
||||
|
||||
it('nimmt je Posten den jüngsten Wertstand und zieht Verbindlichkeiten ab', () => {
|
||||
const lage = vermoegenBerechnen([
|
||||
posten({
|
||||
id: 'giro',
|
||||
art: 'KONTO',
|
||||
wertstaende: [
|
||||
{ stichtag: dbTag('2026-01-01'), wertCent: 100_000n },
|
||||
{ stichtag: dbTag('2026-07-01'), wertCent: 250_000n },
|
||||
],
|
||||
}),
|
||||
posten({
|
||||
id: 'lebensversicherung',
|
||||
art: 'VERSICHERUNG',
|
||||
wertstaende: [{ stichtag: dbTag('2026-06-01'), wertCent: 1_248_000n }],
|
||||
}),
|
||||
posten({
|
||||
id: 'heimrechnung',
|
||||
art: 'VERBINDLICHKEIT',
|
||||
wertstaende: [{ stichtag: dbTag('2026-07-01'), wertCent: 340_000n }],
|
||||
}),
|
||||
])
|
||||
|
||||
expect(lage.aktivaCent).toBe(1_498_000n)
|
||||
expect(lage.verbindlichkeitenCent).toBe(340_000n)
|
||||
expect(lage.nettoCent).toBe(1_158_000n)
|
||||
})
|
||||
|
||||
it('weist den jüngsten tatsächlich verwendeten Stichtag aus', () => {
|
||||
const lage = vermoegenBerechnen([
|
||||
posten({
|
||||
wertstaende: [
|
||||
{ stichtag: dbTag('2026-03-15'), wertCent: 1n },
|
||||
{ stichtag: dbTag('2026-05-20'), wertCent: 2n },
|
||||
],
|
||||
}),
|
||||
])
|
||||
expect(lage.stichtag?.getDate()).toBe(20)
|
||||
expect(lage.stichtag?.getMonth()).toBe(4)
|
||||
})
|
||||
|
||||
it('zählt Posten ohne Wert gesondert, statt sie stillschweigend als 0 zu führen', () => {
|
||||
const lage = vermoegenBerechnen([
|
||||
posten({ id: 'a', wertstaende: [{ stichtag: dbTag('2026-05-01'), wertCent: 500n }] }),
|
||||
posten({ id: 'b', wertstaende: [] }),
|
||||
posten({ id: 'c', wertstaende: [] }),
|
||||
])
|
||||
|
||||
expect(lage.postenGesamt).toBe(3)
|
||||
expect(lage.postenOhneWert).toBe(2)
|
||||
expect(lage.nettoCent).toBe(500n)
|
||||
})
|
||||
|
||||
it('liefert bei einer frischen Installation keinen Stichtag', () => {
|
||||
const lage = vermoegenBerechnen([])
|
||||
expect(lage.stichtag).toBeNull()
|
||||
expect(lage.nettoCent).toBe(0n)
|
||||
})
|
||||
})
|
||||
|
||||
describe('Heimkosten und Deckungslücke', () => {
|
||||
function monat(teil: Partial<HeimkostenmonatRoh>): HeimkostenmonatRoh {
|
||||
return {
|
||||
jahr: 2026,
|
||||
monat: 7,
|
||||
pflegeEigenanteilCent: 0n,
|
||||
unterkunftVerpflegungCent: 0n,
|
||||
investitionskostenCent: 0n,
|
||||
ausbildungsumlageCent: 0n,
|
||||
zusatzleistungenCent: 0n,
|
||||
pflegekasseCent: 0n,
|
||||
leistungszuschlagCent: 0n,
|
||||
renteCent: 0n,
|
||||
sonstigeEinkuenfteCent: 0n,
|
||||
sozialhilfeCent: 0n,
|
||||
eigenmittelCent: 0n,
|
||||
...teil,
|
||||
}
|
||||
}
|
||||
|
||||
it('stellt die Kostenseite der Deckungsseite gegenüber', () => {
|
||||
const lage = heimkostenlageBerechnen(
|
||||
monat({
|
||||
pflegeEigenanteilCent: 130_000n,
|
||||
unterkunftVerpflegungCent: 95_000n,
|
||||
investitionskostenCent: 45_000n,
|
||||
ausbildungsumlageCent: 5_000n,
|
||||
renteCent: 120_000n,
|
||||
sozialhilfeCent: 100_000n,
|
||||
}),
|
||||
)
|
||||
|
||||
expect(lage.gesamtkostenCent).toBe(275_000n)
|
||||
expect(lage.deckungCent).toBe(220_000n)
|
||||
expect(lage.deckungsluecke).toBe(55_000n)
|
||||
})
|
||||
|
||||
it('weist eine Überdeckung als negative Lücke aus', () => {
|
||||
const lage = heimkostenlageBerechnen(
|
||||
monat({ unterkunftVerpflegungCent: 100_000n, renteCent: 150_000n }),
|
||||
)
|
||||
expect(lage.deckungsluecke).toBe(-50_000n)
|
||||
})
|
||||
|
||||
it('rechnet in Cent und nicht in Fließkomma', () => {
|
||||
const lage = heimkostenlageBerechnen(
|
||||
monat({ pflegeEigenanteilCent: 1n, renteCent: 0n }),
|
||||
)
|
||||
expect(typeof lage.deckungsluecke).toBe('bigint')
|
||||
expect(lage.deckungsluecke).toBe(1n)
|
||||
})
|
||||
})
|
||||
@@ -0,0 +1,315 @@
|
||||
import { describe, expect, it } from 'vitest'
|
||||
import {
|
||||
KontaktSchema,
|
||||
KontaktprotokollSchema,
|
||||
kontaktFormularLesen,
|
||||
protokollFormularLesen,
|
||||
tagFuerFormular,
|
||||
} from '@/lib/validierung/kontakte'
|
||||
import {
|
||||
dauerAusgeschrieben,
|
||||
statistikBerechnen,
|
||||
textbausteinErzeugen,
|
||||
textkontextAusAnrede,
|
||||
type ProtokollFuerStatistik,
|
||||
} from '@/lib/kontakte/statistik'
|
||||
|
||||
/**
|
||||
* Kontakte und Kontaktprotokoll. Die Protokolle sind die Grundlage des
|
||||
* Jahresberichts nach § 1863 BGB - was hier falsch gezaehlt wird, steht
|
||||
* spaeter falsch im Bericht ans Betreuungsgericht.
|
||||
*/
|
||||
|
||||
function formular(werte: Record<string, string>): FormData {
|
||||
const daten = new FormData()
|
||||
for (const [name, wert] of Object.entries(werte)) daten.set(name, wert)
|
||||
return daten
|
||||
}
|
||||
|
||||
/** Ein Protokollzeitstempel liegt zur Mittagszeit in UTC. */
|
||||
function tag(text: string): Date {
|
||||
return new Date(`${text}T12:00:00.000Z`)
|
||||
}
|
||||
|
||||
describe('Kontakt erfassen', () => {
|
||||
it('braucht einen Namen und eine Rolle, alles andere ist freiwillig', () => {
|
||||
const ergebnis = KontaktSchema.safeParse({ name: 'Frau Krämer', rolle: 'RECHTSPFLEGER' })
|
||||
expect(ergebnis.success).toBe(true)
|
||||
if (ergebnis.success) {
|
||||
expect(ergebnis.data.name).toBe('Frau Krämer')
|
||||
expect(ergebnis.data.telefon).toBeNull()
|
||||
}
|
||||
})
|
||||
|
||||
it('weist einen fehlenden Namen mit einer verständlichen Meldung ab', () => {
|
||||
const ergebnis = KontaktSchema.safeParse({ name: ' ', rolle: 'HEIMLEITUNG' })
|
||||
expect(ergebnis.success).toBe(false)
|
||||
if (!ergebnis.success) {
|
||||
expect(ergebnis.error.flatten().fieldErrors.name?.[0]).toContain('Namen angeben')
|
||||
}
|
||||
})
|
||||
|
||||
it('macht aus leeren Feldern NULL, nicht aus Versehen einen leeren Text', () => {
|
||||
const ergebnis = KontaktSchema.parse({
|
||||
name: 'Amtsgericht Bayreuth',
|
||||
rolle: 'RECHTSPFLEGER',
|
||||
organisation: '',
|
||||
telefon: '',
|
||||
aktenzeichen: '',
|
||||
})
|
||||
expect(ergebnis.organisation).toBeNull()
|
||||
expect(ergebnis.telefon).toBeNull()
|
||||
expect(ergebnis.aktenzeichen).toBeNull()
|
||||
})
|
||||
|
||||
it('lässt das E-Mail-Feld leer, akzeptiert aber keine kaputte Adresse', () => {
|
||||
expect(KontaktSchema.safeParse({ name: 'Dr. Weber', rolle: 'HAUSARZT', email: '' }).success).toBe(
|
||||
true,
|
||||
)
|
||||
|
||||
const kaputt = KontaktSchema.safeParse({
|
||||
name: 'Dr. Weber',
|
||||
rolle: 'HAUSARZT',
|
||||
email: 'weber(at)praxis.de',
|
||||
})
|
||||
expect(kaputt.success).toBe(false)
|
||||
})
|
||||
|
||||
it('schreibt E-Mail-Adressen klein und schneidet Leerzeichen ab', () => {
|
||||
const ergebnis = KontaktSchema.parse({
|
||||
name: 'Bezirk Oberfranken',
|
||||
rolle: 'SACHBEARBEITER_BEZIRK',
|
||||
email: ' Sachbearbeitung@Bezirk-Oberfranken.DE ',
|
||||
})
|
||||
expect(ergebnis.email).toBe('sachbearbeitung@bezirk-oberfranken.de')
|
||||
})
|
||||
|
||||
it('nimmt eine unbekannte Rolle nicht an', () => {
|
||||
expect(KontaktSchema.safeParse({ name: 'X', rolle: 'HAUSMEISTER' }).success).toBe(false)
|
||||
})
|
||||
|
||||
it('liest ein Formular vollständig ein', () => {
|
||||
const roh = kontaktFormularLesen(
|
||||
formular({ name: 'Frau Krämer', rolle: 'RECHTSPFLEGER', telefon: '0921 504-0' }),
|
||||
)
|
||||
const ergebnis = KontaktSchema.parse(roh)
|
||||
expect(ergebnis.telefon).toBe('0921 504-0')
|
||||
})
|
||||
})
|
||||
|
||||
describe('Kontaktprotokoll erfassen', () => {
|
||||
const grundgeruest = { datum: '2026-08-19', art: 'BESUCH' }
|
||||
|
||||
it('kommt mit Datum und Art aus – das ist die Schnellerfassung', () => {
|
||||
const ergebnis = KontaktprotokollSchema.safeParse(grundgeruest)
|
||||
expect(ergebnis.success).toBe(true)
|
||||
if (ergebnis.success) {
|
||||
expect(ergebnis.data.dauerMinuten).toBeNull()
|
||||
expect(ergebnis.data.mitBetreuter).toBe(false)
|
||||
expect(ergebnis.data.inhalt).toBeNull()
|
||||
}
|
||||
})
|
||||
|
||||
it('legt das Datum auf die Mittagszeit, damit keine Zeitzone den Tag kippt', () => {
|
||||
const ergebnis = KontaktprotokollSchema.parse(grundgeruest)
|
||||
expect(ergebnis.datum.toISOString()).toBe('2026-08-19T12:00:00.000Z')
|
||||
expect(tagFuerFormular(ergebnis.datum)).toBe('2026-08-19')
|
||||
})
|
||||
|
||||
it('besteht auf einem Datum', () => {
|
||||
const ergebnis = KontaktprotokollSchema.safeParse({ datum: '', art: 'TELEFONAT' })
|
||||
expect(ergebnis.success).toBe(false)
|
||||
if (!ergebnis.success) {
|
||||
expect(ergebnis.error.flatten().fieldErrors.datum?.[0]).toContain('Datum')
|
||||
}
|
||||
})
|
||||
|
||||
it('nimmt die Dauer als Zahl an und lässt sie auch weg', () => {
|
||||
expect(KontaktprotokollSchema.parse({ ...grundgeruest, dauerMinuten: '45' }).dauerMinuten).toBe(
|
||||
45,
|
||||
)
|
||||
expect(KontaktprotokollSchema.parse({ ...grundgeruest, dauerMinuten: '' }).dauerMinuten).toBeNull()
|
||||
})
|
||||
|
||||
it('weist eine unsinnige Dauer ab', () => {
|
||||
expect(
|
||||
KontaktprotokollSchema.safeParse({ ...grundgeruest, dauerMinuten: '-10' }).success,
|
||||
).toBe(false)
|
||||
expect(
|
||||
KontaktprotokollSchema.safeParse({ ...grundgeruest, dauerMinuten: '2000' }).success,
|
||||
).toBe(false)
|
||||
expect(
|
||||
KontaktprotokollSchema.safeParse({ ...grundgeruest, dauerMinuten: 'lang' }).success,
|
||||
).toBe(false)
|
||||
})
|
||||
|
||||
it('übersetzt das Häkchen für den persönlichen Kontakt in einen Wahrheitswert', () => {
|
||||
const angehakt = protokollFormularLesen(
|
||||
formular({ datum: '2026-08-19', art: 'BESUCH', mitBetreuter: 'on' }),
|
||||
)
|
||||
expect(KontaktprotokollSchema.parse(angehakt).mitBetreuter).toBe(true)
|
||||
|
||||
const leer = protokollFormularLesen(formular({ datum: '2026-08-19', art: 'BESUCH' }))
|
||||
expect(KontaktprotokollSchema.parse(leer).mitBetreuter).toBe(false)
|
||||
})
|
||||
|
||||
it('behandelt eine nicht gewählte Verknüpfung als "keine"', () => {
|
||||
const roh = protokollFormularLesen(
|
||||
formular({ datum: '2026-08-19', art: 'BESUCH', kontaktId: '', vorgangId: '' }),
|
||||
)
|
||||
const ergebnis = KontaktprotokollSchema.parse(roh)
|
||||
expect(ergebnis.kontaktId).toBeNull()
|
||||
expect(ergebnis.vorgangId).toBeNull()
|
||||
})
|
||||
|
||||
it('nimmt eine Kontaktart, die es nicht gibt, nicht an', () => {
|
||||
expect(KontaktprotokollSchema.safeParse({ datum: '2026-08-19', art: 'TAUBENPOST' }).success).toBe(
|
||||
false,
|
||||
)
|
||||
})
|
||||
})
|
||||
|
||||
describe('Auswertung für den Jahresbericht', () => {
|
||||
const VON = new Date('2026-01-01T00:00:00.000Z')
|
||||
const BIS = new Date('2026-12-31T23:59:59.999Z')
|
||||
|
||||
function eintrag(teil: Partial<ProtokollFuerStatistik> & { datum: Date }): ProtokollFuerStatistik {
|
||||
return { art: 'BESUCH', dauerMinuten: null, mitBetreuter: false, ...teil }
|
||||
}
|
||||
|
||||
it('zählt die Kontakte je Monat und darunter die persönlichen', () => {
|
||||
const statistik = statistikBerechnen(
|
||||
[
|
||||
eintrag({ datum: tag('2026-01-12'), mitBetreuter: true }),
|
||||
eintrag({ datum: tag('2026-01-26'), art: 'TELEFONAT' }),
|
||||
eintrag({ datum: tag('2026-02-03'), mitBetreuter: true }),
|
||||
],
|
||||
VON,
|
||||
BIS,
|
||||
)
|
||||
|
||||
expect(statistik.jeMonat).toEqual([
|
||||
{ jahr: 2026, monat: 1, gesamt: 2, persoenlich: 1 },
|
||||
{ jahr: 2026, monat: 2, gesamt: 1, persoenlich: 1 },
|
||||
])
|
||||
expect(statistik.gesamt).toBe(3)
|
||||
expect(statistik.persoenlich).toBe(2)
|
||||
})
|
||||
|
||||
it('zählt zwei Besuche am selben Tag als einen Besuchstag', () => {
|
||||
const statistik = statistikBerechnen(
|
||||
[
|
||||
eintrag({ datum: tag('2026-03-04'), mitBetreuter: true }),
|
||||
eintrag({ datum: tag('2026-03-04'), mitBetreuter: true }),
|
||||
eintrag({ datum: tag('2026-03-05'), mitBetreuter: true }),
|
||||
],
|
||||
VON,
|
||||
BIS,
|
||||
)
|
||||
expect(statistik.persoenlich).toBe(3)
|
||||
expect(statistik.besuchstage).toBe(2)
|
||||
})
|
||||
|
||||
it('rechnet einen Anruf beim Bezirk nicht als persönlichen Kontakt zur Betreuten', () => {
|
||||
const statistik = statistikBerechnen(
|
||||
[eintrag({ datum: tag('2026-04-02'), art: 'TELEFONAT', mitBetreuter: false })],
|
||||
VON,
|
||||
BIS,
|
||||
)
|
||||
expect(statistik.telefonate).toBe(1)
|
||||
expect(statistik.persoenlich).toBe(0)
|
||||
expect(statistik.besuchstage).toBe(0)
|
||||
})
|
||||
|
||||
it('summiert nur die tatsächlich erfassten Dauern', () => {
|
||||
const statistik = statistikBerechnen(
|
||||
[
|
||||
eintrag({ datum: tag('2026-05-02'), dauerMinuten: 45 }),
|
||||
eintrag({ datum: tag('2026-05-09'), dauerMinuten: 90 }),
|
||||
eintrag({ datum: tag('2026-05-16'), dauerMinuten: null }),
|
||||
],
|
||||
VON,
|
||||
BIS,
|
||||
)
|
||||
expect(statistik.gesamtdauerMinuten).toBe(135)
|
||||
expect(statistik.mitDauerErfasst).toBe(2)
|
||||
expect(statistik.gesamt).toBe(3)
|
||||
})
|
||||
|
||||
it('zählt die Monate des Berichtszeitraums mit', () => {
|
||||
expect(statistikBerechnen([], VON, BIS).monateImZeitraum).toBe(12)
|
||||
expect(
|
||||
statistikBerechnen([], new Date('2026-03-01T00:00:00Z'), new Date('2026-05-31T00:00:00Z'))
|
||||
.monateImZeitraum,
|
||||
).toBe(3)
|
||||
})
|
||||
|
||||
it('schreibt einen Textbaustein in ganzen Sätzen mit Zeitraum und Zahlen', () => {
|
||||
const protokolle: ProtokollFuerStatistik[] = []
|
||||
// Ein Besuch je Monat, dazu zwei Telefonate.
|
||||
for (let monat = 1; monat <= 12; monat += 1) {
|
||||
const mm = String(monat).padStart(2, '0')
|
||||
protokolle.push(
|
||||
eintrag({ datum: tag(`2026-${mm}-10`), mitBetreuter: true, dauerMinuten: 60 }),
|
||||
)
|
||||
}
|
||||
protokolle.push(eintrag({ datum: tag('2026-03-20'), art: 'TELEFONAT' }))
|
||||
protokolle.push(eintrag({ datum: tag('2026-09-08'), art: 'TELEFONAT' }))
|
||||
|
||||
const statistik = statistikBerechnen(protokolle, VON, BIS)
|
||||
const text = textbausteinErzeugen(
|
||||
statistik,
|
||||
textkontextAusAnrede('Frau', 'Pflegeheim Sonnenhof'),
|
||||
)
|
||||
|
||||
expect(text).toContain('Im Berichtszeitraum vom 01.01.2026 bis 31.12.2026')
|
||||
expect(text).toContain('regelmäßiger persönlicher Kontakt zur Betreuten')
|
||||
expect(text).toContain('an 12 Tagen persönlich im Pflegeheim Sonnenhof besucht')
|
||||
expect(text).toContain('2 Telefonate')
|
||||
expect(text).toContain('12 Stunden')
|
||||
expect(text).toContain('12 von 12 Monaten')
|
||||
})
|
||||
|
||||
it('nennt es nicht "regelmäßig", wenn der Kontakt nur sporadisch war', () => {
|
||||
const statistik = statistikBerechnen(
|
||||
[
|
||||
eintrag({ datum: tag('2026-02-10'), mitBetreuter: true }),
|
||||
eintrag({ datum: tag('2026-08-14'), mitBetreuter: true }),
|
||||
],
|
||||
VON,
|
||||
BIS,
|
||||
)
|
||||
const text = textbausteinErzeugen(statistik)
|
||||
expect(text).toContain('bestand persönlicher Kontakt')
|
||||
expect(text).not.toContain('regelmäßiger')
|
||||
})
|
||||
|
||||
it('beschönigt nichts, wenn kein persönlicher Kontakt dokumentiert ist', () => {
|
||||
const statistik = statistikBerechnen(
|
||||
[eintrag({ datum: tag('2026-06-02'), art: 'BRIEF' })],
|
||||
VON,
|
||||
BIS,
|
||||
)
|
||||
const text = textbausteinErzeugen(statistik, textkontextAusAnrede('Herr', null))
|
||||
expect(text).toContain('kein persönlicher Kontakt zum Betreuten dokumentiert')
|
||||
})
|
||||
|
||||
it('sagt bei einem leeren Zeitraum, dass nachzutragen ist', () => {
|
||||
const text = textbausteinErzeugen(statistikBerechnen([], VON, BIS))
|
||||
expect(text).toContain('kein Kontakt dokumentiert')
|
||||
expect(text).toContain('nachzutragen')
|
||||
})
|
||||
|
||||
it('schreibt Dauern in Stunden und Minuten aus', () => {
|
||||
expect(dauerAusgeschrieben(45)).toBe('45 Minuten')
|
||||
expect(dauerAusgeschrieben(60)).toBe('1 Stunde')
|
||||
expect(dauerAusgeschrieben(135)).toBe('2 Stunden 15 Minuten')
|
||||
expect(dauerAusgeschrieben(0)).toBe('0 Minuten')
|
||||
})
|
||||
|
||||
it('wählt die Anrede passend zur betreuten Person', () => {
|
||||
expect(textkontextAusAnrede('Frau', null).kontaktZu).toBe('zur Betreuten')
|
||||
expect(textkontextAusAnrede('Herr', null).akkusativ).toBe('den Betreuten')
|
||||
expect(textkontextAusAnrede(null, null).kontaktZu).toBe('zur betreuten Person')
|
||||
})
|
||||
})
|
||||
Reference in New Issue
Block a user