Планирование и Управление Часовыми Поясами

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

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

{
  "contact": {
    "number": "34666033135",
    "name": "Иван Петров"
  },
  "language_template": "ru_RU",
  "name_template": "рождественская_акция",
  "recipient_id": "34666033135",
  "notification_type": "marketing"
}

{
  "contact": {
    "number": "34666033135",
    "name": "Иван Петров"
  },
  "language_template": "ru_RU",
  "name_template": "рождественская_акция",
  "recipient_id": "34666033135",
  "notification_type": "marketing",
  "datetime_sending": "2024-12-25T10:30:00",
  "timezone": "Europe/Moscow"
}

await loviService.scheduleVoiceNotification({
  contact: { number: "34666033135" },
  message: "Напоминание: встреча завтра в 9:00",
  datetime_sending: "2024-12-24T20:00:00Z", // Накануне вечером
  voice: "ru-RU-Standard-A"
});

await loviService.scheduleVoiceNotification({
  contact: { number: "34666033135" },
  template: "ежедневное_напоминание_о_лекарствах",
  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] // Пн-Пт
  },
  variables: {
    name: "Иван",
    medication: "инсулин",
    dosage: "10 единиц"
  }
});

const result = await loviService.scheduleNotification({
  contact: { number: "34666033135" },
  template: "подтверждение_встречи",
  datetime_sending: "2024-12-25T09:00:00Z",
  variables: {
    name: "Иван",
    date: "25 декабря",
    time: "10:00"
  }
});

console.log(result.notification_id); // ID для будущего обращения

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" // Изменить время
});

await loviService.updateScheduledNotification(notificationId, {
  variables: {
    name: "Иван Петров", // Новое имя
    date: "26 декабря"  // Новая дата
  }
});

await loviService.cancelScheduledNotification(notificationId);

await loviService.cancelScheduledNotifications({
  contact_number: "34666033135",
  template: "напоминание_о_встрече"
});

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

// Результат:
// {
//   "total_scheduled": 1250,
//   "total_sent": 1245,
//   "total_failed": 5,
//   "average_delay": 0.2, // минуты
//   "by_day": [...]
// }

const deliveryReport = await loviService.getDeliveryReport(notificationId);

// Результат:
// {
//   "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"]
});

// ✅ Хорошие времена
"2024-12-25T09:00:00Z" // Рабочее время
"2024-12-25T19:00:00Z" // Вечер

// ❌ Времена, которых следует избегать
"2024-12-25T03:00:00Z" // Глубокая ночь
"2024-12-25T12:00:00Z" // Обеденное время

try {
  await loviService.scheduleNotification(notificationData);
} catch (error) {
  if (error.code === 'INVALID_SCHEDULE_TIME') {
    // Предложить новое время
    const suggestedTime = suggestValidTime(notificationData.datetime_sending);
    await loviService.scheduleNotification({
      ...notificationData,
      datetime_sending: suggestedTime
    });
  }
}