ЛР 5 - БВТ2301 - Никитин - на 5 #72

Closed
AndrewNikkk wants to merge 1 commits from AndrewNikkk/mtusi2026lab5:solution/nikitin-bvt2301 into main
First-time contributor

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

Автор / группа: Никитин Андрей Александрович, БВТ2301
Целевая оценка (3/4/5): 5
Трек 5, если заявлен: трек 2 — доказанная идемпотентность pipeline.

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

Из lab4 перенесены API мессенджера, репозитории, работа с PostgreSQL и S3.

Добавлена асинхронная обработка вложений:

  • API сохраняет оригинал в S3 staging и возвращает 202 Accepted.
  • Attachment, job и transactional outbox создаются в одной транзакции.
  • Фоновый публикатор отправляет задания в Redis Streams.
  • Отдельный worker формирует thumbnail JPEG, crop 128×128 и optimized WebP.
  • Реализованы retry с backoff и jitter, восстановление pending, реестр failed, операторский replay и очистка staging.
  • Ограничены размер файла, число пикселей, время обработки и память worker.

Для трека 2 реализованы версии pipeline v1/v2, раздельные S3-ключи и атомарная публикация результата. Устаревшая job не может перезаписать результат новой версии.

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

Для воспроизводимой проверки в изолированных Docker Compose стендах:

python3 -m venv .venv
.venv/bin/python -m pip install \
  -r requirements-dev.txt \
  -r student-tests/requirements.txt

make check validate PYTHON=.venv/bin/python

make test-async PYTHON=.venv/bin/python \
  TEST_ARGS="--output evidence/async-suite.json"

make test-track2 PYTHON=.venv/bin/python \
  TEST_ARGS="--no-build --repetitions 3 --output evidence/track2.json"

Нужны Docker Engine, Compose v2 и доступ к сети для первой сборки. Runner создаёт собственные credentials и volumes, затем удаляет тестовый стенд.

Запуск обычного стенда и создание локальных secrets описаны в REPORT.md.

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

  • make check validate — PASS.
  • Полная регрессия — 18/18 групп проверок, включая неизменённый публичный smoke.
  • Трек 2 — три успешных повтора: 48 вложений, 81 job, 24 падения worker и 9 возобновлений старого процесса после публикации v2.
  • Потерь принятых вложений, дублей логических результатов и перезаписей v2 старой версией не обнаружено.

Отчёт: REPORT.md.
Методика: infra/track2.md.
Фактические результаты: async-suite.json, track2.json.

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

Проверена заданная матрица отказов при сохранных volumes. Потеря хранилищ, HA и нагрузочные характеристики не исследовались.

Физические XADD/PUT могут повторяться; гарантия относится к одному логическому результату версии, а не к exactly-once доставке.

Исторические результаты версий сохраняются без автоматического retention. Известных ошибок в проверенных сценариях не выявлено.

Источники и использование ИИ

Использованы код lab4, контракты задания, minio-cpp, hiredis, libpqxx, libsodium, stb, libwebp и libexif. Pillow используется для независимой проверки изображений. Версии и ссылки приведены в REPORT.md.

Codex использовался для переноса кода, реализации pipeline, подготовки тестов, проведения проверок и оформления документации.

  • Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами.
  • Контракт и публичные тесты не ослаблены.
  • make check и make test выполнены; приложен реальный вывод.
  • Сценарии отказов/безопасности своего уровня воспроизведены.
  • Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens.
    Evidence обезличены; состав файлов коммита необходимо проверить перед push.
  • README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
## Лабораторная 5 Автор / группа: Никитин Андрей Александрович, БВТ2301 Целевая оценка (3/4/5): 5 Трек 5, если заявлен: трек 2 — доказанная идемпотентность pipeline. ### Что реализовано и что перенесено Из lab4 перенесены API мессенджера, репозитории, работа с PostgreSQL и S3. Добавлена асинхронная обработка вложений: - API сохраняет оригинал в S3 staging и возвращает `202 Accepted`. - Attachment, job и transactional outbox создаются в одной транзакции. - Фоновый публикатор отправляет задания в Redis Streams. - Отдельный worker формирует thumbnail JPEG, crop 128×128 и optimized WebP. - Реализованы retry с backoff и jitter, восстановление pending, реестр failed, операторский replay и очистка staging. - Ограничены размер файла, число пикселей, время обработки и память worker. Для трека 2 реализованы версии pipeline v1/v2, раздельные S3-ключи и атомарная публикация результата. Устаревшая job не может перезаписать результат новой версии. ### Команды запуска из чистого clone Для воспроизводимой проверки в изолированных Docker Compose стендах: ```sh python3 -m venv .venv .venv/bin/python -m pip install \ -r requirements-dev.txt \ -r student-tests/requirements.txt make check validate PYTHON=.venv/bin/python make test-async PYTHON=.venv/bin/python \ TEST_ARGS="--output evidence/async-suite.json" make test-track2 PYTHON=.venv/bin/python \ TEST_ARGS="--no-build --repetitions 3 --output evidence/track2.json" ``` Нужны Docker Engine, Compose v2 и доступ к сети для первой сборки. Runner создаёт собственные credentials и volumes, затем удаляет тестовый стенд. Запуск обычного стенда и создание локальных secrets описаны в [REPORT.md](REPORT.md). ### Результаты проверок и ссылка на REPORT.md - `make check validate` — PASS. - Полная регрессия — 18/18 групп проверок, включая неизменённый публичный smoke. - Трек 2 — три успешных повтора: 48 вложений, 81 job, 24 падения worker и 9 возобновлений старого процесса после публикации v2. - Потерь принятых вложений, дублей логических результатов и перезаписей v2 старой версией не обнаружено. Отчёт: [REPORT.md](REPORT.md). Методика: [infra/track2.md](infra/track2.md). Фактические результаты: [async-suite.json](evidence/async-suite.json), [track2.json](evidence/track2.json). ### Ограничения / известные ошибки Проверена заданная матрица отказов при сохранных volumes. Потеря хранилищ, HA и нагрузочные характеристики не исследовались. Физические XADD/PUT могут повторяться; гарантия относится к одному логическому результату версии, а не к exactly-once доставке. Исторические результаты версий сохраняются без автоматического retention. Известных ошибок в проверенных сценариях не выявлено. ### Источники и использование ИИ Использованы код lab4, контракты задания, minio-cpp, hiredis, libpqxx, libsodium, stb, libwebp и libexif. Pillow используется для независимой проверки изображений. Версии и ссылки приведены в REPORT.md. Codex использовался для переноса кода, реализации pipeline, подготовки тестов, проведения проверок и оформления документации. - [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. - [x] Контракт и публичные тесты не ослаблены. - [x] make check и make test выполнены; приложен реальный вывод. - [x] Сценарии отказов/безопасности своего уровня воспроизведены. - [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. Evidence обезличены; состав файлов коммита необходимо проверить перед push. - [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.
AndrewNikkk added 1 commit 2026-11-16 09:33:48 +03:00
Owner

Принято. Закрываю МР.

Принято. Закрываю МР.
veprickiy closed this pull request 2026-11-17 11:03:31 +03:00

Pull request closed

Please reopen this pull request to perform a merge.
Sign in to join this conversation.
No Reviewers
No labels
2 Participants
Notifications
Due Date
No due date set.
Dependencies

No dependencies set.

Reference: mtusi2026/mtusi2026lab5#72