Files
mtusi2026lab5/contracts/extensions.md
T

3.2 KiB
Raw Blame History

Расширения лабораторной 5

Обязательный контракт contracts/openapi.json не изменён. Ниже — операторский интерфейс и параметры pipeline, нужные для уровня 4 и трека 5. Эти маршруты не входят в публичный API и требуют заголовок X-Operator-Token.

Pipeline

Ключ эффекта: (attachment_id, pipeline_version, variant).

Версия Назначение JPEG thumbnail/crop WebP optimized
1 Основной курс quality 85, optimize, без progressive и без EXIF quality 80, method 6, lossy
2 Эксперимент идемпотентности quality 60 / 70 quality 50, method 4

Геометрия одинаковая: thumbnail вписывается в 256×256 без увеличения, crop — центр 128×128, optimized вписывается в 1280×1280 без увеличения. EXIF orientation применяется до кодирования, альфа-канал кладётся на белый. Метаданные исходника в варианты не копируются. Версия 2 нужна только чтобы отличить новый результат от старого по SHA-256.

Повторная доставка, смена порядка и устаревшая версия не создают второй набор объектов одной и той же версии и не заменяют уже опубликованный более новый ready_pipeline_version.

Операторские маршруты

  • POST /internal/control/outbox {"paused": true} — остановить публикацию outbox после COMMIT.
  • POST /internal/control/fault {"mode": "before_effect"|"after_s3"|"after_commit"|"duplicate"|"transient"|"permanent", "remaining": 1} — одноразовая инъекция. transient уменьшает remaining.
  • POST /internal/control/backpressure {"max_queued_jobs": 0} или null — вернуть лимит окружения.
  • GET /internal/metrics, GET /internal/attachments/{id}, GET /internal/failed.
  • POST /internal/attachments/{id}/replay — новая попытка того же job_id. Уже ready задание не исполняется повторно.
  • POST /internal/attachments/{id}/reprocess {"pipeline_version": 2} — новая версия pipeline.
  • POST /internal/jobs/{id}/redeliver — ещё одна доставка того же сообщения брокером.

Повторы

JOB_MAX_ATTEMPTS по умолчанию 5. Временная ошибка возвращает задание в queued с задержкой base * 2^(attempt-1), умноженной на случайный коэффициент 0.5–1.5, но не дольше JOB_BACKOFF_CAP_SECONDS. Постоянная ошибка и исчерпание попыток пишут failed_jobs и копию сообщения в DLQ. Коды: invalid_image, processing_failed, retry_exhausted.