From 7f0fb2b0da50002e297cf5b8b333cd8dbbf5fa4d Mon Sep 17 00:00:00 2001 From: =?UTF-8?q?=D0=93=D0=BE=D0=BB=D0=B8=D0=BA=D0=BE=D0=B2=20Maximillian?= =?UTF-8?q?=20=D0=90=D0=BD=D1=82=D0=BE=D0=BD?= Date: Fri, 6 Nov 2026 22:43:56 +0300 Subject: [PATCH] feat(domain,db): lab5 add outbox entry, transaction contract and 0006 migration --- backend/internal/domain/outbox.go | 28 +++++++++++++++++++++++ backend/internal/domain/repository.go | 4 ++++ backend/internal/domain/tx.go | 18 +++++++++++++++ backend/migrations/0006_outbox.sql | 32 +++++++++++++++++++++++++++ 4 files changed, 82 insertions(+) create mode 100644 backend/internal/domain/outbox.go create mode 100644 backend/internal/domain/tx.go create mode 100644 backend/migrations/0006_outbox.sql diff --git a/backend/internal/domain/outbox.go b/backend/internal/domain/outbox.go new file mode 100644 index 00000000..ecaa511b --- /dev/null +++ b/backend/internal/domain/outbox.go @@ -0,0 +1,28 @@ +package domain + +import "time" + +const ( + OutboxAggregateAttachment = "attachment" + OutboxEventProcess = "attachment.process" +) + +// OutboxEntry — намерение опубликовать сообщение, записанное +// в одной транзакции с бизнес-изменением (transactional outbox). +// +// Инварианты: +// - PublishedAt == nil => ещё не опубликовано, publisher обязан дослать; +// - PublishedAt != nil => RabbitMQ принял сообщение, +// а не «мы вызвали Publish». At-least-once: повторная доставка +// возможна и нормальна, гасится идемпотентностью consumer'а. +// +type OutboxEntry struct { + ID string + AggregateType string + AggregateID string + EventType string + Payload []byte + CreatedAt time.Time + PublishedAt *time.Time + Attempts int +} diff --git a/backend/internal/domain/repository.go b/backend/internal/domain/repository.go index b5d6a619..bfa312b9 100644 --- a/backend/internal/domain/repository.go +++ b/backend/internal/domain/repository.go @@ -45,3 +45,7 @@ type AttachmentRepository interface { ExistingKeys(ctx context.Context, keys []string) ([]string, error) DeletePending(ctx context.Context, id string) error } + +type OutboxRepository interface { + Enqueue(ctx context.Context, tx Tx, e *OutboxEntry) error +} diff --git a/backend/internal/domain/tx.go b/backend/internal/domain/tx.go new file mode 100644 index 00000000..e60809d9 --- /dev/null +++ b/backend/internal/domain/tx.go @@ -0,0 +1,18 @@ +package domain + +import "context" + +// Tx — минимальная абстракция транзакции, нужная domain-слою. +// Реализуется адаптером над pgx.Tx в storage/postgres, поэтому +// domain не зависит от драйвера БД. +// +// Зачем: transactional outbox требует, чтобы бизнес-изменение +// (например, INSERT attachments) и INSERT outbox шли в одной +// транзакции. Без передачи транзакции в репозиторий эту гарантию +// не выразить. +// +// Метод один — Exec. Расширять по мере появления реальных +// потребителей, а не на будущее. +type Tx interface { + Exec(ctx context.Context, sql string, args ...any) error +} diff --git a/backend/migrations/0006_outbox.sql b/backend/migrations/0006_outbox.sql new file mode 100644 index 00000000..80a0f1b7 --- /dev/null +++ b/backend/migrations/0006_outbox.sql @@ -0,0 +1,32 @@ +-- +goose Up +-- +goose StatementBegin + +CREATE TABLE outbox ( + id UUID PRIMARY KEY, + aggregate_type TEXT NOT NULL, + aggregate_id UUID NOT NULL, + event_type TEXT NOT NULL, + payload JSONB NOT NULL, + attempts INT NOT NULL DEFAULT 0, + created_at TIMESTAMPTZ NOT NULL DEFAULT now(), + published_at TIMESTAMPTZ, + + CONSTRAINT outbox_aggregate_type_len + CHECK (char_length(aggregate_type) BETWEEN 1 AND 64), + CONSTRAINT outbox_event_type_len + CHECK (char_length(event_type) BETWEEN 1 AND 64), + CONSTRAINT outbox_attempts_nonneg + CHECK (attempts >= 0) +); + +CREATE INDEX outbox_pending_idx + ON outbox (created_at) + WHERE published_at IS NULL; + +-- +goose StatementEnd + + +-- +goose Down +-- +goose StatementBegin +DROP TABLE IF EXISTS outbox; +-- +goose StatementEnd \ No newline at end of file