Files
mtusi2026lab2/openspec/specs/lab5-image-variants/spec.md
T
ArtyomandClaude Opus 5.5 64d5c6746e Archive the crop, optimized, worker limits and job recovery change
The change add-lab5-variants-and-recovery is archived as
2026-10-29-add-lab5-variants-and-recovery with archived and lab: 5 in
.openspec.yaml. Specs are synced: lab5-image-variants and
lab5-job-recovery are created, lab5-attachment-pipeline (four
requirements) and lab4-attachments (metadata and download) are updated.
Level 4 is closed by make level4 (evidence/level4.json) and the rows
4.1-4.4 of REPORT.md.

Co-Authored-By: Claude Opus 5.5 (1M context) <noreply@anthropic.com>
2026-10-29 03:39:39 +03:00

5.4 KiB
Raw Blame History

lab5-image-variants Specification

Purpose

Определяет варианты crop и optimized уровня «4» по контракту и пределы, которыми worker ограничивает обработку недоверенного изображения: байты, пиксели по заголовку, время и память одного рендера.

Requirements

Requirement: Crop и optimized

Worker SHALL строить для каждого задания, кроме thumbnail, вариант crop — JPEG, центрированный квадрат 128×128 после применения EXIF orientation, с увеличением маленьких исходников, — и вариант optimized — WebP, вписанный в 1280×1280 с сохранением пропорций, без увеличения, размеры округлены вниз и не меньше 1 px. Альфа-канал во всех вариантах SHALL компоноваться на белый фон. Варианты SHALL NOT содержать EXIF, ICC и XMP; параметры кодирования SHALL быть документированы (crop — JPEG quality 85, optimized — WebP с потерями quality 80, method 4). Метаданные каждого варианта (content_type, size_bytes, width, height, sha256) SHALL совпадать с байтами, которые отдаёт /content?variant=<имя>.

Scenario: Fixture 320×200

  • WHEN обработана tests/fixtures/sample.png
  • THEN у вложения варианты crop 128×128 image/jpeg, optimized 320×200 image/webp и thumbnail 256×160, каждый /content?variant=<имя> отдаёт настоящий файл этого формата длиной size_bytes с SHA-256 из метаданных и реальными размерами из метаданных

Scenario: Большой и вытянутый исходник

  • WHEN обработаны JPEG 4000×3000 и PNG 3000×2
  • THEN optimized 1280×960 и 1280×1 соответственно, crop в обоих случаях 128×128

Scenario: Ориентация и прозрачность

  • WHEN обработаны JPEG 400×200 с EXIF orientation 6 и PNG RGBA с прозрачным фоном
  • THEN optimized первого 200×400, прозрачные области crop и optimized второго белые, ни в одном варианте нет EXIF

Requirement: Пределы обработки изображения в worker

Worker SHALL ограничивать обработку одного задания: размер оригинала — MAX_UPLOAD_BYTES, число пикселей по заголовку до декодирования — MAX_IMAGE_PIXELS, время рендера — RENDER_TIMEOUT_SECONDS, адресное пространство процесса рендера — RENDER_MEMORY_MB; рендер SHALL выполняться в отдельном процессе, число одновременных рендеров SHALL не превышать WORKER_CONCURRENCY, а процесс worker SHALL иметь предел памяти контейнера не меньше суммы пределов рендеров и собственной памяти. Превышение предела SHALL переводить вложение в failed с processing_failed без повторов; процесс, превысивший время, SHALL принудительно завершаться. Падение процесса рендера по внешней причине SHALL считаться временной ошибкой. Worker SHALL продолжать обрабатывать другие задания после любого из этих исходов.

Scenario: Рендер дольше предела

  • WHEN worker запущен с RENDER_TIMEOUT_SECONDS меньше времени рендера загруженного изображения
  • THEN вложение становится failed с processing_failed после первой попытки, процесс worker продолжает работать, следующая загрузка становится ready

Scenario: Рендер больше предела памяти

  • WHEN worker запущен с RENDER_MEMORY_MB меньше пика рендера изображения 40 Мпикс
  • THEN вложение становится failed с processing_failed, процесс worker продолжает работать

Scenario: Изображение на пределе пикселей

  • WHEN со штатными пределами загружен PNG 8000×5000
  • THEN вложение становится ready с тремя вариантами, пик памяти контейнера worker ниже его предела

Scenario: Пиксели сверх предела по заголовку

  • WHEN worker получает задание на оригинал, у которого по заголовку больше MAX_IMAGE_PIXELS пикселей
  • THEN изображение не декодируется, вложение становится failed с invalid_image