Terminplaner: Kunden-Schnittstelle – Nachbesserungen

- GET /zeiten?ohne=<Buchung>: Leistung, Dauer und Person der Buchung wie beim
  Verschieben (verschiebeZeiten exportiert), unbekannte/fremde/Sperre 404 (R42)
- Schreib-Begrenzung als gemeinsamer Baustein (writeLimiter.js) fuer News und
  Terminplaner statt kopierter Funktion (R43)
- Unlesbares Einstellungs-JSON: Kontext traegt die echte Version, Speichern
  ueberschreibt den Schaden statt dauerhaft 409
- U+FEFF als Escape statt als rohes Zeichen
- Tests: Mandantentrennung mit echtem zweitem Kunden, R42, Limiter, kaputtes JSON

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

server/services/termine/ablauf.js

@@ -713,9 +713,10 @@ const verschiebeRessource = (einstellung, buchung) => (einstellung.regeln?.perso
 
 /**
  * Freie Startzeiten eines Tages fuer das Verschieben einer Buchung (ohne die Buchung selbst); => { zeiten, amTag }.
- * ohneRegeln: Verschieben durch den Betrieb (kein Vorlauf, kein Horizont).
+ * Leistung, Dauer und Person kommen aus der Buchung (mitGebuchterDauer, verschiebeRessource), genau wie in verschiebeKern.
+ * ohneRegeln: Verschieben durch den Betrieb (kein Vorlauf, kein Horizont). Auch die Zeitenabfrage des Portals nutzt sie.
  */
-async function verschiebeZeiten(ctx, buchung, tag, now, { ohneRegeln = false } = {}) {
+export async function verschiebeZeiten(ctx, buchung, tag, now, { ohneRegeln = false } = {}) {
   const amTag = await imZeitraum(ctx.feature.$id, zuUtc(tag, '00:00'), zuUtc(tag, '24:00'))
   const zeiten = freieZeiten({
     einstellung: mitGebuchterDauer(ctx.einstellung, buchung),

server/services/termine/kontext.js

@@ -15,7 +15,7 @@ import { pruefeNow, pruefeText } from './util.js'
  *   feature       portalFeatures-Dokument (featureKey 'termine')
  *   project       websiteProjects-Dokument oder null (Projekt fehlt)
  *   einstellung   gespeicherte Einstellung (Objekt) oder null (noch nie gespeichert / unlesbar)
- *   version       Zaehler fuer die optimistische Sperre (0 = noch nie gespeichert)
+ *   version       Zaehler fuer die optimistische Sperre (0 = noch nie gespeichert; bei unlesbarem JSON die Version des Dokuments)
  * Ein ctx ist nur zum Lesen: kontextPerSiteKey gibt innerhalb von 30 Sekunden dasselbe Objekt zurueck.
  *
  * - kontextPerSiteKey (oeffentliche Schnittstelle): nur Funktionen im Zustand active und nur mit gespeicherter
@@ -51,8 +51,11 @@ async function holeOderNull(collectionId, id) {
   }
 }
 
-/** { einstellung, version } aus einem termineConfig-Dokument; unlesbares JSON gilt als nicht gespeichert (mit Log). */
-function liesEinstellung(doc) {
+/**
+ * { einstellung, version } aus einem termineConfig-Dokument. Unlesbares JSON (mit Log) ergibt einstellung null, die Version
+ * des Dokuments bleibt: wer die kaputte Einstellung ueberschreiben will, speichert mit genau dieser Version.
+ */
+function liesDokument(doc) {
   const version = Number.isInteger(doc.version) ? doc.version : 0
   try {
     const einstellung = JSON.parse(doc.einstellung)
@@ -60,7 +63,7 @@ function liesEinstellung(doc) {
     return { einstellung, version }
   } catch (err) {
     console.error(`[termine-kontext] Einstellung ${doc.$id} ist unlesbar: ${err.message}`)
-    return null
+    return { einstellung: null, version }
   }
 }
 
@@ -72,15 +75,17 @@ function liesEinstellung(doc) {
 export async function ladeEinstellung(featureId) {
   pruefeText(featureId, 'featureId')
   const doc = await holeOderNull(config.collections.termineConfig, featureId)
-  return doc ? liesEinstellung(doc) : null
+  const gelesen = doc ? liesDokument(doc) : null
+  return gelesen?.einstellung ? gelesen : null
 }
 
 async function baueKontext(feature) {
-  const [project, gespeichert] = await Promise.all([
+  const [project, doc] = await Promise.all([
     feature.projectId ? holeOderNull(config.collections.websiteProjects, feature.projectId) : null,
-    ladeEinstellung(feature.$id),
+    holeOderNull(config.collections.termineConfig, feature.$id),
   ])
-  return { feature, project, einstellung: gespeichert?.einstellung ?? null, version: gespeichert?.version ?? 0 }
+  const gelesen = doc ? liesDokument(doc) : null
+  return { feature, project, einstellung: gelesen?.einstellung ?? null, version: gelesen?.version ?? 0 }
 }
 
 /**
@@ -160,7 +165,7 @@ export async function speichereEinstellung(feature, einstellungOderFn, { version
     const aktuell = vorhanden && Number.isInteger(vorhanden.version) ? vorhanden.version : 0
     if (version !== null && version !== aktuell) throw veraltet()
 
-    const einstellung = alsFunktion ? await einstellungOderFn(vorhanden ? (liesEinstellung(vorhanden)?.einstellung ?? null) : null) : einstellungOderFn
+    const einstellung = alsFunktion ? await einstellungOderFn(vorhanden ? liesDokument(vorhanden).einstellung : null) : einstellungOderFn
     if (!istObjekt(einstellung)) throw new TypeError('einstellung fehlt')
     const json = JSON.stringify(einstellung)
 

server/services/writeLimiter.js

@@ -0,0 +1,41 @@
+/**
+ * Schreib-Begrenzung je Schluessel (meist Kunde) im Speicher: hoechstens `max` Aufrufe je Fenster (Standard eine Stunde),
+ * gezaehlt ab dem Aufruf. Jeder Aufruf zaehlt, auch ein abgelehnter. Wie beim Chat und bei den News nur im Prozess, ein
+ * Neustart setzt die Zaehler zurueck; Schluessel ohne Treffer im Fenster werden bei der naechsten Abfrage vergessen.
+ * Genutzt von routes/news.js (30 je Stunde) und routes/termine.js (120 je Stunde).
+ *
+ * @param {{ max: number, fensterMs?: number, now?: () => number }} optionen now liefert Millisekunden (Tests: feste Uhr)
+ * @returns {{
+ *   istUeberschritten: (key: string) => boolean,
+ *   middleware: (keyOf: (req: object) => string, message: string) => (req: object, res: object, next: () => void) => void,
+ *   reset: () => void,
+ * }} istUeberschritten zaehlt diesen Aufruf mit und sagt, ob damit mehr als `max` im Fenster liegen;
+ *   middleware antwortet dann 429 { error: message }, sonst next(); reset leert alles (Tests)
+ */
+export function createWriteLimiter({ max, fensterMs = 60 * 60 * 1000, now = () => Date.now() } = {}) {
+  if (!Number.isInteger(max) || max < 1) throw new TypeError('createWriteLimiter: max muss eine ganze Zahl ab 1 sein')
+  if (!Number.isFinite(fensterMs) || fensterMs <= 0) throw new TypeError('createWriteLimiter: fensterMs muss groesser als 0 sein')
+  if (typeof now !== 'function') throw new TypeError('createWriteLimiter: now muss eine Funktion sein')
+
+  const treffer = new Map() // Schluessel -> Zeitpunkte (ms) im Fenster
+
+  function istUeberschritten(key) {
+    const jetzt = now()
+    for (const [schluessel, zeiten] of treffer) {
+      const frisch = zeiten.filter((t) => jetzt - t < fensterMs)
+      if (frisch.length === 0) treffer.delete(schluessel)
+      else if (frisch.length !== zeiten.length) treffer.set(schluessel, frisch)
+    }
+    const liste = treffer.get(key) || []
+    liste.push(jetzt)
+    treffer.set(key, liste)
+    return liste.length > max
+  }
+
+  const middleware = (keyOf, message) => (req, res, next) => {
+    if (istUeberschritten(keyOf(req))) return res.status(429).json({ error: message })
+    return next()
+  }
+
+  return { istUeberschritten, middleware, reset: () => treffer.clear() }
+}