ЛР 5 — БПИ2302 — Максимова — на 4 #49

Open
kleprer wants to merge 15 commits from kleprer/mtusi2026lab5:solution/БПИ2302-Максимова into main
First-time contributor

Лабораторная 5

Автор / группа: Максимова Снежана Игоревна / БПИ2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен

Что реализовано и что перенесено
Реализовано:

  • Асинхронная обработка: API возвращает 202 Accepted, статус queued. Тяжелая обработка вынесена в отдельный контейнер worker.
  • Transactional Outbox: Для гарантированной отправки задач в RabbitMQ используется таблица outbox. Запись задачи происходит в одной транзакции с вложением (в main.py), что защищает от потери задач при падении брокера.
  • Генерация 3 вариантов (уровень 4): Worker создает thumbnail (JPEG 256x256), crop (JPEG 128x128) и optimized (WebP до 1280x1280).
  • DLQ и Timeout: В queue.py настроен Dead Letter Exchange. Если воркер падает или превышает таймаут в 30 секунд, задача отправляется в DLQ (basic_nack(requeue=False)), не блокируя очередь.
  • Идемпотентность: Повторная доставка задачи не создает дубликаты файлов (проверка status == "ready" в воркере).
  • Негативные тесты: Добавлены тесты на превышение размера (413), битые файлы (415), подмену MIME (415) и доступ к чужим вложениям (404).
  • Лимиты: В compose.yaml заданы лимиты CPU/RAM для API и Worker.

Перенесено из предыдущей работы (lab4):

  • Базовый API (FastAPI), Nginx, PostgreSQL, Redis, MinIO, аутентификация и миграции.

Команды запуска из чистого clone

git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab5.git
cd mtusi2026lab5
git checkout solution/БПИ2302-Максимова
python3 -c "import shutil; shutil.copy('.env.example', '.env')"  # на Windows используйте python
docker compose up -d --build --scale api=2

Результаты проверок и ссылка на REPORT.md

  • python tests/smoke.py — PASS (тест проверяет загрузку, ожидание фоновой обработки, генерацию всех 3 вариантов).
  • pytest student-tests/test_attachments.py -v — PASS (4 passed).
  • В Web UI RabbitMQ (localhost:15672) видно, как задачи поступают в очередь и забираются воркером.
  • Outbox и DLQ подтверждены кодом в app/main.py, app/worker.py и app/queue.py.
  • Ссылка на подробный анализ: REPORT.md

Ограничения / известные ошибки

  • Единый экземпляр RabbitMQ и MinIO: Используется один узел для брокера и хранилища (SPOF).
  • Синхронное чтение при загрузке: В API файл целиком считывается в память (await request.body()) перед отправкой в S3. Это допустимо для лимита в 10 МБ, но не масштабируется для больших файлов.

Источники и использование ИИ
FastAPI, SQLAlchemy, pika, Pillow, RabbitMQ, MinIO, Nginx. ИИ использовался для генерации черновиков кода и конфигураций, финальная отладка (включая настройку DLQ и Outbox) проводилась вручную.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены (Outbox, DLQ).
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 5 Автор / группа: Максимова Снежана Игоревна / БПИ2302 Целевая оценка (3/4/5): 4 Трек 5, если заявлен: не заявлен **Что реализовано и что перенесено** Реализовано: - **Асинхронная обработка:** API возвращает `202 Accepted`, статус `queued`. Тяжелая обработка вынесена в отдельный контейнер `worker`. - **Transactional Outbox:** Для гарантированной отправки задач в RabbitMQ используется таблица `outbox`. Запись задачи происходит в одной транзакции с вложением (в `main.py`), что защищает от потери задач при падении брокера. - **Генерация 3 вариантов (уровень 4):** Worker создает `thumbnail` (JPEG 256x256), `crop` (JPEG 128x128) и `optimized` (WebP до 1280x1280). - **DLQ и Timeout:** В `queue.py` настроен Dead Letter Exchange. Если воркер падает или превышает таймаут в 30 секунд, задача отправляется в DLQ (`basic_nack(requeue=False)`), не блокируя очередь. - **Идемпотентность:** Повторная доставка задачи не создает дубликаты файлов (проверка `status == "ready"` в воркере). - **Негативные тесты:** Добавлены тесты на превышение размера (413), битые файлы (415), подмену MIME (415) и доступ к чужим вложениям (404). - **Лимиты:** В `compose.yaml` заданы лимиты CPU/RAM для API и Worker. Перенесено из предыдущей работы (lab4): - Базовый API (FastAPI), Nginx, PostgreSQL, Redis, MinIO, аутентификация и миграции. **Команды запуска из чистого clone** ```sh git clone https://gitea.privcloud.tech/kleprer/mtusi2026lab5.git cd mtusi2026lab5 git checkout solution/БПИ2302-Максимова python3 -c "import shutil; shutil.copy('.env.example', '.env')" # на Windows используйте python docker compose up -d --build --scale api=2 ``` **Результаты проверок и ссылка на REPORT.md** - `python tests/smoke.py` — PASS (тест проверяет загрузку, ожидание фоновой обработки, генерацию всех 3 вариантов). - `pytest student-tests/test_attachments.py -v` — PASS (4 passed). - В Web UI RabbitMQ (`localhost:15672`) видно, как задачи поступают в очередь и забираются воркером. - Outbox и DLQ подтверждены кодом в `app/main.py`, `app/worker.py` и `app/queue.py`. - Ссылка на подробный анализ: REPORT.md **Ограничения / известные ошибки** - **Единый экземпляр RabbitMQ и MinIO:** Используется один узел для брокера и хранилища (SPOF). - **Синхронное чтение при загрузке:** В API файл целиком считывается в память (`await request.body()`) перед отправкой в S3. Это допустимо для лимита в 10 МБ, но не масштабируется для больших файлов. **Источники и использование ИИ** FastAPI, SQLAlchemy, pika, Pillow, RabbitMQ, MinIO, Nginx. ИИ использовался для генерации черновиков кода и конфигураций, финальная отладка (включая настройку DLQ и Outbox) проводилась вручную. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены (Outbox, DLQ). - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
kleprer added 12 commits 2026-11-11 21:52:57 +03:00
kleprer added 1 commit 2026-11-12 21:35:53 +03:00
kleprer added 1 commit 2026-11-12 21:36:28 +03:00
kleprer added 1 commit 2026-11-12 22:09:41 +03:00
You are not authorized to merge this pull request.
This pull request can be merged automatically.
View command line instructions

Checkout

From your project repository, check out a new branch and test the changes.
git fetch -u https://gitea.privcloud.tech/kleprer/mtusi2026lab5 solution/БПИ2302-Максимова:kleprer-solution/БПИ2302-Максимова
git checkout kleprer-solution/БПИ2302-Максимова
Sign in to join this conversation.
No Reviewers
No labels
1 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab5#49