2.1 KiB
Асинхронная обработка вложений
API авторизует и проверяет изображение, сохраняет private staging и одной SQL-транзакцией публикует queued + durable job. Ответ содержит снимок queued независимо от скорости worker.
Отдельный worker публикует SQL outbox в Valkey Streams и принимает уведомления consumer group. SQL остаётся источником истины: незавершённые работы повторно уведомляются после ограниченного интервала. AOF брокера не заменяет outbox. Любая повторная доставка проверяет актуальный pipeline_version и lease.
Worker арендует задание на ограниченное время, читает доверенный staging key из SQL, создаёт оригинал/thumbnail/crop/WebP в prefix результата с версией и уникальным fencing token. SQL CAS публикует только результат текущей аренды. Устаревшая попытка не перезаписывает даже байты новой попытки. Неопубликованные объекты удаляются отдельной сверкой после grace period; staging сохраняется для replay/version upgrade.
Попытки ограничены пятью. Временная ошибка фиксирует next-attempt с exponential backoff и jitter; постоянная ошибка переводит в failed. Replay — отдельная операторская команда, которая не повторяет ready без явного повышения версии. Интерфейсы queue/store/processor принадлежат pipeline, инфраструктура связывается через Fx. Worker имеет владельца context и bounded shutdown.