Funktionen/News: Schlussdurchgang (Webhook-Retry, Checkout-Sitzung, Rechnungslink, Widerruf Funktion, UI- und Rechtstext-Korrekturen)

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

server/mail-templates/K04 Eingang Widerruf.html

@@ -8,7 +8,7 @@
   Absender:   „WEBklar“ <Portal-Postfach>
   Empfänger:  E-Mail aus dem Formular · BCC intern
   Platzhalter: {{name}}, {{produkt}}, {{bestellung}}, {{eingang_zeitpunkt}}, {{email}}, {{kundennummer}}
-  Optionale Blöcke (zwischen WENN-/ENDE-Kommentaren; bei Nichtzutreffen samt Inhalt entfernen): kundennummer, abschluss, wechsel, zusatzspeicher, pruefen
+  Optionale Blöcke (zwischen WENN-/ENDE-Kommentaren; bei Nichtzutreffen samt Inhalt entfernen): kundennummer, abschluss, wechsel, zusatzspeicher, funktion, pruefen
   produkt = Katalogname ohne „WEBklar “ („Abo“ ohne gefundenes Abo). Folgen je Bestellung wie in den Hinweisen zum Widerruf (Fassung 4): abschluss (Wertersatz bei Sofortbeginn, Zusatzspeicher voll erstattet), wechsel (Hosting-Abo läuft weiter, Mehrbetrag abzüglich Wertersatz), zusatzspeicher (volle Erstattung, kein Wertersatz), pruefen (keine offene Frist).
 -->
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -50,6 +50,9 @@ a{color:#111111;}
 <!-- WENN zusatzspeicher -->
 <tr><td class="px" style="padding:28px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#f7f6f3;border:1px solid #e8e6e0;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Wie es weitergeht</div><div class="mut" style="color:#4a4843;">Wir setzen Ihren E-Mail-Zusatzspeicher auf die Menge vor der Bestellung zurück. Was Sie dafür gezahlt haben, erstatten wir vollständig innerhalb von 14 Tagen über das ursprüngliche Zahlungsmittel; Wertersatz verlangen wir nicht. Passen die gespeicherten E-Mails danach nicht mehr in den verbleibenden Speicher, nimmt das betroffene Postfach keine neuen E-Mails mehr an, bis wieder Platz ist.</div></td></tr></table></td></tr>
 <!-- ENDE zusatzspeicher -->
+<!-- WENN funktion -->
+<tr><td class="px" style="padding:28px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#f7f6f3;border:1px solid #e8e6e0;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Wie es weitergeht</div><div class="mut" style="color:#4a4843;">Wir prüfen Ihren Widerruf und melden uns umgehend bei Ihnen. Ist er wirksam, erstatten wir bereits gezahlte Beträge innerhalb von 14 Tagen über das ursprüngliche Zahlungsmittel und schalten die Funktion ab; war die Einrichtung auf Ihren Wunsch schon vor Ablauf der Widerrufsfrist abgeschlossen, verrechnen wir gegebenenfalls einen Wertersatz (§ 357a Abs. 2 BGB). Sie erhalten dazu eine gesonderte Abrechnung.</div></td></tr></table></td></tr>
+<!-- ENDE funktion -->
 <!-- WENN pruefen -->
 <tr><td class="px" style="padding:28px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#f7f6f3;border:1px solid #e8e6e0;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Wie es weitergeht</div><div class="mut" style="color:#4a4843;">Wir prüfen, ob für diese Bestellung eine Widerrufsfrist läuft, und melden uns umgehend bei Ihnen.</div></td></tr></table></td></tr>
 <!-- ENDE pruefen -->

server/mail-templates/T09 Widerruf eingegangen.html

@@ -8,7 +8,7 @@
   Absender:   „WEBklar Kundenportal“ <Portal-Postfach>
   Empfänger:  kenso@webklar.com, andrej@webklar.com
   Platzhalter: {{email}}, {{name}}, {{produkt}}, {{kundennummer}}, {{bestellung}}, {{stripe_abo_id}}, {{abo_beginn}}, {{fristende}}, {{rechtzeitig}}, {{ereignisse}}, {{pruefhinweis}}
-  Optionale Blöcke (zwischen WENN-/ENDE-Kommentaren; bei Nichtzutreffen samt Inhalt entfernen): kundennummer, abo_gefunden, auf_kuendigung_gesetzt, kein_abo_gefunden, kuendigung_fehlgeschlagen, abschluss, wechsel, zusatzspeicher, keine_frist, nachweis_fehlt, wechsel_offen, abschluss_verspaetet, nicht_pruefbar, bereits_widerrufen
+  Optionale Blöcke (zwischen WENN-/ENDE-Kommentaren; bei Nichtzutreffen samt Inhalt entfernen): kundennummer, abo_gefunden, auf_kuendigung_gesetzt, kein_abo_gefunden, kuendigung_fehlgeschlagen, abschluss, wechsel, zusatzspeicher, funktion, keine_frist, nachweis_fehlt, wechsel_offen, abschluss_verspaetet, nicht_pruefbar, bereits_widerrufen
 -->
 <meta name="viewport" content="width=device-width, initial-scale=1">
 <meta name="color-scheme" content="light dark">
@@ -60,6 +60,9 @@ a{color:#111111;}
 <!-- WENN zusatzspeicher -->
 <tr><td class="px" style="padding:24px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#fdf0ef;border:1px solid #f1c9c5;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Zu tun</div><div class="mut" style="color:#4a4843;">Zusatzspeicher-Bestellung widerrufen: in Stripe die Menge zurück auf den Stand vor der Bestellung setzen, konsoleH anpassen und den Betrag innerhalb von 14 Tagen vollständig erstatten (kein Wertersatz, Hinweise zum Widerruf Nr. 4). Widerrufen:<br>{{ereignisse}}</div></td></tr></table></td></tr>
 <!-- ENDE zusatzspeicher -->
+<!-- WENN funktion -->
+<tr><td class="px" style="padding:24px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#fdf0ef;border:1px solid #f1c9c5;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Zu tun</div><div class="mut" style="color:#4a4843;">Widerruf einer Funktion (z. B. News-Pinnwand, 30 € einmalig). Widerrufsfrist bis {{fristende}}, Eingang: <strong>{{rechtzeitig}}</strong>. Es wurde NICHTS automatisch geändert: kein Abo, kein Vertragsereignis. Bitte von Hand prüfen, die Zahlung in Stripe innerhalb von 14 Tagen erstatten (gegebenenfalls abzüglich Wertersatz, wenn der Kunde den Einbau vor Fristende ausdrücklich verlangt hat) und die Funktion im Admin-Bereich abschalten. Der Kunde hat „wir prüfen“ bekommen. Bezahlte Funktionen des Kunden:<br>{{ereignisse}}</div></td></tr></table></td></tr>
+<!-- ENDE funktion -->
 <!-- WENN keine_frist -->
 <tr><td class="px" style="padding:24px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#fdf0ef;border:1px solid #f1c9c5;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Achtung</div><div class="mut" style="color:#4a4843;">Nichts automatisch geändert – keine offene Frist gefunden: zu dieser Bestellung läuft keine Widerrufsfrist (mehr) oder es gibt keine Bestellung dieser Art. Bitte prüfen, bevor der Widerruf abgelehnt wird; der Kunde hat „wir prüfen“ bekommen.</div></td></tr></table></td></tr>
 <!-- ENDE keine_frist -->

server/mail-templates/T16 Funktion bestellt.html

@@ -7,8 +7,9 @@
   Betreff:    Neue Funktion bestellt: News-Pinnwand
   Absender:   „WEBklar Kundenportal“ <Portal-Postfach>
   Empfänger:  kenso@webklar.com, andrej@webklar.com
-  Platzhalter: {{kunde_name}}, {{email}}, {{projekt}}, {{woid}}, {{sitekey}}
-  Optionale Blöcke (zwischen WENN-/ENDE-Kommentaren; bei Nichtzutreffen samt Inhalt entfernen): zahlung_fehlgeschlagen
+  Platzhalter: {{kunde_name}}, {{email}}, {{projekt}}, {{woid}}, {{sitekey}}, {{sitzung}}
+  Optionale Blöcke (zwischen WENN-/ENDE-Kommentaren; bei Nichtzutreffen samt Inhalt entfernen): zahlung_fehlgeschlagen, ungeklaert
+  ungeklaert = eine bezahlte Stripe-Sitzung passt zu keiner offenen Bestellung (Betreff und Inhalt: von Hand pruefen); sitzung nennt Sitzungs-ID, Kunde und Projekt.
   zahlung_fehlgeschlagen = die Zahlung (SEPA) ist nicht eingegangen; es wurde nichts bestellt, woid und sitekey sind dann leer.
 -->
 <meta name="viewport" content="width=device-width, initial-scale=1">
@@ -39,6 +40,9 @@ a{color:#111111;}
 <!-- WENN zahlung_fehlgeschlagen -->
 <tr><td class="px" style="padding:24px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#fdf0ef;border:1px solid #f1c9c5;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Zahlung fehlgeschlagen</div><div class="mut" style="color:#4a4843;">Die Zahlung ist nicht eingegangen (zum Beispiel SEPA-Lastschrift abgelehnt). Es wurde nichts eingerichtet und kein Ticket angelegt; die Bestellung steht im Portal wieder auf „nicht bestellt“.</div></td></tr></table></td></tr>
 <!-- ENDE zahlung_fehlgeschlagen -->
+<!-- WENN ungeklaert -->
+<tr><td class="px" style="padding:24px 40px 0 40px;"><table role="presentation" class="box" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#fdf0ef;border:1px solid #f1c9c5;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:14px;line-height:21px;color:#111111;"><div class="ink" style="font-weight:bold;color:#111111;padding-bottom:6px;">Bezahlt, aber nicht zuzuordnen</div><div class="mut" style="color:#4a4843;">Der Kunde hat bezahlt, die Zahlung passt aber zu keiner offenen Bestellung. Es wurde nichts eingerichtet und kein Ticket angelegt. Bitte von Hand prüfen: {{sitzung}}</div></td></tr></table></td></tr>
+<!-- ENDE ungeklaert -->
 <tr><td style="padding:0 0 44px 0;font-size:0;line-height:0;">&nbsp;</td></tr>
 </table>
 </td></tr>

server/routes/abo.js

@@ -18,7 +18,7 @@ import {
   reconcilePendingSwitch,
   switchToWartung,
 } from '../services/planSwitch.js'
-import { handleFeatureCheckoutEvent, isFeatureCheckoutEvent } from '../services/siteFeatures.js'
+import { handleFeatureCheckoutEvent, isFeatureCheckoutEvent, paidFeatureOrders } from '../services/siteFeatures.js'
 import { PRODUCT_KEYS, contractAttachmentFor, describeItems, isTermsV4OrNewer, productLabel, productView, termsDocFor } from '../services/products.js'
 import {
   ACTIVE_STATUSES,
@@ -704,13 +704,13 @@ export function publicRateLimitState() {
 
 // Auswahl im Formular: Vertrag (Kuendigung) und Bestellung (Widerruf), Standard jeweils der erste Wert
 const CONTRACTS = ['abo', 'zusatzspeicher']
-const ORDERS = ['abschluss', 'wechsel', 'zusatzspeicher']
+const ORDERS = ['abschluss', 'wechsel', 'zusatzspeicher', 'funktion']
 // Bestellung -> Ereignistyp mit Widerrufsfrist (F03); beim Zusatzspeicher zaehlt nur ein Plus (openWithdrawals)
 const ORDER_EVENT_TYPE = { abschluss: 'abschluss', wechsel: 'wechsel', zusatzspeicher: 'speicher' }
 
 /**
  * Erklaerung aus dem Formular: null ohne Name oder gueltige E-Mail; { error } bei einer unzulaessigen Paketzahl.
- * contract 'abo' | 'zusatzspeicher', order 'abschluss' | 'wechsel' | 'zusatzspeicher'; packages (nur beim
+ * contract 'abo' | 'zusatzspeicher', order 'abschluss' | 'wechsel' | 'zusatzspeicher' | 'funktion'; packages (nur beim
  * Zusatzspeicher) ganze Zahl von 1 bis maxUnits, null heisst alle gebuchten (Rechtsrunde 28.09.2026).
  */
 function validDeclaration(body) {
@@ -782,6 +782,7 @@ function contractLabel(contract, sub) {
 function orderLabel(order, sub, { customer = false } = {}) {
   if (order === 'wechsel') return 'Wechsel ins Wartungs-Abo'
   if (order === 'zusatzspeicher') return 'E-Mail-Zusatzspeicher'
+  if (order === 'funktion') return 'Funktion (z. B. News-Pinnwand)'
   const abo = productNameOf(sub)
   return `${customer ? 'Abschluss Ihres Abos' : 'Abschluss des Abos'}${abo ? ` (${abo})` : ''}`
 }
@@ -1067,6 +1068,25 @@ async function withdrawOrder(sub, d, receivedAt) {
   }
 }
 
+const FEATURE_STATE_LABEL = { setup: 'in Einrichtung', active: 'aktiv', disabled: 'abgeschaltet' }
+
+/**
+ * Widerruf einer Funktion (z. B. News-Pinnwand, 30 € einmalig): gehoert zu keinem Abo und hat kein Vertrags-
+ * ereignis, darum aendert sich nichts automatisch. Gesucht wird der Kunde ueber die E-Mail-Adresse; das Team
+ * bekommt in T09 die bezahlten Funktionen mit Fristende und erstattet/schaltet ab von Hand.
+ */
+async function withdrawFeature(d, receivedAt) {
+  const customer =
+    (await getCustomerByEmail(d.email).catch(() => null)) || (await getCustomerByEmail(d.email.toLowerCase()).catch(() => null))
+  const orders = customer ? await paidFeatureOrders(customer.$id) : []
+  const ends = orders.filter((o) => o.orderedAt).map((o) => withdrawalDeadline(o.orderedAt).endsAt)
+  const deadline = ends.length ? new Date(Math.max(...ends.map((e) => new Date(e).getTime()))) : null
+  const lines = orders
+    .map((o) => `${o.projekt || 'Projekt'}: ${FEATURE_STATE_LABEL[o.state] || o.state}, bestellt am ${fmtDate(o.orderedAt)}${o.ticketWoid ? `, Ticket #${o.ticketWoid}` : ''}`)
+    .join('\n')
+  return { customer, orders, deadline, lines, inTime: Boolean(deadline) && receivedAt <= deadline }
+}
+
 /** Zeile je widerrufenem Ereignis fuer T09: ID, Inhalt (Speicher: Menge vorher -> nachher), Bestelldatum. */
 function describeWithdrawn(events) {
   return events
@@ -1085,11 +1105,19 @@ router.post('/public/withdraw', async (req, res) => {
 
   let sub = null
   let result = { inTime: false, deadline: null, withdrawn: [], canceled: false, cancelFailed: false, event: null, unreadable: false, startMissing: false, alreadyWithdrawn: false, late: false, openSwitchWithdrawn: false }
+  // Funktion: kein Abo, keine Vertragsereignisse; nur Nachschlagen fuer das Team (withdrawFeature)
+  const feature = d.order === 'funktion'
+  let fn = { customer: null, orders: [], deadline: null, lines: '', inTime: false }
   try {
-    sub = await findActiveSubscriptionByEmail(d.email)
-    if (sub) {
-      result = await withdrawOrder(sub, d, receivedAt)
-      sub = result.sub || sub
+    if (feature) {
+      fn = await withdrawFeature(d, receivedAt)
+      result = { ...result, deadline: fn.deadline, inTime: fn.inTime, late: !fn.inTime && Boolean(fn.deadline) }
+    } else {
+      sub = await findActiveSubscriptionByEmail(d.email)
+      if (sub) {
+        result = await withdrawOrder(sub, d, receivedAt)
+        sub = result.sub || sub
+      }
     }
   } catch (err) {
     console.error('[abo] Widerruf nicht verarbeitbar:', err.message)
@@ -1103,7 +1131,7 @@ router.post('/public/withdraw', async (req, res) => {
     values: {
       name: d.name,
       bestellung: orderLabel(d.order, sub, { customer: true }),
-      produkt: productLabelOf(sub),
+      produkt: feature ? 'News-Pinnwand' : productLabelOf(sub),
       eingang_zeitpunkt: fmtDateTime(receivedAt),
       email: d.email,
       kundennummer: d.customerNumber,
@@ -1113,7 +1141,8 @@ router.post('/public/withdraw', async (req, res) => {
       abschluss: inTime && d.order === 'abschluss',
       wechsel: inTime && d.order === 'wechsel',
       zusatzspeicher: inTime && d.order === 'zusatzspeicher',
-      pruefen: !inTime,
+      funktion: feature,
+      pruefen: !inTime && !feature,
     },
   }).catch((e) => console.error('[abo] Widerrufsbestaetigung fehlgeschlagen:', e.message))
 
@@ -1125,11 +1154,19 @@ router.post('/public/withdraw', async (req, res) => {
       name: d.name,
       kundennummer: d.customerNumber,
       bestellung: orderLabel(d.order, sub),
-      produkt: productLabelOf(sub),
+      produkt: feature ? 'News-Pinnwand' : productLabelOf(sub),
       stripe_abo_id: sub?.stripeSubscriptionId || '',
       abo_beginn: fmtDate(sub?.startedAt),
       fristende: result.deadline ? `${fmtDate(result.deadline)}, 24 Uhr` : 'keine Frist gefunden',
-      rechtzeitig: !sub
+      rechtzeitig: feature
+        ? !fn.customer
+          ? 'ungeprüft (kein Kunde zu dieser E-Mail-Adresse gefunden)'
+          : !fn.orders.length
+            ? 'ungeprüft (keine bezahlte Funktion gefunden)'
+            : inTime
+              ? 'RECHTZEITIG'
+              : 'NACH Fristende, vor einer Ablehnung bitte prüfen'
+        : !sub
         ? 'ungeprüft (kein Abo gefunden)'
         : inTime
           ? 'RECHTZEITIG'
@@ -1142,18 +1179,19 @@ router.post('/public/withdraw', async (req, res) => {
                 : result.deadline
                   ? 'ungeprüft (keine offene Frist: Bestellung gescheitert)'
                   : 'ungeprüft (keine Bestellung dieser Art gefunden)',
-      ereignisse: describeWithdrawn(result.withdrawn),
+      ereignisse: feature ? fn.lines : describeWithdrawn(result.withdrawn),
       pruefhinweis,
     },
     blocks: {
       kundennummer: Boolean(d.customerNumber),
       abo_gefunden: Boolean(sub),
       auf_kuendigung_gesetzt: result.canceled,
-      kein_abo_gefunden: !sub,
+      kein_abo_gefunden: !sub && !feature,
       kuendigung_fehlgeschlagen: result.cancelFailed,
       abschluss: inTime && d.order === 'abschluss',
       wechsel: inTime && d.order === 'wechsel',
       zusatzspeicher: inTime && d.order === 'zusatzspeicher',
+      funktion: feature,
       keine_frist: Boolean(sub) && !inTime && !pruefhinweis && !result.alreadyWithdrawn,
       nachweis_fehlt: Boolean(sub) && !result.event,
       wechsel_offen: result.openSwitchWithdrawn,

server/routes/funktionen.js

@@ -3,8 +3,15 @@ import { config } from '../config.js'
 import { getDocument } from '../services/appwriteAdmin.js'
 import { getSessionCustomerId, requireSession } from '../middleware/session.js'
 import { withLocks } from '../services/keyedLock.js'
-import { createFeatureCheckout } from '../services/stripeBilling.js'
-import { assertOwnProject, getFeatureDoc, listCustomerFeatures, markOrdered, runActivation } from '../services/siteFeatures.js'
+import { createFeatureCheckout, retrieveCheckoutSession } from '../services/stripeBilling.js'
+import {
+  DISABLED_MESSAGE,
+  assertOwnProject,
+  backfillInvoiceLinks,
+  getFeatureDoc,   listCustomerFeatures,
+  markOrdered,
+  runActivation,
+} from '../services/siteFeatures.js'
 
 const router = Router()
 const DAY_MS = 24 * 60 * 60 * 1000
@@ -20,6 +27,7 @@ router.get('/', requireSession, async (req, res) => {
     const customerId = getSessionCustomerId(req)
     // Ein Fehler beim Freischalten (z. B. Ticketsystem) darf die Liste nicht verhindern
     await runActivation({ customerId }).catch((err) => console.error('[funktionen] Freischalten fehlgeschlagen:', err.message))
+    await backfillInvoiceLinks(customerId)
     res.json({
       projects: await listCustomerFeatures(customerId),
       setupEstimate: config.funktionen.setupEstimate,
@@ -30,6 +38,27 @@ router.get('/', requireSession, async (req, res) => {
   }
 })
 
+/**
+ * Offene Bestellung: die gespeicherte Stripe-Sitzung entscheidet. open -> dieselbe Zahlungsseite nochmal
+ * (z. B. nach "Zurueck" im Checkout), expired -> null (neue Sitzung), complete -> 409 (Zahlung laeuft
+ * oder ist da, der Webhook richtet ein). Ist Stripe nicht erreichbar, gilt wie frueher: frisch (< 24 h) -> 409.
+ */
+async function openOrderSession(doc) {
+  const conflict = () => Object.assign(new Error('Die News-Pinnwand ist für dieses Projekt schon bestellt.'), { status: 409 })
+  if (!doc.stripeSessionId) return null
+  let session
+  try {
+    session = await retrieveCheckoutSession(doc.stripeSessionId)
+  } catch (err) {
+    console.warn('[funktionen] Sitzung nicht abrufbar:', err.message)
+    if (Date.now() - new Date(doc.orderedAt || 0).getTime() < DAY_MS) throw conflict()
+    return null
+  }
+  if (session.status === 'open' && session.url) return { id: session.id, url: session.url }
+  if (session.status === 'expired') return null
+  throw conflict()
+}
+
 router.post('/news/checkout', requireSession, async (req, res) => {
   try {
     if (req.session.viewAs) {
@@ -47,12 +76,17 @@ router.post('/news/checkout', requireSession, async (req, res) => {
     // Pruefen, Sitzung anlegen und eintragen als Ganzes je (Kunde, Projekt): zwei schnelle Klicks duerfen keine
     // zwei Sitzungen erzeugen, sonst ueberschreibt die zweite die ID der ersten und deren Zahlung findet kein Dokument
     const session = await withLocks([`feature-order:${customerId}:${projectId}`], async () => {
-      // Zustand vor dem Stripe-Aufruf pruefen: bezahlt/aktiv oder eine noch gueltige offene Bestellung -> 409
+      // Zustand vor dem Stripe-Aufruf pruefen: bezahlt/aktiv/abgeschaltet -> 409, eine offene Bestellung
+      // richtet sich nach ihrer gespeicherten Stripe-Sitzung
       const existing = await getFeatureDoc(customerId, projectId, 'news')
-      const freshOrder = existing?.state === 'ordered' && Date.now() - new Date(existing.orderedAt || 0).getTime() < DAY_MS
-      if (existing?.state === 'setup' || existing?.state === 'active' || freshOrder) {
+      if (existing?.state === 'setup' || existing?.state === 'active') {
         throw Object.assign(new Error('Die News-Pinnwand ist für dieses Projekt schon bestellt.'), { status: 409 })
       }
+      if (existing?.state === 'disabled') throw Object.assign(new Error(DISABLED_MESSAGE), { status: 409 })
+      if (existing?.state === 'ordered') {
+        const open = await openOrderSession(existing)
+        if (open) return open
+      }
       const customer = await getDocument(config.collections.customers, customerId)
       const now = new Date().toISOString()
       const created = await createFeatureCheckout(customer, { projectId, key: 'news', consentAt: now })

server/services/siteFeatures.js

@@ -3,12 +3,15 @@ import { config } from '../config.js'
 import { createDocument, getDocument, listDocuments, updateDocument, Query } from './appwriteAdmin.js'
 import { withLocks } from './keyedLock.js'
 import { sendAdminNotice, sendCustomerMail } from './mailer.js'
-import { getStripe } from './stripeBilling.js'
+import { getStripe, retrieveCheckoutSession } from './stripeBilling.js'
 import { createFeatureTicket } from './ticketAdmin.js'
 
 export const FEATURE_KEYS = ['news']
 export const STATES = ['off', 'ordered', 'setup', 'active', 'disabled']
 
+export const DISABLED_MESSAGE =
+  'Die News-Pinnwand wurde für diese Website abgeschaltet. Schreib uns im Chat, wenn du sie wieder möchtest.'
+
 const BASE32 = 'abcdefghijklmnopqrstuvwxyz234567'
 
 function httpError(status, message) {
@@ -143,12 +146,64 @@ export async function listCustomerFeatures(customerId) {
   return result
 }
 
+/**
+ * Rechnungslink nachtragen: Stripe legt die Rechnung eines Zahlungs-Checkouts erst kurz nach der Zahlung an,
+ * der Webhook sieht sie oft noch nicht. Best effort - Fehler werden geloggt und nie weitergereicht.
+ */
+export async function backfillInvoiceLinks(customerId) {
+  try {
+    const docs = await listDocuments(config.collections.portalFeatures, [
+      Query.equal('customerId', customerId),
+      Query.limit(1000),
+    ])
+    for (const doc of docs) {
+      if ((doc.state !== 'setup' && doc.state !== 'active') || doc.invoiceUrl || !doc.stripeSessionId) continue
+      try {
+        const session = await retrieveCheckoutSession(doc.stripeSessionId, { expandInvoice: true })
+        const invoice = session.invoice && typeof session.invoice === 'object' ? session.invoice : null
+        if (!invoice?.hosted_invoice_url) continue
+        await updateDocument(config.collections.portalFeatures, doc.$id, {
+          stripeInvoiceId: invoice.id || doc.stripeInvoiceId || '',
+          invoiceUrl: invoice.hosted_invoice_url,
+        })
+      } catch (err) {
+        console.warn(`[funktionen] Rechnungslink fuer Sitzung ${doc.stripeSessionId} nicht nachgetragen:`, err.message)
+      }
+    }
+  } catch (err) {
+    console.warn('[funktionen] Rechnungslinks nicht nachgetragen:', err.message)
+  }
+}
+
+/**
+ * Bezahlte Funktionen eines Kunden mit Projektname und Ticketnummer (Widerruf der Funktion, Team-Hinweis T09).
+ * Reine Lesefunktion; 'ordered' (noch nicht bezahlt) und 'off' zaehlen nicht.
+ */
+export async function paidFeatureOrders(customerId) {
+  const docs = await listDocuments(config.collections.portalFeatures, [
+    Query.equal('customerId', customerId),
+    Query.limit(1000),
+  ])
+  const paid = docs.filter((d) => ['setup', 'active', 'disabled'].includes(d.state) && d.unlockedByPurchase)
+  const result = []
+  for (const doc of paid) {
+    result.push({
+      projekt: await projectName(doc.projectId).catch(() => ''),
+      state: doc.state,
+      orderedAt: doc.orderedAt || '',
+      ticketWoid: doc.ticketId ? await ticketWoid(doc.ticketId).catch(() => null) : null,
+    })
+  }
+  return result
+}
+
 export async function markOrdered({ customerId, projectId, key, sessionId, consent = {} }) {
   assertKey(key)
   const doc = await ensureFeatureDoc(customerId, projectId, key)
   if (doc.state === 'setup' || doc.state === 'active') {
     throw httpError(409, 'Diese Funktion ist bereits bestellt oder freigeschaltet')
   }
+  if (doc.state === 'disabled') throw httpError(409, DISABLED_MESSAGE)
   return updateDocument(config.collections.portalFeatures, doc.$id, {
     featureKey: key,
     ...stateFields('ordered'),
@@ -174,22 +229,26 @@ async function findBySession(sessionId) {
 /**
  * Idempotent und je Session serialisiert: nur der Uebergang aus 'ordered' legt das Ticket an. Erst
  * wird auf 'setup' gestellt, dann das Ticket erstellt; scheitert das, bleibt 'setup' ohne ticketId
- * (das Portal zeigt "Ticket fehlt") und der Fehler wird weitergereicht.
+ * (das Portal zeigt "Ticket fehlt") und der Fehler wird weitergereicht. Stripe wiederholt den Webhook:
+ * 'setup' ohne ticketId gilt dann als fortsetzbar (Ticket anlegen, created:true -> K15/T16 gehen raus).
  */
 export async function markPaid({ sessionId, invoiceId, invoiceUrl }) {
   if (!sessionId) return { doc: null, created: false }
   return withLocks([`feature-paid:${sessionId}`], async () => {
     const doc = await findBySession(sessionId)
     if (!doc) return { doc: null, created: false }
-    if (doc.state !== 'ordered') return { doc, created: false }
+    const resumable = doc.state === 'setup' && !doc.ticketId
+    if (doc.state !== 'ordered' && !resumable) return { doc, created: false }
 
-    const setup = await updateDocument(config.collections.portalFeatures, doc.$id, {
-      ...stateFields('setup'),
-      purchaseStatus: 'paid',
-      unlockedByPurchase: true,
-      stripeInvoiceId: invoiceId || '',
-      invoiceUrl: invoiceUrl || '',
-    })
+    const setup = resumable
+      ? doc
+      : await updateDocument(config.collections.portalFeatures, doc.$id, {
+          ...stateFields('setup'),
+          purchaseStatus: 'paid',
+          unlockedByPurchase: true,
+          stripeInvoiceId: invoiceId || '',
+          invoiceUrl: invoiceUrl || '',
+        })
     const project = await getDocument(config.collections.websiteProjects, doc.projectId)
     const { ticketId } = await createFeatureTicket({
       customerId: doc.customerId,
@@ -354,8 +413,27 @@ async function teamNotice(doc, customer, { failed = false } = {}) {
       projekt: await projectName(doc.projectId),
       woid: failed ? '' : await ticketWoidOf(doc),
       sitekey: failed ? '' : doc.siteKey || '',
+      sitzung: '',
     },
-    blocks: { zahlung_fehlgeschlagen: failed },
+    blocks: { zahlung_fehlgeschlagen: failed, ungeklaert: false },
+  })
+}
+
+/** Bezahlte Sitzung ohne passende Bestellung: das Team muss von Hand klaeren (T16, Block ungeklaert). */
+async function unmatchedNotice(session) {
+  const { customerId, projectId } = session.metadata || {}
+  const customer = customerId ? await customerOf(customerId).catch(() => null) : null
+  await sendAdminNotice({
+    template: 'T16',
+    values: {
+      kunde_name: customer?.name || customer?.email || customerId || 'unbekannt',
+      email: customer?.email || '',
+      projekt: projectId ? (await projectName(projectId).catch(() => '')) || projectId : '',
+      woid: '',
+      sitekey: '',
+      sitzung: `${session.id} (Kunde ${customerId || '-'}, Projekt ${projectId || '-'})`,
+    },
+    blocks: { zahlung_fehlgeschlagen: false, ungeklaert: true },
   })
 }
 
@@ -371,6 +449,11 @@ async function adoptPaidSession(session) {
     console.error(
       `[funktionen] BEZAHLTE Sitzung ${session.id} ohne passende Bestellung (Kunde ${customerId}, Projekt ${projectId}, Zustand ${doc?.state || 'kein Dokument'}) - bitte von Hand pruefen`
     )
+    try {
+      await unmatchedNotice(session)
+    } catch (err) {
+      console.error('[funktionen] Hinweis zur ungeklaerten Zahlung fehlgeschlagen:', err.message)
+    }
     return false
   }
   await updateDocument(config.collections.portalFeatures, doc.$id, {
@@ -384,7 +467,8 @@ async function onFeaturePaid(session) {
   const { invoiceId, invoiceUrl } = await invoiceOf(session.invoice)
   const paid = { sessionId: session.id, invoiceId, invoiceUrl }
   let { doc, created } = await markPaid(paid)
-  if (!doc && (await adoptPaidSession(session))) ({ doc, created } = await markPaid(paid))
+  // Kein Dokument zur Sitzung, oder es fiel auf 'off' (Ablauf/SEPA-Fehler) und die Zahlung kam doch noch an
+  if ((!doc || doc.state === 'off') && (await adoptPaidSession(session))) ({ doc, created } = await markPaid(paid))
   if (!created) return
   // Ab hier ist die Bestellung gebucht; ein Wiederholungsversuch von Stripe sieht created:false und
   // wuerde keine Mail mehr schicken. Darum scheitert jede Mail einzeln und der Webhook antwortet trotzdem 200.

server/services/stripeBilling.js

@@ -633,6 +633,11 @@ export async function createFeatureCheckout(customer, { projectId, key = 'news',
   return { id: session.id, url: session.url }
 }
 
+/** Gespeicherte Funktions-Sitzung abrufen (status open|complete|expired); mit expand die Rechnung als Objekt. */
+export async function retrieveCheckoutSession(id, { expandInvoice = false } = {}) {
+  return getStripe().checkout.sessions.retrieve(id, expandInvoice ? { expand: ['invoice'] } : {})
+}
+
 export async function createBillingPortalUrl(customerId) {
   const sub = await getCurrentSubscription(customerId)
   if (!sub?.stripeCustomerId) {

server/services/ticketAdmin.js

@@ -96,6 +96,7 @@ export async function createFeatureTicket({ customerId, project, featureKey, sit
         `Domain: ${domain}`,
         `siteKey: ${siteKey}`,
         `Einbau: ${embed}`,
+        'Anleitung: docs/funktionen/news-einbau.md (Repo Webklar-Kundenbereich)',
       ].join('\n'),
       createdAt: new Date().toISOString(),
     },