Geburtstag-Management-Modal mit Reset + Send + Auto-Flag

Neuer Cake-Button neben dem Geburtsdatum in den Stammdaten öffnet ein Modal mit drei Funktionen: 1. **Gruß-Marker zurücksetzen** (lastBirthdayGreetingYear → null) - Für Debugging oder als Fallback, wenn der Kunde den Gruß erneut sehen soll - Mit Bestätigungsdialog 2. **Geburtstagsgruß jetzt senden** (Email / WhatsApp / Telegram / Signal) - Email: direkt via System-SMTP mit HTML-Template (Du/Sie-abhängig) - WhatsApp/Telegram/Signal: öffnet vorbefülltes Fenster mit Gruß-Text - Text beachtet Du/Sie-Verhältnis (pronomen, possessiv, etc.) - Mit Bestätigungsdialog 3. **Automatisch senden** – neue Einstellung am Customer - autoBirthdayGreeting (Boolean) + autoBirthdayChannel (String) - Für späteren Cron-basierten Automatik-Versand vorbereitet Backend: - birthday.service.ts: resetBirthdayGreeting, buildBirthdayGreetingText, getBirthdayGreetingData - birthday.controller.ts: resetBirthdayGreeting, sendBirthdayGreeting - Routes: POST /birthdays/:customerId/reset + /send - Audit-Log bei beiden Aktionen Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
2026-04-23 12:46:03 +02:00
parent 2a3928d0e7
commit 9d6bd68ddc
9 changed files with 597 additions and 1 deletions
@@ -169,6 +169,10 @@ model Customer {
  // Anrede-Verhältnis: true = Du (informell), false = Sie (formell, Default)
  useInformalAddress           Boolean        @default(false)

+  // Automatischer Geburtstagsgruß-Versand
+  autoBirthdayGreeting         Boolean        @default(false)
+  autoBirthdayChannel          String?        // "email", "whatsapp", "telegram", "signal"
+
  user                 User?
  addresses            Address[]
  bankCards            BankCard[]
@@ -1,6 +1,9 @@
 import { Response } from 'express';
 import { AuthRequest } from '../types/index.js';
 import * as birthdayService from '../services/birthday.service.js';
+import { sendEmail, SmtpCredentials } from '../services/smtpService.js';
+import { getSystemEmailCredentials } from '../services/emailProvider/emailProviderService.js';
+import { createAuditLog } from '../services/audit.service.js';

 /**
 * Admin/Mitarbeiter: Kommende und vergangene Geburtstage
@@ -54,3 +57,125 @@ export async function acknowledgeMyBirthday(req: AuthRequest, res: Response) {
    res.status(500).json({ success: false, error: 'Fehler beim Speichern' });
  }
 }
+
+/**
+ * Admin: Geburtstagsgruß-Marker für einen Kunden zurücksetzen (Debug / Re-Trigger).
+ */
+export async function resetBirthdayGreeting(req: AuthRequest, res: Response) {
+  try {
+    const customerId = parseInt(req.params.customerId);
+    await birthdayService.resetBirthdayGreeting(customerId);
+
+    await createAuditLog({
+      userId: req.user?.userId,
+      userEmail: req.user?.email || 'unknown',
+      action: 'UPDATE',
+      resourceType: 'Customer',
+      resourceId: customerId.toString(),
+      resourceLabel: `Geburtstagsgruß-Marker zurückgesetzt`,
+      endpoint: req.path,
+      httpMethod: req.method,
+      ipAddress: req.socket.remoteAddress || 'unknown',
+      dataSubjectId: customerId,
+    });
+
+    res.json({ success: true });
+  } catch (error) {
+    console.error('Fehler beim Zurücksetzen:', error);
+    res.status(500).json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Fehler beim Zurücksetzen',
+    });
+  }
+}
+
+/**
+ * Admin: Geburtstagsgruß manuell senden (Email oder Link für WhatsApp/Telegram/Signal).
+ */
+export async function sendBirthdayGreeting(req: AuthRequest, res: Response) {
+  try {
+    const customerId = parseInt(req.params.customerId);
+    const { channel } = req.body; // 'email', 'whatsapp', 'telegram', 'signal'
+
+    if (!['email', 'whatsapp', 'telegram', 'signal'].includes(channel)) {
+      return res.status(400).json({ success: false, error: 'Ungültiger Kanal' });
+    }
+
+    const data = await birthdayService.getBirthdayGreetingData(customerId);
+    if (!data) {
+      return res.status(400).json({
+        success: false,
+        error: 'Kunde hat kein Geburtsdatum hinterlegt',
+      });
+    }
+
+    const { subject, plain, html } = birthdayService.buildBirthdayGreetingText(data, data.age);
+
+    if (channel === 'email') {
+      if (!data.email) {
+        return res.status(400).json({
+          success: false,
+          error: 'Kunde hat keine E-Mail-Adresse hinterlegt',
+        });
+      }
+
+      const systemEmail = await getSystemEmailCredentials();
+      if (!systemEmail) {
+        return res.status(400).json({
+          success: false,
+          error: 'Keine System-E-Mail konfiguriert. Bitte in den Email-Provider-Einstellungen hinterlegen.',
+        });
+      }
+
+      const credentials: SmtpCredentials = {
+        host: systemEmail.smtpServer,
+        port: systemEmail.smtpPort,
+        user: systemEmail.emailAddress,
+        password: systemEmail.password,
+        encryption: systemEmail.smtpEncryption,
+        allowSelfSignedCerts: systemEmail.allowSelfSignedCerts,
+      };
+
+      const result = await sendEmail(credentials, systemEmail.emailAddress, {
+        to: data.email,
+        subject,
+        html,
+      }, {
+        context: 'birthday-greeting',
+        customerId,
+        triggeredBy: req.user?.email,
+      });
+
+      if (!result.success) {
+        return res.status(400).json({
+          success: false,
+          error: `E-Mail-Versand fehlgeschlagen: ${result.error}`,
+        });
+      }
+    }
+
+    await createAuditLog({
+      userId: req.user?.userId,
+      userEmail: req.user?.email || 'unknown',
+      action: 'CREATE',
+      resourceType: 'Customer',
+      resourceId: customerId.toString(),
+      resourceLabel: `Geburtstagsgruß gesendet (${channel})`,
+      endpoint: req.path,
+      httpMethod: req.method,
+      ipAddress: req.socket.remoteAddress || 'unknown',
+      dataSubjectId: customerId,
+    });
+
+    res.json({
+      success: true,
+      data: { channel, messageText: plain },
+    });
+  } catch (error) {
+    console.error('Fehler beim Senden des Geburtstagsgrußes:', error);
+    res.status(500).json({
+      success: false,
+      error: error instanceof Error ? error.message : 'Fehler beim Senden',
+    });
+  }
+}
@@ -7,6 +7,10 @@ const router = Router();
 // Admin: Kommende und vergangene Geburtstage
 router.get('/upcoming', authenticate, requirePermission('customers:read'), birthdayController.getUpcomingBirthdays);

