Vertical Slice Architecture

This repository showcases how to build a Vertical Slice API that supports multiple SQL dialects using huma and sqlt.

// Run as local In-memory sqlite app and fill with fake data
go run ./cmd/sqlite/main.go
// open: http://localhost:8080/docs


// Or run as postgres app with docker
docker run --name postgres -e POSTGRES_USER=user -e POSTGRES_PASSWORD=password -e POSTGRES_DB=db -p 5432:5432 -d postgres:16
go run ./cmd/postgres/main.go
// open: http://localhost:8080/docs

// stop and remove container:
docker stop postgres && docker rm postgres

// create new fake data
go run ./cmd/fake-data/main.go

What is Vertical Slice Architecture?

• https://www.jimmybogard.com/vertical-slice-architecture/
• https://www.milanjovanovic.tech/blog/vertical-slice-architecture

Minimize coupling between slices, and maximize coupling in a slice. (Jimmy Bogard)

The Slices

In the alternative slice, the list of books is directly converted into a JSON array in the database. In the regular version, two queries are executed to obtain the total number of books available before pagination.

• Query Books Standard: app/get_books_standard.go
• Query Books Standard Alternative: app/get_books_standard_alternative.go
• Query Books sqlt: app/get_books_sqlt.go
• Query Books sqlt Alternative: app/get_books_sqlt_alternative.go
• Insert Book with sqlt: app/post_books_sqlt.go

Highlights

• Huma is a great framework for OpenAPI generation and validation that works with any web framework.
• Without a repository layer, each query is designed perfectly for its specific use case, avoiding poor reuse.
• The SQL templates are a flexible and powerful tool that let you focus on business logic.

Benchmarks

go test -bench . -benchmem ./... -benchtime=10s
goos: darwin
goarch: arm64
pkg: github.com/wroge/vertical-slice-architecture/app
cpu: Apple M3 Pro
BenchmarkGetBooksStandard100-12                     2310           4927665 ns/op          714800 B/op       6945 allocs/op
BenchmarkGetBooksStandardAlternative100-12          2695           4477207 ns/op          653990 B/op       3364 allocs/op
BenchmarkGetBooksSqlt100-12                         2388           4996416 ns/op          626265 B/op       4694 allocs/op
BenchmarkGetBooksSqltAlternative100-12              2684           4440727 ns/op          634598 B/op       3015 allocs/op
BenchmarkGetBooksStandard10-12                      3061           3915790 ns/op          103804 B/op       1386 allocs/op
BenchmarkGetBooksStandardAlternative10-12           3579           3342710 ns/op           98844 B/op        865 allocs/op
BenchmarkGetBooksSqlt10-12                          3012           3953652 ns/op           79300 B/op        750 allocs/op
BenchmarkGetBooksSqltAlternative10-12               3549           3338057 ns/op           76204 B/op        514 allocs/op
PASS
ok      github.com/wroge/vertical-slice-architecture/app        98.714s

Feedback

Take a look at the code and give me feedback. Thanks :)