forked from mtusi2026/mtusi2026lab5
docs(lab5): fill pull request template
This commit is contained in:
@@ -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 содержит инструкцию именно моего решения.
|
||||
|
||||
Reference in New Issue
Block a user