// Dokument-Registry der veroeffentlichten Rechtstexte (je Fassung feste Dateien unter public/rechtliches/): // Saetze 'analyse' (AVV, Leistungsbeschreibung der Website-Analyse) und 'termine' (Leistungsbeschreibung, AVV und // Widerrufsbelehrung mit Muster-Widerrufsformular des Terminplaners). analyseLegal.js ist ein duenner Wrapper darum. // Die Fassung ist der Berliner Kalendertag der Texte (JJJJ-MM-TT); eine ausgelieferte Fassung wird nie ueberschrieben. import { access, readFile } from 'node:fs/promises' import { fileURLToPath } from 'node:url' import { join } from 'node:path' import { Router } from 'express' import { config } from '../config.js' const publicDir = fileURLToPath(new URL('../../public/', import.meta.url)) const VERSION_RE = /^\d{4}-\d{2}-\d{2}$/ /** * Dokumente je Satz in Anhangsreihenfolge: slug = Dateiname der HTML-Seite und des PDFs (-.html|pdf), * pdf = Dateiname des Mail-Anhangs (-.pdf). config.js baut die Adressen des Terminplaners aus denselben * Slugs (config.js darf diese Datei nicht importieren); test/legalDocs.test.js gleicht beide ab. */ const SAETZE = { analyse: { avv: { slug: 'avv-website-analyse', pdf: 'AVV-Website-Analyse' }, lb: { slug: 'leistungsbeschreibung-website-analyse', pdf: 'Leistungsbeschreibung-Website-Analyse' }, }, termine: { lb: { slug: 'leistungsbeschreibung-terminplaner', pdf: 'Leistungsbeschreibung-Terminplaner' }, avv: { slug: 'avv-terminplaner', pdf: 'AVV-Terminplaner' }, widerruf: { slug: 'widerrufsbelehrung-funktionen', pdf: 'Widerrufsbelehrung-Muster-Widerrufsformular' }, }, } /** Satz, dessen Dokumente eine Funktion (Registerschluessel) mit der Bestellung bekommt; News hat keine. */ const FUNKTION_SATZ = { news: null, termine: 'termine' } /** Aktuelle Fassung je Satz, bei jedem Aufruf aus config gelesen (Tests aendern sie zur Laufzeit). */ const aktuelleFassung = (satz) => (satz === 'analyse' ? config.analyse.avvVersion : config.termine.avvVersion) function satzDokumente(satz) { if (typeof satz !== 'string' || !Object.hasOwn(SAETZE, satz)) throw new Error('Rechtstexte: unbekannter Satz') return SAETZE[satz] } function pruefeFassung(version) { if (!VERSION_RE.test(String(version))) throw new Error('Rechtstexte: ungültige Fassung') return String(version) } /** Adressen der versionierten HTML-Seiten: { [doc]: '/rechtliches/-.html' }. */ export function legalPaths(satz, version) { const dokumente = satzDokumente(satz) const v = pruefeFassung(version) return Object.fromEntries(Object.entries(dokumente).map(([doc, d]) => [doc, `/rechtliches/${d.slug}-${v}.html`])) } /** PDF je Dokument: { [doc]: { filename (Anhangsname), path (Datei unter public/rechtliches/) } }. */ export function legalPdfFiles(satz, version) { const dokumente = satzDokumente(satz) const v = pruefeFassung(version) return Object.fromEntries( Object.entries(dokumente).map(([doc, d]) => [doc, { filename: `${d.pdf}-${v}.pdf`, path: join(publicDir, 'rechtliches', `${d.slug}-${v}.pdf`) }]) ) } /** * PDFs als Mail-Anhaenge in der Reihenfolge des Satzes (termine: lb, avv, widerruf; analyse: avv, lb); wirft, wenn eine * Datei fehlt oder nicht lesbar ist. ohne: Dokumente, die nicht angehaengt werden (sie muessen nicht vorhanden sein). */ export async function legalPdfAttachments(satz, version, { ohne = [] } = {}) { const dateien = legalPdfFiles(satz, version) for (const doc of ohne) { if (!Object.hasOwn(dateien, doc)) throw new Error('Rechtstexte: unbekanntes Dokument') } return Promise.all( Object.entries(dateien) .filter(([doc]) => !ohne.includes(doc)) .map(async ([, f]) => ({ filename: f.filename, content: await readFile(f.path), contentType: 'application/pdf' })) ) } function funktionSatz(featureKey) { if (typeof featureKey !== 'string' || !Object.hasOwn(FUNKTION_SATZ, featureKey)) throw new Error('Rechtstexte: unbekannte Funktion') return FUNKTION_SATZ[featureKey] } /** * Anhaenge der Bestellmail einer Funktion in der aktuellen Fassung: termine => Satz 'termine', news => []. Wirft bei * unbekannter Funktion und bei fehlender Datei (der Aufrufer entscheidet, was dann geschieht). */ export async function featureLegalAttachments(featureKey, opts) { const satz = funktionSatz(featureKey) return satz ? legalPdfAttachments(satz, aktuelleFassung(satz), opts) : [] } /** * true, wenn alle Rechtsdokumente der Funktion in der aktuellen Fassung vorliegen: HTML-Seiten (die die Bestellseite * verlinkt) und PDFs (die Mail anhaengt). Unbekannte Funktion und jeder Lesefehler: false (fail-closed). */ export async function featureLegalReady(featureKey) { try { const satz = funktionSatz(featureKey) if (!satz) return true const v = aktuelleFassung(satz) await Promise.all(Object.values(legalPaths(satz, v)).map((adresse) => access(join(publicDir, adresse)))) await legalPdfAttachments(satz, v) return true } catch { return false } } /** * Adressen ohne Fassung (/rechtliches/.html) liefern die Datei der aktuellen Fassung aus config. Nur fuer * Menschen und die WOMS-Karten: keine Mail und kein Zustimmungstext darf sie verlinken, denn sie aendern sich mit der * Fassung. Gehoert vor express.static; fehlt die Datei, geht die Anfrage weiter (404). saetze: welche Saetze bedient * werden, dir: Verzeichnis der Dateien (Standard public/rechtliches, Tests uebergeben ein eigenes). */ export function legalRouter({ saetze = Object.keys(SAETZE), dir = join(publicDir, 'rechtliches') } = {}) { const router = Router() for (const satz of saetze) { for (const d of Object.values(satzDokumente(satz))) { router.get(`/${d.slug}.html`, (_req, res, next) => { const datei = join(dir, `${d.slug}-${pruefeFassung(aktuelleFassung(satz))}.html`) res.sendFile(datei, (err) => err && next(err.code === 'ENOENT' ? undefined : err)) }) } } return router }