Architecture Overview
Architecture Overview — CM Marketplace Platform
This document provides a comprehensive architectural overview of the CM Marketplace platform. It is organized into focused sub-pages so that each concern — components, scaling, redundancy, fault tolerance, infrastructure, multi-region readiness, and dependencies — can be understood independently.
Quick Navigation
| Topic | Description |
|---|---|
| Technical Components | All microservices, shared libraries, adapters, and how they connect |
| Scaling Strategy | How each component scales horizontally and vertically |
| Geographic Redundancy | How components are made redundant across zones — see also Redundancy & High Availability |
| Fault Tolerance | Retry policies, dead-letter queues, graceful shutdown, circuit breakers |
| Infrastructure | GCP services, Terraform modules, networking, and secrets |
| Multi-Region Readiness | Current single-region architecture and path to multi-region |
| Service Dependencies | All internal CM.com and external third-party dependencies |
Platform at a Glance
- Cloud Provider: Google Cloud Platform (GCP)
- Region: europe-west4 (Netherlands)
- Infrastructure as Code: Terraform (modular)
- Runtime: .NET 10 on Cloud Run + GKE Autopilot
- Database: Cloud SQL PostgreSQL 14 (Regional HA)
- Cache: Memorystore Redis 1GB
- Messaging: Cloud Pub/Sub + Cloud Tasks
- CI/CD: GitHub Actions → Artifact Registry → Terraform Apply
- Monitoring: Cloud Monitoring with 5xx alerting
- Services: 13 independently deployable microservices
- External Integrations: 40+ adapters across CRM, Livechat, CDP, CMS, Comms, Payments, Product Feed
Each sub-page below contains detailed documentation with code snippets from the repository. For redundancy and high availability specifics (database failover, backup configuration, Pub/Sub retry policies, Polly patterns, graceful shutdown), see Redundancy & High Availability.
Last updated: May 2026