feat(domain,db): lab5 add outbox entry, transaction contract and 0006 migration

This commit is contained in:
Голиков Maximillian Антон
2026-11-06 22:43:56 +03:00
parent 18afe2563e
commit 7f0fb2b0da
4 changed files with 82 additions and 0 deletions
+28
View File
@@ -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
}
+4
View File
@@ -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
}
+18
View File
@@ -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
}
+32
View File
@@ -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