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>
5.4 KiB
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 у вложения варианты
crop128×128image/jpeg,optimized320×200image/webpиthumbnail256×160, каждый/content?variant=<имя>отдаёт настоящий файл этого формата длинойsize_bytesс SHA-256 из метаданных и реальными размерами из метаданных
Scenario: Большой и вытянутый исходник
- WHEN обработаны JPEG 4000×3000 и PNG 3000×2
- THEN
optimized1280×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