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,103 @@
|
||||
import Link from 'next/link'
|
||||
import { notFound } from 'next/navigation'
|
||||
import { Alert, AlertDescription, AlertTitle } from '@/components/ui/alert'
|
||||
import { AlertCircle } from 'lucide-react'
|
||||
import { Button } from '@/components/ui/button'
|
||||
import { SeitenKopf } from '@/components/seiten-kopf'
|
||||
import { Rechtshinweis } from '@/components/rechtshinweis'
|
||||
import { Buchungsformular } from '@/components/finanzen/buchungs-formular'
|
||||
import { db, nichtGeloescht } from '@/lib/db'
|
||||
import { finanzKontext } from '@/lib/finanzen/seite'
|
||||
import { heute, tagAlsText } from '@/lib/finanzen/datum'
|
||||
|
||||
export const metadata = { title: 'Buchung erfassen' }
|
||||
|
||||
/**
|
||||
* Buchung erfassen.
|
||||
*
|
||||
* Mit ?schnell=1 bleibt das Formular nach dem Speichern offen – für den
|
||||
* Abend, an dem ein ganzer Kontoauszug nachgetragen wird.
|
||||
*/
|
||||
export default async function BuchungNeuSeite({
|
||||
searchParams,
|
||||
}: {
|
||||
searchParams: Promise<Record<string, string | string[] | undefined>>
|
||||
}) {
|
||||
const parameter = await searchParams
|
||||
const { betreute, darfSchreiben } = await finanzKontext()
|
||||
if (!darfSchreiben('FINANZEN')) notFound()
|
||||
|
||||
const schnell = parameter.schnell === '1'
|
||||
const kontoId = typeof parameter.kontoId === 'string' ? parameter.kontoId : null
|
||||
|
||||
const [konten, belege] = await Promise.all([
|
||||
db.konto.findMany({
|
||||
where: { betreuteId: betreute.id, ...nichtGeloescht },
|
||||
select: { id: true, bezeichnung: true, istBetreuerkonto: true },
|
||||
orderBy: [{ istBetreuerkonto: 'asc' }, { bezeichnung: 'asc' }],
|
||||
}),
|
||||
db.dokument.findMany({
|
||||
where: { betreuteId: betreute.id, ...nichtGeloescht },
|
||||
select: { id: true, titel: true },
|
||||
orderBy: { erstelltAm: 'desc' },
|
||||
take: 200,
|
||||
}),
|
||||
])
|
||||
|
||||
return (
|
||||
<div className="max-w-3xl space-y-6">
|
||||
<SeitenKopf
|
||||
titel={schnell ? 'Schnellerfassung' : 'Buchung erfassen'}
|
||||
beschreibung={
|
||||
schnell
|
||||
? 'Das Formular bleibt nach dem Speichern offen. Datum und Konto musst du je Buchung neu wählen – dafür wanderst du zügig durch den Kontoauszug.'
|
||||
: 'Beträge immer positiv eintragen; ob Geld kommt oder geht, sagt die Richtung.'
|
||||
}
|
||||
pfad={[
|
||||
{ titel: 'Vermögen & Kasse', href: '/finanzen' },
|
||||
{ titel: 'Kassenbuch', href: '/finanzen/buchungen' },
|
||||
{ titel: schnell ? 'Schnellerfassung' : 'Neu' },
|
||||
]}
|
||||
aktionen={
|
||||
<Button asChild variant="ghost">
|
||||
<Link href={schnell ? '/finanzen/buchungen/neu' : '/finanzen/buchungen/neu?schnell=1'}>
|
||||
{schnell ? 'Zur normalen Erfassung' : 'Zur Schnellerfassung'}
|
||||
</Link>
|
||||
</Button>
|
||||
}
|
||||
/>
|
||||
|
||||
{konten.length === 0 && (
|
||||
<Alert variant="warnung">
|
||||
<AlertCircle aria-hidden="true" />
|
||||
<AlertTitle>Es gibt noch kein Konto</AlertTitle>
|
||||
<AlertDescription>
|
||||
Du kannst eine Buchung auch ohne Konto erfassen, aber dann lässt sie sich später
|
||||
keinem Kontostand zuordnen – und die Rechenprobe der Rechnungslegung geht nicht auf.{' '}
|
||||
<Link href="/finanzen/konten/neu" className="underline">
|
||||
Erst ein Konto anlegen
|
||||
</Link>
|
||||
.
|
||||
</AlertDescription>
|
||||
</Alert>
|
||||
)}
|
||||
|
||||
<Buchungsformular
|
||||
betreuteId={betreute.id}
|
||||
konten={
|
||||
kontoId
|
||||
? [
|
||||
...konten.filter((k) => k.id === kontoId),
|
||||
...konten.filter((k) => k.id !== kontoId),
|
||||
]
|
||||
: konten
|
||||
}
|
||||
belege={belege}
|
||||
schnellerfassung={schnell}
|
||||
standardDatum={tagAlsText(heute())}
|
||||
/>
|
||||
|
||||
<Rechtshinweis rechtsgrundlage="§ 1865 BGB" />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,286 @@
|
||||
import Link from 'next/link'
|
||||
import { Banknote, Plus, Upload } from 'lucide-react'
|
||||
import type { Prisma } from '@prisma/client'
|
||||
import { Badge } from '@/components/ui/badge'
|
||||
import { Button } from '@/components/ui/button'
|
||||
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, Kennzahl, Vermischungswarnung } from '@/components/finanzen/bausteine'
|
||||
import { Buchungsfilter } from '@/components/finanzen/buchungs-filter'
|
||||
import { centZuZahl, db, nichtGeloescht } from '@/lib/db'
|
||||
import { oeffnen } from '@/lib/crypto/feld'
|
||||
import { formatCent, formatDatum } from '@/lib/utils'
|
||||
import { finanzKontext } from '@/lib/finanzen/seite'
|
||||
import { belegFehlt, kennzahlen, vermischungsWarnung, type BuchungEingabe } from '@/lib/finanzen/kassenbuch'
|
||||
import { KATEGORIE_BESCHRIFTUNG, RICHTUNG_BESCHRIFTUNG } from '@/lib/finanzen/kategorien'
|
||||
import { buchungsfilterSchema } from '@/lib/validierung/finanzen'
|
||||
|
||||
export const metadata = { title: 'Kassenbuch' }
|
||||
|
||||
const HOECHSTZAHL = 300
|
||||
|
||||
/**
|
||||
* Das Kassenbuch.
|
||||
*
|
||||
* Zwei Dinge sind hier absichtlich auffällig: Buchungen ohne Beleg und
|
||||
* ohne Begründung werden rot markiert, und eine Buchung, die auf einem
|
||||
* Konto des Betreuers läuft und trotzdem als Vermögen der Betreuten
|
||||
* gilt, bekommt eine eigene Warnung. Beides sind die Punkte, an denen
|
||||
* eine Rechnungslegung beim Gericht auseinanderfällt.
|
||||
*/
|
||||
export default async function BuchungenSeite({
|
||||
searchParams,
|
||||
}: {
|
||||
searchParams: Promise<Record<string, string | string[] | undefined>>
|
||||
}) {
|
||||
const roh = await searchParams
|
||||
const { betreute, darfSchreiben } = await finanzKontext()
|
||||
const schreiben = darfSchreiben('FINANZEN')
|
||||
|
||||
const flach: Record<string, string> = {}
|
||||
for (const [schluessel, wert] of Object.entries(roh)) {
|
||||
if (typeof wert === 'string') flach[schluessel] = wert
|
||||
}
|
||||
const gepruft = buchungsfilterSchema.safeParse(flach)
|
||||
const filter = gepruft.success
|
||||
? gepruft.data
|
||||
: {
|
||||
kontoId: null,
|
||||
kategorie: null,
|
||||
richtung: null,
|
||||
von: null,
|
||||
bis: null,
|
||||
suche: null,
|
||||
nurOhneBeleg: false,
|
||||
nurEigeneAuslagen: false,
|
||||
}
|
||||
|
||||
const bedingung: Prisma.BuchungWhereInput = {
|
||||
betreuteId: betreute.id,
|
||||
...nichtGeloescht,
|
||||
...(filter.kontoId ? { kontoId: filter.kontoId } : {}),
|
||||
...(filter.kategorie ? { kategorie: filter.kategorie } : {}),
|
||||
...(filter.richtung ? { richtung: filter.richtung } : {}),
|
||||
...(filter.von || filter.bis
|
||||
? {
|
||||
datum: {
|
||||
...(filter.von ? { gte: filter.von } : {}),
|
||||
...(filter.bis ? { lte: filter.bis } : {}),
|
||||
},
|
||||
}
|
||||
: {}),
|
||||
// Der Verwendungszweck ist verschluesselt und laesst sich nicht
|
||||
// durchsuchen - gesucht wird deshalb nur in der Gegenstelle.
|
||||
...(filter.suche ? { gegenstelle: { contains: filter.suche, mode: 'insensitive' } } : {}),
|
||||
...(filter.nurEigeneAuslagen ? { betrifftBetreute: false } : {}),
|
||||
...(filter.nurOhneBeleg
|
||||
? { belegId: null, OR: [{ belegFehltBegruendung: null }, { belegFehltBegruendung: '' }] }
|
||||
: {}),
|
||||
}
|
||||
|
||||
const [zeilen, gesamt, konten] = await Promise.all([
|
||||
db.buchung.findMany({
|
||||
where: bedingung,
|
||||
include: {
|
||||
konto: { select: { id: true, bezeichnung: true, istBetreuerkonto: true } },
|
||||
beleg: { select: { id: true, titel: true } },
|
||||
},
|
||||
orderBy: [{ datum: 'desc' }, { erstelltAm: 'desc' }],
|
||||
take: HOECHSTZAHL,
|
||||
}),
|
||||
db.buchung.count({ where: bedingung }),
|
||||
db.konto.findMany({
|
||||
where: { betreuteId: betreute.id, ...nichtGeloescht },
|
||||
select: { id: true, bezeichnung: true },
|
||||
orderBy: { bezeichnung: 'asc' },
|
||||
}),
|
||||
])
|
||||
|
||||
const buchungen: BuchungEingabe[] = zeilen.map((zeile) => {
|
||||
const offen = oeffnen('Buchung', zeile)
|
||||
return {
|
||||
id: zeile.id,
|
||||
datum: zeile.datum,
|
||||
betragCent: zeile.betragCent,
|
||||
richtung: zeile.richtung,
|
||||
kategorie: zeile.kategorie,
|
||||
gegenstelle: zeile.gegenstelle,
|
||||
verwendungszweck: offen.verwendungszweck,
|
||||
kontoId: zeile.kontoId,
|
||||
kontoBezeichnung: zeile.konto?.bezeichnung ?? null,
|
||||
belegId: zeile.belegId,
|
||||
belegTitel: zeile.beleg?.titel ?? null,
|
||||
belegFehltBegruendung: zeile.belegFehltBegruendung,
|
||||
betrifftBetreute: zeile.betrifftBetreute,
|
||||
vermoegenswirksam: zeile.vermoegenswirksam,
|
||||
aufBetreuerkonto: zeile.konto?.istBetreuerkonto ?? false,
|
||||
}
|
||||
})
|
||||
|
||||
const zahlen = kennzahlen(buchungen)
|
||||
|
||||
return (
|
||||
<div className="space-y-6">
|
||||
<SeitenKopf
|
||||
titel="Kassenbuch"
|
||||
beschreibung="Jede Einnahme und jede Ausgabe. Aus diesen Zeilen entsteht die Rechnungslegung – deshalb gehört zu jeder Zeile ein Beleg oder eine Begründung, warum keiner da ist."
|
||||
pfad={[{ titel: 'Vermögen & Kasse', href: '/finanzen' }, { titel: 'Kassenbuch' }]}
|
||||
aktionen={
|
||||
schreiben ? (
|
||||
<>
|
||||
<Button asChild variant="secondary">
|
||||
<Link href="/finanzen/buchungen/import">
|
||||
<Upload aria-hidden="true" />
|
||||
Importieren
|
||||
</Link>
|
||||
</Button>
|
||||
<Button asChild>
|
||||
<Link href="/finanzen/buchungen/neu">
|
||||
<Plus aria-hidden="true" />
|
||||
Buchung erfassen
|
||||
</Link>
|
||||
</Button>
|
||||
</>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
|
||||
<Buchungsfilter
|
||||
konten={konten}
|
||||
aktiv={{
|
||||
kontoId: filter.kontoId ?? '',
|
||||
kategorie: filter.kategorie ?? '',
|
||||
richtung: filter.richtung ?? '',
|
||||
von: filter.von ? filter.von.toISOString().slice(0, 10) : '',
|
||||
bis: filter.bis ? filter.bis.toISOString().slice(0, 10) : '',
|
||||
suche: filter.suche ?? '',
|
||||
nurOhneBeleg: filter.nurOhneBeleg,
|
||||
nurEigeneAuslagen: filter.nurEigeneAuslagen,
|
||||
}}
|
||||
/>
|
||||
|
||||
<div className="grid gap-4 sm:grid-cols-2 lg:grid-cols-4">
|
||||
<Kennzahl titel="Buchungen in der Auswahl" wert={gesamt} />
|
||||
<Kennzahl
|
||||
titel="Einnahmen"
|
||||
wert={formatCent(centZuZahl(zahlen.einnahmenCent))}
|
||||
hinweis="ohne Umbuchungen und eigene Auslagen"
|
||||
/>
|
||||
<Kennzahl
|
||||
titel="Ausgaben"
|
||||
wert={formatCent(centZuZahl(zahlen.ausgabenCent))}
|
||||
hinweis="ohne Umbuchungen und eigene Auslagen"
|
||||
/>
|
||||
<Kennzahl
|
||||
titel="Ohne Beleg und ohne Begründung"
|
||||
wert={zahlen.beleg.ohneNachweis}
|
||||
hinweis={
|
||||
zahlen.beleg.ohneNachweis > 0
|
||||
? 'Genau danach fragt der Rechtspfleger.'
|
||||
: 'Da fehlt nichts.'
|
||||
}
|
||||
ton={zahlen.beleg.ohneNachweis > 0 ? 'achtung' : 'gut'}
|
||||
/>
|
||||
</div>
|
||||
|
||||
{zahlen.vermischungen > 0 && <Vermischungswarnung />}
|
||||
|
||||
{buchungen.length === 0 ? (
|
||||
<Leerzustand
|
||||
icon={Banknote}
|
||||
titel={gesamt === 0 ? 'Noch keine Buchung erfasst' : 'Keine Buchung passt zu diesem Filter'}
|
||||
beschreibung={
|
||||
gesamt === 0
|
||||
? 'Erfasse die erste Buchung von Hand oder lies einen Kontoauszug als CSV ein.'
|
||||
: 'Setz den Filter zurück oder wähl einen anderen Zeitraum.'
|
||||
}
|
||||
aktion={
|
||||
schreiben && gesamt === 0 ? (
|
||||
<Button asChild>
|
||||
<Link href="/finanzen/buchungen/neu">
|
||||
<Plus aria-hidden="true" />
|
||||
Buchung erfassen
|
||||
</Link>
|
||||
</Button>
|
||||
) : undefined
|
||||
}
|
||||
/>
|
||||
) : (
|
||||
<>
|
||||
<Table>
|
||||
<TableHeader>
|
||||
<TableRow>
|
||||
<TableHead>Datum</TableHead>
|
||||
<TableHead>Vorgang</TableHead>
|
||||
<TableHead>Konto</TableHead>
|
||||
<TableHead>Beleg</TableHead>
|
||||
<TableHead className="text-right">Betrag</TableHead>
|
||||
</TableRow>
|
||||
</TableHeader>
|
||||
<TableBody>
|
||||
{buchungen.map((buchung) => (
|
||||
<TableRow
|
||||
key={buchung.id}
|
||||
className={belegFehlt(buchung) ? 'bg-ampel-rot/5' : undefined}
|
||||
>
|
||||
<TableCell className="whitespace-nowrap align-top">
|
||||
{formatDatum(buchung.datum)}
|
||||
</TableCell>
|
||||
<TableCell className="align-top">
|
||||
<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">
|
||||
{RICHTUNG_BESCHRIFTUNG[buchung.richtung]} ·{' '}
|
||||
{KATEGORIE_BESCHRIFTUNG[buchung.kategorie]}
|
||||
</span>
|
||||
{buchung.verwendungszweck && (
|
||||
<span className="block text-sm text-muted-foreground">
|
||||
{buchung.verwendungszweck}
|
||||
</span>
|
||||
)}
|
||||
<span className="mt-1 flex flex-wrap gap-1.5">
|
||||
{!buchung.betrifftBetreute && (
|
||||
<Badge variant="secondary">eigene Auslage</Badge>
|
||||
)}
|
||||
{buchung.vermoegenswirksam && (
|
||||
<Badge variant="outline">vermögenswirksam</Badge>
|
||||
)}
|
||||
{vermischungsWarnung(buchung) && <Vermischungswarnung kurz />}
|
||||
</span>
|
||||
</TableCell>
|
||||
<TableCell className="align-top text-sm text-muted-foreground">
|
||||
{buchung.kontoBezeichnung ?? 'kein Konto'}
|
||||
</TableCell>
|
||||
<TableCell className="align-top">
|
||||
<Belegzeichen
|
||||
belegId={buchung.belegId}
|
||||
belegTitel={buchung.belegTitel ?? null}
|
||||
begruendung={buchung.belegFehltBegruendung}
|
||||
/>
|
||||
</TableCell>
|
||||
<TableCell className="text-right align-top">
|
||||
<Betrag cent={centZuZahl(buchung.betragCent)} richtung={buchung.richtung} />
|
||||
</TableCell>
|
||||
</TableRow>
|
||||
))}
|
||||
</TableBody>
|
||||
</Table>
|
||||
|
||||
{gesamt > buchungen.length && (
|
||||
<p className="text-sm text-muted-foreground">
|
||||
Es werden die {HOECHSTZAHL} jüngsten von {gesamt} Buchungen gezeigt. Grenze den
|
||||
Zeitraum ein, um die älteren zu sehen.
|
||||
</p>
|
||||
)}
|
||||
</>
|
||||
)}
|
||||
|
||||
<Rechtshinweis rechtsgrundlage="§ 1865 BGB" />
|
||||
</div>
|
||||
)
|
||||
}
|
||||
Reference in New Issue
Block a user