Funktions-Ticket: Text aus dem Register, Laengendeckel, Notfall-Details und gezielte Wiederholung

markPaid holt Betreff und Details des Einrichtungs-Tickets aus dem Register (ticketTexte), createFeatureTicket
bleibt die einzige Stelle, die das Ticket anlegt. Betreff auf 128, Details auf 7000 Zeichen gekuerzt (surrogatsicher,
Schnitt an der Zeilengrenze, einheitliche Schlusszeile). Wirft die Details-Funktion oder liefert sie keinen Text,
gelten die Notfall-Details (Kopfzeilen und Verweis ins WOMS). Nach einem 400 bei langen Details gibt es genau einen
zweiten Versuch mit den Notfall-Details und derselben woid; 5xx, Netzfehler und kurze Details werden ohne
Wiederholung weitergereicht. Stub termine/ticketDetails.js bis Task D4.

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

server/services/ticketAdmin.js

@@ -9,6 +9,7 @@ import {
   Query,
   ID,
 } from './appwriteAdmin.js'
+import { kuerze, LANGE_DETAILS, TICKET_DETAILS_MAX, TICKET_GEKUERZT, TICKET_TOPIC_MAX } from './featureRegistry.js'
 
 const WOID_BASE = 9999
 
@@ -69,30 +70,33 @@ export async function ensureProjectTicket(project, { repoFullName } = {}) {
 }
 
 /**
- * Einrichtungs-Ticket fuer eine gekaufte Funktion (z. B. News-Pinnwand) einer Kundenwebsite.
+ * Einrichtungs-Ticket fuer eine gekaufte Funktion (z. B. News-Pinnwand, Terminplaner) einer Kundenwebsite.
  * Wird geschlossen, sobald die Funktion eingebaut ist; danach schaltet das Portal sie frei.
+ * Einzige Stelle, die dieses Ticket anlegt. topic und details sind optional (ohne: die News-Festwerte); markPaid uebergibt
+ * die Registertexte (ticketTexte). Beides wird auf TICKET_TOPIC_MAX / TICKET_DETAILS_MAX gekuerzt.
+ * Wiederholung nur, wenn das Anlegen mit 400 scheitert, fallbackDetails uebergeben wurde und die Details lang waren
+ * (LANGE_DETAILS): dann einmal mit fallbackDetails und derselben woid. Jeder andere Fehler (5xx, Netz: unklar, ob das Ticket
+ * entstand) wird ohne Wiederholung weitergereicht, sonst gaebe es Doppel-Tickets; scheitert auch der Rueckfall, wird der erste
+ * Fehler geworfen.
  */
-export async function createFeatureTicket({ customerId, project, featureKey, siteKey, topic = null, details = null }) {
+export async function createFeatureTicket({
+  customerId,
+  project,
+  featureKey,
+  siteKey,
+  topic = null,
+  details = null,
+  fallbackDetails = null,
+}) {
   const customer = await getDocument(config.collections.customers, customerId).catch(() => null)
   const woid = await generateNextWoid()
   const projectName = project?.projectName || project?.subdomain || ''
   const domain = project?.liveDomain || project?.previewUrl || project?.subdomain || ''
   const embed = `<div data-webklar-news="${siteKey}"></div> + https://project.webklar.com/embed/news.js`
 
-  const ticket = await createDocument(
-    config.collections.workorders,
-    {
-      topic: topic || `News-Pinnwand einbauen – ${projectName}`.trim(),
-      type: 'Webpage',
-      status: 'Open',
-      priority: 1,
-      serviceType: 'Remote',
-      systemType: 'n/a',
-      customerId,
-      customerName: customer?.name || '',
-      customerLocation: customer?.location || '',
-      woid,
-      details: details || [
+  const text = kuerze(
+    details ||
+      [
         `Funktion: ${featureKey}`,
         `Projekt: ${projectName}`,
         `Domain: ${domain}`,
@@ -100,10 +104,41 @@ export async function createFeatureTicket({ customerId, project, featureKey, sit
         `Einbau: ${embed}`,
         'Anleitung: docs/funktionen/news-einbau.md (Repo Webklar-Kundenbereich)',
       ].join('\n'),
-      createdAt: new Date().toISOString(),
-    },
-    ID.unique()
+    TICKET_DETAILS_MAX,
+    { anZeile: true, endzeile: TICKET_GEKUERZT }
   )
+  const fields = {
+    topic: kuerze(topic || `News-Pinnwand einbauen – ${projectName}`.trim(), TICKET_TOPIC_MAX, { endzeile: '…' }),
+    type: 'Webpage',
+    status: 'Open',
+    priority: 1,
+    serviceType: 'Remote',
+    systemType: 'n/a',
+    customerId,
+    customerName: customer?.name || '',
+    customerLocation: customer?.location || '',
+    woid,
+    createdAt: new Date().toISOString(),
+  }
+
+  let ticket
+  try {
+    ticket = await createDocument(config.collections.workorders, { ...fields, details: text }, ID.unique())
+  } catch (firstError) {
+    const hatRueckfall = typeof fallbackDetails === 'string' && fallbackDetails !== ''
+    if (firstError?.status !== 400 || !hatRueckfall || text.length <= LANGE_DETAILS) throw firstError
+    console.warn(`[ticketAdmin] Funktions-Ticket #${woid} (${featureKey}) abgelehnt (400), zweiter Versuch mit Notfall-Details:`, firstError.message)
+    try {
+      ticket = await createDocument(
+        config.collections.workorders,
+        { ...fields, details: kuerze(fallbackDetails, TICKET_DETAILS_MAX, { anZeile: true, endzeile: TICKET_GEKUERZT }) },
+        ID.unique()
+      )
+    } catch (secondError) {
+      console.error(`[ticketAdmin] Funktions-Ticket #${woid} (${featureKey}): auch der zweite Versuch scheiterte:`, secondError.message)
+      throw firstError
+    }
+  }
   console.log(`[ticketAdmin] Funktions-Ticket #${woid} (${featureKey}) fuer Projekt ${project?.$id} angelegt`)
   return { ticketId: ticket.$id, woid }
 }