# googlecloudplatform/microservices-demo architecture

> Architecture diagram of the GitHub repository googlecloudplatform/microservices-demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-13). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/googlecloudplatform/microservices-demo
- Repository: https://github.com/googlecloudplatform/microservices-demo

## Overview

Online Boutique is a multilingual gRPC e-commerce application. Users browse products, manage a cart, and place orders through the frontend; checkout prepares the order, obtains shipping and currency data, charges payment, ships the order, and requests a confirmation email. Other documented capabilities include ads, recommendations, and a shopping assistant. The checkout and cart edges are supported by excerpts; other service-to-service links are shown only where documented or explicitly marked unverified. Some peripheral implementation details were not sampled.

Main entry points: [`src/frontend/handlers.go`](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/frontend/handlers.go) (Web frontend), [`src/checkoutservice/main.go`](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/checkoutservice/main.go) (Checkout), [`src/cartservice/src/Startup.cs`](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/Startup.cs) (Cart configuration), [`src/cartservice/src/services/CartService.cs`](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/services/CartService.cs) (Cart RPC service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["User experience"]
  node_frontend["Web frontend<br/>[handlers.go]"]
  node_loadgen["Traffic generator<br/>[locustfile.py]"]
end

subgraph group_checkout["Order orchestration"]
  node_checkout["Checkout<br/>[main.go]"]
  node_money["Money helpers<br/>[money.go]"]
end

subgraph group_services["Commerce services"]
  node_catalog["Product catalog<br/>[product_catalog.go]"]
  node_currency["Currency conversion<br/>[server.js]"]
  node_shipping["Shipping quotes<br/>[main.go]"]
  node_payment["Payment charging<br/>[charge.js]"]
  node_email["Order email<br/>[email_server.py]"]
end

subgraph group_cartstate["Cart storage"]
  node_cart["Cart RPC service<br/>[CartService.cs]"]
  node_cartstartup["Cart configuration<br/>[Startup.cs]"]
  node_cartstore["Cart store interface<br/>[ICartStore.cs]"]
  node_redis[("Redis cart store<br/>[RedisCartStore.cs]")]
  node_alloydb[("AlloyDB cart store")]
  node_spanner[("Spanner cart store")]
end

subgraph group_discovery["Discovery features"]
  node_ads["Contextual ads<br/>[AdService.java]"]
  node_recommendations["Recommendations"]
  node_assistant["Shopping assistant"]
end

node_customer(("Shopper"))

node_customer -->|"browses and buys"| node_frontend
node_loadgen -->|"sends shopping requests"| node_frontend
node_frontend -.->|"requests catalog"| node_catalog
node_frontend -.->|"manages cart"| node_cart
node_frontend -.->|"places orders"| node_checkout
node_frontend -.->|"requests conversion"| node_currency
node_frontend -.->|"requests ads"| node_ads
node_frontend -.->|"requests suggestions"| node_recommendations
node_frontend -.->|"uses assistant"| node_assistant
node_checkout -->|"reads and empties"| node_cart
node_checkout -->|"gets products"| node_catalog
node_checkout -->|"converts amounts"| node_currency
node_checkout -->|"quotes and ships"| node_shipping
node_checkout -->|"charges card"| node_payment
node_checkout -->|"sends confirmation"| node_email
node_checkout -->|"calculates totals"| node_money
node_cart -->|"uses store"| node_cartstore
node_cartstartup -->|"configures service"| node_cart
node_cartstartup -->|"configures store"| node_redis
node_cartstartup -->|"configures store"| node_alloydb
node_cartstartup -->|"configures store"| node_spanner
node_spanner -->|"implements interface"| node_cartstore

click node_frontend "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/frontend/handlers.go"
click node_checkout "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/checkoutservice/main.go"
click node_money "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/checkoutservice/money/money.go"
click node_cart "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/services/CartService.cs"
click node_cartstartup "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/Startup.cs"
click node_cartstore "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/ICartStore.cs"
click node_redis "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/RedisCartStore.cs"
click node_alloydb "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/AlloyDBCartStore.cs"
click node_spanner "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/SpannerCartStore.cs"
click node_catalog "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/productcatalogservice/product_catalog.go"
click node_currency "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/currencyservice/server.js"
click node_shipping "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/shippingservice/main.go"
click node_payment "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/paymentservice/charge.js"
click node_email "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/emailservice/email_server.py"
click node_ads "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/adservice/src/main/java/hipstershop/AdService.java"
click node_recommendations "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/recommendationservice/recommendation_server.py"
click node_assistant "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/shoppingassistantservice/shoppingassistantservice.py"
click node_loadgen "https://github.com/googlecloudplatform/microservices-demo/blob/main/src/loadgenerator/locustfile.py"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_frontend,node_loadgen toneBlue
class node_checkout,node_money toneAmber
class node_catalog,node_currency,node_shipping,node_payment,node_email toneMint
class node_cart,node_cartstartup,node_cartstore,node_redis,node_alloydb,node_spanner toneRose
class node_ads,node_recommendations,node_assistant,node_customer toneIndigo
```

## Components

### User experience

- [Web frontend](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/frontend/handlers.go): `src/frontend/handlers.go`
- [Traffic generator](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/loadgenerator/locustfile.py): `src/loadgenerator/locustfile.py`

### Order orchestration

- [Checkout](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/checkoutservice/main.go): `src/checkoutservice/main.go`
- [Money helpers](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/checkoutservice/money/money.go): `src/checkoutservice/money/money.go`

### Commerce services

- [Product catalog](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/productcatalogservice/product_catalog.go): `src/productcatalogservice/product_catalog.go`
- [Currency conversion](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/currencyservice/server.js): `src/currencyservice/server.js`
- [Shipping quotes](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/shippingservice/main.go): `src/shippingservice/main.go`
- [Payment charging](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/paymentservice/charge.js): `src/paymentservice/charge.js`
- [Order email](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/emailservice/email_server.py): `src/emailservice/email_server.py`

### Cart storage

- [Cart RPC service](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/services/CartService.cs): `src/cartservice/src/services/CartService.cs`
- [Cart configuration](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/Startup.cs): `src/cartservice/src/Startup.cs`
- [Cart store interface](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/ICartStore.cs): `src/cartservice/src/cartstore/ICartStore.cs`
- [Redis cart store](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/RedisCartStore.cs): `src/cartservice/src/cartstore/RedisCartStore.cs`
- [AlloyDB cart store](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/AlloyDBCartStore.cs): `src/cartservice/src/cartstore/AlloyDBCartStore.cs`
- [Spanner cart store](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/cartservice/src/cartstore/SpannerCartStore.cs): `src/cartservice/src/cartstore/SpannerCartStore.cs`

### Discovery features

- [Contextual ads](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/adservice/src/main/java/hipstershop/AdService.java): `src/adservice/src/main/java/hipstershop/AdService.java`
- [Recommendations](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/recommendationservice/recommendation_server.py): `src/recommendationservice/recommendation_server.py`
- [Shopping assistant](https://github.com/googlecloudplatform/microservices-demo/blob/main/src/shoppingassistantservice/shoppingassistantservice.py): `src/shoppingassistantservice/shoppingassistantservice.py`

### Other components

- **Shopper**

## Connections

- Shopper → Web frontend: browses and buys
- Traffic generator → Web frontend: sends shopping requests
- Web frontend → Product catalog: requests catalog
- Web frontend → Cart RPC service: manages cart
- Web frontend → Checkout: places orders
- Web frontend → Currency conversion: requests conversion
- Web frontend → Contextual ads: requests ads
- Web frontend → Recommendations: requests suggestions
- Web frontend → Shopping assistant: uses assistant
- Checkout → Cart RPC service: reads and empties (evidence: `src/checkoutservice/main.go`)
- Checkout → Product catalog: gets products (evidence: `src/checkoutservice/main.go`)
- Checkout → Currency conversion: converts amounts (evidence: `src/checkoutservice/main.go`)
- Checkout → Shipping quotes: quotes and ships (evidence: `src/checkoutservice/main.go`)
- Checkout → Payment charging: charges card (evidence: `src/checkoutservice/main.go`)
- Checkout → Order email: sends confirmation (evidence: `src/checkoutservice/main.go`)
- Checkout → Money helpers: calculates totals (evidence: `src/checkoutservice/main.go`)
- Cart RPC service → Cart store interface: uses store (evidence: `src/cartservice/src/services/CartService.cs`)
- Cart configuration → Cart RPC service: configures service (evidence: `src/cartservice/src/Startup.cs`)
- Cart configuration → Redis cart store: configures store (evidence: `src/cartservice/src/Startup.cs`)
- Cart configuration → AlloyDB cart store: configures store (evidence: `src/cartservice/src/Startup.cs`)
- Cart configuration → Spanner cart store: configures store (evidence: `src/cartservice/src/Startup.cs`)
- Spanner cart store → Cart store interface: implements interface (evidence: `src/cartservice/src/cartstore/SpannerCartStore.cs`)
