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,57 @@
|
||||
import Link from 'next/link'
|
||||
import { HinweisKarte } from '@/components/hinweise/hinweis-karte'
|
||||
import { cn } from '@/lib/utils'
|
||||
import { hinweiseFuerKontext } from '@/lib/hinweise/laden'
|
||||
|
||||
/**
|
||||
* Zeigt die Hinweiskarten, die zum Kontext einer Seite passen.
|
||||
*
|
||||
* Die Karten kommen aus daten/hinweise.json und sind kein Beiwerk: Sie
|
||||
* stehen an der Stelle, an der ein Fehler teuer wuerde - die Warnung vor
|
||||
* der Genehmigungspflicht steht neben der Wohnungsaufloesung, nicht in
|
||||
* einem Handbuch. Zu jeder Karte gehoert der stehende Rechtshinweis: Das
|
||||
* hier ist eine Gedaechtnisstuetze, keine Rechtsberatung.
|
||||
*
|
||||
* Kontexte sind Modulnamen ("IMMOBILIE"), "VORGANG:<Kategorie>",
|
||||
* "VORLAGE:<schluessel>" oder "FRIST:<systemSchluessel>". Ein Ausloeser
|
||||
* ohne Jahreszahl passt auch auf die Frist mit Jahreszahl, damit
|
||||
* "FRIST:jahresbericht" nicht jaehrlich nachgepflegt werden muss.
|
||||
*
|
||||
* Serverkomponente - sie liest die Wissensbasis von der Platte.
|
||||
*/
|
||||
export function HinweisKarten({
|
||||
kontext,
|
||||
grenze = 3,
|
||||
ueberschrift = 'Darauf solltest du achten',
|
||||
className,
|
||||
}: {
|
||||
kontext: readonly string[]
|
||||
/** Wie viele Karten hoechstens? Mehr als drei liest niemand. */
|
||||
grenze?: number
|
||||
ueberschrift?: string
|
||||
className?: string
|
||||
}) {
|
||||
const karten = hinweiseFuerKontext(kontext, grenze)
|
||||
if (karten.length === 0) return null
|
||||
|
||||
return (
|
||||
<section className={cn('space-y-3', className)} aria-label={ueberschrift}>
|
||||
<div className="flex items-baseline justify-between gap-3">
|
||||
<h2 className="text-base font-semibold">{ueberschrift}</h2>
|
||||
<Link
|
||||
href="/hinweise"
|
||||
className="text-sm text-muted-foreground underline-offset-4 hover:underline"
|
||||
>
|
||||
Alle Hinweise
|
||||
</Link>
|
||||
</div>
|
||||
<div className="grid gap-3 md:grid-cols-2 xl:grid-cols-3">
|
||||
{karten.map((karte) => (
|
||||
<HinweisKarte key={karte.schluessel} karte={karte} klein />
|
||||
))}
|
||||
</div>
|
||||
</section>
|
||||
)
|
||||
}
|
||||
|
||||
export { HinweisKarte }
|
||||
@@ -0,0 +1,44 @@
|
||||
import Link from 'next/link'
|
||||
import { ExternalLink, Lightbulb } from 'lucide-react'
|
||||
import { Rechtshinweis } from '@/components/rechtshinweis'
|
||||
import { Card, CardContent, CardHeader, CardTitle } from '@/components/ui/card'
|
||||
import { Badge } from '@/components/ui/badge'
|
||||
import { cn } from '@/lib/utils'
|
||||
import type { Hinweiskarte } from '@/lib/hinweise/laden'
|
||||
|
||||
/**
|
||||
* Die Darstellung einer einzelnen Hinweiskarte.
|
||||
*
|
||||
* Bewusst in einer eigenen Datei und ohne Zugriff auf die Wissensbasis:
|
||||
* Diese Komponente wird auch aus der Suche im Browser heraus benutzt, und
|
||||
* das Laden der JSON-Datei geht ueber "node:fs" - das darf nie im
|
||||
* Browserbuendel landen. Deshalb hier nur der Typ, nie der Lader.
|
||||
*/
|
||||
export function HinweisKarte({ karte, klein = false }: { karte: Hinweiskarte; klein?: boolean }) {
|
||||
return (
|
||||
<Card className={cn(klein && 'shadow-none')}>
|
||||
<CardHeader className="flex flex-row items-start gap-3 space-y-0">
|
||||
<Lightbulb className="mt-0.5 size-5 shrink-0 text-ampel-gelb" aria-hidden="true" />
|
||||
<div className="min-w-0 space-y-1">
|
||||
<CardTitle className={cn('leading-snug', klein ? 'text-base' : 'text-lg')}>
|
||||
{karte.titel}
|
||||
</CardTitle>
|
||||
<Badge variant="outline">{karte.rechtsgrundlage}</Badge>
|
||||
</div>
|
||||
</CardHeader>
|
||||
<CardContent className="space-y-3">
|
||||
<p className="text-sm leading-relaxed">{karte.text}</p>
|
||||
<Link
|
||||
href={karte.link}
|
||||
target="_blank"
|
||||
rel="noopener noreferrer"
|
||||
className="inline-flex min-h-11 items-center gap-1.5 text-sm font-medium text-primary underline-offset-4 hover:underline"
|
||||
>
|
||||
{karte.rechtsgrundlage} im Gesetzestext nachlesen
|
||||
<ExternalLink className="size-4" aria-hidden="true" />
|
||||
</Link>
|
||||
<Rechtshinweis rechtsgrundlage={karte.rechtsgrundlage} kurz />
|
||||
</CardContent>
|
||||
</Card>
|
||||
)
|
||||
}
|
||||
@@ -0,0 +1,82 @@
|
||||
'use client'
|
||||
|
||||
import * as React from 'react'
|
||||
import { Search } from 'lucide-react'
|
||||
import { Feld } from '@/components/feld'
|
||||
import { Input } from '@/components/ui/input'
|
||||
import { Leerzustand } from '@/components/seiten-kopf'
|
||||
import { HinweisKarte } from '@/components/hinweise/hinweis-karte'
|
||||
import type { Hinweiskarte } from '@/lib/hinweise/laden'
|
||||
|
||||
/**
|
||||
* Durchsuchbare Liste aller Hinweiskarten.
|
||||
*
|
||||
* Die Karten kommen fertig geladen von der Serverseite - gesucht wird im
|
||||
* Browser, weil es nur ein paar Dutzend sind und jede Runde zum Server
|
||||
* sich beim Tippen wie Warten anfuehlen wuerde. Die Suchlogik steht hier
|
||||
* noch einmal, statt aus lib/hinweise/laden.ts importiert zu werden: Jenes
|
||||
* Modul liest die Datei mit "node:fs" und gehoert nicht ins Browserbuendel.
|
||||
*/
|
||||
function suchen(karten: Hinweiskarte[], suche: string): Hinweiskarte[] {
|
||||
const sortiert = [...karten].sort(
|
||||
(a, b) => b.gewicht - a.gewicht || a.titel.localeCompare(b.titel, 'de'),
|
||||
)
|
||||
const begriff = suche.trim().toLowerCase()
|
||||
if (begriff === '') return sortiert
|
||||
|
||||
return sortiert.filter((karte) =>
|
||||
[karte.titel, karte.text, karte.rechtsgrundlage, karte.schluessel, ...karte.kontext]
|
||||
.join(' ')
|
||||
.toLowerCase()
|
||||
.includes(begriff),
|
||||
)
|
||||
}
|
||||
|
||||
export function HinweisSuche({ karten }: { karten: Hinweiskarte[] }) {
|
||||
const [suche, setSuche] = React.useState('')
|
||||
const treffer = React.useMemo(() => suchen(karten, suche), [karten, suche])
|
||||
|
||||
return (
|
||||
<div className="space-y-5">
|
||||
<Feld
|
||||
id="hinweis-suche"
|
||||
beschriftung="Suchen"
|
||||
erklaerung="Sucht in Überschrift, Text, Rechtsgrundlage und Auslöser – zum Beispiel „Genehmigung“, „1878“ oder „Heim“."
|
||||
>
|
||||
<div className="relative">
|
||||
<Search
|
||||
className="pointer-events-none absolute left-3 top-1/2 size-4 -translate-y-1/2 opacity-60"
|
||||
aria-hidden="true"
|
||||
/>
|
||||
<Input
|
||||
type="search"
|
||||
value={suche}
|
||||
onChange={(ereignis) => setSuche(ereignis.target.value)}
|
||||
placeholder="Stichwort oder Paragraph"
|
||||
className="pl-9"
|
||||
autoComplete="off"
|
||||
/>
|
||||
</div>
|
||||
</Feld>
|
||||
|
||||
<p className="text-sm text-muted-foreground" aria-live="polite">
|
||||
{treffer.length === karten.length
|
||||
? `${karten.length} Hinweise`
|
||||
: `${treffer.length} von ${karten.length} Hinweisen`}
|
||||
</p>
|
||||
|
||||
{treffer.length === 0 ? (
|
||||
<Leerzustand
|
||||
titel="Dazu ist nichts hinterlegt"
|
||||
beschreibung="Die Hinweise stehen in daten/hinweise.json. Fehlt dir etwas, das du immer wieder nachschlägst, trag es dort nach – die Datei wird beim nächsten Start eingelesen."
|
||||
/>
|
||||
) : (
|
||||
<div className="grid gap-4 md:grid-cols-2">
|
||||
{treffer.map((karte) => (
|
||||
<HinweisKarte key={karte.schluessel} karte={karte} />
|
||||
))}
|
||||
</div>
|
||||
)}
|
||||
</div>
|
||||
)
|
||||
}
|
||||
Reference in New Issue
Block a user