repository·master·Indexed 27 days ago
https://github.com/threedotslabs/wild-workouts-go-ddd-exampleAn example Go project demonstrating Domain-Driven Design (DDD) principles. It showcases how to build maintainable and scalable applications using Clean Architecture, CQRS, and the Repository pattern, specifically designed for a serverless environment using Google Cloud Run and Firebase.
The repository is organized into the following key directories:
api/: Contains OpenAPI and gRPC definitions.docker/: Contains Dockerfiles for containerization.internal/: Contains the core Go application code.scripts/: Contains deployment and development scripts.terraform/: Contains the infrastructure-as-code definitions.web/: Contains the frontend JavaScript (Vue) code.You can deploy the entire infrastructure using Terraform and Make. This process sets up Google Cloud Run and Firebase. During execution, you will be prompted to provide your Google Cloud project name, email, billing account, region, and Firebase location.
Post-deployment steps:
https://console.firebase.google.com/u/0/project/[your-project]/authentication/providers.cd terraform/
makeTo tear down the entire project and its resources, run the following command:
make destroyRe-creating the project: If you wish to recreate the project after a destruction, you must:
terraform.tfstate file.Follow these steps to initialize the project infrastructure:
Authorize gcloud CLI: Run the following commands to authenticate your local environment. Note that default application login is not recommended for production.
gcloud auth login
gcloud auth application-default loginRun Infrastructure Deployment: Execute make to start the Terraform process. When prompted to confirm applying changes, type yes.
makeNote on Regions: You will be prompted to pick a region for Cloud Run and Firebase. If you choose a region other than europe-west1, you must manually update the following files to match your selection:
./scripts/deploy.sh./web/firebase.jsonEnable Firebase Authentication: You must manually enable the Email/Password provider in the Firebase console as instructed by the make output:
a. Open the Firebase Console.
b. Select the Wild Workouts project.
c. Navigate to Authentication.
d. Select the Sign-in method tab.
e. Click on Email/Password, switch it to Enabled, and click Save.
gcloud auth login
gcloud auth application-default login
makeTo run the full application stack (including the web frontend and backend services) on your local machine, use docker-compose. Once started, the Vue-based web application will be available at http://localhost:8080/.
docker-compose upTo run or deploy this project, ensure you have the following software installed and running:
start.sh script serves as the entrypoint for the web frontend Docker container. When executed, it performs a fresh installation of dependencies using yarn install and then starts the development server using yarn serve.start.sh script is used as a Docker container entrypoint to execute the Go application. It navigates to the directory specified by the $SERVICE environment variable and runs the application using go run ..start.sh script located in the docker/firestore-emulator/ directory. This script runs the firebase emulators:start command to initialize the Firebase emulator suite.The project uses a docker-compose.yml file to orchestrate the full application stack, including the web frontend, various microservices (trainer, trainings, users), a Firestore emulator, and a MySQL database.
To run the stack, ensure you have a .env file in the root directory, as most services depend on it for configuration. The services are bound to 127.0.0.1 to prevent external exposure.
The web/vue.config.js file allows you to customize the Vue CLI build process. Currently, it is configured to enable the runtime compiler and disable dev-server progress reporting.
module.exports = {
runtimeCompiler: true,
devServer: {
progress: false
}
}