+// Admin: Gruß-Marker zurücksetzen + Gruß senden
+router.post('/:customerId/reset', authenticate, requirePermission('customers:update'), birthdayController.resetBirthdayGreeting);
+router.post('/:customerId/send', authenticate, requirePermission('customers:update'), birthdayController.sendBirthdayGreeting);
+
 // Portal: eigener Geburtstag-Check
 router.get('/my-birthday', authenticate, birthdayController.getMyBirthday);
 router.post('/my-birthday/acknowledge', authenticate, birthdayController.acknowledgeMyBirthday);
@@ -214,3 +214,123 @@ export async function acknowledgeBirthdayGreeting(customerId: number): Promise<v
    data: { lastBirthdayGreetingYear: thisYear },
  });
 }
+
+/**
+ * Setzt den Gruß-Marker zurück, damit das Modal beim nächsten Login wieder erscheint.
+ * (Für Mitarbeiter – nützlich zum Debuggen und als Fallback wenn etwas schief ging.)
+ */
+export async function resetBirthdayGreeting(customerId: number): Promise<void> {
+  await prisma.customer.update({
+    where: { id: customerId },
+    data: { lastBirthdayGreetingYear: null },
+  });
+}
+
+/**
+ * Generiert den persönlichen Geburtstagsgruß-Text (Du/Sie-abhängig).
+ */
+export function buildBirthdayGreetingText(
+  customer: {
+    firstName: string;
+    lastName: string;
+    salutation: string | null;
+    useInformalAddress: boolean;
+  },
+  age: number,
+): { subject: string; plain: string; html: string } {
+  const name = customer.useInformalAddress
+    ? customer.firstName
+    : [customer.salutation, customer.lastName].filter(Boolean).join(' ') || customer.firstName;
+  const du = customer.useInformalAddress;
+  const pronoun = du ? 'dir' : 'Ihnen';
+  const possessive = du ? 'deinem' : 'Ihrem';
+  const yourLower = du ? 'dein' : 'Ihr';
+
+  const subject = du
+    ? `Alles Gute zum Geburtstag, ${customer.firstName}! 🎉`
+    : 'Herzlichen Glückwunsch zum Geburtstag 🎉';
+
+  const plain = [
+    `Herzlichen Glückwunsch, ${name}!`,
+    '',
+    age > 0
+      ? `Alles Gute zu ${possessive} ${age}. Geburtstag!`
+      : `Alles Gute zu ${possessive} Geburtstag!`,
+    '',
+    `Wir wünschen ${pronoun} einen wunderschönen Tag und alles Gute für ${yourLower} neues Lebensjahr. 🌟`,
+    '',
+    'Herzliche Grüße',
+    'Hacker-Net Telekommunikation',
+  ].join('\n');
+
+  const html = `
+    <div style="font-family: Arial, sans-serif; max-width: 600px; margin: 0 auto;">
+      <div style="background: linear-gradient(135deg, #ec4899 0%, #8b5cf6 50%, #6366f1 100%); padding: 40px 20px; text-align: center; border-radius: 12px 12px 0 0;">
+        <div style="font-size: 64px; margin-bottom: 8px;">🎉🎂🎈</div>
+      </div>
+      <div style="padding: 32px; background: #ffffff; border: 1px solid #e5e7eb; border-top: none; border-radius: 0 0 12px 12px;">
+        <h2 style="color: #1f2937; margin-top: 0;">Herzlichen Glückwunsch, ${name}!</h2>
+        <p style="color: #4b5563; font-size: 16px; line-height: 1.6;">
+          ${age > 0 ? `Alles Gute zu ${possessive} <strong>${age}. Geburtstag</strong>!` : `Alles Gute zu ${possessive} Geburtstag!`}
+        </p>
+        <p style="color: #6b7280; font-size: 14px; line-height: 1.6;">
+          Wir wünschen ${pronoun} einen wunderschönen Tag und alles Gute für ${yourLower} neues Lebensjahr. 🌟
+        </p>
+        <hr style="border: none; border-top: 1px solid #e5e7eb; margin: 24px 0;">
+        <p style="color: #9ca3af; font-size: 12px; margin: 0;">
+          Herzliche Grüße<br>
+          <strong>Hacker-Net Telekommunikation</strong><br>
+          Am Wunderburgpark 5b, 26135 Oldenburg<br>
+          info@hacker-net.de
+        </p>
+      </div>
+    </div>
+  `;
+
+  return { subject, plain, html };
+}
+
+/**
+ * Lädt die für den Gruß benötigten Kundendaten inkl. aktuellem Alter heute.
+ */
+export async function getBirthdayGreetingData(customerId: number): Promise<{
+  firstName: string;
+  lastName: string;
+  salutation: string | null;
+  useInformalAddress: boolean;
+  email: string | null;
+  phone: string | null;
+  mobile: string | null;
+  age: number;
+} | null> {
+  const c = await prisma.customer.findUnique({
+    where: { id: customerId },
+    select: {
+      firstName: true,
+      lastName: true,
+      salutation: true,
+      useInformalAddress: true,
+      email: true,
+      phone: true,
+      mobile: true,
+      birthDate: true,
+    },
+  });
+
+  if (!c?.birthDate) return null;
+
+  const today = new Date();
+  today.setHours(0, 0, 0, 0);
+  const age = calculateAge(c.birthDate, today);
+
+  return {
+    firstName: c.firstName,
+    lastName: c.lastName,
+    salutation: c.salutation,
+    useInformalAddress: c.useInformalAddress,
+    email: c.email,
+    phone: c.phone,
+    mobile: c.mobile,
+    age,
+  };
+}
@@ -57,6 +57,15 @@ als Factory-Default beim Initialisieren wieder einspielen lassen.

 ## ✅ Erledigt

+- [x] **Geburtstag-Management-Modal in Kundenstammdaten**
+  - Neuer Button (Cake-Icon) neben Geburtsdatum öffnet Modal
+  - **Gruß zurücksetzen:** setzt `lastBirthdayGreetingYear` auf null zurück (fürs Debugging + Fallback)
+  - **Gruß jetzt senden:** per Email (direkt), WhatsApp/Telegram/Signal (öffnet vorbefülltes Fenster)
+  - Beide Aktionen mit Ja/Nein-Bestätigungsdialog (kein versehentliches Klicken)
+  - Text respektiert Du/Sie-Einstellung des Kunden
+  - Checkbox "Automatisch senden" mit Kanal-Dropdown (neue Felder am Customer)
+  - Audit-Log für Reset + Send
+
 - [x] **Anrede-Verhältnis Du/Sie pro Kunde**
  - Neues Feld `useInformalAddress` in Stammdaten (auch bei Firmenkunden)
  - Default: Sie (formell)