Repository navigation
Feature Notifications
Назад к Requirements.
Бот сам напоминает о паре и аудитории за несколько минут до начала. Студенту не нужно открывать расписание между парами, а риск опоздать или прийти не в ту аудиторию снижается. По Concept эта функция — основа платной подписки; в рамках учебного проекта реализуется бесплатно.
- FR-12. В меню «Настройки» пользователь включает уведомления и выбирает время до начала пары: 5, 10, 15 или 30 минут.
- FR-13. Уведомление содержит номер пары, время, дисциплину, вид занятия, аудиторию, преподавателя и заметку к паре, если есть.
- FR-14. Уведомления отключаются одной кнопкой.
- NFR-2. Задержка доставки — не более 1 минуты от расчётного времени.
- Уведомление отправляется только о первой паре дня и о каждой следующей паре после перерыва; о паре, идущей сразу за предыдущей без перерыва, уведомление тоже отправляется, так как может смениться аудитория.
- Уведомления не отправляются в дни без пар.
- Если расписание изменилось после планового обновления (пара отменена, перенесена, сменилась аудитория), пользователям группы с включёнными уведомлениями отправляется сообщение об изменении.
- Отправка идёт пакетами с соблюдением лимитов Telegram Bot API (не более 30 сообщений в секунду).
Планировщик уведомлений — фоновый процесс, который раз в минуту выбирает из базы пары, начинающиеся через N минут, для пользователей с включёнными уведомлениями, и отправляет сообщения через бота. Часовой пояс — Челябинск (UTC+5).
Пользователь, флаг «уведомления включены», время до пары в минутах, журнал отправленных уведомлений (пользователь, занятие, время отправки) — чтобы не отправлять дважды.
| Краткое описание | Пользователь включает напоминания и выбирает, за сколько минут до пары их получать |
| Актор | Пользователь |
| Предусловия | Пользователь зарегистрирован |
| Постусловия | В базе сохранены флаг включения и интервал; со следующей пары пользователь получает уведомления |
Основной сценарий
- Пользователь открывает «Настройки» → «Уведомления».
- Бот показывает текущее состояние («Выключены») и кнопку «Включить».
- Пользователь нажимает «Включить».
- Бот предлагает выбрать интервал: 5, 10, 15, 30 минут.
- Пользователь выбирает интервал.
- Бот сохраняет настройки и подтверждает: «Буду напоминать за 15 минут до пары».
Альтернативные сценарии
- 2а. Уведомления уже включены: бот показывает текущий интервал и кнопки «Изменить интервал» и «Выключить».
- 5а. Пользователь нажимает «Отмена»: настройки не меняются.
| Краткое описание | Сервис отправляет напоминание пользователю за выбранное время до начала пары |
| Актор | Сервис (планировщик уведомлений) |
| Предусловия | У пользователя включены уведомления; в базе есть пара его группы, начинающаяся через выбранный интервал; уведомление об этой паре ещё не отправлялось |
| Постусловия | Пользователь получил сообщение; факт отправки записан в журнал |
Основной сценарий
- Планировщик срабатывает (раз в минуту).
- Планировщик выбирает пользователей с включёнными уведомлениями и для каждого — пару его группы, начинающуюся через его интервал (±30 секунд).
- Планировщик исключает пары, по которым уведомление уже отправлено.
- Для каждого пользователя бот формирует сообщение с парой, аудиторией и заметкой, если есть.
- Бот отправляет сообщения пакетами с учётом лимитов Telegram.
- Планировщик записывает отправленные уведомления в журнал.
Альтернативные сценарии
- 5а. Telegram вернул ошибку «пользователь заблокировал бота»: уведомления для него отключаются, запись об этом в журнал.
- 5б. Telegram вернул ошибку превышения лимита: планировщик ждёт указанное время и повторяет отправку.
- 2а. Подходящих пар нет: планировщик завершает цикл без действий.
| Краткое описание | Пользователь отключает напоминания |
| Актор | Пользователь |
| Предусловия | Пользователь зарегистрирован; уведомления включены |
| Постусловия | Флаг уведомлений снят; новые уведомления не отправляются; интервал сохранён для повторного включения |
Основной сценарий
- Пользователь открывает «Настройки» → «Уведомления».
- Бот показывает текущий интервал и кнопку «Выключить».
- Пользователь нажимает «Выключить».
- Бот снимает флаг в базе и подтверждает: «Уведомления выключены».
Альтернативные сценарии
- 3а. Пользователь нажимает «Изменить интервал»: переход к шагу 4 сценария UC-10.