feat(domain,db): lab5 add outbox entry, transaction contract and 0006 migration
This commit is contained in:
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
}
|
||||
|
||||
@@ -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
|
||||
}
|
||||
@@ -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
|
||||
Reference in New Issue
Block a user