Buchungskalender: origin/main (Aufträge) zusammenführen

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

scripts/auftraege-setup.mjs

@@ -0,0 +1,102 @@
+#!/usr/bin/env node
+/**
+ * Aufträge und Rechnungen: legt die Collections auftraege und projektRechnungen mit Attributen und Indizes in
+ * Appwrite an (nur Server-Key, keine Client-Rechte) und ergänzt die vorhandenen Collections customers (Feld
+ * kundenart) und financeSettings (Feld steuernummer). Das Schema steht in server/services/auftraege/schema.js.
+ * Idempotent: Vorhandenes wird übersprungen, fehlende Attribute und Indizes auch in schon vorhandenen Collections
+ * nachgezogen. customers (gehört dem Ticketsystem) und financeSettings (scripts/setup-finanzen.mjs) legt dieses
+ * Skript nie an; fehlen sie, bricht es vor jeder Änderung ab. Vor dem Code-Deploy und vor dem Einschalten
+ * (AUFTRAEGE_ENABLED) ausführen: der Code schreibt die neuen Felder, ohne Schema antwortet Appwrite mit
+ * "Unknown attribute".
+ * Usage:
+ *   docker exec -w /app webklar-kundenbereich-server node scripts/auftraege-setup.mjs
+ *   node scripts/auftraege-setup.mjs --check   (nur melden, nichts anlegen; Exit 1 bei Fehlendem)
+ *   node scripts/auftraege-setup.mjs           (Fehlendes anlegen)
+ */
+import { pathToFileURL } from 'node:url'
+import { config } from '../server/config.js'
+import { AUFTRAEGE_COLLECTIONS, AUFTRAEGE_ZUSATZ_ATTRIBUTE } from '../server/services/auftraege/schema.js'
+import { createAppwriteClient } from './analyse-setup.mjs'
+
+// Hinweis, falls eine nicht eigene Collection fehlt
+const HINWEIS = {
+  financeSettings: 'zuerst scripts/setup-finanzen.mjs ausfuehren',
+  customers: 'die Kunden-Collection gehört dem Ticketsystem (WOMS)',
+}
+
+export async function main({ check = false, client, log = console.log } = {}) {
+  const api = client || createAppwriteClient()
+  const missing = []
+  const missingCollections = []
+  const missingIndexes = []
+  const plan = []
+
+  // Eigene Collections plus die vorhandenen customers und financeSettings (nur zusätzliche Attribute, keine Indizes)
+  const targets = [
+    ...Object.entries(AUFTRAEGE_COLLECTIONS).map(([name, { attributes, indexes }]) => ({ name, id: config.collections[name], attributes, indexes, own: true })),
+    ...Object.entries(AUFTRAEGE_ZUSATZ_ATTRIBUTE).map(([name, attributes]) => ({ name, id: config.collections[name], attributes, indexes: [], own: false })),
+  ]
+
+  // Erst alles pruefen, dann (ohne --check) anlegen, damit --check garantiert nichts veraendert
+  for (const { name, id, attributes, indexes, own } of targets) {
+    const exists = await api.collectionExists(id)
+    if (!exists && !own) throw new Error(`Collection ${id} fehlt – ${HINWEIS[name]}`)
+    const haveAttributes = exists ? new Set((await api.listAttributes(id)).map((a) => a.key)) : new Set()
+    const haveIndexes = exists ? new Set((await api.listIndexes(id)).map((i) => i.key)) : new Set()
+    const absentAttributes = attributes.filter((a) => !haveAttributes.has(a.key))
+    const absentIndexes = indexes.filter((i) => !haveIndexes.has(i.key))
+
+    if (!exists) {
+      log(`${check ? '-' : '+'} Collection ${id}${check ? ' FEHLT' : ''}`)
+      missingCollections.push(id)
+    } else {
+      log(`= ${id}: ${haveAttributes.size} Attribute, ${haveIndexes.size} Indizes vorhanden`)
+    }
+    if (check) {
+      absentAttributes.forEach((a) => log(`- ${id}.${a.key} FEHLT`))
+      absentIndexes.forEach((i) => log(`- Index ${id}.${i.key} FEHLT`))
+    }
+    absentAttributes.forEach((a) => missing.push({ ...a, collection: id }))
+    absentIndexes.forEach((i) => missingIndexes.push({ ...i, collection: id }))
+    plan.push({ id, exists, absentAttributes, absentIndexes })
+  }
+
+  const result = { missing, missingCollections, missingIndexes }
+  if (check) {
+    const open = missing.length + missingCollections.length + missingIndexes.length
+    log(open ? `${open} Eintrag/Eintraege fehlen.` : 'Alles vorhanden.')
+    return result
+  }
+
+  for (const { id, exists, absentAttributes } of plan) {
+    if (!exists) await api.ensureCollection(id, id)
+    for (const attr of absentAttributes) {
+      await api.createAttribute(id, attr)
+      log(`+ Attribut ${id}.${attr.key}`)
+    }
+  }
+  // Indizes brauchen verfuegbare Attribute: erst warten, dann anlegen
+  for (const { id, absentAttributes } of plan) {
+    for (const attr of absentAttributes) await api.waitForAttribute(id, attr.key)
+  }
+  for (const { id, absentIndexes } of plan) {
+    for (const index of absentIndexes) {
+      await api.createIndex(id, index)
+      log(`+ Index ${id}.${index.key}`)
+    }
+  }
+  log('Fertig.')
+  return result
+}
+
+const invokedDirectly = process.argv[1] && import.meta.url === pathToFileURL(process.argv[1]).href
+if (invokedDirectly) {
+  const check = process.argv.includes('--check')
+  main({ check })
+    .then(({ missing, missingCollections, missingIndexes }) =>
+      process.exit(check && (missing.length || missingCollections.length || missingIndexes.length) ? 1 : 0))
+    .catch((e) => {
+      console.error(e.message)
+      process.exit(1)
+    })
+}

