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
2026-08-22 02:35:08 +02:00
parent 6b4df4c9cb
commit 3833a9dd8f
141 changed files with 30302 additions and 66 deletions
+206
View File
@@ -0,0 +1,206 @@
import * as React from 'react'
import Link from 'next/link'
import { AlertTriangle, FileWarning, Paperclip } from 'lucide-react'
import { Badge } from '@/components/ui/badge'
import { Card, CardContent } from '@/components/ui/card'
import { cn, formatCent } from '@/lib/utils'
/**
* Kleine Bausteine, die in mehreren Finanzseiten vorkommen.
*
* Alle rein darstellend und ohne Zustand - sie laufen deshalb sowohl in
* Server- als auch in Client-Komponenten. Betraege kommen hier immer als
* Number in Cent an; die Umwandlung aus BigInt passiert vorher mit
* centZuZahl().
*/
/**
* Ein Geldbetrag. Ausgaben werden mit Minuszeichen UND in gedeckter
* Farbe gezeigt - die Farbe allein waere fuer farbfehlsichtige Nutzer
* keine Information.
*/
export function Betrag({
cent,
richtung,
fett,
className,
}: {
cent: number | null
richtung?: 'EINNAHME' | 'AUSGABE' | 'UMBUCHUNG'
fett?: boolean
className?: string
}) {
if (cent === null) {
return <span className={cn('tabular-nums text-muted-foreground', className)}>nicht erfasst</span>
}
const vorzeichenbehaftet = richtung === 'AUSGABE' ? -Math.abs(cent) : cent
const negativ = vorzeichenbehaftet < 0
return (
<span
className={cn(
'tabular-nums',
fett && 'font-semibold',
negativ ? 'text-ampel-rot' : undefined,
className,
)}
>
{formatCent(vorzeichenbehaftet)}
</span>
)
}
/** Kachel mit einer Zahl und einer Erklärung, was sie bedeutet. */
export function Kennzahl({
titel,
wert,
hinweis,
ton = 'neutral',
href,
}: {
titel: string
wert: React.ReactNode
hinweis?: React.ReactNode
ton?: 'neutral' | 'gut' | 'achtung' | 'schlecht'
href?: string
}) {
const rahmen =
ton === 'gut'
? 'border-ampel-gruen/40'
: ton === 'achtung'
? 'border-ampel-orange/50'
: ton === 'schlecht'
? 'border-ampel-rot/50'
: undefined
const inhalt = (
<CardContent className="space-y-1 p-4">
<p className="text-sm font-medium text-muted-foreground">{titel}</p>
<p className="text-2xl font-semibold tabular-nums">{wert}</p>
{hinweis && <p className="text-sm text-muted-foreground">{hinweis}</p>}
</CardContent>
)
if (href) {
return (
<Card className={cn('transition-colors hover:bg-accent/40', rahmen)}>
<Link href={href} className="block focus-visible:outline-none focus-visible:ring-2 focus-visible:ring-ring">
{inhalt}
</Link>
</Card>
)
}
return <Card className={rahmen}>{inhalt}</Card>
}
/**
* Belegzustand einer Buchung. Der Belegzwang verbietet nichts - er macht
* sichtbar. Eine Buchung ohne Beleg und ohne Begruendung ist die, nach
* der beim Rechtspfleger gefragt wird.
*/
export function Belegzeichen({
belegTitel,
begruendung,
belegId,
}: {
belegId: string | null
belegTitel: string | null
begruendung: string | null
}) {
if (belegId) {
return (
<span className="inline-flex items-center gap-1 text-sm text-muted-foreground">
<Paperclip className="size-3.5 shrink-0" aria-hidden="true" />
<span className="truncate">{belegTitel ?? 'Beleg hinterlegt'}</span>
</span>
)
}
if (begruendung && begruendung.trim() !== '') {
return (
<Badge variant="gelb" title={begruendung}>
<FileWarning className="size-3.5" aria-hidden="true" />
Beleg begründet fehlend
</Badge>
)
}
return (
<Badge variant="rot">
<AlertTriangle className="size-3.5" aria-hidden="true" />
Beleg fehlt
</Badge>
)
}
/**
* Die Warnung, um die es bei der Trennung der Vermoegensmassen geht:
* eine Buchung auf einem Konto des Betreuers, die trotzdem als Vermoegen
* der betreuten Person gefuehrt wird.
*/
export function Vermischungswarnung({ kurz = false }: { kurz?: boolean }) {
if (kurz) {
return (
<Badge variant="rot">
<AlertTriangle className="size-3.5" aria-hidden="true" />
Vermögen vermischt
</Badge>
)
}
return (
<div className="flex items-start gap-2.5 rounded-md border border-ampel-rot/50 bg-ampel-rot/10 p-3">
<AlertTriangle className="mt-0.5 size-4 shrink-0 text-ampel-rot" aria-hidden="true" />
<div className="space-y-1 text-sm">
<p className="font-medium">Vorsicht: hier vermischen sich zwei Vermögen.</p>
<p className="text-muted-foreground">
Die Buchung läuft über ein Konto, das als <strong>Konto des Betreuers</strong> markiert
ist, gilt aber als Vermögen der betreuten Person. Genau das fällt einem in der
Rechnungslegung um die Ohren. Entweder ist das Konto falsch markiert, oder es ist eine
eigene Auslage – dann bitte den Haken bei „betrifft das Vermögen der betreuten Person“
entfernen.
</p>
</div>
</div>
)
}
/** Zeile in einer Bestands- oder Summenaufstellung. */
export function Summenzeile({
beschriftung,
cent,
betont,
}: {
beschriftung: React.ReactNode
cent: number
betont?: boolean
}) {
return (
<div
className={cn(
'flex items-baseline justify-between gap-4 border-t py-2',
betont && 'border-foreground/40 font-semibold',
)}
>
<span>{beschriftung}</span>
<Betrag cent={cent} fett={betont} />
</div>
)
}
/** Hinweise aus einer Berechnung - Lücken werden benannt, nicht versteckt. */
export function Hinweisliste({ hinweise, titel }: { hinweise: string[]; titel?: string }) {
if (hinweise.length === 0) return null
return (
<div className="rounded-md border border-ampel-orange/50 bg-ampel-orange/10 p-3">
<p className="mb-1.5 text-sm font-medium">{titel ?? 'Das solltest du vor der Abgabe klären'}</p>
<ul className="list-disc space-y-1 pl-5 text-sm text-muted-foreground">
{hinweise.map((hinweis, i) => (
<li key={i}>{hinweis}</li>
))}
</ul>
</div>
)
}