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
- golang-migrate/migrate/v4
- Utils
- google/wire
- ilyakaznacheev/cleanenv
- golang.org/x/exp/slog
- 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
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-composeFrom vscode => Press F1 => Type Simple Browser View => Choose it and enter http://localhost:8888.
Enjoy!!!
Screenshots
Home screen
Payment screen
Order list screen
HashiCorp stack deployment
The details of how to run it can be find at deployment with Nomad, Consult Connect and Vault.
Development
Clean Domain-driven Design
Generate dependency injection instances with wire
> make wireGenerate code with sqlc
> make sqlcDebug Apps
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