scripts/build-legal-html.mjs

@@ -14,7 +14,11 @@
 //                                                        Achtung: Ändert sich die Widerrufsbelehrung der Funktionen (neue Fassung bei termine/shop), braucht auch unterkunft
 //                                                        eine neue Fassung (config.unterkunft.fassung); eine ausgelieferte Datei wird nie an Ort und Stelle neu gebaut.
 //
-// Fassung = config.termine.avvVersion (Satz termine) bzw. config.shop.fassung (Satz shop) bzw. config.unterkunft.fassung (Satz unterkunft). Die Ausgabe enthält keine Datumsangabe außer der Fassung und hängt nur vom Markdown und
+//   node scripts/build-legal-html.mjs auftraege [--check]
+//                                                        dasselbe für die Widerrufsbelehrung der Projektaufträge (Wortlaut aus server/services/auftraege/texte.js)
+//                                                        und die AGB-Kopie (Quelle docs/rechtliches/agb.md)
+//
+// Fassung = config.termine.avvVersion (Satz termine), config.shop.fassung (Satz shop) bzw. config.unterkunft.fassung (Satz unterkunft) bzw. TEXTE_FASSUNG und AGB_FASSUNG (Satz auftraege). 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,
@@ -24,6 +28,8 @@ import { basename, join } from 'node:path'
 import { fileURLToPath } from 'node:url'
 import { config } from '../server/config.js'
 import { legalPaths } from '../server/services/legalDocs.js'
+import { TEXTE_FASSUNG, WIDERRUFSBELEHRUNG_PROJEKT, WIDERRUFSFORMULAR } from '../server/services/auftraege/texte.js'
+import { AGB_FASSUNG } from '../server/services/auftraege/konstanten.js'
 
 const ROOT = fileURLToPath(new URL('..', import.meta.url))
 const FASSUNG_RE = /^\d{4}-\d{2}-\d{2}$/
