Skip to content

Feature Notifications

Denis Revyagin edited this page Nov 12, 2026 · 2 revisions

F5. Уведомления о следующей паре

Назад к Requirements.

Целевая спецификация: наличие требования не означает, что функция уже реализована. Фактический статус проекта — на странице Home.

Назначение

Бот сам напоминает о паре и аудитории за несколько минут до начала. Студенту не нужно открывать расписание между парами, а риск опоздать или прийти не в ту аудиторию снижается. По Concept эта функция — основа платной подписки; в рамках учебного проекта реализуется бесплатно.

Требования

  • FR-12. В меню «Настройки» пользователь включает уведомления и выбирает время до начала пары: 5, 10, 15 или 30 минут.
  • FR-13. Уведомление содержит номер пары, время, дисциплину, вид занятия, аудиторию, преподавателя и заметку к паре, если есть.
  • FR-14. В открытом разделе «Уведомления» отключение выполняется одним нажатием кнопки «Выключить».
  • NFR-2. Целевая задержка отправки при штатной работе — не более 1 минуты от расчётного времени до успешного ответа Telegram Bot API на отправку. Превышения, в том числе при сбоях или ограничении скорости Telegram, фиксируются как нарушения целевого значения с указанием причины, а не исключаются из результатов проверки. Успешный ответ API не подтверждает доставку на устройство пользователя.
  • Уведомление отправляется о каждой паре дня, включая пары, идущие без перерыва: между ними также может смениться аудитория.
  • Напоминания о начале занятий не отправляются в дни без пар. Сообщение об отмене последней пары дня при этом отправляется по правилам уведомлений об изменениях.
  • Если расписание изменилось после успешного планового или внепланового обновления (пара отменена, перенесена, сменилась аудитория), пользователям группы с включёнными уведомлениями отправляется сообщение об изменении.
  • После включения или изменения интервала настройки применяются к расчётным моментам, наступающим не раньше сохранения этих настроек. Пропущенные до этого моменты не вызывают ретроспективную рассылку; успешно отправленное напоминание об этом занятии повторно не отправляется.
  • Отправка идёт пакетами с общим лимитом проекта не более 30 сообщений в секунду. Ответы Telegram об ограничениях скорости также учитываются; число 30 не объявляется универсальным лимитом платформы для всех условий.

Место в системе

Планировщик уведомлений — фоновый процесс, который раз в минуту выбирает из базы актуальные напоминания с наступившим расчётным временем и отправляет сообщения через бота. Расчётное время (due_at) равно времени начала занятия минус выбранный интервал. Напоминание не отправляется раньше due_at и остаётся актуальным только до начала занятия. Часовой пояс — Asia/Yekaterinburg (Челябинск, UTC+5).

Перед каждой отправкой и повторной попыткой проверяются текущая группа пользователя, флаг включения, актуальный интервал, время начала и статус занятия. Кандидаты, утратившие актуальность, не отправляются. Запрос, уже переданный Telegram, отозвать нельзя. Для сообщений об изменениях проверяются текущая группа и настройки получателя; отмена занятия является основанием для такого сообщения, а не запретом на него.

Хранимые данные

Пользователь, флаг «уведомления включены», время до пары в минутах и время вступления текущих настроек в силу. Журнал хранит расчётное время, результат и время успешной отправки либо ошибку. Для напоминаний обрабатывается ключ «пользователь + занятие»; для сообщений об изменениях — отдельный ключ «пользователь + идентификатор изменения». Поэтому отправленное напоминание не блокирует сообщение об изменении этой же пары, а новое изменение не блокируется сообщением о предыдущем.

После однозначной ошибки отправка не считается успешной и может быть повторена, пока напоминание актуально. При неопределённом исходе запроса Telegram или сбое между отправкой и записью результата возможен дубль; абсолютная гарантия доставки «ровно один раз» не заявляется.

Сценарии

UC-10. Включение и настройка уведомлений

