Skip to content

v1.0.0 — First stable release

Latest
Latest

Choose a tag to compare

View all tags
@github-actions github-actions released this 14 Jul 12:45
· 10 commits to main since this release
v1.0.0
b7fa9c2
This commit was created on GitHub.com and signed with GitHub’s verified signature.
GPG key ID: B5690EEEBB952194
Verified
Learn about vigilant mode.

First tagged release of the go-ddd template.

Highlights

  • Domain layer: aggregates with factory methods, Money value object (integer cents + ISO currency — no floats for money), validated-entity pattern, domain events
  • Race-safe idempotency: atomic key reservation via INSERT ... ON CONFLICT DO NOTHING, cached replay, payload-mismatch rejection (422), crash-TTL takeover
  • Transactional outbox: domain events persisted in the same transaction as the aggregate, polling relay with at-least-once delivery
  • CQRS foundation: explicit command/query flows with per-use-case DTOs
  • Modern stack: Go 1.26, Echo v4, pgx/v5 + sqlc, golang-migrate, testcontainers integration tests
  • Ops-ready: /healthz + /readyz probes, OpenAPI spec, structured slog logging, graceful shutdown, distroless Docker image, one-command make docker-up

Container image

docker pull ghcr.io/sklinkert/go-ddd:v1.0.0

See the README for a 30-second API walkthrough and DDD_CQRS_PRINCIPLES.md for the full pattern guide.

Assets 2
Loading