Dunder Mifflin Inventory Service

📖 Overview

This repository is a sandbox project for experimenting with Domain-Driven Design (DDD) principles using a FastAPI application across multiple cloud platforms.

It comes with Terraform setups for GCP, AWS, and Azure, deployed through GitHub Actions pipelines.

It simulates managing paper product inventory, sales personnel, and sales transactions — inspired by Dunder Mifflin.

✨ Highlights

• Domain-Driven Design architecture with FastAPI
• Containerization with Docker
• ☁️ Multi-cloud deployment targets ☁️
  • Google Cloud Platform (GCP)
  • Amazon Web Services (AWS)
  • Microsoft Azure (Azure)
• Infrastructure as Code via Terraform
• Automated CI/CD using GitHub Actions (Terraform validation + deployment)

---

🚀 Getting Started

Prerequisites

Ensure the following tools are installed:

• Python
  • Python 3.12+
• Google Cloud Platform (GCP)
  • Google Cloud Account
  • gcloud CLI
• Amazon Web Services (AWS)
  • AWS Account
  • AWS CLI
• Microsft Azure (Azure)
  • Azure Account
  • Azure CLI
• Docker
  • Docker Desktop or CLI
• Terraform
  • Terraform CLI

---

Installation

# Clone repository
git clone git@github.com:mel-cdn/aws-gcp-azure-terraform-fastapi.git
cd aws-gcp-azure-terraform-fastapi

# Install Pipenv
pip install pipenv==2025.0.4

# Activate Pipenv environment
pipenv shell

# Install dependencies
./run-pip-updates.sh

# Run locally
./run-local-service.sh

Testing

# Run pytest with coverage
./run-unit-tests-with-coverage.sh

🌍 API Deployments

Infrastructure as Code (IaC)

• AWS via Terraform
• GCP via Terraform
• Azure via Terraform

FastAPI Endpoints

AWS Swagger URL

Heads up — this service might be unavailable because I paused it to save on costs (since App Runner doesn’t support 0-minimum instance scaling, haha! 🙂)

• App Runner: https://xzmd8mftmp.ap-southeast-1.awsapprunner.com/swagger
• Domain Mapped: https://api.dminventory.aws.melcadano.com/swagger

GCP Swagger URL

• Cloud Run: https://dm-inventory-api-6jqimisapa-de.a.run.app/swagger
• Domain Mapped: https://api.dminventory.gcp.melcadano.com/swagger

Azure Swagger URL

• Container App: https://playground-dm-inventory-prod-aca.proudwave-14ef48de.southeastasia.azurecontainerapps.io/swagger
• Domain Mapped: https://api-dminventory-azure.melcadano.com/swagger

Dashes, because Azure does not support multi-level sub-domain for binding_type = "SniEnabled" 🙂

🗺️ Roadmap / To-Do

Inventory Service

• Initial setup of FastAPI project
• Make PaperProduct a nested object of Product
• Add Salesman and Sales entities
• Integrate real database: S3 (AWS)
• Integrate real database: Cloud Storage (GCP)
• Integrate real database: Azure Storage (Azure)

Infrastructure (GCP)

• Terraform deployment with GCS backend
• Setup GitHub Actions deployment pipeline
• Automated deployment to prod environment
• Map service to a domain name
• Update GitHub Pipeline to use OIDC instead of Service Account Key

Infrastructure (AWS)

• Terraform deployment with S3 backend
• Setup GitHub Actions deployment pipeline
• Automated deployment to prod environment
• Map service to a domain name
• Update GitHub Pipeline to use OIDC instead AWS Keys

Infrastructure (Azure)

• Terraform deployment with backend
• Setup GitHub Actions deployment pipeline
• Automated deployment to prod environment
• Map service to a domain name