A production-ready REST API for a vinyl record store built with zerohttp.

• RESTful API - Clean endpoints for users, records, orders, and inventory
• JWT Authentication - ECDSA-signed tokens with refresh support
• RBAC - Admin and user roles with middleware protection
• MongoDB & Redis - Document storage with caching and rate limiting
• Idempotency - Safe retry handling for POST requests
• Rate Limiting - Tiered limits (IP-based public, JWT-based auth)
• Observability - OpenTelemetry tracing, Prometheus metrics, pprof profiling
• Health Checks - Kubernetes-ready liveness, readiness, and startup probes

# Start dependencies
docker compose up -d

# Run the application
make run

# Create your first user
curl -X POST http://localhost:8080/users \
  -H "Content-Type: application/json" \
  -d '{"email":"user@example.com","name":"User","password":"securepassword123"}'

Configuration priority: CLI flags > env vars > config file > defaults. All env vars are prefixed with VINYL_.

# CLI flags
go run ./cmd/server --bind-addr 0.0.0.0:9090 --mongo-uri mongodb://mongo:27017

# Environment variables
export VINYL_BIND_ADDR=0.0.0.0:9090
export VINYL_MONGO_URI=mongodb://mongo:27017

# Config file (config.toml)
bind_addr = "0.0.0.0:9090"
mongo_uri = "mongodb://mongo:27017"

Three tiers by default:

# Unit tests
go test ./...

# Integration tests (requires Docker)
go test ./... -tags=integration

# Coverage
go test ./... -coverprofile=coverage.out
go tool cover -html=coverage.out

# Regenerate mocks
make generate

├── app/          # Application bootstrap and server setup
├── cmd/server/   # Application entry point
├── config/       # Configuration management with Viper
├── handlers/     # HTTP handlers using zerohttp
├── models/       # Domain models (User, Record, Order)
├── mocks/        # Generated mocks for testing
└── store/        # Data persistence layer (MongoDB interface)

Handlers use zerohttp's error-returning pattern:

func (h *Handler) GetRecord(w http.ResponseWriter, r *http.Request) error {
    id := r.PathValue("id")
    record, ok := h.store.GetRecord(r.Context(), id)
    if !ok {
        return zh.NotFoundError("record not found")
    }
    return zh.JSON(w, http.StatusOK, record)
}

MIT License - see LICENSE file.