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,318 @@
|
||||
import Link from 'next/link'
|
||||
import { ArrowRight, Banknote, FileDown, Landmark, Plus, Upload } from 'lucide-react'
|
||||
import { Button } from '@/components/ui/button'
|
||||
import { Card, CardContent, CardDescription, CardHeader, CardTitle } from '@/components/ui/card'
|
||||
import { Table, TableBody, TableCell, TableHead, TableHeader, TableRow } from '@/components/ui/table'
|
||||
import { SeitenKopf, Leerzustand } from '@/components/seiten-kopf'
|
||||
import { Rechtshinweis } from '@/components/rechtshinweis'
|
||||
import {
|
||||
Belegzeichen,
|
||||
Betrag,
|
||||
Hinweisliste,
|
||||
Kennzahl,
|
||||
Vermischungswarnung,
|
||||
} from '@/components/finanzen/bausteine'
|
||||
import { centZuZahl } from '@/lib/db'
|
||||
import { formatCent, formatDatum } from '@/lib/utils'
|
||||
import { finanzKontext } from '@/lib/finanzen/seite'
|
||||
import { heute, monatePlus, tagePlus } from '@/lib/finanzen/datum'
|
||||
import { kennzahlen, vermischungsWarnung } from '@/lib/finanzen/kassenbuch'
|
||||
import { KATEGORIE_BESCHRIFTUNG } from '@/lib/finanzen/kategorien'
|
||||
import { laufendesBetreuungsjahr } from '@/lib/finanzen/betreuungsjahr'
|
||||
import { buchungenLaden, kontenLaden, kontostaendeZumStichtag, vermoegenLaden } from '@/lib/berichte/gemeinsam'
|
||||
|
||||
export const metadata = { title: 'Vermögen & Kasse' }
|
||||
|
||||
/**
|
||||
* Übersichtsseite des Finanzmoduls.
|
||||
*
|
||||
* Sie beantwortet die vier Fragen, die man sich beim Öffnen stellt:
|
||||
* Was ist da? Wo liegt es? Was ist zuletzt passiert? Und: Wo fehlt noch
|
||||
* ein Beleg?
|
||||
*/
|
||||
export default async function FinanzenSeite() {
|
||||
const { betreute, darfSchreiben } = await finanzKontext()
|
||||
const schreiben = darfSchreiben('FINANZEN')
|
||||
const stichtag = heute()
|
||||
|
||||
const [konten, buchungen, vermoegen] = await Promise.all([
|
||||
kontenLaden(betreute.id),
|
||||
buchungenLaden(betreute.id),
|
||||
vermoegenLaden(betreute.id, stichtag),
|
||||
])
|
||||
|
||||
const eigeneKonten = konten.filter((k) => !k.istBetreuerkonto)
|
||||
const staende = kontostaendeZumStichtag(eigeneKonten, stichtag)
|
||||
const summeKontenCent = staende.reduce((s, z) => s + (z.betragCent ?? 0n), 0n)
|
||||
|
||||
const zwoelfMonate = tagePlus(monatePlus(stichtag, -12), 1)
|
||||
const letzteZwoelf = buchungen.filter((b) => b.datum >= zwoelfMonate)
|
||||
const zahlen = kennzahlen(letzteZwoelf)
|
||||
|
||||
const letzte = [...buchungen].sort((a, b) => b.datum.getTime() - a.datum.getTime()).slice(0, 8)
|
||||
|
||||
const jahr = betreute.bestellungAm ? laufendesBetreuungsjahr(betreute.bestellungAm) : null
|
||||
|
||||
const hinweise: string[] = []
|
||||
for (const stand of staende) {
|
||||
if (stand.betragCent === null) {
|
||||
hinweise.push(`Für „${stand.bezeichnung}“ ist noch kein Kontostand erfasst.`)
|
||||
} else if (stand.stichtag && stand.stichtag < monatePlus(stichtag, -3)) {
|
||||
hinweise.push(
|
||||
`Der Stand von „${stand.bezeichnung}“ ist vom ${formatDatum(stand.stichtag)} und damit ` +
|
||||
'älter als drei Monate.',
|
||||
)
|
||||
}
|
||||
}
|
||||
if (!betreute.bestellungAm) {
|
||||
hinweise.push(
|
||||
'In den Stammdaten fehlt das Datum der Bestellung. Ohne dieses Datum lässt sich das ' +
|
||||
'Betreuungsjahr nicht bestimmen – und damit auch keine Rechnungslegung erzeugen.',
|
||||
)
|
||||
}
|
||||
|
||||
return (
|
||||
<div className="space-y-8">
|
||||
<SeitenKopf
|
||||
titel="Vermögen & Kasse"
|
||||
beschreibung={
|
||||
jahr
|
||||
? `Aktuell läuft das ${jahr.bezeichnung}. Alles hier fließt in das Vermögensverzeichnis und die Rechnungslegung.`
|
||||
: 'Konten, Kassenbuch und Vermögensposten. Von hier aus entstehen beide Berichte ans Betreuungsgericht.'
|
||||
}
|
||||
pfad={[{ titel: 'Vermögen & Kasse' }]}
|
||||
aktionen={
|
||||
schreiben ? (
|
||||
<>
|
||||
<Button asChild variant="secondary">
|
||||
<Link href="/finanzen/buchungen/neu">
|
||||
<Plus aria-hidden="true" />
|
||||
Buchung erfassen
|
||||
</Link>
|
||||
</Button>
|
||||
<Button asChild>
|
||||
<Link href="/finanzen/berichte">
|
||||
<FileDown aria-hidden="true" />
|
||||
Berichte
|
||||
</Link>
|
||||
</Button>
|
||||
</>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-4">
|
||||
<Kennzahl
|
||||
titel="Guthaben auf Konten"
|
||||
wert={formatCent(centZuZahl(summeKontenCent))}
|
||||
hinweis={`${staende.length} Konto/Konten der betreuten Person`}
|
||||
href="/finanzen/konten"
|
||||
/>
|
||||
<Kennzahl
|
||||
titel="Reinvermögen"
|
||||
wert={formatCent(centZuZahl(summeKontenCent + vermoegen.summeAktivaCent - vermoegen.summePassivaCent))}
|
||||
hinweis="Konten und Vermögensposten, abzüglich Verbindlichkeiten"
|
||||
href="/finanzen/vermoegen"
|
||||
/>
|
||||
<Kennzahl
|
||||
titel="Belegquote (12 Monate)"
|
||||
wert={`${zahlen.beleg.quoteProzent} %`}
|
||||
hinweis={
|
||||
zahlen.beleg.ohneNachweis > 0
|
||||
? `${zahlen.beleg.ohneNachweis} Buchung(en) ohne Beleg und ohne Begründung`
|
||||
: 'Alle Buchungen sind belegt oder begründet'
|
||||
}
|
||||
ton={zahlen.beleg.ohneNachweis > 0 ? 'achtung' : 'gut'}
|
||||
href="/finanzen/buchungen?nurOhneBeleg=on"
|
||||
/>
|
||||
<Kennzahl
|
||||
titel="Saldo der letzten 12 Monate"
|
||||
wert={formatCent(centZuZahl(zahlen.saldoCent))}
|
||||
hinweis={`${formatCent(centZuZahl(zahlen.einnahmenCent))} ein, ${formatCent(centZuZahl(zahlen.ausgabenCent))} aus`}
|
||||
ton={zahlen.saldoCent < 0n ? 'achtung' : 'neutral'}
|
||||
href="/finanzen/buchungen"
|
||||
/>
|
||||
</div>
|
||||
|
||||
{zahlen.vermischungen > 0 && <Vermischungswarnung />}
|
||||
|
||||
<Hinweisliste hinweise={hinweise} titel="Das solltest du nachtragen" />
|
||||
|
||||
{/* ------------------------------------------------------------- */}
|
||||
<Card>
|
||||
<CardHeader>
|
||||
<CardTitle>Konten</CardTitle>
|
||||
<CardDescription>
|
||||
Stand zum {formatDatum(stichtag)} – jeweils der jüngste erfasste Saldostand.
|
||||
</CardDescription>
|
||||
</CardHeader>
|
||||
<CardContent>
|
||||
{konten.length === 0 ? (
|
||||
<Leerzustand
|
||||
icon={Landmark}
|
||||
titel="Noch kein Konto erfasst"
|
||||
beschreibung="Fang mit dem Girokonto an, über das Rente und Heimkosten laufen. Das Verwahrgeldkonto im Heim gehört ebenfalls dazu."
|
||||
aktion={
|
||||
schreiben ? (
|
||||
<Button asChild>
|
||||
<Link href="/finanzen/konten/neu">
|
||||
<Plus aria-hidden="true" />
|
||||
Konto anlegen
|
||||
</Link>
|
||||
</Button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
) : (
|
||||
<Table>
|
||||
<TableHeader>
|
||||
<TableRow>
|
||||
<TableHead>Konto</TableHead>
|
||||
<TableHead>Art</TableHead>
|
||||
<TableHead>Stand vom</TableHead>
|
||||
<TableHead className="text-right">Betrag</TableHead>
|
||||
</TableRow>
|
||||
</TableHeader>
|
||||
<TableBody>
|
||||
{kontostaendeZumStichtag(konten, stichtag).map((stand) => (
|
||||
<TableRow key={stand.kontoId}>
|
||||
<TableCell>
|
||||
<Link
|
||||
href={`/finanzen/konten/${stand.kontoId}`}
|
||||
className="font-medium hover:underline"
|
||||
>
|
||||
{stand.bezeichnung}
|
||||
</Link>
|
||||
{stand.istBetreuerkonto && (
|
||||
<span className="block text-sm text-muted-foreground">
|
||||
Konto des Betreuers – zählt nicht zum Vermögen der Betreuten
|
||||
</span>
|
||||
)}
|
||||
{stand.ibanMaskiert && (
|
||||
<span className="block text-sm text-muted-foreground">
|
||||
{stand.ibanMaskiert}
|
||||
</span>
|
||||
)}
|
||||
</TableCell>
|
||||
<TableCell className="text-sm text-muted-foreground">
|
||||
{stand.artBeschriftung}
|
||||
</TableCell>
|
||||
<TableCell className="whitespace-nowrap text-sm text-muted-foreground">
|
||||
{stand.stichtag ? formatDatum(stand.stichtag) : 'nie erfasst'}
|
||||
</TableCell>
|
||||
<TableCell className="text-right">
|
||||
<Betrag cent={centZuZahl(stand.betragCent)} />
|
||||
</TableCell>
|
||||
</TableRow>
|
||||
))}
|
||||
</TableBody>
|
||||
</Table>
|
||||
)}
|
||||
</CardContent>
|
||||
</Card>
|
||||
|
||||
{/* ------------------------------------------------------------- */}
|
||||
<Card>
|
||||
<CardHeader className="flex-row items-start justify-between gap-3">
|
||||
<div>
|
||||
<CardTitle>Zuletzt gebucht</CardTitle>
|
||||
<CardDescription>Die acht jüngsten Einträge im Kassenbuch.</CardDescription>
|
||||
</div>
|
||||
<div className="flex shrink-0 flex-wrap gap-2">
|
||||
{schreiben && (
|
||||
<Button asChild variant="ghost" size="sm">
|
||||
<Link href="/finanzen/buchungen/import">
|
||||
<Upload aria-hidden="true" />
|
||||
Importieren
|
||||
</Link>
|
||||
</Button>
|
||||
)}
|
||||
<Button asChild variant="ghost" size="sm">
|
||||
<Link href="/finanzen/buchungen">
|
||||
Alle ansehen
|
||||
<ArrowRight aria-hidden="true" />
|
||||
</Link>
|
||||
</Button>
|
||||
</div>
|
||||
</CardHeader>
|
||||
<CardContent>
|
||||
{letzte.length === 0 ? (
|
||||
<Leerzustand
|
||||
icon={Banknote}
|
||||
titel="Das Kassenbuch ist noch leer"
|
||||
beschreibung="Erfasse die erste Buchung von Hand oder lies einen Kontoauszug als CSV ein."
|
||||
aktion={
|
||||
schreiben ? (
|
||||
<div className="flex flex-wrap justify-center gap-2">
|
||||
<Button asChild>
|
||||
<Link href="/finanzen/buchungen/neu">
|
||||
<Plus aria-hidden="true" />
|
||||
Buchung erfassen
|
||||
</Link>
|
||||
</Button>
|
||||
<Button asChild variant="secondary">
|
||||
<Link href="/finanzen/buchungen/import">
|
||||
<Upload aria-hidden="true" />
|
||||
CSV einlesen
|
||||
</Link>
|
||||
</Button>
|
||||
</div>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
) : (
|
||||
<Table>
|
||||
<TableHeader>
|
||||
<TableRow>
|
||||
<TableHead>Datum</TableHead>
|
||||
<TableHead>Vorgang</TableHead>
|
||||
<TableHead>Beleg</TableHead>
|
||||
<TableHead className="text-right">Betrag</TableHead>
|
||||
</TableRow>
|
||||
</TableHeader>
|
||||
<TableBody>
|
||||
{letzte.map((buchung) => (
|
||||
<TableRow key={buchung.id}>
|
||||
<TableCell className="whitespace-nowrap">
|
||||
{formatDatum(buchung.datum)}
|
||||
</TableCell>
|
||||
<TableCell>
|
||||
<Link
|
||||
href={`/finanzen/buchungen/${buchung.id}`}
|
||||
className="font-medium hover:underline"
|
||||
>
|
||||
{buchung.gegenstelle ?? KATEGORIE_BESCHRIFTUNG[buchung.kategorie]}
|
||||
</Link>
|
||||
<span className="block text-sm text-muted-foreground">
|
||||
{KATEGORIE_BESCHRIFTUNG[buchung.kategorie]}
|
||||
{!buchung.betrifftBetreute && ' · eigene Auslage'}
|
||||
{buchung.vermoegenswirksam && ' · vermögenswirksam'}
|
||||
</span>
|
||||
{vermischungsWarnung(buchung) && (
|
||||
<span className="mt-1 block">
|
||||
<Vermischungswarnung kurz />
|
||||
</span>
|
||||
)}
|
||||
</TableCell>
|
||||
<TableCell>
|
||||
<Belegzeichen
|
||||
belegId={buchung.belegId}
|
||||
belegTitel={buchung.belegTitel ?? null}
|
||||
begruendung={buchung.belegFehltBegruendung}
|
||||
/>
|
||||
</TableCell>
|
||||
<TableCell className="text-right">
|
||||
<Betrag cent={centZuZahl(buchung.betragCent)} richtung={buchung.richtung} />
|
||||
</TableCell>
|
||||
</TableRow>
|
||||
))}
|
||||
</TableBody>
|
||||
</Table>
|
||||
)}
|
||||
</CardContent>
|
||||
</Card>
|
||||
|
||||
<Rechtshinweis rechtsgrundlage="§ 1835 BGB, §§ 1859, 1865 BGB" />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
Reference in New Issue
Block a user