Repository navigation
Home
Учебный проект 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.
- Feature-Registration — регистрация и выбор группы
- Feature-Schedule — просмотр расписания
- Feature-Parser — парсинг расписания с сайта ЮУрГУ
- Feature-Notes — заметки к парам
- Feature-Notifications — уведомления о следующей паре
- Feature-Admin — панель администратора
- Architecture — целевая архитектура системы (HLD) и текущее состояние
- WBS — структурная декомпозиция работ