all for 4

This commit is contained in:
2026-11-11 23:05:16 +03:00
parent 1ec85a2402
commit a2e143caea
26 changed files with 5103 additions and 281 deletions
@@ -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;