Files
mtusi2026lab5-fork/REPORT.md
T
2026-11-07 16:10:32 +03:00

6.1 KiB
Raw Blame History

Отчёт — лабораторная 5

  • Автор, группа: Григорян Илья Мурадович, БПИ2303 (из отчёта lab4).
  • Целевая оценка: 5; исследовательский трек пока не выбран.
  • Этап: перенос базы lab4 и заготовки с docstring, без реализации lab5.
  • Дата переноса: 07.11.2026.
  • Commit/PR lab5: заполнить после публикации.
  • Использованные источники: README-файлы и contracts/ репозитория lab5, исходники lab4. Использована помощь Codex. Новых зависимостей нет.

Запуск из чистого clone

Нужны Python 3.12, pip, Docker с Compose. Подготовка и запуск:

python3 -m venv .venv
.venv/bin/python -m pip install -r requirements.txt -r requirements-dev.txt
make init
make up

HTTP: http://localhost:18081. make down останавливает стенд с сохранением данных. Тестовый стенд: make test-stand-up, остановка: make test-stand-down. Намеренное удаление учебных данных: make test-stand-destroy для тестового стенда, docker compose --env-file .env down --volumes для основного. Версии зависимостей перенесены без обновления. Локальные secrets/.env генерируются заново, не копируются из lab4. Стенд при переносе не запускался; воспроизводимость после переноса ещё не проверена.

Архитектура и решения

Перенесены приложение FastAPI, PostgreSQL-миграции, общие Redis-сессии, идемпотентность сообщений, приватный MinIO, две API-реплики за Nginx, собственные тесты и скрипты эксплуатации lab4. Перенесена и незакоммиченная правка MinIO bootstrap из исходного рабочего дерева. Исходный lab4 не изменён.

Имена Compose-проектов, образы и порты отделены от lab4. Рабочие настройки — .env.example; там же указаны будущие параметры очереди, пока не используемые. Compose получает настройки environment из .env, включая пути S3, PostgreSQL и MinIO к файлам секретов; секретные значения остаются в secrets/. Пути *_FILE в Compose также задают точки монтирования соответствующих secrets; MinIO bootstrap читает эти пути из окружения. Публичные tests/, contracts/, lab.json и README.md lab5 сохранены.

Будущая архитектура: API → durable staging + PostgreSQL job/outbox → publisher → broker → worker → конечный MinIO + атомарная фиксация metadata в PostgreSQL. Текущая реализация продолжает синхронно сохранять оригинал и возвращает 201 ready. Заготовки lab5 не подключены и вызывают NotImplementedError. Реализация транзакционных границ и восстановления после отказов ещё предстоит.

Доказательства критериев

Критерий README Будущая команда/сценарий Текущий результат Доказательство
Публичный smoke lab5 make test Не запускался; 202/thumbnail ещё не реализованы Нет
3: сохранён минимум lab4 Собственные тесты, persistence/failover Перенесён, повторно не проверен Не подтверждает lab5
3: durable приём и broker/worker Worker stop → upload → restart → ready Не реализовано Нет
3: состояния, original/thumbnail, retry, дубли Smoke + собственные сценарии Не реализовано Нет
4: crop/optimized, resource limits Собственные проверки изображений/лимитов Не реализовано Нет
4: outbox и восстановление COMMIT/publish Fault injection Не реализовано Нет
4: backoff/jitter, failed/replay Сбой до исчерпания и явный replay Не реализовано Нет
4: crash до ack, lease, concurrency, cleanup Fault injection и lifecycle Не реализовано Нет
5: законченный исследовательский трек Методика после выбора трека Трек не выбран Нет

Эксперименты и отказы

Пока не проводились. После выбора трека описать гипотезу, hardware/лимиты, версии, размеры/число файлов, профиль нагрузки, concurrency/prefetch, длительность, прогрев и повторы. Сохранить raw summary без секретов, queue lag, время до ready, RSS и другие метрики выбранного трека.

Ограничения и следующие шаги

Сейчас это база для дальнейшей реализации, не завершённая lab5. Очереди и асинхронной обработки нет; прежние результаты lab4 к этому дереву не относятся. Сначала просмотр пользователем и выбор трека/брокера, затем реализация; тестовый прогон и новые evidence — по отдельному указанию после реализации.