@@ -333,7 +339,6 @@ export function unterkunftDokumente(fassung = config.unterkunft.fassung) {
 }
 
 /** Sätze der Kommandozeile: Name => Dokumente. */
-const SAETZE = { termine: termineDokumente, shop: shopDokumente, unterkunft: unterkunftDokumente }
 
 /** Markdown eines Dokuments; trägt die Quelle eine andere Fassung (d.stempel), wird die Fassungszeile auf die des Dokuments gesetzt. */
 export function quelleVon(d, root = ROOT) {
@@ -343,23 +348,83 @@ export function quelleVon(d, root = ROOT) {
   if (!md.includes(alt)) throw new MarkdownFehler(3, `${d.md}: die Zeile ${alt} fehlt`)
   return md.replace(alt, `**Fassung ${d.meta.fassung}**`)
 }
+// ---------------------------------------------------------------------------------------------------------- Projektaufträge
+
+/** Einleitung der Seite zur Widerrufsbelehrung der Projektaufträge (Seitentext, nicht Teil der Belehrung nach dem Muster). */
+export const PROJEKT_WIDERRUF_EINLEITUNG =
+  'Das Widerrufsrecht gilt nur für Verbraucher. Wir fügen die Belehrung und das Muster-Widerrufsformular jeder Auftragsbestätigung an eine Privatperson bei '
+  + 'und zeigen sie hier zusätzlich allen Kunden. Die Belehrung gilt für den Auftrag, den die jeweilige Auftragsbestätigung bestätigt.'
+
+/**
+ * Markdown der Seite „Widerrufsbelehrung und Muster-Widerrufsformular (Projektaufträge)“ aus server/services/auftraege/texte.js: Überschrift,
+ * Fassung, Einleitung, dann die Abschnitte der Belehrung und das Formular, jede Formularzeile als eigener Absatz.
+ */
+export function projektWiderrufMarkdown(fassung = TEXTE_FASSUNG, belehrung = WIDERRUFSBELEHRUNG_PROJEKT, formular = WIDERRUFSFORMULAR) {
+  const teile = [
+    '# Widerrufsbelehrung und Muster-Widerrufsformular (Projektaufträge)',
+    `**Fassung ${fassung}**`,
+    PROJEKT_WIDERRUF_EINLEITUNG,
+    `## ${belehrung.titel}`,
+    ...belehrung.abschnitte.flatMap((a) => [`### ${a.ueberschrift}`, ...a.absaetze]),
+    `## ${formular.titel}`,
+    formular.einleitung,
+    ...formular.zeilen,
+  ]
+  return `${teile.join('\n\n')}\n`
+}
+
+/**
+ * Die zwei Seiten des Satzes auftraege: die Widerrufsbelehrung der Projektaufträge (Fassung TEXTE_FASSUNG, Wortlaut aus texte.js, ohne Markdown-Datei)
+ * und die AGB-Kopie (Fassung AGB_FASSUNG, Quelle docs/rechtliches/agb.md). Beide Seiten verlinken einander. Die Adressen stehen nicht in legalDocs.js:
+ * die Mails und das PDF der Auftragsbestätigung verlinken die versionierten Dateien (public/rechtliches/<slug>-<Fassung>.html|pdf) unmittelbar.
+ */
+export function auftraegeDokumente(texteFassung = TEXTE_FASSUNG, agbFassung = AGB_FASSUNG) {
+  const widerrufAdresse = `/rechtliches/widerrufsbelehrung-projektauftrag-${texteFassung}.html`
+  const agbAdresse = `/rechtliches/agb-${agbFassung}.html`
+  const nav = [
+    { href: '/dashboard.html', text: '← Kundenportal' },
+    { href: '/abo-bedingungen.html', text: 'Abo-Bedingungen' },
+    { href: widerrufAdresse, text: 'Widerrufsbelehrung Projektaufträge' },
+    { href: agbAdresse, text: 'AGB' },
+    { href: '/datenschutz.html', text: 'Datenschutzerklärung' },
+    { href: 'https://webklar.com/impressum', text: 'Impressum' },
+  ]
+  return [
+    {
+      doc: 'widerruf',
+      md: null,
+      markdown: () => projektWiderrufMarkdown(texteFassung),
+      html: `public${widerrufAdresse}`,
+      meta: { fassung: texteFassung, titel: 'Widerrufsbelehrung und Muster-Widerrufsformular (Projektaufträge)', seitenkopf: 'Widerrufsbelehrung Projektaufträge', nav },
+    },
+    {
+      doc: 'agb',
+      md: 'docs/rechtliches/agb.md',
+      html: `public${agbAdresse}`,
+      meta: { fassung: agbFassung, titel: 'Allgemeine Geschäftsbedingungen', seitenkopf: 'AGB', nav },
+    },
+  ]
+}
+
+/** Sätze der Kommandozeile: Name => Dokumente. */
+const SAETZE = { termine: termineDokumente, shop: shopDokumente, unterkunft: unterkunftDokumente, auftraege: auftraegeDokumente }
 
 // ---------------------------------------------------------------------------------------------------------- Aufruf
 
 /**
- * Kommandozeile: `termine|shop|unterkunft [--check]`. root = Wurzel des Projekts (Tests übergeben ein Verzeichnis mit Kopien).
+ * Kommandozeile: `termine|shop|unterkunft|auftraege [--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 (!Object.hasOwn(SAETZE, satz ?? '') || optionen.some((o) => o !== '--check')) {
-    fehler('Aufruf: node scripts/build-legal-html.mjs termine|shop|unterkunft [--check]')
+    fehler('Aufruf: node scripts/build-legal-html.mjs termine|shop|unterkunft [--check]\n       node scripts/build-legal-html.mjs auftraege [--check]')
     return 2
   }
   let abweichungen = 0
   for (const d of SAETZE[satz]()) {
-    const html = render(quelleVon(d, root), d.meta)
+    const html = render(d.markdown ? d.markdown() : quelleVon(d, root), d.meta)
     const ziel = join(root, d.html)
     if (pruefen) {
       const gleich = existsSync(ziel) && readFileSync(ziel, 'utf8') === html

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|unterkunft|datenschutz]
+# Usage: CHROME=/pfad/zu/chrome scripts/build-legal-pdfs.sh [all|analyse|termine|shop|unterkunft|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
@@ -12,6 +12,9 @@
 #             gehoert zu termine (dieselbe Datei) und wird hier nicht gedruckt. `all` druckt auch diese beiden PDFs.
 #   unterkunft = Leistungsbeschreibung, AVV und Widerrufsbelehrung des Buchungskalenders (Fassung UNTERKUNFT_VERSION, Standard: config.unterkunft.fassung); die HTML-Seiten
 #             kommen vorher aus `node scripts/build-legal-html.mjs unterkunft`, Pruefsumme und Neudruck wie bei termine. `all` druckt diese PDFs nicht mit.
+#   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.
@@ -59,6 +62,47 @@ unterkunft_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
@@ -115,6 +159,9 @@ unterkunft)
     fi
   done
   ;;
+auftraege)
+  auftraege_pdfs
+  ;;
 datenschutz)
   quelle="public/datenschutz.html"
   ziel="docs/WEBklar-Datenschutzerklaerung.pdf"
@@ -132,8 +179,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|unterkunft|datenschutz]"; exit 1
+  echo "Usage: $0 [all|analyse|termine|shop|unterkunft|datenschutz]"; echo "       $0 auftraege   (Widerrufsbelehrung der Projektauftraege und AGB)"; exit 1
   ;;
 esac