Skip to content
Denis Revyagin edited this page Nov 12, 2026 · 19 revisions

ЮУрГУ.Пары

Учебный проект Telegram-бота с расписанием пар для студентов ЮУрГУ. Планируется просмотр расписания на день и неделю, заметки к занятиям и уведомления о следующей паре.

Статус Реализованы HTTP-каркас и компонент меню; пользовательские сценарии MVP в разработке
Начало учебного проекта 21.09.2026
Обязательный календарный план 12.11.2026 – 15.12.2026: MVP и подготовка сдачи
Крайний срок готовности 15.12.2026
Репозиторий unlaesh/project
Kanban-доска GitHub Project № 1

Текущее состояние

Состояние основного кода после слияния PR #63, коммит 2b3354e:

Область Что есть сейчас
HTTP-сервис FastAPI, запуск Uvicorn, настройки PARY_* и GET /health
Проверки продукта 24 теста: два для /health и 22 для навигации; CI включает Ruff, проверку форматирования и Pytest
Навигация Telegram Компонент меню на aiogram, передача кнопок подключённым обработчикам и возврат в меню с очисткой FSM; транспорт Telegram ещё не подключён
Пользовательские функции Регистрация, расписание, заметки, уведомления и администрирование пока не реализованы
Данные и эксплуатация Парсер и БД — пустые модули; Docker и Alembic — пустые файлы; развёртывание запланировано

/health проверяет только живость HTTP-процесса. Страницы Requirements, описания функций и Architecture задают целевой результат, а WBS — план работ. Их содержание не является отчётом о выполнении.

Реализация выбранных задач пункта 12 принята: компонент меню, исследование публичного источника и обезличенный HTML включены в main через PR #63 после одобрения ay1nesk и успешного CI. Транспорт Telegram и парсер ещё не реализованы. Итоги реализации и сравнение плана с фактом учебного эксперимента приведены в отчёте пункта 12 и Estimation.

План оставшейся работы

План с 12 ноября сохраняет ранее выполненные результаты. До 15 декабря включительно предусмотрены пять итераций: 12–18.11, 19–25.11, 26.11–02.12, 03–09.12 и 10–15.12. Это 34 календарных и 24 будних дня при пятидневной неделе; фактическую доступность участников требуется учитывать отдельно.

При расчётной доступности 4 ч на человека в будний день текущий обязательный объём составляет 296,82 чел.-ч. Заметки, уведомления, администрирование и поздние части проверок — 152 чел.-ч — отложены без назначенного срока; требования и оценки сохранены. Даты 28 целых задач и трёх ранних фаз проверок показаны в Roadmap, расчёт — в Estimation.

14–15 декабря — окно финальных проверок, исправлений и материалов внутри последней итерации. Плановая работа занимает его часть; это не два полностью свободных дня и не продление срока. Точный остаток по ролям приведён в календаре пункта 10. Организационные события — в Development, ограничения — в Concept.

Навигация

Идея и обоснование

Страница Содержание
Ideas Три рассмотренные идеи проекта
Evaluation Экспертная оценка идей по взвешенным критериям и выбор идеи
Concept Концепция, устав, цель по SMART, классификация, экономика проекта
Stakeholders Реестр заинтересованных сторон и матрица «интерес — влияние»

Команда и процесс

Страница Содержание
Team Состав команды, RACI-матрица, должностные инструкции
Development Модель жизненного цикла, процесс разработки, Scrum-роли и события, Definition of Done, правила Kanban-доски и автоматизация
Estimation Оценки, PERT, резервы, длительности, зависимости, календарь и Roadmap

Состав из пяти участников на странице Team используется как учебная модель команды.

Требования

Страница Содержание
Requirements Планируемые функции, приоритеты и пользовательские сценарии
Non-Functional-Requirements Требования к качеству и способы их проверки

Кратко о проекте

Потребность. Быстро узнавать следующую пару и аудиторию в Telegram, хранить домашние задания рядом с расписанием. Исследование выявило публичный источник new.susu.ru; полный четырёхнедельный горизонт пока не подтверждён. Условия и открытая зависимость описаны в Feature-Parser.

Планируемое решение. Расписание в Telegram, заметки к конкретным парам и настраиваемые напоминания.

Цель. К 15 декабря 2026 года выпустить обязательный MVP Telegram-бота с выбором группы и просмотром расписания ЮУрГУ. За первые 30 дней после фактического релиза MVP привлечь не менее 60 студентов, причём не менее половины из них должны обращаться к боту каждую неделю.

Текущий стек. Python 3.12+, FastAPI, aiogram, Uvicorn, Pydantic Settings; проверки — Pytest, HTTPX и Ruff.

Планируемые компоненты. PostgreSQL, Alembic, Playwright, BeautifulSoup, Docker Compose и Nginx; транспорт Telegram и пользовательские сценарии поверх aiogram ещё предстоит подключить.

Учебная версия. Расписание, заметки и уведомления планируются бесплатными. Подписка за 59 ₽ в месяц — гипотеза развития после курса; автоматические напоминания по дедлайнам также относятся к дальнейшим идеям и не входят в требования релиза 1.2.

Планируемые функции системы

Архитектура

  • Architecture — целевая архитектура системы (HLD) и текущее состояние
  • WBS — структурная декомпозиция работ

Ссылки

Clone this wiki locally