build-legal-pdfs: Modus auftraege, PDFs und Prüfsummen der Widerrufsbelehrung der Projektaufträge und der AGB

Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>

public/rechtliches/agb-2026-09-30.pdf.sha256

@@ -0,0 +1 @@
+d271a7ed066ee758dd5dd85b865134a4f9f65e1bc2ee375af7ab959b6455d2de

public/rechtliches/widerrufsbelehrung-projektauftrag-2026-10-06.pdf.sha256

@@ -0,0 +1 @@
+f9948c0a656e5eaf62c964a933d4fda4b162cf1cdc4069632e1068c6488b8408

scripts/build-legal-pdfs.sh

@@ -1,7 +1,7 @@
 #!/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|shop|datenschutz]
+# Usage: CHROME=/pfad/zu/chrome scripts/build-legal-pdfs.sh [all|analyse|termine|shop|auftraege|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
@@ -10,6 +10,9 @@
 #   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.
+#   auftraege = Widerrufsbelehrung der Projektauftraege (Fassung TEXTE_VERSION, Standard: TEXTE_FASSUNG aus server/services/auftraege/texte.js) und AGB
+#             (Fassung AGB_VERSION, Standard: AGB_FASSUNG aus server/services/auftraege/konstanten.js); die HTML-Seiten kommen vorher aus
+#             `node scripts/build-legal-html.mjs auftraege`, Pruefsumme und Neudruck wie bei termine und shop. `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.
@@ -47,6 +50,47 @@ shop_version() {
   echo "$v"
 }
 
+# Fassung der Projektauftrags-Texte (Widerrufsbelehrung): TEXTE_VERSION, sonst TEXTE_FASSUNG aus server/services/auftraege/texte.js
+texte_version() {
+  local v="${TEXTE_VERSION:-}"
+  if [ -z "$v" ]; then
+    v="$(timeout 60 node --max-old-space-size=256 --input-type=module -e "const { TEXTE_FASSUNG } = await import('./server/services/auftraege/texte.js'); console.log(TEXTE_FASSUNG)")"
+  fi
+  [[ "$v" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || { echo "Ungueltige Fassung: $v" >&2; exit 1; }
+  echo "$v"
+}
+
+# Fassung der AGB-Kopie: AGB_VERSION, sonst AGB_FASSUNG aus server/services/auftraege/konstanten.js
+agb_version() {
+  local v="${AGB_VERSION:-}"
+  if [ -z "$v" ]; then
+    v="$(timeout 60 node --max-old-space-size=256 --input-type=module -e "const { AGB_FASSUNG } = await import('./server/services/auftraege/konstanten.js'); console.log(AGB_FASSUNG)")"
+  fi
+  [[ "$v" =~ ^[0-9]{4}-[0-9]{2}-[0-9]{2}$ ]] || { echo "Ungueltige Fassung: $v" >&2; exit 1; }
+  echo "$v"
+}
+
+# Widerrufsbelehrung der Projektauftraege und AGB drucken (je PDF nur, wenn die Pruefsumme der HTML-Seite nicht mehr passt)
+auftraege_pdfs() {
+  local texte agb eintrag slug fassung quelle ziel summe
+  texte="$(texte_version)"
+  agb="$(agb_version)"
+  for eintrag in "widerrufsbelehrung-projektauftrag:$texte" "agb:$agb"; do
+    slug="${eintrag%%:*}"
+    fassung="${eintrag##*:}"
+    quelle="public/rechtliches/$slug-$fassung.html"
+    ziel="public/rechtliches/$slug-$fassung.pdf"
+    [ -f "$quelle" ] || { echo "HTML fehlt: $quelle (zuerst node scripts/build-legal-html.mjs auftraege)"; exit 1; }
+    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
+}
+
 # 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
@@ -88,6 +132,9 @@ termine)
 shop)
   shop_pdfs
   ;;
+auftraege)
+  auftraege_pdfs
+  ;;
 datenschutz)
   quelle="public/datenschutz.html"
   ziel="docs/WEBklar-Datenschutzerklaerung.pdf"
@@ -105,8 +152,9 @@ all)
   pdf public/abo-bedingungen.html public/WEBklar-Abo-Vertragsunterlagen.pdf
   pdf public/datenschutz.html docs/WEBklar-Datenschutzerklaerung.pdf
   shop_pdfs
+  auftraege_pdfs
   ;;
 *)
-  echo "Usage: $0 [all|analyse|termine|shop|datenschutz]"; exit 1
+  echo "Usage: $0 [all|analyse|termine|shop|datenschutz]"; echo "       $0 auftraege   (Widerrufsbelehrung der Projektauftraege und AGB)"; exit 1
   ;;
 esac

test/auftraegeRechtstexte.test.js

