Skip to content

Feature Registration

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

F1. Регистрация и выбор группы

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

Назад к Requirements.

Назначение

При первом обращении к боту пользователь указывает свою учебную группу. После этого группу не требуется вводить заново при каждом запросе расписания. Регистрация не требует отдельного логина и пароля — достаточно Telegram-аккаунта.

Требования

  • FR-1. При первом запуске (команда /start) бот предлагает выбрать группу из списка групп ЮУрГУ.
  • FR-2. Группу можно сменить в любой момент через меню «Настройки».
  • Список групп берётся из базы данных, куда его загружает парсер.
  • Выбор группы делается поиском по названию: пользователь вводит часть названия (например, ЕТ-41), бот показывает подходящие варианты кнопками.
  • Если группа не найдена, бот сообщает об этом и предлагает ввести название ещё раз.
  • Если расписание выбранной группы ещё не загружено, создаётся запрос в очередь парсера в PostgreSQL; повторный выбор не создаёт дубликат ожидающего обновления. Обработка очереди описана в Feature-Parser.

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

Telegram ID пользователя, идентификатор группы, дата регистрации, дата последней активности.

Сценарии

UC-01. Первый запуск и выбор группы

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

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

  1. Пользователь нажимает штатную кнопку запуска бота или отправляет команду /start.
  2. Бот отправляет приветствие и просит ввести название группы.
  3. Пользователь вводит часть названия группы.
  4. Бот ищет группы по введённой строке и показывает до 10 подходящих вариантов кнопками.
  5. Пользователь нажимает на свою группу.
  6. Бот сохраняет пользователя и группу в базе, при необходимости ставит запрос первоначальной загрузки и показывает главное меню с кнопками «Сегодня», «Завтра», «Неделя», «Настройки». Кнопка «Заметки» добавляется после реализации релиза 1.1.

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

  • 4а. Группы не найдены: бот сообщает «Группа не найдена» и возвращается к шагу 2.
  • 4б. Найдено больше 10 групп: бот просит уточнить название и возвращается к шагу 2.
  • 1а. Пользователь уже зарегистрирован: бот сразу показывает главное меню.

UC-02. Смена группы

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

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

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

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

  • 4а. Группы не найдены: сообщение об ошибке, возврат к шагу 2.
  • 2а. Пользователь нажимает «Отмена»: группа не меняется, возврат в главное меню.

Clone this wiki locally