Shop J1: Leistungsbeschreibung und AVV Webshop (Fassung 2026-10-05) als Markdown, HTML, PDF und Prüfsumme, Satz/Modus shop in den Build-Skripten, Kanzlei-Fragenliste
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
1 parent
b8055b336c
commit
17ad5cbcdc
13 files changed
+1066
-25
No files matched your search
@@ -5,8 +5,10 @@
|
||||
//
|
||||
// node scripts/build-legal-html.mjs termine schreibt die drei Seiten des Terminplaners
|
||||
// node scripts/build-legal-html.mjs termine --check vergleicht mit den eingecheckten Seiten (Exit 1 bei Abweichung, schreibt nichts)
|
||||
// node scripts/build-legal-html.mjs shop [--check] dasselbe für Leistungsbeschreibung und AVV des Webshops (die Widerrufsbelehrung der
|
||||
// Funktionen gehört zum Satz termine und wird von shop nicht angefasst)
|
||||
//
|
||||
// Fassung = config.termine.avvVersion. Die Ausgabe enthält keine Datumsangabe außer der Fassung und hängt nur vom Markdown und
|
||||
// Fassung = config.termine.avvVersion (Satz termine) bzw. config.shop.fassung (Satz shop). Die Ausgabe enthält keine Datumsangabe außer der Fassung und hängt nur vom Markdown und
|
||||
// von der Fassung ab (zweimal erzeugen ergibt dieselben Bytes). Unterstützte Teilmenge von Markdown: Überschriften # bis ###
|
||||
// (# nur als erste Zeile), Absätze, Listen mit "- ", **fett**, `code` und Tabellen (Kopfzeile, Trennzeile |---|---|, Zeilen).
|
||||
// Jede andere Syntax (Codeblöcke, Zitate, Bilder, Links, rohes HTML, nummerierte Listen, Einrückungen, Trennlinien) bricht laut ab,
|
||||
@@ -257,50 +259,74 @@ ${STYLE(meta.seitenkopf)} </style>
|
||||
|
||||
// ---------------------------------------------------------------------------------------------------------- Dokumentsätze
|
||||
|
||||
/** Namen je Dokument des Terminplaners (Schlüssel wie in legalPaths: lb, avv, widerruf). */
|
||||
/** Namen je Dokument (Schlüssel wie in legalPaths: lb, avv, widerruf): Seitentitel und Kopfzeile des Drucks. */
|
||||
const TERMINE_NAMEN = {
|
||||
lb: { titel: 'Leistungsbeschreibung Terminplaner', seitenkopf: 'Leistungsbeschreibung Terminplaner' },
|
||||
avv: { titel: 'Auftragsverarbeitungsvertrag Terminplaner', seitenkopf: 'AVV Terminplaner' },
|
||||
widerruf: { titel: 'Widerrufsbelehrung und Muster-Widerrufsformular (Funktionen)', seitenkopf: 'Widerrufsbelehrung Funktionen' },
|
||||
}
|
||||
const NAV_NAMEN = { lb: 'Leistungsbeschreibung Terminplaner', avv: 'AVV Terminplaner', widerruf: 'Widerrufsbelehrung Funktionen' }
|
||||
const SHOP_NAMEN = {
|
||||
lb: { titel: 'Leistungsbeschreibung Webshop', seitenkopf: 'Leistungsbeschreibung Webshop' },
|
||||
avv: { titel: 'Auftragsverarbeitungsvertrag Webshop', seitenkopf: 'AVV Webshop' },
|
||||
}
|
||||
const NAV_NAMEN = {
|
||||
termine: { lb: 'Leistungsbeschreibung Terminplaner', avv: 'AVV Terminplaner', widerruf: 'Widerrufsbelehrung Funktionen' },
|
||||
shop: { lb: 'Leistungsbeschreibung Webshop', avv: 'AVV Webshop', widerruf: 'Widerrufsbelehrung Funktionen' },
|
||||
}
|
||||
|
||||
/**
|
||||
* Die drei Dokumente des Terminplaners in der Fassung: { doc, md, html, meta } mit Pfaden relativ zur Wurzel des Projekts.
|
||||
* Dokumente eines Satzes in der Fassung: { doc, md, html, meta } mit Pfaden relativ zur Wurzel des Projekts.
|
||||
* namen = die Dokumente, die dieser Satz erzeugt (Schlüssel von legalPaths); die Navigation verlinkt alle Dokumente des Satzes.
|
||||
* Quelle docs/rechtliches/<slug>.md, Ziel public/rechtliches/<slug>-<Fassung>.html (Slugs und Adressen aus legalDocs.js).
|
||||
*/
|
||||
export function termineDokumente(fassung = config.termine.avvVersion) {
|
||||
const adressen = legalPaths('termine', fassung)
|
||||
function dokumenteDesSatzes(satz, fassung, namen) {
|
||||
const adressen = legalPaths(satz, fassung)
|
||||
const nav = [
|
||||
{ href: '/dashboard.html', text: '← Kundenportal' },
|
||||
{ href: '/abo-bedingungen.html', text: 'Abo-Bedingungen' },
|
||||
...Object.keys(adressen).map((doc) => ({ href: adressen[doc], text: NAV_NAMEN[doc] })),
|
||||
...Object.keys(adressen).map((doc) => ({ href: adressen[doc], text: NAV_NAMEN[satz][doc] })),
|
||||
{ href: '/datenschutz.html', text: 'Datenschutzerklärung' },
|
||||
{ href: 'https://webklar.com/impressum', text: 'Impressum' },
|
||||
]
|
||||
return Object.entries(adressen).map(([doc, adresse]) => ({
|
||||
return Object.keys(namen).map((doc) => ({
|
||||
doc,
|
||||
md: `docs/rechtliches/${basename(adresse, `-${fassung}.html`)}.md`,
|
||||
html: `public${adresse}`,
|
||||
meta: { fassung, ...TERMINE_NAMEN[doc], nav },
|
||||
md: `docs/rechtliches/${basename(adressen[doc], `-${fassung}.html`)}.md`,
|
||||
html: `public${adressen[doc]}`,
|
||||
meta: { fassung, ...namen[doc], nav },
|
||||
}))
|
||||
}
|
||||
|
||||
/** Die drei Dokumente des Terminplaners (lb, avv, widerruf) in der Fassung config.termine.avvVersion. */
|
||||
export function termineDokumente(fassung = config.termine.avvVersion) {
|
||||
return dokumenteDesSatzes('termine', fassung, TERMINE_NAMEN)
|
||||
}
|
||||
|
||||
/**
|
||||
* Die Dokumente des Webshops in der Fassung config.shop.fassung: lb und avv. Die Widerrufsbelehrung der Funktionen (dritte Adresse
|
||||
* des Satzes shop) ist dieselbe Datei wie die des Terminplaners und wird nur vom Satz termine erzeugt; die Navigation verlinkt sie.
|
||||
*/
|
||||
export function shopDokumente(fassung = config.shop.fassung) {
|
||||
return dokumenteDesSatzes('shop', fassung, SHOP_NAMEN)
|
||||
}
|
||||
|
||||
/** Sätze der Kommandozeile: Name => Dokumente. */
|
||||
const SAETZE = { termine: termineDokumente, shop: shopDokumente }
|
||||
|
||||
// ---------------------------------------------------------------------------------------------------------- Aufruf
|
||||
|
||||
/**
|
||||
* Kommandozeile: `termine [--check]`. root = Wurzel des Projekts (Tests übergeben ein Verzeichnis mit Kopien).
|
||||
* Kommandozeile: `termine|shop [--check]`. root = Wurzel des Projekts (Tests übergeben ein Verzeichnis mit Kopien).
|
||||
* => Exit-Code: 0 ok, 1 mindestens eine Seite weicht ab (nur --check), 2 falscher Aufruf
|
||||
*/
|
||||
export function lauf(argv, { root = ROOT, log = console.log, fehler = console.error } = {}) {
|
||||
const [satz, ...optionen] = argv
|
||||
const pruefen = optionen.includes('--check')
|
||||
if (satz !== 'termine' || optionen.some((o) => o !== '--check')) {
|
||||
fehler('Aufruf: node scripts/build-legal-html.mjs termine [--check]')
|
||||
if (!Object.hasOwn(SAETZE, satz ?? '') || optionen.some((o) => o !== '--check')) {
|
||||
fehler('Aufruf: node scripts/build-legal-html.mjs termine|shop [--check]')
|
||||
return 2
|
||||
}
|
||||
let abweichungen = 0
|
||||
for (const d of termineDokumente()) {
|
||||
for (const d of SAETZE[satz]()) {
|
||||
const html = render(readFileSync(join(root, d.md), 'utf8'), d.meta)
|
||||
const ziel = join(root, d.html)
|
||||
if (pruefen) {
|
||||
|
||||
@@ -1,12 +1,15 @@
|
||||
#!/usr/bin/env bash
|
||||
# Erzeugt die Druck-/PDF-Fassungen der Vertragsunterlagen aus den HTML-Quellen.
|
||||
# Laeuft auf dem Host (braucht Chrome/Chromium), die PDFs werden eingecheckt.
|
||||
# Usage: CHROME=/pfad/zu/chrome scripts/build-legal-pdfs.sh [all|analyse|termine|datenschutz]
|
||||
# Usage: CHROME=/pfad/zu/chrome scripts/build-legal-pdfs.sh [all|analyse|termine|shop|datenschutz]
|
||||
# analyse = nur AVV und Leistungsbeschreibung der Website-Analyse (Fassung ANALYSE_VERSION), andere PDFs bleiben unveraendert
|
||||
# termine = Leistungsbeschreibung, AVV und Widerrufsbelehrung des Terminplaners (Fassung TERMINE_VERSION, Standard: config.termine.avvVersion);
|
||||
# die HTML-Seiten kommen vorher aus `node scripts/build-legal-html.mjs termine`. Neben jedem PDF liegt <PDF>.sha256 mit der
|
||||
# SHA-256 der HTML-Seite, aus der es gedruckt wurde (test/buildLegalHtml.test.js prueft, dass beide zusammenpassen). Ein PDF,
|
||||
# dessen Pruefsumme noch stimmt, wird nicht neu gedruckt (FORCE=1 druckt alle neu).
|
||||
# shop = Leistungsbeschreibung und AVV des Webshops (Fassung SHOP_VERSION, Standard: config.shop.fassung); die HTML-Seiten kommen vorher
|
||||
# aus `node scripts/build-legal-html.mjs shop`, Pruefsumme und Neudruck wie bei termine. Die Widerrufsbelehrung der Funktionen
|
||||
# gehoert zu termine (dieselbe Datei) und wird hier nicht gedruckt. `all` druckt auch diese beiden PDFs.
|
||||
# datenschutz = nur die Datenschutzerklaerung (docs/WEBklar-Datenschutzerklaerung.pdf); daneben liegt <PDF>.sha256 mit der SHA-256 von
|
||||
# public/datenschutz.html (test/legalTexts.test.js prueft sie); ein PDF mit passender Pruefsumme wird nicht neu gedruckt (FORCE=1 druckt neu)
|
||||
# Vorher `free -m` pruefen und mit `nice` aufrufen; jeder Chrome-Aufruf laeuft hoechstens 120 Sekunden (timeout), die PDFs nacheinander.
|
||||
@@ -34,6 +37,34 @@ termine_version() {
|
||||
echo "$v"
|
||||
}
|
||||
|
||||
# Fassung des Webshops: SHOP_VERSION, sonst die Konstante des Servers
|
||||
shop_version() {
|
||||
local v="${SHOP_VERSION:-}"
|
||||
if [ -z "$v" ]; then
|
||||
v="$(timeout 60 node --max-old-space-size=256 --input-type=module -e "const { config } = await import('./server/config.js'); console.log(config.shop.fassung)")"
|
||||
fi
|
||||
[[ "$v" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || { echo "Ungueltige Fassung: $v" >&2; exit 1; }
|
||||
echo "$v"
|
||||
}
|
||||
|
||||
# Leistungsbeschreibung und AVV des Webshops drucken (je PDF nur, wenn die Pruefsumme der HTML-Seite nicht mehr passt)
|
||||
shop_pdfs() {
|
||||
local fassung slug quelle ziel summe
|
||||
fassung="$(shop_version)"
|
||||
for slug in leistungsbeschreibung-webshop avv-webshop; do
|
||||
[ -f "public/rechtliches/$slug-$fassung.html" ] || { echo "HTML fehlt: public/rechtliches/$slug-$fassung.html (zuerst node scripts/build-legal-html.mjs shop)"; exit 1; }
|
||||
quelle="public/rechtliches/$slug-$fassung.html"
|
||||
ziel="public/rechtliches/$slug-$fassung.pdf"
|
||||
summe="$(sha256sum "$quelle" | cut -d' ' -f1)"
|
||||
if [ -z "${FORCE:-}" ] && [ -f "$ziel" ] && [ "$(cat "$ziel.sha256" 2>/dev/null)" = "$summe" ]; then
|
||||
echo "= $ziel (unveraendert)"
|
||||
else
|
||||
pdf "$quelle" "$ziel"
|
||||
echo "$summe" > "$ziel.sha256"
|
||||
fi
|
||||
done
|
||||
}
|
||||
|
||||
case "$MODE" in
|
||||
analyse)
|
||||
pdf "public/rechtliches/avv-website-analyse-$ANALYSE_VERSION.html" "public/rechtliches/avv-website-analyse-$ANALYSE_VERSION.pdf"
|
||||
@@ -54,6 +85,9 @@ termine)
|
||||
fi
|
||||
done
|
||||
;;
|
||||
shop)
|
||||
shop_pdfs
|
||||
;;
|
||||
datenschutz)
|
||||
quelle="public/datenschutz.html"
|
||||
ziel="docs/WEBklar-Datenschutzerklaerung.pdf"
|
||||
@@ -70,8 +104,9 @@ all)
|
||||
# Fassung 3 (public/WEBklar-Wartungs-Abo-Vertragsunterlagen.pdf, Archiv unter public/vertragsunterlagen/v3/) wird nicht neu erzeugt
|
||||
pdf public/abo-bedingungen.html public/WEBklar-Abo-Vertragsunterlagen.pdf
|
||||
pdf public/datenschutz.html docs/WEBklar-Datenschutzerklaerung.pdf
|
||||
shop_pdfs
|
||||
;;
|
||||
*)
|
||||
echo "Usage: $0 [all|analyse|termine|datenschutz]"; exit 1
|
||||
echo "Usage: $0 [all|analyse|termine|shop|datenschutz]"; exit 1
|
||||
;;
|
||||
esac
|
||||
Reference in new issue
Block a user