@@ -549,3 +549,42 @@ test('auftraege_lauf: --check meldet fehlende oder abweichende Seiten mit Exit 1
     rmSync(dir, { recursive: true, force: true })
   }
 })
+
+// ---------------------------------------------------------------------------------------------------------- PDFs
+
+test('auftraege_pdf_dateien: je Seite ein PDF unter demselben Namen, Prüfsumme der HTML-Seite daneben (HTML geändert ohne neues PDF fällt auf)', () => {
+  const DOKUMENTE = dokumente()
+  const mindest = { widerruf: { seiten: 1, bytes: 5 * 1024 }, agb: { seiten: 2, bytes: 20 * 1024 } }
+  for (const d of DOKUMENTE) {
+    const pdf = d.html.replace(/\.html$/, '.pdf')
+    const bytes = readFileSync(join(ROOT, pdf))
+    assert.equal(bytes.subarray(0, 5).toString('latin1'), '%PDF-', `${pdf}: kein PDF`)
+    assert.ok(bytes.length > mindest[d.doc].bytes, `${pdf}: ${bytes.length} Bytes sind zu wenig`)
+    assert.ok(bytes.subarray(-1024).toString('latin1').includes('%%EOF'), `${pdf}: PDF ist abgeschnitten`)
+    const seiten = bytes.toString('latin1').match(/\/Type\s*\/Page[^s]/g) ?? []
+    assert.ok(seiten.length >= mindest[d.doc].seiten, `${pdf}: ${seiten.length} Seiten`)
+    const summe = lies(`${pdf}.sha256`)
+    assert.match(summe, /^[0-9a-f]{64}\n$/, `${pdf}.sha256: nur die Prüfsumme und ein Zeilenende`)
+    assert.equal(summe.trim(), sha256(readFileSync(join(ROOT, d.html))), `${d.html} wurde geändert, ohne das PDF neu zu drucken (scripts/build-legal-pdfs.sh auftraege)`)
+  }
+  // die AGB liegen unter dem Namen, den die Auftragsbestätigung (Mail K31 und Bestätigungsseite) verlinkt und anhängt
+  assert.ok(existsSync(join(ROOT, `public/rechtliches/agb-${AGB_FASSUNG}.pdf`)))
+})
+
+test('auftraege_script_modus: build-legal-pdfs.sh kennt auftraege (Fassungen aus texte.js und konstanten.js), all druckt es mit, bestehende Modi und Grenzen unverändert', () => {
+  const sh = lies('scripts/build-legal-pdfs.sh')
+  assert.match(sh, /^auftraege\)\n {2}auftraege_pdfs\n {2};;$/m)
+  for (const name of ['TEXTE_VERSION', 'TEXTE_FASSUNG', 'AGB_VERSION', 'AGB_FASSUNG', 'widerrufsbelehrung-projektauftrag:$texte', 'agb:$agb']) assert.ok(sh.includes(name), name)
+  // die Funktionen stehen vor shop_pdfs (test/buildLegalHtml.test.js liest ab dort den Modus shop) und zeigen auf die HTML-Quelle
+  const auftraege = sh.slice(sh.indexOf('\nauftraege_pdfs() {'), sh.indexOf('\nshop_pdfs() {'))
+  assert.ok(auftraege.length > 100 && sh.indexOf('\nauftraege_pdfs() {') > 0, 'auftraege_pdfs steht vor shop_pdfs')
+  assert.ok(auftraege.includes('sha256sum "$quelle"') && auftraege.includes('echo "$summe" > "$ziel.sha256"') && auftraege.includes('(unveraendert)') && auftraege.includes('${FORCE:-}'))
+  assert.ok(auftraege.includes('node scripts/build-legal-html.mjs auftraege'), 'fehlt die HTML-Seite, nennt die Meldung den Generator')
+  assert.ok(sh.slice(sh.indexOf('\nall)'), sh.indexOf('\n*)')).includes('  auftraege_pdfs\n'), 'all druckt auch diese PDFs')
+  assert.ok(sh.includes('Usage: $0 [all|analyse|termine|shop|datenschutz]') && sh.includes('$0 auftraege'), 'Aufruf nennt alle Modi')
+  // je Chrome-Aufruf höchstens 120 Sekunden, kein paralleler Lauf, Node-Aufrufe mit Heap-Grenze und Zeitgrenze
+  assert.match(sh, /^ {2}timeout 120 "\$CHROME" /m)
+  assert.equal([...sh.matchAll(/timeout 60 node --max-old-space-size=256 /g)].length, 4, 'je Fassungsfunktion ein Aufruf: termine, shop, texte und agb')
+  assert.ok(!/ &$|^\s*wait\b|xargs -P/m.test(sh), 'keine parallelen Läufe')
+  assert.equal(spawnSync('bash', ['-n', 'scripts/build-legal-pdfs.sh'], { cwd: ROOT, encoding: 'utf8' }).status, 0)
+})