Repository navigation
Architecture
Назад к Home.
Схема описывает запланированную архитектуру учебного проекта. В main реализованы HTTP-каркас FastAPI с /health и компонент меню на aiogram; транспорт Telegram, пользовательские сценарии и остальные инфраструктурные компоненты предстоит разработать.
Исходник схемы: docs/architecture/hld.puml.
| Область | Состояние основного кода после PR #63, коммит 2b3354e
|
|---|---|
| HTTP-сервис | Реализованы FastAPI, запуск Uvicorn и настройки PARY_*
|
/health |
Возвращает статус и версию; проверяет живость процесса, без проверки БД |
| Проверки продукта | 24 теста: два для /health и 22 для навигации |
| CI | GitHub Actions выполняет Ruff, проверку форматирования и Pytest при push в любую ветку и pull request в main; проверки PR #63 успешно пройдены |
| Telegram | Реализован компонент меню на aiogram; транспорт, вебхук и обработчики пользовательских сценариев ещё не подключены |
| Парсер, БД и уведомления | Прикладные модули пока не реализованы; исследование источника не является работающим парсером |
| Развёртывание и эксплуатация | Dockerfile, Docker Compose и конфигурация Alembic пока пусты; сборка, деплой, мониторинг и резервное копирование не реализованы в репозитории |
Сборка и автоматический деплой относятся к WBS 2.3.3; сканирование секретов и проверка миграций в CI — к WBS 2.3.2. Наличие этих компонентов на схеме не означает, что они уже развёрнуты.
Компонент навигации включает клавиатуры, передачу кнопок подключённым обработчикам и возврат в меню с очисткой FSM. Он включён в main через PR #63 после одобрения ay1nesk и успешного CI. Изолированные тесты маршрутизации не подтверждают работу живого Telegram-бота. Результаты реализации и сравнение плана с фактом учебного эксперимента приведены в отчёте пункта 12.
- Nginx — принимает HTTPS-соединения (TLS), передаёт вебхук Telegram в сервис бота.
-
Сервис бота (FastAPI + aiogram) — принимает обновления от Telegram, обрабатывает команды, отдаёт
/healthдля мониторинга. -
Парсер расписания — отдельный процесс, который выполняет плановые обновления и обрабатывает очередь внеплановых загрузок из PostgreSQL, получает общедоступное расписание ЮУрГУ и сохраняет его в базу. Исследованный кандидат —
new.susu.ru; получение полного четырёхнедельного горизонта остаётся зависимостью SRC-4W, см. Feature-Parser. Ранее указанный на HLDonline.susu.ruне считается подтверждённым источником без авторизации. - Планировщик уведомлений — раз в минуту находит пары, начинающиеся через N минут, и отправляет напоминания.
- PostgreSQL — единственное хранилище данных; сервисы обмениваются данными только через базу.
- Резервное копирование — ежедневный дамп базы во внешнее хранилище.
-
GitHub Actions — существующие проверки CI; в дальнейшем сборка образов и деплой на сервер при push в
main.
В целевой архитектуре сервисы обмениваются данными через PostgreSQL; брокер сообщений не предусмотрен. Внеплановые задания на обновление сохраняются в базе и обрабатываются парсером независимо от обработки команд бота.
Ограничение «не чаще одного раза в час на группу» на схеме относится к обычным плановым и внеплановым обновлениям. При временных сбоях допускаются до трёх повторных попыток по UC-07 — это исключение из часового ограничения (см. Feature-Parser и NFR-3).
Текущий /health проверяет живость HTTP-процесса. Успешный ответ сам по себе не подтверждает работоспособность PostgreSQL или Telegram.
Требования к компонентам — на страницах Requirements и Non-Functional-Requirements; план реализации — на странице WBS.