Skip to content

Feature Schedule

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

F2. Просмотр расписания

Это целевая спецификация проекта, а не перечень уже реализованных возможностей. Фактический статус — на странице Home.

Назад к Requirements.

Назначение

Основная функция бота: показать студенту, какая пара, когда и в какой аудитории, не заходя на online.susu.ru. Расписание читается из базы данных, которую обновляет парсер. При наличии сохранённых данных запрос пользователя не требует обращения к сайту; если данные ещё не загружены, бот сообщает об этом. Целевое время обработки задано в NFR-1.

Требования

  • FR-3. Кнопки «Сегодня», «Завтра», «Неделя» в главном меню.
  • FR-4. Для каждой пары выводятся: номер и время пары, название дисциплины, вид занятия (лекция, практика, лабораторная), аудитория, преподаватель.
  • FR-5. Команда /date или кнопка «Другая дата» позволяет указать произвольную дату в формате ДД.ММ.
  • Сообщение «Пар нет» выводится только для дня внутри фактически загруженного периода, в котором нет занятий. Отсутствие загруженных данных обозначается отдельно.
  • После реализации релиза 1.1 личная заметка пользователя выводится под соответствующей парой.
  • Внизу сообщения указываются дата и время последнего успешного обновления расписания этой группы с сайта, а не время текущего запроса.
  • Даты и время интерпретируются по Asia/Yekaterinburg (Челябинск). В выводе на сегодня выделяется текущая пара при начало ≤ сейчас < конец; если её нет — ближайшая будущая пара этого дня. После окончания последней пары выделение отсутствует.
  • Каждый день имеет заголовок с датой и днём недели; занятия перечисляются по времени начала. Просмотры дня, недели и выбранной даты используют общий формат из WBS 3.4.4.

Целевой формат вывода

Пример включает заметку, доступную начиная с релиза 1.1; имена и занятия в примере условные.

Понедельник, 2 ноября

1 пара  08:00–09:35
Математический анализ · лекция
ауд. 3-408 · Иванова А. А.

2 пара  09:50–11:25
Программирование · лабораторная
ауд. 3-320 · Петров В. С.
📝 Сдать лабу №3

Обновлено 02.11 07:00

Сценарии

UC-03. Просмотр расписания на сегодня

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

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

  1. Пользователь нажимает кнопку «Сегодня» (или отправляет /today).
  2. Бот определяет группу пользователя и текущую дату по Asia/Yekaterinburg.
  3. Бот читает пары группы на эту дату из базы данных.
  4. Бот формирует сообщение по формату выше, выделяет текущую или ближайшую пару; после реализации релиза 1.1 добавляет личные заметки пользователя.
  5. Бот отправляет сообщение.

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

  • 3а. День входит в загруженный период, но пар нет: бот отправляет «Сегодня пар нет».
  • 3б. Данные на день ещё не загружены: бот сообщает об отсутствии данных и ставит запрос обновления группы в очередь парсера без дублирования уже ожидающего запроса. Это не означает, что на сайте нет расписания.

UC-04. Просмотр расписания на неделю

Краткое описание Пользователь получает расписание на текущую учебную неделю с возможностью перейти к следующей
Актор Пользователь
Предусловия Пользователь зарегистрирован и выбрал группу
Постусловия Отправлено сообщение с парами по дням недели и кнопками «← Пред. неделя», «След. неделя →»

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

  1. Пользователь нажимает «Неделя».
  2. Бот определяет границы текущей учебной недели (понедельник–суббота) по Asia/Yekaterinburg.
  3. Бот читает пары за неделю из базы, группирует по дням.
  4. Бот отправляет одно сообщение с заголовками дней и парами, внизу — кнопки навигации по неделям.
  5. Пользователь нажимает «След. неделя →».
  6. Бот редактирует то же сообщение, показывая следующую неделю.

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

  • 3а. Вся выбранная учебная неделя входит в загруженный период, но пар нет: бот сообщает «На этой неделе пар нет» с кнопками навигации.
  • 3б. Данные за весь выбранный период или его часть отсутствуют: бот явно обозначает незагруженные даты, сохраняя навигацию; отсутствие данных не выдаётся за отсутствие пар.
  • 4а. Сообщение превышает лимит Telegram (4096 символов): бот разбивает его по дням или на допустимые части. При последующей навигации обновляется весь вывод, чтобы старые части не выдавались за выбранную неделю.

UC-05. Просмотр расписания на выбранную дату

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

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

  1. Пользователь нажимает «Другая дата» или отправляет /date.
  2. Бот просит ввести дату в формате ДД.ММ.
  3. Пользователь вводит дату.
  4. Бот определяет год по текущей дате в Asia/Yekaterinburg (текущий или следующий, если указанные день и месяц уже прошли), затем проверяет существование такой календарной даты.
  5. Бот читает пары на эту дату и отправляет сообщение в стандартном формате.

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

  • 4а. Дата в неверном формате: бот сообщает об ошибке и возвращается к шагу 2.
  • 4б. Дата вне фактически загруженного периода: бот сообщает, что данных на эту дату в боте нет. Из этого не делается вывод о публикации расписания на сайте.

Clone this wiki locally