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,315 @@
|
||||
import { z } from 'zod'
|
||||
|
||||
/**
|
||||
* Eingabepruefung fuer die Dokumentenakte.
|
||||
*
|
||||
* Geprueft wird IMMER serverseitig - das Formular im Browser ist nur
|
||||
* Bequemlichkeit. Alle Meldungen sagen, was zu tun ist, nicht was falsch
|
||||
* war.
|
||||
*
|
||||
* Was hier bewusst NICHT steht: die Pruefung der Datei selbst. Groesse und
|
||||
* Dateityp entscheidet `src/lib/speicher` an den Magic Bytes - ein Zod-
|
||||
* Schema koennte dazu nur wiederholen, was der Browser behauptet.
|
||||
*/
|
||||
|
||||
const optionalerText = (max = 200) =>
|
||||
z
|
||||
.string()
|
||||
.trim()
|
||||
.max(max, `Bitte höchstens ${max} Zeichen.`)
|
||||
.transform((wert) => (wert === '' ? null : wert))
|
||||
.nullable()
|
||||
.optional()
|
||||
.transform((wert) => wert ?? null)
|
||||
|
||||
/** HTML-Datumsfelder liefern "" oder "2026-01-15". */
|
||||
const optionalesDatum = z
|
||||
.string()
|
||||
.trim()
|
||||
.nullable()
|
||||
.optional()
|
||||
.transform((wert) => (wert === '' || wert === undefined ? null : wert))
|
||||
.refine((wert) => wert === null || /^\d{4}-\d{2}-\d{2}$/.test(wert), {
|
||||
message: 'Bitte ein Datum im Format TT.MM.JJJJ wählen.',
|
||||
})
|
||||
.transform((wert) => (wert === null ? null : new Date(`${wert}T00:00:00.000Z`)))
|
||||
|
||||
export const DOKUMENT_ARTEN = [
|
||||
'BESCHEID',
|
||||
'ANTRAG',
|
||||
'SCHREIBEN',
|
||||
'RECHNUNG',
|
||||
'KONTOAUSZUG',
|
||||
'VERTRAG',
|
||||
'BESCHLUSS',
|
||||
'URKUNDE',
|
||||
'GUTACHTEN',
|
||||
'AUSWEIS',
|
||||
'PROTOKOLL',
|
||||
'QUITTUNG',
|
||||
'MAHNUNG',
|
||||
'VOLLMACHT',
|
||||
'ATTEST',
|
||||
'GRUNDBUCHAUSZUG',
|
||||
'FOTO',
|
||||
'SONSTIGES',
|
||||
] as const
|
||||
|
||||
export const DOKUMENT_RICHTUNGEN = ['EINGANG', 'AUSGANG', 'INTERN'] as const
|
||||
|
||||
export const POSTEINGANG_STUFEN = ['NEU', 'GESICHTET', 'ZUGEORDNET', 'BEANTWORTET'] as const
|
||||
|
||||
export const POSTEINGANG_BESCHRIFTUNG: Record<(typeof POSTEINGANG_STUFEN)[number], string> = {
|
||||
NEU: 'Neu',
|
||||
GESICHTET: 'Gesichtet',
|
||||
ZUGEORDNET: 'Zugeordnet',
|
||||
BEANTWORTET: 'Beantwortet',
|
||||
}
|
||||
|
||||
export const POSTEINGANG_ERKLAERUNG: Record<(typeof POSTEINGANG_STUFEN)[number], string> = {
|
||||
NEU: 'Liegt im Posteingang und wurde noch nicht angesehen.',
|
||||
GESICHTET: 'Angesehen, aber noch keinem Vorgang zugeordnet.',
|
||||
ZUGEORDNET: 'Einem Vorgang, einer Frist oder einer Buchung zugeordnet.',
|
||||
BEANTWORTET: 'Erledigt – beantwortet, bezahlt oder abgelegt.',
|
||||
}
|
||||
|
||||
/** Alle Ziele, mit denen sich ein Dokument verknuepfen laesst. */
|
||||
export const VERKNUEPFUNGSZIELE = [
|
||||
'vorgang',
|
||||
'frist',
|
||||
'buchung',
|
||||
'vermoegensposten',
|
||||
'immobilie',
|
||||
'vertrag',
|
||||
'kontaktprotokoll',
|
||||
'gesundheitsereignis',
|
||||
'genehmigung',
|
||||
'nachforderung',
|
||||
'bescheid',
|
||||
'kontakt',
|
||||
] as const
|
||||
|
||||
export type Verknuepfungsziel = (typeof VERKNUEPFUNGSZIELE)[number]
|
||||
|
||||
export const ZIEL_BESCHRIFTUNG: Record<Verknuepfungsziel, string> = {
|
||||
vorgang: 'Vorgang',
|
||||
frist: 'Frist',
|
||||
buchung: 'Buchung',
|
||||
vermoegensposten: 'Vermögensposten',
|
||||
immobilie: 'Immobilie',
|
||||
vertrag: 'Vertrag',
|
||||
kontaktprotokoll: 'Gesprächsnotiz',
|
||||
gesundheitsereignis: 'Gesundheitsereignis',
|
||||
genehmigung: 'Genehmigung',
|
||||
nachforderung: 'Nachforderung',
|
||||
bescheid: 'Bescheid',
|
||||
kontakt: 'Kontakt',
|
||||
}
|
||||
|
||||
/** Die Spalte in DokumentVerknuepfung, die zu einem Ziel gehoert. */
|
||||
export const ZIEL_SPALTE: Record<Verknuepfungsziel, string> = {
|
||||
vorgang: 'vorgangId',
|
||||
frist: 'fristId',
|
||||
buchung: 'buchungId',
|
||||
vermoegensposten: 'vermoegenspostenId',
|
||||
immobilie: 'immobilieId',
|
||||
vertrag: 'vertragId',
|
||||
kontaktprotokoll: 'kontaktprotokollId',
|
||||
gesundheitsereignis: 'gesundheitsereignisId',
|
||||
genehmigung: 'genehmigungId',
|
||||
nachforderung: 'nachforderungId',
|
||||
bescheid: 'bescheidId',
|
||||
kontakt: 'kontaktId',
|
||||
}
|
||||
|
||||
const kennung = z
|
||||
.string()
|
||||
.trim()
|
||||
.min(1)
|
||||
.max(64)
|
||||
.regex(/^[A-Za-z0-9_-]+$/, 'Diese Kennung sieht nicht wie eine gültige Kennung aus.')
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// Metadaten
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
export const DokumentMetadatenSchema = z
|
||||
.object({
|
||||
titel: z
|
||||
.string()
|
||||
.trim()
|
||||
.min(2, 'Bitte einen Titel angeben – daran findest du das Dokument später wieder.')
|
||||
.max(200, 'Bitte höchstens 200 Zeichen.'),
|
||||
art: z.enum(DOKUMENT_ARTEN),
|
||||
richtung: z.enum(DOKUMENT_RICHTUNGEN),
|
||||
|
||||
schreibenVom: optionalesDatum,
|
||||
eingangAm: optionalesDatum,
|
||||
versandAm: optionalesDatum,
|
||||
|
||||
absender: optionalerText(200),
|
||||
empfaenger: optionalerText(200),
|
||||
aktenzeichen: optionalerText(100),
|
||||
|
||||
/** Wo liegt das Original im Papierordner? Papier bleibt Papier. */
|
||||
ablageortPapier: optionalerText(150),
|
||||
|
||||
wiedervorlageAm: optionalesDatum,
|
||||
ablaufAm: optionalesDatum,
|
||||
|
||||
posteingangStatus: z.enum(POSTEINGANG_STUFEN).optional(),
|
||||
|
||||
notizen: optionalerText(4000),
|
||||
|
||||
/** Bestehende Tag-Kennungen. */
|
||||
tagIds: z.array(kennung).max(20).optional(),
|
||||
/** Neue Tags, mit Komma getrennt eingegeben. */
|
||||
neueTags: optionalerText(200),
|
||||
})
|
||||
.refine(
|
||||
(daten) =>
|
||||
!daten.schreibenVom ||
|
||||
!daten.eingangAm ||
|
||||
daten.schreibenVom.getTime() <= daten.eingangAm.getTime(),
|
||||
{
|
||||
message: 'Das Schreiben kann nicht nach seinem Eingang datiert sein. Bitte prüfen.',
|
||||
path: ['eingangAm'],
|
||||
},
|
||||
)
|
||||
|
||||
export type DokumentMetadaten = z.output<typeof DokumentMetadatenSchema>
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// Upload
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Beim Hochladen darf fast alles fehlen: Ziel ist, dass ein Foto in zwei
|
||||
* Klicks in der Akte liegt. Die Metadaten kommen im zweiten Schritt aus den
|
||||
* Erkennungsvorschlaegen.
|
||||
*/
|
||||
export const UploadSchema = z.object({
|
||||
titel: optionalerText(200),
|
||||
art: z.enum(DOKUMENT_ARTEN).optional(),
|
||||
richtung: z.enum(DOKUMENT_RICHTUNGEN).optional(),
|
||||
eingangAm: optionalesDatum,
|
||||
absender: optionalerText(200),
|
||||
aktenzeichen: optionalerText(100),
|
||||
ablageortPapier: optionalerText(150),
|
||||
/** Direkt beim Hochladen mit einem Vorgang verknuepfen. */
|
||||
vorgangId: kennung.optional().nullable(),
|
||||
})
|
||||
|
||||
export type Uploadeingabe = z.output<typeof UploadSchema>
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// Verknuepfung
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
export const VerknuepfungSchema = z.object({
|
||||
dokumentId: kennung,
|
||||
ziel: z.enum(VERKNUEPFUNGSZIELE),
|
||||
zielId: kennung,
|
||||
bemerkung: optionalerText(200),
|
||||
})
|
||||
|
||||
export const PosteingangSchema = z.object({
|
||||
dokumentId: kennung,
|
||||
status: z.enum(POSTEINGANG_STUFEN),
|
||||
})
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// Frist aus einem Erkennungsvorschlag
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
/**
|
||||
* Aus einem Fristvorschlag wird nur dann eine Frist, wenn der Nutzer sie
|
||||
* ausdruecklich uebernimmt. Das Schema prueft genau das, was er dabei
|
||||
* bestaetigt hat - Datum und Titel sind Pflicht.
|
||||
*/
|
||||
export const FristUebernehmenSchema = z.object({
|
||||
dokumentId: kennung,
|
||||
titel: z
|
||||
.string()
|
||||
.trim()
|
||||
.min(3, 'Bitte einen Titel angeben, an dem du die Frist wiedererkennst.')
|
||||
.max(200),
|
||||
datum: z
|
||||
.string()
|
||||
.trim()
|
||||
.regex(/^\d{4}-\d{2}-\d{2}$/, 'Bitte ein Datum im Format TT.MM.JJJJ wählen.')
|
||||
.transform((wert) => new Date(`${wert}T00:00:00.000Z`)),
|
||||
typ: z.enum(['GESETZLICH', 'BEHOERDLICH', 'SELBST_GESETZT', 'WIEDERVORLAGE']).default('BEHOERDLICH'),
|
||||
beschreibung: optionalerText(1000),
|
||||
rechtsgrundlage: optionalerText(120),
|
||||
/** Rechtsbehelfsfristen sind Ausschlussfristen - sie verfallen. */
|
||||
ausschlussfrist: z.coerce.boolean().optional().default(false),
|
||||
vorgangId: kennung.optional().nullable(),
|
||||
})
|
||||
|
||||
// -----------------------------------------------------------------------------
|
||||
// Filter der Liste
|
||||
// -----------------------------------------------------------------------------
|
||||
|
||||
export const ListenfilterSchema = z.object({
|
||||
suche: optionalerText(200),
|
||||
art: z.enum(DOKUMENT_ARTEN).optional().nullable(),
|
||||
richtung: z.enum(DOKUMENT_RICHTUNGEN).optional().nullable(),
|
||||
posteingangStatus: z.enum(POSTEINGANG_STUFEN).optional().nullable(),
|
||||
von: optionalesDatum,
|
||||
bis: optionalesDatum,
|
||||
tagId: kennung.optional().nullable(),
|
||||
seite: z.coerce.number().int().min(1).max(1000).optional().default(1),
|
||||
})
|
||||
|
||||
/**
|
||||
* Liest die Filter aus den Suchparametern der Seite. Unbrauchbare Werte
|
||||
* werden stillschweigend verworfen - eine kaputte URL soll die Liste nicht
|
||||
* mit einer Fehlermeldung ersetzen.
|
||||
*/
|
||||
export function filterAusParametern(
|
||||
parameter: Record<string, string | string[] | undefined>,
|
||||
): z.output<typeof ListenfilterSchema> {
|
||||
const einzeln = (name: string): string | undefined => {
|
||||
const wert = parameter[name]
|
||||
const roh = Array.isArray(wert) ? wert[0] : wert
|
||||
return roh && roh.trim() !== '' ? roh : undefined
|
||||
}
|
||||
|
||||
const gelesen = ListenfilterSchema.safeParse({
|
||||
suche: einzeln('suche'),
|
||||
art: einzeln('art'),
|
||||
richtung: einzeln('richtung'),
|
||||
posteingangStatus: einzeln('status'),
|
||||
von: einzeln('von'),
|
||||
bis: einzeln('bis'),
|
||||
tagId: einzeln('tag'),
|
||||
seite: einzeln('seite') ?? 1,
|
||||
})
|
||||
|
||||
if (gelesen.success) return gelesen.data
|
||||
|
||||
return {
|
||||
suche: einzeln('suche')?.slice(0, 200) ?? null,
|
||||
art: null,
|
||||
richtung: null,
|
||||
posteingangStatus: null,
|
||||
von: null,
|
||||
bis: null,
|
||||
tagId: null,
|
||||
seite: 1,
|
||||
}
|
||||
}
|
||||
|
||||
/** Aus "Bezirk, Pflege , Wichtig" werden drei saubere Tag-Namen. */
|
||||
export function tagsAufteilen(roh: string | null | undefined): string[] {
|
||||
if (!roh) return []
|
||||
return [
|
||||
...new Set(
|
||||
roh
|
||||
.split(',')
|
||||
.map((name) => name.trim().replace(/\s+/g, ' '))
|
||||
.filter((name) => name.length >= 2 && name.length <= 40),
|
||||
),
|
||||
].slice(0, 20)
|
||||
}
|
||||
Reference in New Issue
Block a user