How veeramaddula/opentelemetry-demo-main-gke works
OpenTelemetry Astronomy Shop is a microservice-based demo storefront for illustrating distributed-system observability. The principal user workflow is browsing the shop, managing a cart, and placing an order; checkout coordinates cart retrieval, shipping quotes, payment, cart clearing, confirmation email, and optional order-event publishing. The wider service map includes catalog, currency, ads, recommendations, shipping, and asynchronous order consumers, alongside feature-flag management and assistant integrations. Source excerpts are partial, so several service-to-service links and the internals of unsampled capabilities are intentionally omitted; the README describes the product’s observability purpose, not detailed runtime wiring.
Main entry points: main.go Checkout Service · api Store API Routes · index.tsx Web Storefront · producer.go Orders Topic
Components 28
Storefront
- Web Storefront
src/frontend/pages/index.tsx - Store API Routes
src/frontend/pages/api - Catalog Gateway
src/frontend/gateways/rpc/ProductCatalog.gateway.ts - Cart Gateway
src/frontend/gateways/rpc/Cart.gateway.ts - Checkout Gateway
src/frontend/gateways/rpc/Checkout.gateway.ts
Commerce Services
- Product Catalog
src/product-catalog/main.go - Catalog Database
- Cart Service
src/cart/src/Program.cs - Cart Store
src/cart/src/cartstore/ValkeyCartStore.cs - Checkout Service
src/checkout/main.go - Shipping Service
src/shipping/src/main.rs - Quote Endpoint
src/quote/app/routes.php - Currency Service
src/currency/src/server.cpp - Ad Service
src/ad/src/main/java/oteldemo/AdService.java - Recommendations
src/recommendation/recommendation_server.py - Payment Service
src/payment/index.js - Email Service
src/email/email_server.rb
Order Processing
- Orders Topic
src/checkout/kafka/producer.go - Accounting Consumer
src/accounting/Consumer.cs - Fraud Detection
src/fraud-detection/src/main/kotlin/frauddetection/main.kt
Feature Flags
- Flag Management UI
src/flagd-ui/lib/flagd_ui_web/controllers/feature_controller.ex - Flag Configuration
src/flagd-ui/lib/flagd_ui/storage.ex - Flag Provider
Extensions
- Chat Interface
src/chatbot/src/chat_interface/chat_interface.py - Astronomy Shop MCP
src/mcp/src/mcp_server/astronomy_shop_mcp_server.py - Agent Services
src/agent/src/agents/agents.py
Other components
- Shopper
- OpenTelemetry Collector
Connections 20
- Shopper → Web Storefront: browses and orders
- Web Storefront → Store API Routes: requests shop data
- Store API Routes → Catalog Gateway: fetches products
- Store API Routes → Cart Gateway: manages cart
- Store API Routes → Checkout Gateway: submits order
- Product Catalog → Catalog Database: queries products
- Checkout Service → Cart Service: gets and empties cart
- Checkout Service → Shipping Service: requests quote
- Checkout Service → Payment Service: charges card
- Checkout Service → Email Service: sends confirmation
- Checkout Service → Orders Topic: publishes order
- Accounting Consumer → Orders Topic: consumes orders
- Fraud Detection → Orders Topic: consumes orders
- Flag Management UI → Flag Configuration: reads and writes flags
- Flag Configuration → Flag Provider: persists flag config
- Chat Interface → Agent Services: uses agent capability
- Agent Services → Astronomy Shop MCP: uses MCP tools
- Web Storefront → OpenTelemetry Collector: exports telemetry
- Checkout Service → OpenTelemetry Collector: exports telemetry
- Product Catalog → OpenTelemetry Collector: exports telemetry