docs: README, Datenschutztexte, Dockerfile und Sicherungsskripte
Damit ist Etappe 1 abgeschlossen und betriebsfertig dokumentiert. README mit beiden Betriebswegen. Docker Compose auf eigenem Server ist der Hauptweg; Vercel und Neon sind vollstaendig beschrieben, aber mit einer klaren Begruendung, warum ich davon abrate: beide Anbieter sind US-Unternehmen und unterliegen auch bei EU-Region potenziell dem CLOUD-Act. Bei Gesundheitsdaten einer nicht entscheidungsfaehigen Person ist das eine Abwaegung, die man bewusst treffen muss. Reverse-Proxy-Beispiele fuer Caddy, nginx und Traefik - der Proxy selbst ist nicht Teil des Compose-Setups, weil er auf dem Zielserver schon steht. Die Datenbank hat keine Portfreigabe. Sicherung: pg_dump schreibt direkt in die Verschluesselung, der Klartext landet nie auf der Platte. Danach eine Selbstpruefung - laesst sich die Datei nicht wieder entschluesseln, endet der Lauf mit Fehler statt mit einem stillen Scheinerfolg. Der jeweils erste Stand eines Monats bleibt dauerhaft stehen. Die README sagt ausdruecklich, was das Backup NICHT enthaelt: den Schluessel ENC_KEY_V1 und die Dateien im Objektspeicher. Dazu eine Anleitung, die Wiederherstellung einmal im Jahr zu ueben - mit dem letzten Schritt, in der Anwendung nachzusehen, ob die Diagnosen im Klartext erscheinen. Erst dann stimmt nicht nur die Datenbank, sondern auch der Schluessel. Verarbeitungsverzeichnis und Datenschutzhinweise als ausfuellbare Textbausteine. Die Hinweise sind in einfacher Sprache geschrieben - sie sollen der betreuten Person vorgelesen werden koennen. Die Seite /datenschutz liest denselben Text aus docs/, damit es nicht zwei Fassungen gibt, die auseinanderlaufen. Dockerfile in drei Stufen mit Tesseract, deutschen Sprachdaten und poppler-utils. Zeitzone Europe/Berlin ist gesetzt - ohne sie rechnet der Server in UTC und verschiebt Fristen um einen Tag. Etappe: 1 Phase: Fundament
This commit is contained in:
Florian Wilde
@@ -0,0 +1,223 @@
|
||||
import type { GesundheitsArt } from '@prisma/client'
|
||||
|
||||
/**
|
||||
* Strukturierte Zusatzangaben der Schnellerfassung.
|
||||
*
|
||||
* Das Schema kennt am Gesundheitsereignis nur Titel, Datum, bisDatum,
|
||||
* Behandler, Einrichtung, Abwesenheitstage und eine verschluesselte
|
||||
* Beschreibung. Die Details, die bei einer COPD wirklich interessieren -
|
||||
* Schweregrad einer Exazerbation, Sauerstofffluss, ob stationaer behandelt
|
||||
* wurde - haben kein eigenes Feld (siehe docs/schema-wuensche/substanz.md).
|
||||
*
|
||||
* Sie werden deshalb als beschriftete Zeilen in die Beschreibung
|
||||
* geschrieben, die ohnehin verschluesselt ist. Gesundheitsdaten sind
|
||||
* besondere Kategorien nach Art. 9 DSGVO; genau deshalb landen sie dort
|
||||
* und nicht in einem unverschluesselten Zusatzfeld.
|
||||
*
|
||||
* Das Format steht nur hier, damit es sich spaeter in echte Spalten
|
||||
* migrieren laesst.
|
||||
*/
|
||||
|
||||
export type Detailfeld = {
|
||||
name: string
|
||||
beschriftung: string
|
||||
erklaerung?: string
|
||||
typ: 'text' | 'zahl' | 'auswahl' | 'mehrzeilig' | 'jaNein'
|
||||
optionen?: readonly string[]
|
||||
einheit?: string
|
||||
pflicht?: boolean
|
||||
}
|
||||
|
||||
/**
|
||||
* Welche Zusatzfelder gehoeren zu welcher Ereignisart? Bewusst wenige -
|
||||
* eine Schnellerfassung, die zwanzig Felder zeigt, wird nicht benutzt,
|
||||
* und dann steht am Jahresende gar nichts in der Akte.
|
||||
*/
|
||||
export const DETAILFELDER: Partial<Record<GesundheitsArt, readonly Detailfeld[]>> = {
|
||||
EXAZERBATION: [
|
||||
{
|
||||
name: 'schweregrad',
|
||||
beschriftung: 'Schweregrad',
|
||||
typ: 'auswahl',
|
||||
optionen: ['leicht', 'mittel', 'schwer'],
|
||||
erklaerung:
|
||||
'leicht = nur Bedarfsmedikation gesteigert, mittel = Antibiotikum oder Kortison, ' +
|
||||
'schwer = Krankenhausbehandlung nötig.',
|
||||
pflicht: true,
|
||||
},
|
||||
{
|
||||
name: 'ausloeser',
|
||||
beschriftung: 'Auslöser',
|
||||
typ: 'text',
|
||||
erklaerung: 'Zum Beispiel Atemwegsinfekt, Lungenentzündung, Kälte — oder „unklar“.',
|
||||
},
|
||||
{ name: 'behandlung', beschriftung: 'Behandlung', typ: 'mehrzeilig' },
|
||||
{
|
||||
name: 'stationaer',
|
||||
beschriftung: 'Stationär behandelt',
|
||||
typ: 'jaNein',
|
||||
erklaerung:
|
||||
'Wenn ja, leg zusätzlich einen Krankenhausaufenthalt an — nur dort werden ' +
|
||||
'die Abwesenheitstage gezählt.',
|
||||
},
|
||||
],
|
||||
SAUERSTOFFVERSORGUNG: [
|
||||
{ name: 'fluss', beschriftung: 'Fluss', typ: 'zahl', einheit: 'l/min' },
|
||||
{ name: 'stundenProTag', beschriftung: 'Anwendung', typ: 'zahl', einheit: 'Stunden/Tag' },
|
||||
{
|
||||
name: 'geraet',
|
||||
beschriftung: 'Gerät',
|
||||
typ: 'text',
|
||||
erklaerung: 'Konzentrator, Flüssigsauerstoff, mobile Flasche — mit Hersteller und Modell.',
|
||||
},
|
||||
{ name: 'versorger', beschriftung: 'Versorger / Lieferant', typ: 'text' },
|
||||
],
|
||||
KRANKENHAUS: [
|
||||
{ name: 'grund', beschriftung: 'Grund der Aufnahme', typ: 'mehrzeilig' },
|
||||
{ name: 'station', beschriftung: 'Station', typ: 'text' },
|
||||
{
|
||||
name: 'entlassbericht',
|
||||
beschriftung: 'Entlassbericht angefordert',
|
||||
typ: 'jaNein',
|
||||
erklaerung:
|
||||
'Der Entlassbericht ist das wichtigste Papier für eine spätere ' +
|
||||
'Höherstufung. Direkt anfordern, nicht darauf warten.',
|
||||
},
|
||||
],
|
||||
MEDIKATIONSAENDERUNG: [
|
||||
{ name: 'abgesetzt', beschriftung: 'Abgesetzt', typ: 'mehrzeilig' },
|
||||
{ name: 'neu', beschriftung: 'Neu angesetzt', typ: 'mehrzeilig' },
|
||||
{ name: 'veranlasstDurch', beschriftung: 'Veranlasst durch', typ: 'text' },
|
||||
],
|
||||
INHALATION: [
|
||||
{ name: 'praeparat', beschriftung: 'Präparat', typ: 'text' },
|
||||
{ name: 'haeufigkeit', beschriftung: 'Häufigkeit', typ: 'text' },
|
||||
{
|
||||
name: 'handhabung',
|
||||
beschriftung: 'Handhabung durch die Betreute',
|
||||
typ: 'auswahl',
|
||||
optionen: ['selbstständig', 'mit Anleitung', 'durch Pflegekraft'],
|
||||
},
|
||||
],
|
||||
STURZ: [
|
||||
{ name: 'ort', beschriftung: 'Ort des Sturzes', typ: 'text' },
|
||||
{ name: 'folgen', beschriftung: 'Verletzungen / Folgen', typ: 'mehrzeilig' },
|
||||
{
|
||||
name: 'sturzprotokoll',
|
||||
beschriftung: 'Sturzprotokoll des Heims vorhanden',
|
||||
typ: 'jaNein',
|
||||
erklaerung:
|
||||
'Die Einrichtung muss jeden Sturz protokollieren. Lass dir das Protokoll ' +
|
||||
'geben und lege es zur Akte.',
|
||||
},
|
||||
],
|
||||
HILFSMITTEL: [
|
||||
{ name: 'hilfsmittel', beschriftung: 'Hilfsmittel', typ: 'text', pflicht: true },
|
||||
{
|
||||
name: 'kostentraeger',
|
||||
beschriftung: 'Kostenträger',
|
||||
typ: 'auswahl',
|
||||
optionen: ['Krankenkasse', 'Pflegekasse', 'selbst gezahlt', 'Leihgabe', 'unklar'],
|
||||
},
|
||||
{ name: 'verordnetVon', beschriftung: 'Verordnet von', typ: 'text' },
|
||||
],
|
||||
IMPFUNG: [
|
||||
{ name: 'impfstoff', beschriftung: 'Impfstoff', typ: 'text' },
|
||||
{ name: 'chargennummer', beschriftung: 'Chargennummer', typ: 'text' },
|
||||
{
|
||||
name: 'einwilligung',
|
||||
beschriftung: 'Einwilligung',
|
||||
typ: 'auswahl',
|
||||
optionen: [
|
||||
'durch die Betreute selbst',
|
||||
'durch mich nach ärztlicher Aufklärung',
|
||||
'nach Patientenverfügung',
|
||||
],
|
||||
erklaerung:
|
||||
'Wer eingewilligt hat, gehört dokumentiert — das ist eine Frage von ' +
|
||||
'§ 1821 und § 1829 BGB, nicht nur eine Formalie.',
|
||||
},
|
||||
],
|
||||
PFLEGEBEGUTACHTUNG: [
|
||||
{ name: 'ergebnisGrad', beschriftung: 'Festgestellter Pflegegrad', typ: 'zahl' },
|
||||
{ name: 'gutachter', beschriftung: 'Gutachter / Dienst', typ: 'text' },
|
||||
{
|
||||
name: 'ergebnis',
|
||||
beschriftung: 'Ergebnis',
|
||||
typ: 'auswahl',
|
||||
optionen: ['hochgestuft', 'unverändert', 'abgelehnt', 'herabgestuft'],
|
||||
},
|
||||
{ name: 'widerspruchsfrist', beschriftung: 'Widerspruch bis', typ: 'text' },
|
||||
],
|
||||
}
|
||||
|
||||
export function detailfelderFuer(art: GesundheitsArt): readonly Detailfeld[] {
|
||||
return DETAILFELDER[art] ?? []
|
||||
}
|
||||
|
||||
/**
|
||||
* Baut den Beschreibungstext aus den Zusatzfeldern und dem Freitext.
|
||||
* Erst die beschrifteten Zeilen, dann eine Leerzeile, dann der Freitext -
|
||||
* so bleibt beides beim Wiederlesen unterscheidbar.
|
||||
*/
|
||||
export function detailsFormatieren(
|
||||
art: GesundheitsArt,
|
||||
werte: Record<string, string | null | undefined>,
|
||||
freitext?: string | null,
|
||||
): string | null {
|
||||
const zeilen: string[] = []
|
||||
|
||||
for (const feld of detailfelderFuer(art)) {
|
||||
const wert = werte[feld.name]
|
||||
if (wert === null || wert === undefined || wert === '') continue
|
||||
const einheit = feld.einheit ? ` ${feld.einheit}` : ''
|
||||
zeilen.push(`${feld.beschriftung}: ${wert}${einheit}`)
|
||||
}
|
||||
|
||||
const freitextSauber = freitext?.trim()
|
||||
if (freitextSauber) {
|
||||
if (zeilen.length > 0) zeilen.push('')
|
||||
zeilen.push(freitextSauber)
|
||||
}
|
||||
|
||||
return zeilen.length > 0 ? zeilen.join('\n') : null
|
||||
}
|
||||
|
||||
/**
|
||||
* Liest den Text wieder auseinander - fuer das Bearbeitungsformular.
|
||||
* Was sich keinem Feld zuordnen laesst, bleibt Freitext.
|
||||
*/
|
||||
export function detailsLesen(
|
||||
art: GesundheitsArt,
|
||||
beschreibung: string | null | undefined,
|
||||
): { werte: Record<string, string>; freitext: string } {
|
||||
const werte: Record<string, string> = {}
|
||||
const freitext: string[] = []
|
||||
if (!beschreibung) return { werte, freitext: '' }
|
||||
|
||||
const felder = detailfelderFuer(art)
|
||||
let imFreitext = false
|
||||
|
||||
for (const zeile of beschreibung.split('\n')) {
|
||||
if (imFreitext) {
|
||||
freitext.push(zeile)
|
||||
continue
|
||||
}
|
||||
if (zeile.trim() === '') {
|
||||
imFreitext = true
|
||||
continue
|
||||
}
|
||||
const treffer = felder.find((f) => zeile.startsWith(`${f.beschriftung}: `))
|
||||
if (treffer) {
|
||||
let wert = zeile.slice(treffer.beschriftung.length + 2).trim()
|
||||
if (treffer.einheit && wert.endsWith(treffer.einheit)) {
|
||||
wert = wert.slice(0, -treffer.einheit.length).trim()
|
||||
}
|
||||
werte[treffer.name] = wert
|
||||
} else {
|
||||
freitext.push(zeile)
|
||||
}
|
||||
}
|
||||
|
||||
return { werte, freitext: freitext.join('\n').trim() }
|
||||
}
|
||||
@@ -0,0 +1,173 @@
|
||||
import { heuteAlsTag, plusJahre, plusMonate, tag, tageZwischen, tagesdatum } from '@/lib/fristen/datum'
|
||||
|
||||
/**
|
||||
* Impfungen bei COPD.
|
||||
*
|
||||
* Warum das hier steht und nicht nur beim Hausarzt: Bei einer
|
||||
* fortgeschrittenen COPD ist jede Atemwegsinfektion ein moeglicher
|
||||
* Ausloeser fuer eine Exazerbation - und jede Exazerbation kostet
|
||||
* Lungenfunktion, die nicht zurueckkommt. Die STIKO empfiehlt bei
|
||||
* chronischen Atemwegserkrankungen ausdruecklich Grippe-, Pneumokokken-,
|
||||
* COVID- und RSV-Impfung. Im Heim geht das schnell unter, weil sich
|
||||
* niemand zustaendig fuehlt.
|
||||
*
|
||||
* Diese Datei rechnet nur Faelligkeiten aus. Sie entscheidet nichts: Ob
|
||||
* geimpft wird, entscheidet die betreute Person - oder, wenn sie es nicht
|
||||
* mehr kann, der Betreuer nach ihrem mutmasslichen Willen (§ 1821 BGB),
|
||||
* und zwar nach aerztlicher Aufklaerung.
|
||||
*/
|
||||
|
||||
/** Stand der zugrunde liegenden STIKO-Empfehlungen. */
|
||||
export const IMPFPLAN_STAND = '01.01.2025'
|
||||
|
||||
export type Impfschluessel = 'grippe' | 'pneumokokken' | 'covid' | 'rsv'
|
||||
|
||||
export type Impfempfehlung = {
|
||||
schluessel: Impfschluessel
|
||||
bezeichnung: string
|
||||
/** Abstand bis zur naechsten Impfung in Monaten; null heisst einmalig. */
|
||||
intervallMonate: number | null
|
||||
/** Saisonale Impfungen: bevorzugter Monat. */
|
||||
saisonMonat?: number
|
||||
begruendung: string
|
||||
}
|
||||
|
||||
export const IMPFPLAN_COPD: readonly Impfempfehlung[] = [
|
||||
{
|
||||
schluessel: 'grippe',
|
||||
bezeichnung: 'Grippe (Influenza)',
|
||||
intervallMonate: 12,
|
||||
saisonMonat: 10,
|
||||
begruendung:
|
||||
'Jährlich, weil sich der Impfstoff jede Saison ändert. Für Menschen ab 60 ' +
|
||||
'empfiehlt die STIKO den Hochdosis-Impfstoff. Bester Zeitpunkt: Oktober bis ' +
|
||||
'Mitte Dezember, vor der Welle.',
|
||||
},
|
||||
{
|
||||
schluessel: 'pneumokokken',
|
||||
bezeichnung: 'Pneumokokken',
|
||||
intervallMonate: null,
|
||||
begruendung:
|
||||
'Pneumokokken sind der häufigste Erreger der bakteriellen Lungenentzündung — ' +
|
||||
'bei COPD die gefürchtetste Komplikation. Bei chronischer Atemwegserkrankung ' +
|
||||
'empfohlen; eine Wiederholung nach frühestens sechs Jahren wird ärztlich ' +
|
||||
'entschieden.',
|
||||
},
|
||||
{
|
||||
schluessel: 'covid',
|
||||
bezeichnung: 'COVID-19 (Auffrischung)',
|
||||
intervallMonate: 12,
|
||||
saisonMonat: 10,
|
||||
begruendung:
|
||||
'Für Menschen ab 60 und bei Grunderkrankung empfiehlt die STIKO eine jährliche ' +
|
||||
'Auffrischung im Herbst, mit mindestens zwölf Monaten Abstand zur letzten ' +
|
||||
'Impfung oder Infektion.',
|
||||
},
|
||||
{
|
||||
schluessel: 'rsv',
|
||||
bezeichnung: 'RSV (Respiratorisches Synzytial-Virus)',
|
||||
intervallMonate: null,
|
||||
saisonMonat: 9,
|
||||
begruendung:
|
||||
'Seit 2024 für alle ab 75 und ab 60 bei Grunderkrankung wie COPD empfohlen. ' +
|
||||
'Einmalige Impfung, am besten im Spätsommer oder Herbst vor der Saison.',
|
||||
},
|
||||
] as const
|
||||
|
||||
export type Impfstatus = {
|
||||
empfehlung: Impfempfehlung
|
||||
letzteImpfung: Date | null
|
||||
/** Wann wäre die nächste fällig? Null, wenn einmalig und erledigt. */
|
||||
faelligAm: Date | null
|
||||
/** Negativ heißt: überfällig. */
|
||||
tageBisFaellig: number | null
|
||||
lage: 'unbekannt' | 'faellig' | 'bald' | 'erledigt'
|
||||
text: string
|
||||
}
|
||||
|
||||
/**
|
||||
* Erkennt anhand des Titels, um welche Impfung es ging. Der Titel steht
|
||||
* unverschluesselt am Ereignis - eine Impfbezeichnung ist keine Diagnose.
|
||||
*/
|
||||
export function impfungErkennen(titel: string): Impfschluessel | null {
|
||||
const text = titel.toLowerCase()
|
||||
if (text.includes('grippe') || text.includes('influenza')) return 'grippe'
|
||||
if (text.includes('pneumokokk')) return 'pneumokokken'
|
||||
if (text.includes('covid') || text.includes('corona')) return 'covid'
|
||||
if (text.includes('rsv')) return 'rsv'
|
||||
return null
|
||||
}
|
||||
|
||||
export function impfstatusBerechnen(
|
||||
impfungen: { datum: Date; titel: string }[],
|
||||
heute: Date = heuteAlsTag(),
|
||||
): Impfstatus[] {
|
||||
const stichtag = tagesdatum(heute)
|
||||
const letzte = new Map<Impfschluessel, Date>()
|
||||
|
||||
for (const impfung of impfungen) {
|
||||
const schluessel = impfungErkennen(impfung.titel)
|
||||
if (!schluessel) continue
|
||||
const datum = tagesdatum(impfung.datum)
|
||||
const vorhanden = letzte.get(schluessel)
|
||||
if (!vorhanden || datum.getTime() > vorhanden.getTime()) letzte.set(schluessel, datum)
|
||||
}
|
||||
|
||||
return IMPFPLAN_COPD.map((empfehlung) => {
|
||||
const letzteImpfung = letzte.get(empfehlung.schluessel) ?? null
|
||||
|
||||
if (!letzteImpfung) {
|
||||
return {
|
||||
empfehlung,
|
||||
letzteImpfung: null,
|
||||
faelligAm: null,
|
||||
tageBisFaellig: null,
|
||||
lage: 'unbekannt',
|
||||
text: 'Nicht dokumentiert. Beim Hausarzt oder im Heim nach dem Impfpass fragen.',
|
||||
}
|
||||
}
|
||||
|
||||
if (empfehlung.intervallMonate === null) {
|
||||
return {
|
||||
empfehlung,
|
||||
letzteImpfung,
|
||||
faelligAm: null,
|
||||
tageBisFaellig: null,
|
||||
lage: 'erledigt',
|
||||
text: 'Einmalige Impfung, dokumentiert. Eine Auffrischung entscheidet der Arzt.',
|
||||
}
|
||||
}
|
||||
|
||||
let faellig = plusMonate(letzteImpfung, empfehlung.intervallMonate)
|
||||
// Saisonale Impfungen rutschen auf den Saisonmonat, wenn dieser
|
||||
// spaeter im selben Jahr liegt - eine Grippeimpfung im Maerz nuetzt
|
||||
// wenig.
|
||||
if (empfehlung.saisonMonat) {
|
||||
const saison = tag(faellig.getUTCFullYear(), empfehlung.saisonMonat, 1)
|
||||
if (saison.getTime() > faellig.getTime()) faellig = saison
|
||||
}
|
||||
|
||||
const tage = tageZwischen(stichtag, faellig)
|
||||
const lage: Impfstatus['lage'] = tage <= 0 ? 'faellig' : tage <= 60 ? 'bald' : 'erledigt'
|
||||
const text =
|
||||
lage === 'faellig'
|
||||
? `Seit ${Math.abs(tage)} Tagen fällig.`
|
||||
: lage === 'bald'
|
||||
? `In ${tage} Tagen fällig.`
|
||||
: `Aktuell. Nächste Impfung in ${tage} Tagen.`
|
||||
|
||||
return { empfehlung, letzteImpfung, faelligAm: faellig, tageBisFaellig: tage, lage, text }
|
||||
})
|
||||
}
|
||||
|
||||
/** Nur die Impfungen, bei denen etwas zu tun ist - fuer die Kachel. */
|
||||
export function offeneImpfungen(status: Impfstatus[]): Impfstatus[] {
|
||||
return status.filter((s) => s.lage === 'faellig' || s.lage === 'unbekannt' || s.lage === 'bald')
|
||||
}
|
||||
|
||||
/** Ein Jahr nach der letzten Grippeimpfung - fuer die Wiedervorlage. */
|
||||
export function naechsteGrippesaison(heute: Date = heuteAlsTag()): Date {
|
||||
const stichtag = tagesdatum(heute)
|
||||
const diesesJahr = tag(stichtag.getUTCFullYear(), 10, 1)
|
||||
return diesesJahr.getTime() >= stichtag.getTime() ? diesesJahr : plusJahre(diesesJahr, 1)
|
||||
}
|
||||
Reference in New Issue
Block a user