Buchungskalender: Verdrahtung, Router-Gerüste und API-Vertrag

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

server/config.js

@@ -341,6 +341,86 @@ function shopConsent() {
   }
 }
 
+/**
+ * Rechtsunterlage des Buchungskalenders: wie shopRechtsunterlage, aber mit Fassung und Adresse aus config.unterkunft.fassung
+ * (bei jedem Zugriff gelesen). Slugs wie in services/legalDocs.js (SAETZE.unterkunft); test/legalDocs.test.js gleicht beide ab.
+ */
+function unterkunftRechtsunterlage(slug, { nullIstWert = false } = {}) {
+  let ueberschrieben // undefined = Standard
+  const standard = () => ({ version: config.unterkunft.fassung, url: `/rechtliches/${slug}-${config.unterkunft.fassung}.html` })
+  return {
+    get: () => (ueberschrieben === undefined ? standard() : ueberschrieben),
+    set(wert) {
+      const std = standard()
+      const zurueck = wert === undefined || (wert === null && !nullIstWert) || (wert !== null && wert.version === std.version && wert.url === std.url)
+      ueberschrieben = zurueck ? undefined : wert
+    },
+  }
+}
+const unterkunftLb = unterkunftRechtsunterlage('leistungsbeschreibung-unterkunft')
+const unterkunftAvv = unterkunftRechtsunterlage('avv-unterkunft')
+const unterkunftWiderruf = unterkunftRechtsunterlage('widerrufsbelehrung-funktionen', { nullIstWert: true })
+
+const UNTERKUNFT_PREIS = '199 €'
+const UNTERKUNFT_DAUER = 'meist innerhalb von 1–2 Wochen'
+
+/**
+ * Bestelltexte des Buchungskalenders: sechs Haken (alle Besteller), Aufbau wie shopConsent (Haken je Fassung einmal gebaut).
+ * Die Fassung (consent.version) ist config.unterkunft.fassung. Bei Textaenderung neues Fassungsdatum und neuen Hash im Pin von
+ * test/featureConsentTexte.test.js. Zitat, Wertersatz-Satz und Pflichtinformationen sind Entwurf bis zur Kanzlei.
+ */
+function unterkunftConsent() {
+  let versionGesetzt // undefined = config.unterkunft.fassung
+  let gebaut = null // { version, items }
+  const version = () => versionGesetzt ?? config.unterkunft.fassung
+  const items = (v) => [
+    {
+      id: 'unterlagen',
+      haken: true,
+      text: `Ich stimme der Leistungsbeschreibung Buchungskalender und dem Auftragsverarbeitungsvertrag Buchungskalender in der Fassung ${v} zu.`,
+    },
+    {
+      id: 'verantwortung',
+      haken: true,
+      text: 'Ich vermiete in eigenem Namen; für Preise, Stornobedingungen, Rechnungen und Meldepflichten bin ich verantwortlich.',
+    },
+    {
+      id: 'rechnung',
+      haken: true,
+      text: 'Ich beauftrage WEBklar, in meinem Namen und auf meine Rechnung Rechnungen an meine Gäste auszustellen (§ 14 Abs. 2 Satz 4 UStG). Für Richtigkeit von Preisen und Steuerangaben bin ich verantwortlich.',
+    },
+    {
+      id: 'stripe',
+      haken: true,
+      text: 'Online-Zahlungen meiner Gäste laufen, sofern ich sie nutze, über mein eigenes Stripe-Konto zu den Bedingungen von Stripe. WEBklar erhält und verwahrt kein Geld meiner Gäste und erhebt keine Umsatzbeteiligung.',
+    },
+    {
+      id: 'beginn',
+      haken: true,
+      text: 'Ich verlange ausdrücklich, dass WEBklar vor Ablauf der Widerrufsfrist mit der Einrichtung des Buchungskalenders beginnt. Mir ist bekannt, dass mein Widerrufsrecht mit der vollständigen Erbringung der Einrichtung erlischt (§ 356 Abs. 5 Nr. 2 BGB). Widerrufe ich vor der vollständigen Erbringung, schulde ich einen angemessenen Betrag für die bis dahin erbrachte Leistung (§ 357a Abs. 2 BGB).',
+    },
+    {
+      id: 'information',
+      haken: true,
+      text: `Ich habe die Pflichtinformationen zu dieser Bestellung gelesen: Leistung (Einrichtung des Buchungskalenders für diese Website: Einbau des Kalender-Widgets, Verwaltung im Portal, Rechnungserstellung für Gäste), Gesamtpreis ${UNTERKUNFT_PREIS} einmalig (${ustHinweis}), voraussichtliche Dauer ${UNTERKUNFT_DAUER}, keine laufende Gebühr von WEBklar; der Buchungskalender läuft, solange WEBklar die Website betreibt. Die Widerrufsbelehrung mit Muster-Widerrufsformular habe ich gelesen.`,
+    },
+  ]
+  return {
+    get version() {
+      return version()
+    },
+    set version(wert) {
+      versionGesetzt = wert === undefined || wert === null || wert === config.unterkunft.fassung ? undefined : wert
+    },
+    knopf: `Zahlungspflichtig bestellen · ${UNTERKUNFT_PREIS}`,
+    get items() {
+      const v = version()
+      if (gebaut?.version !== v) gebaut = { version: v, items: items(v) }
+      return gebaut.items
+    },
+  }
+}
+
 /**
  * Register der kaufbaren Funktionen (News-Pinnwand, Terminplaner, Webshop): Preis, Zustimmungen, Rechtsunterlagen,
  * Ticket- und Mail-Texte je Funktion; reine Daten, config.js importiert keine Dienste. Die Helfer (featureConfig,
@@ -521,6 +601,56 @@ const features = {
     orderedConflictMessage: 'Der Webshop ist für dieses Projekt schon bestellt.',
     unavailableMessage: 'Der Webshop ist noch nicht verfügbar.',
   },
+  unterkunft: {
+    key: 'unterkunft',
+    product: 'unterkunftSetup',
+    label: { name: 'Buchungskalender', kurz: 'Buchungskalender', keine: 'keinen Buchungskalender' },
+    priceLabel: UNTERKUNFT_PREIS,
+    setupEstimate: UNTERKUNFT_DAUER,
+    consent: unterkunftConsent(),
+    get leistungsbeschreibung() {
+      return unterkunftLb.get()
+    },
+    set leistungsbeschreibung(wert) {
+      unterkunftLb.set(wert)
+    },
+    get avv() {
+      return unterkunftAvv.get()
+    },
+    set avv(wert) {
+      unterkunftAvv.set(wert)
+    },
+    get widerruf() {
+      return unterkunftWiderruf.get()
+    },
+    set widerruf(wert) {
+      unterkunftWiderruf.set(wert)
+    },
+    returnHash: 'buchungen',
+    returnProjekt: true,
+    ticket: {
+      topic: (project) => `Buchungskalender einbauen – ${ticketProjektName(project)}`,
+      // Dienst erst beim Aufruf laden: config.js importiert keine Dienste statisch
+      details: async (ctx) => {
+        const { unterkunftTicketDetails } = await import('./services/unterkunft/ticketDetails.js')
+        return unterkunftTicketDetails(ctx)
+      },
+    },
+    mails: {
+      funktion: 'Buchungskalender',
+      formen: { dein: 'Dein Buchungskalender', nom: 'der Buchungskalender', akk: 'den Buchungskalender', gen: 'des Buchungskalenders', pron: 'ihn' },
+      knopf: 'Buchungen öffnen',
+      danach: 'Danach kannst Du im Portal Unterkünfte, Preise und Anfragen verwalten.',
+      bereit: 'Dein Buchungskalender ist eingebaut. Du kannst ab sofort Anfragen und Buchungen im Portal verwalten.',
+      preisHinweis: `einmalig, ${ustHinweis}; keine laufende Gebühr von WEBklar, Stripe-Gebühren zahlst Du direkt an Stripe`,
+      anleitung: false,
+    },
+    requiresWartungsAbo: false,
+    ticketFreischaltung: true,
+    disabledMessage: 'Der Buchungskalender ist für diese Website abgeschaltet. Schreib uns im Chat, wenn Du ihn wieder möchtest.',
+    orderedConflictMessage: 'Der Buchungskalender ist für dieses Projekt schon bestellt.',
+    unavailableMessage: 'Der Buchungskalender ist noch nicht verfügbar.',
+  },
   // Oeffnungszeiten live (Spec 2026-10-04): 30 EUR einmalig, im Wartungs-Abo ohne Aufpreis (aboInklusive, consentFrei)
   zeiten: {
     key: 'zeiten',