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


Keywords
clean-architecture, cqrs, ddd, firebase, firestore, gcp, go, golang, google-cloud, hexagonal-architecture, refactoring, serverless, terraform
License
MIT
Install
go get github.com/ThreeDotsLabs/wild-workouts-go-ddd-example/internal/common

Documentation

Wild Workouts

Wild Workouts is an example project that we created to show how to build Go applications that are easy to develop, maintain, and fun to work with, especially in the long term!

No application is perfect from the beginning. With over a dozen coming articles, we will uncover what issues you can find in the current implementation. We will also show how to fix these issues and achieve clean implementation by refactoring.

Articles

  1. Too modern Go application? Building a serverless application with Google Cloud Run and Firebase
  2. A complete Terraform setup of a serverless application on Google Cloud Run and Firebase
  3. Robust gRPC communication on Google Cloud Run (but not only!)
  4. You should not build your own authentication. Let Firebase do it for you.
  5. More articles are on the way!

Directories

  • api OpenAPI and gRPC definitions
  • docker Dockerfiles
  • internal application code
  • scripts deployment and development scripts
  • terraform - infrastructure defintion
  • web - frontend JavaScript code

Live Demo

The example application is available at https://threedotslabs-wildworkouts.web.app/.

Running locally

> docker-compose up

# ...

web_1             |  INFO  Starting development server...
web_1             |  DONE  Compiled successfully in 6315ms11:18:26 AM
web_1             |
web_1             |
web_1             |   App running at:
web_1             |   - Local:   http://localhost:8080/
web_1             |
web_1             |   It seems you are running Vue CLI inside a container.
web_1             |   Access the dev server via http://localhost:<your container's external mapped port>/
web_1             |
web_1             |   Note that the development build is not optimized.
web_1             |   To create a production build, run yarn build.

Google Cloud Deployment

> cd terraform/
> make

Fill all required parameters:
	project [current: wild-workouts project]:       # <----- put your Wild Workouts Google Cloud project name here (it will be created) 
	user [current: email@gmail.com]:                # <----- put your Google (Gmail, G-suite etc.) e-mail here
	billing_account [current: My billing account]:  # <----- your billing account name, can be found here https://console.cloud.google.com/billing
	region [current: europe-west1]: 
	firebase_location [current: europe-west]: 

# it may take a couple of minutes...

The setup is almost done!

Now you need to enable Email/Password provider in the Firebase console.
To do this, visit https://console.firebase.google.com/u/0/project/[your-project]/authentication/providers

You can also downgrade the subscription plan to Spark (it's set to Blaze by default).
The Spark plan is completely free and has all features needed for running this project.

Congratulations! Your project should be available at: https://[your-project].web.app

If it's not, check if the build finished successfully: https://console.cloud.google.com/cloud-build/builds?project=[your-project]

If you need help, feel free to contact us at https://threedots.tech

Screenshots

Wild Workouts login Wild Workouts trainer's schedule Wild Workouts schedule training