-- Расширение метаданных вложения для асинхронной обработки. ALTER TABLE attachments DROP CONSTRAINT chk_attachment_status; ALTER TABLE attachments ADD CONSTRAINT chk_attachment_status CHECK ( status IN ( 'queued', 'processing', 'ready', 'failed' ) ); ALTER TABLE attachments ADD COLUMN staging_key TEXT, ADD COLUMN pipeline_version INTEGER NOT NULL DEFAULT 1, ADD COLUMN error_code VARCHAR(64); ALTER TABLE attachments ADD CONSTRAINT uq_attachment_staging_key UNIQUE (staging_key), ADD CONSTRAINT chk_attachment_pipeline_version CHECK (pipeline_version >= 1), ADD CONSTRAINT chk_attachment_error CHECK ( ( status = 'failed' AND error_code IS NOT NULL AND length(error_code) > 0 ) OR ( status <> 'failed' AND error_code IS NULL ) ); CREATE INDEX idx_attachments_status ON attachments(status, updated_at); -- Готовые варианты изображения. -- object_key используется внутри приложения и не выдаётся клиенту. -- Ключ эффекта соответствует контракту: -- attachment_id + pipeline_version + variant. CREATE TABLE attachment_variants ( attachment_id UUID NOT NULL REFERENCES attachments(id) ON DELETE CASCADE, pipeline_version INTEGER NOT NULL, name VARCHAR(32) NOT NULL, object_key TEXT NOT NULL UNIQUE, content_type VARCHAR(32) NOT NULL, size_bytes BIGINT NOT NULL, width INTEGER NOT NULL, height INTEGER NOT NULL, sha256 CHAR(64) NOT NULL, created_at TIMESTAMPTZ NOT NULL DEFAULT now(), PRIMARY KEY ( attachment_id, pipeline_version, name ), CONSTRAINT chk_variant_pipeline_version CHECK (pipeline_version >= 1), CONSTRAINT chk_variant_name CHECK ( name IN ( 'thumbnail', 'crop', 'optimized' ) ), CONSTRAINT chk_variant_content_type CHECK ( content_type IN ( 'image/jpeg', 'image/png', 'image/webp' ) ), CONSTRAINT chk_variant_size CHECK (size_bytes > 0), CONSTRAINT chk_variant_dimensions CHECK (width > 0 AND height > 0), CONSTRAINT chk_variant_sha256 CHECK (sha256 ~ '^[a-f0-9]{64}$') ); -- Одна логическая работа над вложением в рамках версии pipeline. -- job_id не меняется при повторной доставке. -- attempts увеличивается при начале управляемой попытки, -- а не при каждом получении дубликата сообщения. CREATE TABLE attachment_jobs ( id UUID PRIMARY KEY, attachment_id UUID NOT NULL REFERENCES attachments(id) ON DELETE CASCADE, pipeline_version INTEGER NOT NULL DEFAULT 1, status VARCHAR(16) NOT NULL DEFAULT 'queued', attempts INTEGER NOT NULL DEFAULT 0, max_attempts INTEGER NOT NULL DEFAULT 3, available_at TIMESTAMPTZ NOT NULL DEFAULT now(), lease_owner UUID, lease_until TIMESTAMPTZ, last_error_code VARCHAR(64), created_at TIMESTAMPTZ NOT NULL DEFAULT now(), updated_at TIMESTAMPTZ NOT NULL DEFAULT now(), CONSTRAINT uq_attachment_job_pipeline UNIQUE ( attachment_id, pipeline_version ), CONSTRAINT chk_job_pipeline_version CHECK (pipeline_version >= 1), CONSTRAINT chk_job_status CHECK ( status IN ( 'queued', 'processing', 'ready', 'failed' ) ), CONSTRAINT chk_job_attempts CHECK ( max_attempts >= 1 AND attempts >= 0 AND attempts <= max_attempts ), CONSTRAINT chk_job_lease CHECK ( ( status = 'processing' AND lease_owner IS NOT NULL AND lease_until IS NOT NULL ) OR ( status <> 'processing' AND lease_owner IS NULL AND lease_until IS NULL ) ) ); CREATE INDEX idx_attachment_jobs_available ON attachment_jobs(available_at, id) WHERE status = 'queued'; CREATE INDEX idx_attachment_jobs_expired_lease ON attachment_jobs(lease_until, id) WHERE status = 'processing'; -- Намерение публикации задания в брокер. -- Записывается в той же транзакции, что и метаданные задания. -- published_at устанавливается после подтверждения брокера. -- Потеря подтверждения может привести к повторной публикации: -- worker обязан обрабатывать её идемпотентно. CREATE TABLE attachment_outbox ( id UUID PRIMARY KEY, job_id UUID NOT NULL REFERENCES attachment_jobs(id) ON DELETE CASCADE, attempt INTEGER NOT NULL, created_at TIMESTAMPTZ NOT NULL DEFAULT now(), next_publish_at TIMESTAMPTZ NOT NULL DEFAULT now(), published_at TIMESTAMPTZ, publish_attempts INTEGER NOT NULL DEFAULT 0, last_error_code VARCHAR(64), CONSTRAINT uq_attachment_outbox_attempt UNIQUE (job_id, attempt), CONSTRAINT chk_outbox_attempt CHECK (attempt >= 1), CONSTRAINT chk_outbox_publish_attempts CHECK (publish_attempts >= 0) ); CREATE INDEX idx_attachment_outbox_pending ON attachment_outbox(next_publish_at, id) WHERE published_at IS NULL;