How googlecloudplatform/microservices-demo works
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: handlers.go Web frontend · main.go Checkout · Startup.cs Cart configuration · CartService.cs Cart RPC service
Components 19
User experience
- Web frontend
src/frontend/handlers.go - Traffic generator
src/loadgenerator/locustfile.py
Order orchestration
- Checkout
src/checkoutservice/main.go - Money helpers
src/checkoutservice/money/money.go
Commerce services
- Product catalog
src/productcatalogservice/product_catalog.go - Currency conversion
src/currencyservice/server.js - Shipping quotes
src/shippingservice/main.go - Payment charging
src/paymentservice/charge.js - Order email
src/emailservice/email_server.py
Cart storage
- Cart RPC service
src/cartservice/src/services/CartService.cs - Cart configuration
src/cartservice/src/Startup.cs - Cart store interface
src/cartservice/src/cartstore/ICartStore.cs - Redis cart store
src/cartservice/src/cartstore/RedisCartStore.cs - AlloyDB cart store
src/cartservice/src/cartstore/AlloyDBCartStore.cs - Spanner cart store
src/cartservice/src/cartstore/SpannerCartStore.cs
Discovery features
- Contextual ads
src/adservice/src/main/java/hipstershop/AdService.java - Recommendations
src/recommendationservice/recommendation_server.py - Shopping assistant
src/shoppingassistantservice/shoppingassistantservice.py
Other components
- Shopper
Connections 22
- 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
src/checkoutservice/main.go - Checkout → Product catalog: gets products
src/checkoutservice/main.go - Checkout → Currency conversion: converts amounts
src/checkoutservice/main.go - Checkout → Shipping quotes: quotes and ships
src/checkoutservice/main.go - Checkout → Payment charging: charges card
src/checkoutservice/main.go - Checkout → Order email: sends confirmation
src/checkoutservice/main.go - Checkout → Money helpers: calculates totals
src/checkoutservice/main.go - Cart RPC service → Cart store interface: uses store
src/cartservice/src/services/CartService.cs - Cart configuration → Cart RPC service: configures service
src/cartservice/src/Startup.cs - Cart configuration → Redis cart store: configures store
src/cartservice/src/Startup.cs - Cart configuration → AlloyDB cart store: configures store
src/cartservice/src/Startup.cs - Cart configuration → Spanner cart store: configures store
src/cartservice/src/Startup.cs - Spanner cart store → Cart store interface: implements interface
src/cartservice/src/cartstore/SpannerCartStore.cs