Краткое описание Пользователь включает напоминания и выбирает, за сколько минут до пары их получать
Актор Пользователь
Предусловия Пользователь зарегистрирован
Постусловия В базе сохранены флаг включения, интервал и время вступления настроек в силу; планировщик применяет их к будущим расчётным моментам без повторов уже успешно отправленных напоминаний

Основной сценарий

  1. Пользователь открывает «Настройки» → «Уведомления».
  2. Бот показывает текущее состояние («Выключены») и кнопку «Включить».
  3. Пользователь нажимает «Включить».
  4. Бот предлагает выбрать интервал: 5, 10, 15, 30 минут.
  5. Пользователь выбирает интервал.
  6. Бот сохраняет настройки и время их вступления в силу, затем подтверждает: «Буду напоминать за 15 минут до пары». Если расчётный момент ближайшей пары уже прошёл, напоминание об этой паре не создаётся.

Альтернативные сценарии

  • 2а. Уведомления уже включены: бот показывает текущий интервал и кнопки «Изменить интервал» и «Выключить».
  • 5а. Пользователь нажимает «Отмена»: настройки не меняются.

UC-11. Отправка уведомления о следующей паре

Краткое описание Сервис отправляет напоминание пользователю за выбранное время до начала пары
Актор Сервис (планировщик уведомлений)
Предусловия У пользователя включены уведомления; расчётное время актуальной пары его группы наступило после вступления текущих настроек в силу или одновременно с ним; пара ещё не началась; успешная отправка этому пользователю об этой паре ещё не зарегистрирована
Постусловия Telegram Bot API подтвердил успешную отправку; результат и время записаны в журнал. Доставка на устройство пользователя этим не подтверждается

Основной сценарий

  1. Планировщик срабатывает (раз в минуту).
  2. Планировщик выбирает пользователей с включёнными уведомлениями и занятия их текущих групп, для которых due_at ≤ now < время начала занятия. Расчётный момент должен быть не раньше вступления текущих настроек в силу; отменённые занятия исключаются.
  3. Планировщик исключает пары, по которым этому пользователю уже зарегистрирована успешная отправка. Ошибка предыдущей попытки сама по себе не исключает актуальное напоминание из дальнейшей обработки.
  4. Для каждого пользователя бот формирует сообщение с парой, аудиторией и заметкой, если есть.
  5. Перед отправкой бот повторно проверяет актуальность настроек, группы и занятия и отправляет сообщения пакетами с учётом лимитов Telegram.
  6. Планировщик записывает результат и время успешной отправки в журнал; задержку сопоставляет с NFR-2, превышение фиксирует как нарушение.

Альтернативные сценарии

  • 5а. Telegram вернул ошибку «пользователь заблокировал бота»: уведомления для него отключаются, запись об этом в журнал.
  • 5б. Telegram вернул ошибку превышения лимита: планировщик ждёт указанное время, повторно проверяет актуальность и выполняет попытку только до начала пары.
  • 5в. Пользователь отключил уведомления, сменил группу или интервал либо занятие отменено: перед отправкой кандидат проверяется заново; если он больше не соответствует текущим условиям, отправка не выполняется.
  • 5г. Время начала пары наступило до успешной отправки: дальнейшие попытки этого напоминания прекращаются; пропущенная отправка и причина фиксируются в журнале.
  • 2а. Подходящих пар нет: планировщик завершает цикл без действий.

UC-12. Отключение уведомлений

Краткое описание Пользователь отключает напоминания
Актор Пользователь
Предусловия Пользователь зарегистрирован; уведомления включены
Постусловия Флаг уведомлений снят; ожидающие отправки не проходят проверку актуальности и не выполняются; интервал сохранён для повторного включения. Запросы, уже переданные Telegram до отключения, отозвать нельзя

Основной сценарий

  1. Пользователь открывает «Настройки» → «Уведомления».
  2. Бот показывает текущий интервал и кнопку «Выключить».
  3. Пользователь нажимает «Выключить».
  4. Бот снимает флаг в базе и подтверждает: «Уведомления выключены».

Альтернативные сценарии

  • 3а. Пользователь нажимает «Изменить интервал»: переход к шагу 4 сценария UC-10.

Clone this wiki locally