Planung und Zeitzonen-Verwaltung

{
  "datetime_sending": "2024-12-25T10:30:00",
  "timezone": "Europe/Berlin"
}

"2024-12-25T10:30:00"
"2024-12-25T10:30:00.000"
"2024-12-25T10:30:00Z"
"2024-12-25T10:30:00+01:00"

{
  "contact": {
    "number": "34666033135",
    "name": "Hans Müller"
  },
  "language_template": "de_DE",
  "name_template": "weihnachten_promo",
  "recipient_id": "34666033135",
  "notification_type": "marketing"
}

{
  "contact": {
    "number": "34666033135",
    "name": "Hans Müller"
  },
  "language_template": "de_DE",
  "name_template": "weihnachten_promo",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "datetime_sending": "2024-12-25T10:30:00",
  "timezone": "Europe/Berlin"
}

await loviService.scheduleVoiceNotification({
  contact: { number: "34666033135" },
  message: "Erinnerung: Termin morgen um 9:00",
  datetime_sending: "2024-12-24T20:00:00Z", // Am Vorabend
  voice: "de-DE-Standard-A"
});

await loviService.scheduleVoiceNotification({
  contact: { number: "34666033135" },
  template: "daily_medication_reminder",
  schedule: {
    type: "recurring",
    frequency: "daily",
    start_date: "2024-01-01T08:00:00Z",
    end_date: "2024-01-31T08:00:00Z",
    days_of_week: [1,2,3,4,5] // Mo-Fr
  },
  variables: {
    name: "Hans",
    medication: "insulin",
    dosage: "10 Einheiten"
  }
});

const result = await loviService.scheduleNotification({
  contact: { number: "34666033135" },
  template: "termin_bestaetigung",
  datetime_sending: "2024-12-25T09:00:00Z",
  variables: {
    name: "Hans",
    date: "25 Dezember",
    time: "10:00"
  }
});

console.log(result.notification_id); // ID für zukünftige Referenz

const schedules = await loviService.getScheduledNotifications({
  status: "pending", // pending, sent, cancelled
  limit: 50,
  offset: 0
});

const schedule = await loviService.getScheduledNotification(notificationId);

await loviService.updateScheduledNotification(notificationId, {
  datetime_sending: "2024-12-25T10:00:00Z" // Zeit ändern
});

await loviService.updateScheduledNotification(notificationId, {
  variables: {
    name: "Hans Müller", // Neuer Name
    date: "26 Dezember"  // Neues Datum
  }
});

await loviService.cancelScheduledNotification(notificationId);

await loviService.cancelScheduledNotifications({
  contact_number: "34666033135",
  template: "termin_erinnerung"
});

const stats = await loviService.getSchedulingStats({
  start_date: "2024-12-01",
  end_date: "2024-12-31",
  group_by: "day" // hour, day, week, month
});

// Ergebnis:
// {
//   "total_scheduled": 1250,
//   "total_sent": 1245,
//   "total_failed": 5,
//   "average_delay": 0.2, // Minuten
//   "by_day": [...]
// }

const deliveryReport = await loviService.getDeliveryReport(notificationId);

// Ergebnis:
// {
//   "notification_id": "uuid-123",
//   "status": "sent",
//   "sent_at": "2024-12-25T09:00:15Z",
//   "delivered_at": "2024-12-25T09:00:20Z",
//   "read_at": "2024-12-25T09:05:30Z",
//   "delivery_status": "delivered",
//   "failure_reason": null
// }

await loviService.cleanupExpiredSchedules({
  older_than_days: 30,
  status: "sent"
});

await loviService.archiveSchedules({
  date_before: "2024-01-01",
  status: ["sent", "failed"]
});

// ✅ Gute Zeiten
"2024-12-25T09:00:00Z" // Geschäftszeit
"2024-12-25T19:00:00Z" // Abend

// ❌ Zu vermeidende Zeiten
"2024-12-25T03:00:00Z" // Tief in der Nacht
"2024-12-25T12:00:00Z" // Mittagspause

try {
  await loviService.scheduleNotification(notificationData);
} catch (error) {
  if (error.code === 'INVALID_SCHEDULE_TIME') {
    // Neue Zeit vorschlagen
    const suggestedTime = suggestValidTime(notificationData.datetime_sending);
    await loviService.scheduleNotification({
      ...notificationData,
      datetime_sending: suggestedTime
    });
  }
}