Kundenansicht P6: Widerruf des Wechsels beendet Wartungs-Funktionen, die Analyse bleibt

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

server/services/aboFunktionenAbgleich.js

@@ -7,7 +7,7 @@ import { Query, deleteDocument, getDocument, listAllDocuments, updateDocument }
 import { withLocks } from './keyedLock.js'
 import { deleteNewsImage } from './newsImages.js'
 import { listPosts } from './newsPosts.js'
-import { activate, disable, stateFields } from './siteFeatures.js'
+import { activate, disable, listCustomerFeatureDocs, stateFields } from './siteFeatures.js'
 import { pruefeNow } from './termine/util.js'
 import { loeschTag } from './termine/frist.js'
 import { ladeEinstellung } from './termine/kontext.js'
@@ -40,6 +40,11 @@ import { leereCache } from './unterkunft/kontext.js'
  *               (wie bei News, der Vermerk endet damit), unabhaengig vom Abo. Ohne Vermerk bleibt alles. Der Terminplaner wird von
  *               termine/jobs.js selbst auf off gesetzt.
  *
+ * Sofortpfad (V11, N27): beendeWartungsFunktionen(customerId) beendet alle Abo-Modell-Funktionen eines Kunden, die nur im Wartungs-Abo stecken,
+ * sofort, wenn dessen Wechsel ins Wartungs-Abo in der Frist widerrufen wird (routes/abo.js, withdrawOrder). Ohne Abo-Pruefung (der Spiegel
+ * steht bis zur Handarbeit des Teams noch auf Wartung); die Analyse gehoert zu Hosting und bleibt. Die Mail K39 geht wie im Tagesabgleich
+ * (meldeBeendet), ausser fuer zeiten: dort sendet der Zeiten-Abgleich K41 samt Ersatz-Ticket.
+ *
  * Regeln wie termine/aboAbgleich.js: eine Listenabfrage fuer alle Kunden; das Abo je Kunde einmal fuer die Vorauswahl lesen. Geschrieben
  * wird nur unter der Sperre feature-admin:<projectId> nach frischem Lesen von Dokument UND Abo (nie aus der Vorauswahl); die Mail und der
  * Marker folgen nach der Sperre. Fail-closed: ist etwas nicht lesbar (Liste, Abo, Dokument, Aufbauphase), wird nichts abgeschaltet; Kunde
@@ -52,6 +57,7 @@ export const ABGLEICH_KEYS = Object.freeze(['news', 'termine', 'shop', 'unterkun
 const GRUND = 'abo_ende'
 const NOTIZ = 'System: Abgeschaltet: Abo beendet'
 const NOTIZ_WIEDER = 'System: Wieder eingeschaltet: Abo läuft wieder'
+const NOTIZ_WECHSEL = 'Abgeschaltet: Wechsel widerrufen'
 
 const ADRESSE = /[^\s<>"',;()]+@[^\s<>"',;()]+/g
 
@@ -300,6 +306,50 @@ export async function gleicheAboFunktionenAb(now = new Date()) {
   return erg
 }
 
+/** Steckt die Funktion nur im Wartungs-Abo (ENTHALTEN_IN genau ['wartung'])? Die Analyse (auch Hosting) nicht. */
+const nurImWartungsAbo = (key) => Object.hasOwn(ENTHALTEN_IN, key) && ENTHALTEN_IN[key].length === 1 && ENTHALTEN_IN[key][0] === 'wartung'
+
+/**
+ * Sofortpfad beim Widerruf des Wechsels ins Wartungs-Abo (V11, N27): alle Dokumente des Abo-Modells (auch projekt) des Kunden im Zustand
+ * setup oder active, deren Funktion nur im Wartungs-Abo steckt (news, termine, shop, unterkunft, zeiten; nicht analyse), werden sofort
+ * abgeschaltet (Grund abo_ende, Notiz "Abgeschaltet: Wechsel widerrufen"), je Dokument unter feature-admin:<projectId> nach frischem Lesen
+ * und ohne Abo-Pruefung. Danach, ausserhalb der Sperre, K39 mit dem Hosting-Satz (meldeBeendet, art hosting) fuer alle ausser zeiten (dort
+ * sendet der Zeiten-Abgleich K41 samt Ersatz-Ticket). Ein Fehler bei einem Dokument stoppt die uebrigen nicht; was misslingt, holt der
+ * Tagesabgleich nach (aboProdukt kennt den widerrufenen Wechsel). Wirft nie; das Log nennt weder Namen noch Adressen.
+ * @param {string} customerId
+ * @param {{ now?: Date }} [options] Zeitpunkt des Widerrufs (Marker aboEndeMailAt)
+ * @returns {Promise<{ beendet: string[] }>} die IDs der abgeschalteten Funktionsdokumente
+ */
+export async function beendeWartungsFunktionen(customerId, { now = new Date() } = {}) {
+  const beendet = []
+  if (!customerId) return { beendet }
+  try {
+    const kandidaten = (await listCustomerFeatureDocs(customerId)).filter(
+      (doc) => istAboModell(doc) && doc.projectId && (doc.state === 'setup' || doc.state === 'active') && nurImWartungsAbo(doc.featureKey)
+    )
+    for (const doc of kandidaten) {
+      try {
+        const abgeschaltet = await withLocks([`feature-admin:${doc.projectId}`], async () => {
+          const frisch = await getDocument(portalFeatures(), doc.$id)
+          if (!istAboModell(frisch) || (frisch.state !== 'setup' && frisch.state !== 'active')) return null // das Team war schneller
+          const aus = await disable(frisch.$id, { reason: GRUND, adminNote: NOTIZ_WECHSEL })
+          if (aus.state !== 'disabled' || aus.disabledReason !== GRUND) return null // jemand war zwischen Lesen und Schreiben schneller
+          if (aus.featureKey === 'unterkunft' && aus.siteKey) leereCache(aus.siteKey)
+          return aus
+        })
+        if (!abgeschaltet) continue
+        beendet.push(abgeschaltet.$id)
+        if (abgeschaltet.featureKey !== 'zeiten') await meldeBeendet(abgeschaltet, { art: 'hosting', now }) // nach der Sperre; bei Misserfolg wiederholt der Tagesabgleich
+      } catch (err) {
+        console.error(`[abo-funktionen] Sofortpfad: Funktion ${doc.$id} nicht vollständig beendet, der Tagesabgleich holt nach: ${fehlerText(err)}`)
+      }
+    }
+  } catch (err) {
+    console.error(`[abo-funktionen] Sofortpfad: Funktionen eines Kunden nicht lesbar, nichts beendet: ${fehlerText(err)}`)
+  }
+  return { beendet }
+}
+
 let tagesJobLaeuft = false
 
 /**