Repository navigation
Requirements
Denis Revyagin edited this page Oct 30, 2026
·
4 revisions
Страница описывает функциональные и нефункциональные требования к Telegram-боту «ЮУрГУ.Пары». Основание — Concept и Stakeholders.
- Пользователь — студент ЮУрГУ, взаимодействует с ботом в Telegram.
- Администратор — участник команды проекта, просматривает пользователей и состояние сервиса.
- Сервис — фоновые процессы бота: парсер расписания и планировщик уведомлений.
Каждая функция описана на отдельной странице: назначение, требования, пользовательские сценарии.
| № | Функция | Приоритет | Этап | Страница |
|---|---|---|---|---|
| F1 | Регистрация и выбор группы | Обязательно | MVP | Feature-Registration |
| F2 | Просмотр расписания | Обязательно | MVP | Feature-Schedule |
| F3 | Парсинг расписания с сайта ЮУрГУ | Обязательно | MVP | Feature-Parser |
| F4 | Заметки к парам | Желательно | MVP + 10 дней | Feature-Notes |
| F5 | Уведомления о следующей паре | Желательно | после заметок | Feature-Notifications |
| F6 | Панель администратора | Возможно | при наличии времени | Feature-Admin |
Приоритеты соответствуют треугольнику ограничений из Concept: срок зафиксирован, объём гибкий. Функции с приоритетом «Обязательно» составляют MVP и не могут быть исключены; остальные реализуются в указанном порядке по мере наличия времени.
| ID | Требование | Функция |
|---|---|---|
| FR-1 | Система позволяет пользователю выбрать учебную группу из списка групп ЮУрГУ при первом запуске | F1 |
| FR-2 | Система позволяет пользователю сменить группу в любой момент | F1 |
| FR-3 | Система показывает расписание на сегодня, завтра и текущую неделю по команде или кнопке | F2 |
| FR-4 | Для каждой пары отображаются: номер и время, название дисциплины, вид занятия, аудитория, преподаватель | F2 |
| FR-5 | Система показывает расписание на произвольную дату | F2 |
| FR-6 | Сервис периодически загружает расписание всех групп, по которым есть пользователи, с сайта ЮУрГУ и сохраняет его в базу данных | F3 |
| FR-7 | Пользователю показывается расписание из базы данных, а не напрямую с сайта | F3 |
| FR-8 | При недоступности сайта сервис показывает последнее сохранённое расписание с пометкой о дате обновления | F3 |
| FR-9 | Пользователь может добавить текстовую заметку к конкретной паре | F4 |
| FR-10 | Заметки отображаются вместе с расписанием соответствующей пары | F4 |
| FR-11 | Пользователь может просмотреть список своих заметок, отредактировать и удалить заметку | F4 |
| FR-12 | Пользователь может включить уведомления о следующей паре и выбрать время до начала (5, 10, 15, 30 минут) | F5 |
| FR-13 | Сервис отправляет уведомление с названием пары, временем и аудиторией за выбранное время до начала | F5 |
| FR-14 | Пользователь может отключить уведомления | F5 |
| FR-15 | Администратор может просмотреть список пользователей: Telegram ID, группа, дата регистрации, дата последней активности | F6 |
| FR-16 | Администратор может просмотреть сводную статистику: число пользователей, групп, заметок, подписок на уведомления | F6 |
| FR-17 | Администратор может запустить обновление расписания вручную | F6 |
| ID | Требование |
|---|---|
| NFR-1 | Ответ бота на команду просмотра расписания — не более 2 секунд при наличии данных в базе |
| NFR-2 | Уведомление о паре доставляется не позже чем через 1 минуту после расчётного времени |
| NFR-3 | Парсер обращается к сайту ЮУрГУ не чаще одного раза в час на группу и не более одного параллельного запроса, чтобы не создавать нагрузку на портал |
| NFR-4 | Бот не запрашивает и не хранит учётные данные студентов от online.susu.ru; используется только общедоступное расписание |
| NFR-5 | Хранятся только Telegram ID, группа, заметки и настройки уведомлений; персональные данные (ФИО, телефон) не собираются |
| NFR-6 | Добавление нового вуза сводится к реализации отдельного модуля парсера без изменения остальной системы |
| NFR-7 | Система устойчива к изменению разметки сайта: ошибка парсера логируется и не приводит к остановке бота |
| NFR-8 | Все команды бота доступны через меню кнопок; знание текстовых команд не требуется |
| NFR-9 | Структура базы данных изменяется только через миграции Alembic |
Сценарии описаны на страницах соответствующих функций.
| ID | Сценарий | Актор | Страница |
|---|---|---|---|
| UC-01 | Первый запуск и выбор группы | Пользователь | Feature-Registration |
| UC-02 | Смена группы | Пользователь | Feature-Registration |
| UC-03 | Просмотр расписания на сегодня | Пользователь | Feature-Schedule |
| UC-04 | Просмотр расписания на неделю | Пользователь | Feature-Schedule |
| UC-05 | Просмотр расписания на выбранную дату | Пользователь | Feature-Schedule |
| UC-06 | Плановое обновление расписания | Сервис | Feature-Parser |
| UC-07 | Обработка недоступности сайта ЮУрГУ | Сервис | Feature-Parser |
| UC-08 | Добавление заметки к паре | Пользователь | Feature-Notes |
| UC-09 | Просмотр и удаление заметок | Пользователь | Feature-Notes |
| UC-10 | Включение и настройка уведомлений | Пользователь | Feature-Notifications |
| UC-11 | Отправка уведомления о следующей паре | Сервис | Feature-Notifications |
| UC-12 | Отключение уведомлений | Пользователь | Feature-Notifications |
| UC-13 | Просмотр списка пользователей | Администратор | Feature-Admin |
| UC-14 | Ручной запуск обновления расписания | Администратор | Feature-Admin |