Files

10 lines
2.1 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# Асинхронная обработка вложений
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.