Chat: Kunde bekommt Mail, wenn das Team schreibt (K17)

Neue Vorlage K17 im Stil von K16 mit Nachricht, Absender und Link
auf den Portal-Chat. Hoechstens eine Mail je Kunde im Zeitfenster
CHAT_NOTIFY_THROTTLE_MIN (15 Min.), ohne BCC ans Team, nicht ohne
E-Mail-Adresse oder Portalzugang. Das Admin-Panel zeigt unter dem
Kundennamen, ob der Hinweis rausging.

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

server/mail-templates/K17 Neue Nachricht.html

@@ -0,0 +1,50 @@
+<!DOCTYPE html>
+<html lang="de" xmlns="http://www.w3.org/1999/xhtml">
+<head>
+<meta charset="utf-8">
+<!--
+  K17 · Neue Nachricht vom Team (Chat im Kundenportal)
+  Betreff:    Neue Nachricht von WEBklar
+  Absender:   „WEBklar“ <Portal-Postfach>
+  Empfänger:  Kunde (E-Mail des Kundenkontos) · ohne BCC
+  Platzhalter: {{kunde_name}}, {{absender}}, {{nachricht}}, {{portal_url}}
+  Höchstens eine Mail je Kunde alle 15 Minuten (CHAT_NOTIFY_THROTTLE_MIN).
+-->
+<meta name="viewport" content="width=device-width, initial-scale=1">
+<meta name="color-scheme" content="light dark">
+<meta name="supported-color-schemes" content="light dark">
+<title>Neue Nachricht von WEBklar</title>
+<!--[if mso]><style>table,td{font-family:Arial,Helvetica,sans-serif!important;}</style><![endif]-->
+<style>
+a{color:#111111;}
+@media (max-width:620px){.w{width:100%!important;}.px{padding-left:24px!important;padding-right:24px!important;}.lbl{display:block!important;width:100%!important;padding-bottom:2px!important;border-bottom:0!important;}.val{display:block!important;width:100%!important;padding-top:0!important;}}
+@media (prefers-color-scheme:dark){.bg{background:#161615!important;}.card{background:#1f1f1e!important;}.ink{color:#f2f1ee!important;}.mut{color:#a8a6a0!important;}.box{background:#2a2a28!important;border-color:#3a3a37!important;}.btn{background:#f2f1ee!important;}.btn a{color:#161615!important;}.rowline{border-color:#3a3a37!important;}}
+</style>
+</head>
+<body style="margin:0;padding:0;background:#f1f0ec;">
+<span style="display:none;max-height:0;overflow:hidden;opacity:0;mso-hide:all;font-size:1px;line-height:1px;color:#f1f0ec;">{{absender}} hat Dir im Kundenportal geschrieben.&#8199;&#847;&#8199;&#847;&#8199;&#847;</span>
+<table role="presentation" class="bg" width="100%" cellpadding="0" cellspacing="0" border="0" style="background:#f1f0ec;">
+<tr><td align="center" style="padding:32px 12px;">
+<table role="presentation" class="w" width="600" cellpadding="0" cellspacing="0" border="0" style="width:600px;max-width:600px;">
+<tr><td class="px" style="padding:0 40px 20px 40px;"><table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0"><tr>
+<td><table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr><td valign="middle" style="padding-right:10px;"><img src="https://project.webklar.com/webklar-logo.png" width="40" height="40" alt="WEBklar" style="display:block;width:40px;height:40px;border:0;outline:none;text-decoration:none;border-radius:10px;"></td><td valign="middle" class="ink" style="font-family:Arial,Helvetica,sans-serif;font-size:26px;font-weight:bold;letter-spacing:-1px;color:#111111;">WEBklar</td></tr></table></td>
+<td align="right" class="mut" style="font-family:Arial,Helvetica,sans-serif;font-size:12px;color:#6b6964;">Kundenportal</td>
+</tr></table></td></tr>
+<tr><td class="card" style="background:#ffffff;border-radius:16px;">
+<table role="presentation" width="100%" cellpadding="0" cellspacing="0" border="0">
+<tr><td class="px" style="padding:44px 40px 8px 40px;"><table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr><td style="background:#efe6fb;border-radius:100px;padding:6px 12px;font-family:Arial,Helvetica,sans-serif;font-size:12px;font-weight:bold;color:#5a2a91;">Neue Nachricht</td></tr></table></td></tr>
+<tr><td class="px ink" style="padding:16px 40px 0 40px;font-family:Arial,Helvetica,sans-serif;font-size:28px;line-height:34px;mso-line-height-rule:exactly;font-weight:bold;letter-spacing:-0.5px;color:#111111;">Du hast eine neue Nachricht</td></tr>
+<tr><td class="px mut" style="padding:14px 40px 0 40px;font-family:Arial,Helvetica,sans-serif;font-size:16px;line-height:25px;mso-line-height-rule:exactly;color:#4a4843;">Hallo {{kunde_name}},<br>{{absender}} hat Dir im WEBklar Kundenportal geschrieben:</td></tr>
+<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:#f7f6f3;border:1px solid #e8e6e0;border-radius:12px;"><tr><td class="ink" style="padding:20px 22px;font-family:Arial,Helvetica,sans-serif;font-size:16px;line-height:25px;color:#111111;">{{nachricht}}</td></tr></table></td></tr>
+<tr><td class="px" style="padding:28px 40px 0 40px;"><table role="presentation" cellpadding="0" cellspacing="0" border="0"><tr><td class="btn" bgcolor="#111111" style="background:#111111;border-radius:10px;"><a href="{{portal_url}}" style="display:block;padding:14px 26px;font-family:Arial,Helvetica,sans-serif;font-size:15px;font-weight:bold;color:#ffffff;text-decoration:none;">Im Kundenportal antworten &rarr;</a></td></tr></table></td></tr>
+<tr><td class="px mut" style="padding:10px 40px 0 40px;font-family:Arial,Helvetica,sans-serif;font-size:13px;line-height:20px;mso-line-height-rule:exactly;color:#6b6964;">Bitte antworte im Chat des Kundenportals, dort sieht das ganze Team Deine Nachricht.</td></tr>
+<tr><td class="px ink" style="padding:28px 40px 44px 40px;font-family:Arial,Helvetica,sans-serif;font-size:16px;line-height:24px;color:#111111;">Viele Grüße<br><strong>Dein WEBklar-Team</strong></td></tr>
+</table>
+</td></tr>
+<tr><td class="px" align="center" style="padding:24px 40px 0 40px;font-family:Arial,Helvetica,sans-serif;font-size:12px;line-height:19px;color:#6b6964;"><a class="mut" href="https://project.webklar.com/dashboard.html" style="color:#4a4843;text-decoration:underline;">Kundenportal</a></td></tr>
+<tr><td class="px mut" align="center" style="padding:14px 40px 0 40px;font-family:Arial,Helvetica,sans-serif;font-size:12px;line-height:19px;color:#6b6964;">WEBklar GbR · Am Schwimmbad 10 · 67722 Winnweiler<br>Telefon <a class="mut" href="tel:+4917623726355" style="color:#6b6964;text-decoration:none;">0176 23726355</a> · <a class="mut" href="mailto:support@webklar.com" style="color:#6b6964;text-decoration:none;">support@webklar.com</a><br>Vertreten durch die Gesellschafter Kenso Grimm und Justin Klein</td></tr>
+</table>
+</td></tr>
+</table>
+</body>
+</html>

server/routes/portalAdmin.js

@@ -17,7 +17,9 @@ import { listAppointments, saveAppointment } from '../services/appointments.js'
 import { getCustomerActivity } from '../services/customerActivity.js'
 import { listInvoicesForClient } from '../services/invoiceNinja.js'
 import { prepareMessage, rawUpload, sanitizeMessage, uploadErrors } from './chat.js'
+import { sendCustomerChatNotice } from '../services/mailer.js'
 import {
+  attachmentLines,
   attachmentSummary,
   deletePendingAttachment,
   messageAttachments,
@@ -393,7 +395,14 @@ router.post('/chats/:customerId/messages', async (req, res) => {
       ID.unique()
     )
     await prepared.claim.commit(doc.$id)
-    return res.status(201).json({ message: sanitizeMessage(doc) })
+
+    // Kunden per Mail hinweisen (K17, gedrosselt); Fehler lassen die Nachricht bestehen
+    const lines = attachmentLines(prepared.claim.attachments)
+    const notice = await sendCustomerChatNotice(customer, {
+      sender: doc.senderName,
+      text: [prepared.text, lines.length ? `Anhänge:\n${lines.join('\n')}` : ''].filter(Boolean).join('\n\n'),
+    })
+    return res.status(201).json({ message: sanitizeMessage(doc), notice })
   } catch (err) {
     await prepared?.claim.release()
     return res.status(err.status || 500).json({ error: err.message || 'Nachricht konnte nicht gesendet werden' })

server/services/mailer.js

@@ -78,6 +78,46 @@ export async function sendChatNotification(customer, text) {
   }
 }
 
+// Gleiches Zeitfenster in Gegenrichtung: das Team schreibt, der Kunde bekommt K17
+const lastCustomerNoticeByCustomer = new Map() // customerId -> timestamp
+
+/**
+ * Benachrichtigt den Kunden per E-Mail ueber eine neue Chatnachricht vom Team (K17), ohne BCC.
+ * Wirft nie; das Ergebnis zeigt das Admin-Panel unter der Nachricht an.
+ * @returns {Promise<{ sent: boolean, reason?: string, to?: string }>}
+ */
+export async function sendCustomerChatNotice(customer, { sender, text }) {
+  const to = String(customer.email || '').trim()
+  if (!to) return { sent: false, reason: 'keine E-Mail-Adresse' }
+  if (!customer.portalAccessEnabled) return { sent: false, reason: 'kein Portalzugang' }
+  const now = Date.now()
+  const last = lastCustomerNoticeByCustomer.get(customer.$id) || 0
+  if (now - last < config.chatNotify.throttleMin * 60 * 1000) return { sent: false, reason: 'throttled', to }
+  try {
+    lastCustomerNoticeByCustomer.set(customer.$id, now)
+    await sendCustomerMail(to, {
+      template: 'K17',
+      bccTeam: false,
+      values: {
+        kunde_name: customer.name || to,
+        absender: sender || 'Dein WEBklar-Team',
+        nachricht: text,
+        portal_url: `${config.publicBaseUrl}/dashboard.html#chat`,
+      },
+    })
+    return { sent: true, to }
+  } catch (err) {
+    lastCustomerNoticeByCustomer.delete(customer.$id)
+    console.error(`[mailer] Chat-Hinweis an Kunde ${customer.$id} fehlgeschlagen:`, err.message)
+    return { sent: false, reason: err.message, to }
+  }
+}
+
+/** Nur fuer Tests: Zeitfenster der Kunden-Hinweise zuruecksetzen. */
+export function resetChatNoticeThrottleForTests() {
+  lastCustomerNoticeByCustomer.clear()
+}
+
 // ---------------------------------------------------------------------------
 // Wartungs-Abo: Vertrags-/Kuendigungs-/Widerrufsbestaetigungen
 // ---------------------------------------------------------------------------
@@ -112,9 +152,10 @@ export async function sendAdminNotice(message) {
  * Vertragsunterlagen als PDF.
  * Ergebnis: nodemailer-Info (messageId, Antwort des Mailservers, abgelehnte Empfaenger).
  * @param {string} to
- * @param {{ template: string, values?: object, blocks?: object, attachments?: object[] }} message
+ * `bccTeam: false` laesst die Kopie ans Team weg (K17: das Team hat die Nachricht selbst geschrieben).
+ * @param {{ template: string, values?: object, blocks?: object, attachments?: object[], bccTeam?: boolean }} message
  */
-export async function sendCustomerMail(to, { attachments = [], ...message }) {
+export async function sendCustomerMail(to, { attachments = [], bccTeam = true, ...message }) {
   const mailer = getTransporter()
   if (!mailer) throw new Error('SMTP nicht konfiguriert')
   const mail = render(message)
@@ -122,7 +163,7 @@ export async function sendCustomerMail(to, { attachments = [], ...message }) {
     from: `"${CUSTOMER_SENDER}" <${config.smtp.from}>`,
     replyTo: config.smtp.replyTo || undefined,
     to,
-    bcc: config.chatNotify.emails.join(', ') || undefined,
+    bcc: (bccTeam && config.chatNotify.emails.join(', ')) || undefined,
     subject: mail.subject,
     text: mail.text,
     html: mail.html,