Skip to content

Feature Notifications

Denis Revyagin edited this page Oct 30, 2026 · 2 revisions

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

Назад к Requirements.

Назначение

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

Требования

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

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

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

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

Пользователь, флаг «уведомления включены», время до пары в минутах, журнал отправленных уведомлений (пользователь, занятие, время отправки) — чтобы не отправлять дважды.

Сценарии

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

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

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

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

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

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

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

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

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

  1. Планировщик срабатывает (раз в минуту).
  2. Планировщик выбирает пользователей с включёнными уведомлениями и для каждого — пару его группы, начинающуюся через его интервал (±30 секунд).
  3. Планировщик исключает пары, по которым уведомление уже отправлено.
  4. Для каждого пользователя бот формирует сообщение с парой, аудиторией и заметкой, если есть.
  5. Бот отправляет сообщения пакетами с учётом лимитов Telegram.
  6. Планировщик записывает отправленные уведомления в журнал.

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

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

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

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

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

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

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

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

Clone this wiki locally