Repository navigation
Feature Notifications
Назад к 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 или сбое между отправкой и записью результата возможен дубль; абсолютная гарантия доставки «ровно один раз» не заявляется.
| Краткое описание | Пользователь включает напоминания и выбирает, за сколько минут до пары их получать |
| Актор | Пользователь |
| Предусловия | Пользователь зарегистрирован |
| Постусловия | В базе сохранены флаг включения, интервал и время вступления настроек в силу; планировщик применяет их к будущим расчётным моментам без повторов уже успешно отправленных напоминаний |
Основной сценарий
- Пользователь открывает «Настройки» → «Уведомления».
- Бот показывает текущее состояние («Выключены») и кнопку «Включить».
- Пользователь нажимает «Включить».
- Бот предлагает выбрать интервал: 5, 10, 15, 30 минут.
- Пользователь выбирает интервал.
- Бот сохраняет настройки и время их вступления в силу, затем подтверждает: «Буду напоминать за 15 минут до пары». Если расчётный момент ближайшей пары уже прошёл, напоминание об этой паре не создаётся.
Альтернативные сценарии
- 2а. Уведомления уже включены: бот показывает текущий интервал и кнопки «Изменить интервал» и «Выключить».
- 5а. Пользователь нажимает «Отмена»: настройки не меняются.
| Краткое описание | Сервис отправляет напоминание пользователю за выбранное время до начала пары |
| Актор | Сервис (планировщик уведомлений) |
| Предусловия | У пользователя включены уведомления; расчётное время актуальной пары его группы наступило после вступления текущих настроек в силу или одновременно с ним; пара ещё не началась; успешная отправка этому пользователю об этой паре ещё не зарегистрирована |
| Постусловия | Telegram Bot API подтвердил успешную отправку; результат и время записаны в журнал. Доставка на устройство пользователя этим не подтверждается |
Основной сценарий
- Планировщик срабатывает (раз в минуту).
- Планировщик выбирает пользователей с включёнными уведомлениями и занятия их текущих групп, для которых
due_at ≤ now < время начала занятия. Расчётный момент должен быть не раньше вступления текущих настроек в силу; отменённые занятия исключаются. - Планировщик исключает пары, по которым этому пользователю уже зарегистрирована успешная отправка. Ошибка предыдущей попытки сама по себе не исключает актуальное напоминание из дальнейшей обработки.
- Для каждого пользователя бот формирует сообщение с парой, аудиторией и заметкой, если есть.
- Перед отправкой бот повторно проверяет актуальность настроек, группы и занятия и отправляет сообщения пакетами с учётом лимитов Telegram.
- Планировщик записывает результат и время успешной отправки в журнал; задержку сопоставляет с NFR-2, превышение фиксирует как нарушение.
Альтернативные сценарии
- 5а. Telegram вернул ошибку «пользователь заблокировал бота»: уведомления для него отключаются, запись об этом в журнал.
- 5б. Telegram вернул ошибку превышения лимита: планировщик ждёт указанное время, повторно проверяет актуальность и выполняет попытку только до начала пары.
- 5в. Пользователь отключил уведомления, сменил группу или интервал либо занятие отменено: перед отправкой кандидат проверяется заново; если он больше не соответствует текущим условиям, отправка не выполняется.
- 5г. Время начала пары наступило до успешной отправки: дальнейшие попытки этого напоминания прекращаются; пропущенная отправка и причина фиксируются в журнале.
- 2а. Подходящих пар нет: планировщик завершает цикл без действий.
| Краткое описание | Пользователь отключает напоминания |
| Актор | Пользователь |
| Предусловия | Пользователь зарегистрирован; уведомления включены |
| Постусловия | Флаг уведомлений снят; ожидающие отправки не проходят проверку актуальности и не выполняются; интервал сохранён для повторного включения. Запросы, уже переданные Telegram до отключения, отозвать нельзя |
Основной сценарий
- Пользователь открывает «Настройки» → «Уведомления».
- Бот показывает текущий интервал и кнопку «Выключить».
- Пользователь нажимает «Выключить».
- Бот снимает флаг в базе и подтверждает: «Уведомления выключены».
Альтернативные сценарии
- 3а. Пользователь нажимает «Изменить интервал»: переход к шагу 4 сценария UC-10.