diff --git a/.github/pull_request_template.md b/.github/pull_request_template.md index 7d1ff4a4..332e8a6a 100644 --- a/.github/pull_request_template.md +++ b/.github/pull_request_template.md @@ -1,18 +1,67 @@ ## Лабораторная 5 Автор / группа: TODO -Целевая оценка (3/4/5): TODO -Трек 5, если заявлен: TODO +Целевая оценка (3/4/5): 5 +Трек 5, если заявлен: трек 1 — «Очередь под перегрузкой» -Что реализовано и что перенесено: TODO -Команды запуска из чистого clone: TODO -Результаты проверок и ссылка на REPORT.md: TODO -Ограничения / известные ошибки: TODO -Источники и использование ИИ: TODO +Что реализовано и что перенесено: +Реализован durable-асинхронный pipeline: upload пишет байты в S3 staging и в +одной транзакции создаёт `attachments(queued)` + `attachment_jobs` (outbox); +publisher подтверждает доставку в RabbitMQ quorum queue, отдельный worker +перечитывает метаданные из PostgreSQL, под DB-lease проверяет staging, пишет +оригинал и три варианта (`thumbnail`, `crop`, `optimized`), затем атомарно +фиксирует `ready` и только после этого делает ack. Добавлены retry с +экспоненциальным backoff и jitter, различение постоянных/временных ошибок, +replay, lease recovery, reconciler для брошенного staging и admission cap с +`503`/`Retry-After`. Параметры вариантов вынесены в +`app/internal/config/config.go`. Обязательный минимум предыдущих работ сохранён; +устаревшие файлы `*.lab3`/`*.lab4` удалены, публичный контракт и тесты не +ослаблены. Для трека 1 добавлен сценарий `exactly_right` (1280×1280) и +измерение compression overhead отдельно от decode/scaling. -- [ ] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. -- [ ] Контракт и публичные тесты не ослаблены. -- [ ] make check и make test выполнены; приложен реальный вывод. -- [ ] Сценарии отказов/безопасности своего уровня воспроизведены. -- [ ] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. -- [ ] README задания сохранён, REPORT.md содержит инструкцию именно моего решения. +Команды запуска из чистого clone: +```sh +cp .env.example .env +# заполнить POSTGRES_PASSWORD, S3_ROOT_ACCESS_KEY, S3_ROOT_SECRET_KEY, +# S3_SECRET_ACCESS_KEY, RABBITMQ_PASSWORD; S3_ACCESS_KEY_ID == S3_APP_USER +docker compose --env-file .env up -d --build +curl -fsS http://localhost:8080/health/ready +make check +make test BASE_URL=http://localhost:8080 +make track1 BASE_URL=http://localhost:8080 # эксперимент трека 1 +``` + +Результаты проверок и ссылка на REPORT.md: +`make check` — PASS (offline structure, local refs, Python syntax); `make test` — +`PASS: lab5 public API scenario`; `go test ./...` в `app` — все пакеты зелёные. +Сценарии уровня 4 воспроизведены: broker outage/outbox, worker crash до и после +эффекта, retry, permanent failure + replay, lease recovery, перезапуск всех +контейнеров с сохранением volumes. Трек 1: 9 ячеек (3 профиля × 3 размера), +eager/small — 15.58 jobs/s против 6.84 у serial; `exactly_right`/`huge_few` — +~0.44–0.50 jobs/s, encode share 82–83% против 61–64%; backpressure — `503` + +`Retry-After: 5`, recovery 7.653 s. Подробности, таблица критериев и ограничения — +[REPORT.md](REPORT.md); сырые данные — `evidence/track1.json`, +`evidence/lab5-grade4.json`. + +Ограничения / известные ошибки: +Стенд учебный: один RabbitMQ, один PostgreSQL и один worker, поэтому проверяется +durability на volume, а не HA-кластер. `MAX_PENDING_JOBS` считается по каждой +API-реплике приблизительно, без общей транзакции с вставкой. Время recovery +включает запуск контейнера и healthcheck. PNG-фикстуры синтетические; один +прогон на ячейку, p95 по 12–18 заданиям чувствителен к выбросу. +`exactly_right` убирает scaling, но не уравнивает объём WebP-encode с +`huge_few`. + +Источники и использование ИИ: +RabbitMQ quorum queues и publisher confirms; `amqp091-go`, `gen2brain/webp`, +`golang.org/x/image/draw`, `golang.org/x/sync/semaphore`; стандартные +`image/png`, `image/jpeg`. ИИ: DeepSeek Flash V4.1 under OpenCode harness for +generating the solution and partial review. Все приведённые результаты получены +запуском команд на этом стенде. + +- [x] Весь обязательный минимум текущей и предыдущих работ сохранён с объявленными переходами. +- [x] Контракт и публичные тесты не ослаблены. +- [x] make check и make test выполнены; приложен реальный вывод. +- [x] Сценарии отказов/безопасности своего уровня воспроизведены. +- [x] Все секреты и приватные ключи находятся вне Git; отчёт не содержит tokens. +- [x] README задания сохранён, REPORT.md содержит инструкцию именно моего решения.