all for 4
This commit is contained in:
@@ -0,0 +1,220 @@
|
||||
-- Расширение метаданных вложения для асинхронной обработки.
|
||||
|
||||
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;
|
||||
Reference in New Issue
Block a user