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