Скачать
RU EN DE FR ES PT 中文

Календарь — руководство пользователя | YoBench

Как пользоваться модулем «Календарь» в YoBench: события, повторы, 5 видов, импорт/подписки iCalendar, напоминания и производственный календарь.

Что такое модуль «Календарь»

Полноценный календарь внутри YoBench: события, повторяющиеся расписания, импорт и подписки iCalendar (.ics), напоминания и производственные календари с праздниками. Интегрируется с Трекером задач — задачи с дедлайнами видны на временной шкале.

Что вы получаете:

  • Пять видов — Год, Месяц, Неделя, День, Повестка (Agenda).
  • Гибкие повторы — ежедневно, по рабочим дням, еженедельно (выбор дней недели), ежемесячно, ежегодно или кастомный интервал.
  • Импорт/экспорт ICS — открытие сторонних календарей и выгрузка собственного.
  • Подписки на внешние ICS-URL с автосинхронизацией.
  • Системные напоминания — за 0/5/15/30/60/120/1440 минут до события.
  • Производственный календарь РФ — данные с consultant.ru: рабочие/выходные/праздничные/сокращённые дни.
  • Задачи трекера — рендерятся на той же шкале по due_date.

Параметры события

При создании или редактировании:

  • Заголовок (обязательно).
  • Описание (опционально).
  • Дата и время начала / конца или флаг На весь день.
  • Цвет — HEX (по умолчанию #3b82f6).
  • Категория — работа / личное / встреча / день рождения / без категории.
  • Место/ссылка — текст или URL.
  • Статус — подтверждено / возможно / отменено.
  • Занят — флаг занятости (для шкалы загруженности).
  • Блок фокуса — отметка для focus-time.
  • Напоминания — список значений в минутах: 0 (в момент события), 5, 15, 30, 60, 120, 1440 (за день).
  • Повтор — правило повторения (см. ниже).

Повторяющиеся события

Не RRULE, а простой JSON-формат:

  • Тип: daily, weekdays (по рабочим дням), weekly (с выбором дней недели), monthly, yearly, custom.
  • Интервал/единица для custom — например, каждые 2 недели (unit: weeks, interval: 2).
  • Окончание: никогда, по дате или после N повторов.

Виртуальные экземпляры повторов разворачиваются на лету при отображении диапазона.

iCalendar (.ics)

  • Импорт файла — выберите .ics, события дедуплицируются по external_uid.
  • Экспорт — выгрузка событий года в .ics (через ical-generator).
  • Подписки на URL — добавьте URL и опциональную Basic-аутентификацию. Календарь будет автоматически опрашиваться по интервалу (по умолчанию 60 минут). Удалённые на стороне источника события удаляются и в YoBench.

Производственные календари

Подключён провайдер ru1 — производственный календарь РФ из открытых данных consultant.ru. Поддерживаемые типы дней:

  • working — рабочий
  • weekend — выходной
  • holiday — праздник
  • short — сокращённый

Используется для расчёта рабочих часов и выделения нерабочих дней в видах Год/Месяц.

Архитектура расширяема — провайдеры других стран могут быть добавлены позже.

Напоминания

Пресеты в форме события: 0, 5, 15, 30, 60, 120, 1440 минут до начала. Когда наступает время — отправляется системное уведомление через notification service модуля YoBench. Канал — системные уведомления ОС (отдельных каналов Telegram/email у напоминаний календаря нет).

Контролируется флагом Уведомления календаря (calendarNotificationsEnabled, по умолчанию включено).

Интеграция с трекером

На временной шкале календаря рисуются не только события, но и задачи из Трекера, у которых есть due_date. По клику на задачу можно перейти в её детальное представление в Трекере.

Глобальные настройки

В Настройки → Календарь:

  • Уведомления календаря (calendarNotificationsEnabled) — включает срабатывание напоминаний.
  • Интервал синхронизации ICS-подписок (calendarIcalSyncIntervalMinutes) — по умолчанию 60 минут.
  • Также служебно сохраняются последний открытый год и выбранный провайдер производственного календаря.

Флоу использования

1. Создайте событие

  1. Откройте Календарь в левом меню.
  2. Кликните пустую клетку дня или нажмите + Событие.
  3. Заполните заголовок, время, описание.
  4. При необходимости задайте повтор и напоминания.
  5. Сохраните.

2. Переключайте виды

В шапке календаря — переключатель Год / Месяц / Неделя / День / Повестка.

3. Двигайте и масштабируйте события

Drag-and-drop карточки события переносит его на другую дату/время. Тащите за нижний край — изменяете длительность.

4. Подключите внешний календарь

В разделе Подписки добавьте URL ICS-календаря и (если нужно) логин/пароль. Жмите Синхронизировать сейчас или ждите автосинхронизации.

5. Импорт/экспорт

  • Импорт ICS — кнопка Импорт, выбор файла. События не дублируются благодаря deduplication по UID.
  • Экспорт ICS — кнопка Экспорт, сохраняет события текущего года.

6. Включите производственный календарь

В настройках выберите провайдер ru1 — нерабочие дни выделятся цветом, а в Месяц/Год можно увидеть праздники.

Что дальше

  • Подключите Трекер задач — дедлайны автоматически появятся на шкале.
  • Используйте Email, если хотите создавать события из писем.

Помощь и обратная связь

Хотите производственный календарь другой страны или поддержку RRULE? Напишите нам через форму обратной связи.