Skip to content

Architecture

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

Целевая архитектура системы (HLD)

Назад к Home.

Схема описывает запланированную архитектуру учебного проекта. В main реализованы HTTP-каркас FastAPI с /health и компонент меню на aiogram; транспорт Telegram, пользовательские сценарии и остальные инфраструктурные компоненты предстоит разработать.

HLD ЮУрГУ.Пары

Исходник схемы: 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. Ранее указанный на HLD online.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.

Clone this wiki locally