thangchung/go-coffeeshop

☕ A practical event-driven microservices demo built with Golang. Nomad, Consul Connect, Vault, and Terraform for deployment

4,354

64 commits

updated May 10, 2023

See the code

README

go-coffeeshop

An event-driven microservices coffee shop application has been written in Golang and deployed using Nomad, Consul Connect, Vault, and Terraform.

Other versions in .NET/C# can be found at:

Technical stack

Backend building blocks
- grpc-ecosystem/grpc-gateway/v2
- labstack/echo/v4
- rabbitmq/amqp091-go
- kyleconroy/sqlc
  - pq
- golang-migrate/migrate/v4
- Utils
  - google/wire
  - ilyakaznacheev/cleanenv
  - golang.org/x/exp/slog
    - sirupsen/logrus
  - samber/lo
  - automaxprocs/maxprocs
  - stretchr/testify
  - golang/glog
  - google/uuid
  - google.golang.org/genproto
  - google.golang.org/grpc
  - google.golang.org/protobuf
Infrastructure
- Postgres, RabbitMQ
- Hashicorp Nomad, Consul (Connect), Vault, Terraform
- docker and docker-compose
- devcontainer for reproducible development environment

CoffeeShop - Choreography Saga

coffeeshop

Services

No.	Service	URI
1	grpc-gateway	http://localhost:5000
2	product service	http://localhost:5001
3	counter service	http://localhost:5002
4	barista service	worker only
5	kitchen service	worker only
6	web	http://localhost:8888

Starting project

Jump into .devcontainer, then

> make docker-compose

From vscode => Press F1 => Type Simple Browser View => Choose it and enter http://localhost:8888. Enjoy!!!

Screenshots

Home screen

home_screen

Payment screen

payment_screen

Order list screen

order_list_screen

HashiCorp stack deployment

coffeeshop_hashicorp

The details of how to run it can be find at deployment with Nomad, Consult Connect and Vault.

Development

Clean Domain-driven Design

clean_ddd

Generate dependency injection instances with wire

> make wire

Generate code with sqlc

> make sqlc

Debug Apps

Debug golang app in monorepo

Trouble shooting

Development project trouble shooting

Roadmap

✅ Enhance project structure with DDD patterns
Add testing
Add and integrate with observability libs and tools
Add user identity management (authentication and authorization)
Add resiliency

Credits

alpinejs

clean-architecture

consul-connect

ddd

dependency-injection

echo-framework

event-driven-architecture

event-driven-microservices

golang

grpc-gateway

microservices

nomad

postgresql

rabbitmq

sqlc

terraform

vertical-slice-architecture

wire

Project health

Go module

github.com/thangchung/go-coffeeshop

Latest release

v0.1.0 · Nov 30, 2022

Releases this year

Significant stargazers

Ulises Gascón

1,799 followers · starred Dec 2022

Milan Nikolic

430 followers · starred Nov 2022

Eddie Zaneski

636 followers · starred Feb 2024

AJ Schmidt

80 followers · starred Dec 2022

Similar repos

mehdihadeli/go-food-delivery-microservices

🍕 A practical food delivery microservices, built with Golang, Domain-Driven Design, CQRS, Event…

1,135

MarioCarrion/todo-api-microservice-example

Go microservice tutorial project using Domain Driven Design and Onion Architecture!

1,345

vietnam-devs/coolstore-microservices

A full-stack .NET microservices build on Dapr and Tye

2,532

microservices-patterns/ftgo-application

Example code for the book Microservice patterns

3,776

Mikaelemmmm/go-zero-looklook

🔥基于go-zero(go zero) 微服务全技术栈开发最佳实践项目。Develop best practice projects based on the full technology…

5,209

evrone/go-clean-template

Clean Architecture template for Golang services

7,695

ThreeDotsLabs/wild-workouts-go-ddd-example

Go DDD example application. Complete project to show how to apply DDD, Clean Architecture, and CQRS…

6,474

meysamhadeli/booking-microservices

A practical microservices with the latest technologies and architectures like Vertical Slice…

1,407