// the find
shortlink-org/shortlink
Shortlink service (Microservice example) ⭐️ Star the repo if you like it!
A URL shortener built as a microservices architecture showcase — the actual shortlink functionality is almost beside the point. It exists to demonstrate DDD, event sourcing, CQRS, GitOps, and a full Kubernetes operational stack in one repo. Target audience is engineers who want to study how these patterns fit together in a real (if contrived) codebase, not teams who need a shortlink service.
The ADR documentation is genuinely good — each service boundary has its own decision log explaining why choices were made, not just what they are. The CI/CD setup is thorough: separate GitHub and GitLab pipelines, Helm chart testing, CodeQL, FOSSA license scanning, ClusterFuzzLite, and Renovate for deps. Wire is used for dependency injection, which keeps the DI graph explicit and testable rather than buried in framework magic. The boundary/domain separation is coherent — link management, auth, billing, OMS, and referral are distinct modules with their own go.mod files, not one giant monolith pretending to be microservices.
769 stars for this level of complexity suggests it never gained real adoption, which means the ops patterns haven't been battle-tested under actual load. The directory tree has `.gitlab` and `.github` CI configs that appear to duplicate each other — maintaining two pipeline systems for one hobby project is a maintenance trap. Several services (billing, wallet, referral) appear to exist as stubs to illustrate the pattern rather than working implementations, so if you're trying to learn from production-quality code you'll hit dead ends. The README buries the actual architecture explanation behind badge soup and FOSSA notices — there's no quick diagram showing how the 15+ services actually talk to each other.