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
2026-08-22 02:35:08 +02:00
parent 6b4df4c9cb
commit 3833a9dd8f
141 changed files with 30302 additions and 66 deletions
@@ -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>
+  )
+}