Автор / группа: Максимова Снежана Игоревна / БПИ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
В 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 содержит инструкцию именно моего решения.
Blocking a user prevents them from interacting with repositories, such as opening or commenting on pull requests or issues. Learn more about blocking a user.
Лабораторная 5
Автор / группа: Максимова Снежана Игоревна / БПИ2302
Целевая оценка (3/4/5): 4
Трек 5, если заявлен: не заявлен
Что реализовано и что перенесено
Реализовано:
202 Accepted, статусqueued. Тяжелая обработка вынесена в отдельный контейнерworker.outbox. Запись задачи происходит в одной транзакции с вложением (вmain.py), что защищает от потери задач при падении брокера.thumbnail(JPEG 256x256),crop(JPEG 128x128) иoptimized(WebP до 1280x1280).queue.pyнастроен Dead Letter Exchange. Если воркер падает или превышает таймаут в 30 секунд, задача отправляется в DLQ (basic_nack(requeue=False)), не блокируя очередь.status == "ready"в воркере).compose.yamlзаданы лимиты CPU/RAM для API и Worker.Перенесено из предыдущей работы (lab4):
Команды запуска из чистого clone
Результаты проверок и ссылка на REPORT.md
python tests/smoke.py— PASS (тест проверяет загрузку, ожидание фоновой обработки, генерацию всех 3 вариантов).pytest student-tests/test_attachments.py -v— PASS (4 passed).localhost:15672) видно, как задачи поступают в очередь и забираются воркером.app/main.py,app/worker.pyиapp/queue.py.Ограничения / известные ошибки
await request.body()) перед отправкой в S3. Это допустимо для лимита в 10 МБ, но не масштабируется для больших файлов.Источники и использование ИИ
FastAPI, SQLAlchemy, pika, Pillow, RabbitMQ, MinIO, Nginx. ИИ использовался для генерации черновиков кода и конфигураций, финальная отладка (включая настройку DLQ и Outbox) проводилась вручную.
View command line instructions
Checkout
From your project repository, check out a new branch and test the changes.