# pradeepdamera/ultimate-devops-project-demo architecture

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

- Interactive diagram: https://gitdiagram.com/pradeepdamera/ultimate-devops-project-demo
- Repository: https://github.com/pradeepdamera/ultimate-devops-project-demo

## Overview

OpenTelemetry Astronomy Shop is a microservice-based demo storefront built to demonstrate distributed-system observability. The principal flow runs from browsing and cart activity through checkout, which coordinates catalog, currency, shipping, payment, email, and cart services to produce an order. The repository also includes advertising, recommendations, fraud detection, accounting, and feature-flag UI capabilities. Paths and edges below follow the supplied tree and explicit README/source-index references or excerpts; unsampled services are represented only where their existence is supported, without asserting unverified calls.

Main entry points: [`src/frontend/pages/index.tsx`](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/frontend/pages/index.tsx) (Web Storefront), [`src/checkout/main.go`](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/checkout/main.go) (Checkout Orchestrator), [`src/ad/src/main/java/oteldemo/AdService.java`](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/AdService.java) (Advertising Service), [`src/cart/src/services/CartService.cs`](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/cart/src/services/CartService.cs) (Cart Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_frontend["Web Storefront<br/>[index.tsx]"]
  node_catalogdata["Product Price Service"]
end

subgraph group_commerce["Commerce Services"]
  node_catalogsvc["Product Catalog<br/>[main.go]"]
  node_cart["Cart Service<br/>[CartService.cs]"]
  node_cartstore[("Valkey Cart Store<br/>[ValkeyCartStore.cs]")]
  node_checkout["Checkout Orchestrator<br/>[main.go]"]
  node_currency["Currency Service<br/>[server.cpp]"]
  node_shipping["Shipping Service"]
  node_payment["Payment Service<br/>[charge.js]"]
end

subgraph group_support["Supporting Services"]
  node_email["Email Service<br/>[email_server.rb]"]
  node_ads["Advertising Service<br/>[AdService.java]"]
  node_adload["Ad Load Patterns<br/>[CPULoad.java]"]
  node_adgc["Ad GC Patterns"]
  node_recommendations["Recommendations"]
  node_fraud["Fraud Detection<br/>[main.kt]"]
  node_accounting["Accounting Consumer<br/>[Consumer.cs]"]
  node_kafka["Order Event Broker"]
end

subgraph group_flags["Feature Flags"]
  node_flagui["Flag Configuration UI<br/>[BasicView.tsx]"]
  node_flagd["Feature Flag Provider"]
end

node_shopper(("Shopper"))

node_shopper -->|"browses and orders"| node_frontend
node_frontend -->|"requests product data"| node_catalogdata
node_catalogdata -->|"lists or fetches products"| node_catalogsvc
node_catalogdata -->|"converts displayed price"| node_currency
node_frontend -.->|"uses cart API"| node_cart
node_frontend -.->|"submits checkout"| node_checkout
node_cart -->|"reads and writes cart"| node_cartstore
node_checkout -->|"gets and empties cart"| node_cart
node_checkout -->|"gets quote and ships"| node_shipping
node_checkout -->|"converts order prices"| node_currency
node_checkout -->|"sends confirmation"| node_email
node_checkout -->|"publishes order event"| node_kafka
node_kafka -.->|"streams order events"| node_accounting
node_checkout -.->|"charges payment"| node_payment
node_frontend -.->|"requests advertisements"| node_ads
node_ads -->|"executes CPU pattern"| node_adload
node_ads -->|"triggers GC pattern"| node_adgc
node_frontend -.->|"requests recommendations"| node_recommendations
node_frontend -.->|"checkout risk check"| node_fraud
node_flagui -.->|"configures flags"| node_flagd
node_ads -->|"evaluates feature flags"| node_flagd
node_cart -->|"evaluates failure flag"| node_flagd

click node_frontend "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/frontend/pages/index.tsx"
click node_catalogsvc "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/product-catalog/main.go"
click node_catalogdata "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/frontend/services/ProductCatalog.service.ts"
click node_cart "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/cart/src/services/CartService.cs"
click node_cartstore "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/cart/src/cartstore/ValkeyCartStore.cs"
click node_checkout "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/checkout/main.go"
click node_currency "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/currency/src/server.cpp"
click node_shipping "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/shipping/src/shipping_service.rs"
click node_payment "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/payment/charge.js"
click node_email "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/email/email_server.rb"
click node_ads "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/AdService.java"
click node_adload "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/CPULoad.java"
click node_adgc "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java"
click node_recommendations "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/recommendation/recommendation_server.py"
click node_fraud "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/fraud-detection/src/main/kotlin/frauddetection/main.kt"
click node_accounting "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/accounting/Consumer.cs"
click node_flagui "https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/flagd-ui/src/components/basic/BasicView.tsx"

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_catalogdata toneBlue
class node_catalogsvc,node_cart,node_cartstore,node_checkout,node_currency,node_shipping,node_payment toneAmber
class node_email,node_ads,node_adload,node_adgc,node_recommendations,node_fraud,node_accounting,node_kafka toneMint
class node_flagui,node_flagd toneRose
class node_shopper toneIndigo
```

## Components

### Storefront

- [Web Storefront](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/frontend/pages/index.tsx): `src/frontend/pages/index.tsx`
- [Product Price Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/frontend/services/ProductCatalog.service.ts): `src/frontend/services/ProductCatalog.service.ts`

### Commerce Services

- [Product Catalog](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/product-catalog/main.go): `src/product-catalog/main.go`
- [Cart Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/cart/src/services/CartService.cs): `src/cart/src/services/CartService.cs`
- [Valkey Cart Store](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/cart/src/cartstore/ValkeyCartStore.cs): `src/cart/src/cartstore/ValkeyCartStore.cs`
- [Checkout Orchestrator](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/checkout/main.go): `src/checkout/main.go`
- [Currency Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/currency/src/server.cpp): `src/currency/src/server.cpp`
- [Shipping Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/shipping/src/shipping_service.rs): `src/shipping/src/shipping_service.rs`
- [Payment Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/payment/charge.js): `src/payment/charge.js`

### Supporting Services

- [Email Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/email/email_server.rb): `src/email/email_server.rb`
- [Advertising Service](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/AdService.java): `src/ad/src/main/java/oteldemo/AdService.java`
- [Ad Load Patterns](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/CPULoad.java): `src/ad/src/main/java/oteldemo/problempattern/CPULoad.java`
- [Ad GC Patterns](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java): `src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java`
- [Recommendations](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/recommendation/recommendation_server.py): `src/recommendation/recommendation_server.py`
- [Fraud Detection](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/fraud-detection/src/main/kotlin/frauddetection/main.kt): `src/fraud-detection/src/main/kotlin/frauddetection/main.kt`
- [Accounting Consumer](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/accounting/Consumer.cs): `src/accounting/Consumer.cs`
- **Order Event Broker**

### Feature Flags

- [Flag Configuration UI](https://github.com/pradeepdamera/ultimate-devops-project-demo/blob/main/src/flagd-ui/src/components/basic/BasicView.tsx): `src/flagd-ui/src/components/basic/BasicView.tsx`
- **Feature Flag Provider**

### Other components

- **Shopper**

## Connections

- Shopper → Web Storefront: browses and orders (evidence: `README.md`)
- Web Storefront → Product Price Service: requests product data (evidence: `src/frontend/services/ProductCatalog.service.ts`)
- Product Price Service → Product Catalog: lists or fetches products (evidence: `src/frontend/services/ProductCatalog.service.ts`)
- Product Price Service → Currency Service: converts displayed price (evidence: `src/frontend/services/ProductCatalog.service.ts`)
- Web Storefront → Cart Service: uses cart API
- Web Storefront → Checkout Orchestrator: submits checkout
- Cart Service → Valkey Cart Store: reads and writes cart (evidence: `src/cart/src/services/CartService.cs`)
- Checkout Orchestrator → Cart Service: gets and empties cart (evidence: `src/checkout/main.go`)
- Checkout Orchestrator → Shipping Service: gets quote and ships (evidence: `src/checkout/main.go`)
- Checkout Orchestrator → Currency Service: converts order prices (evidence: `src/checkout/main.go`)
- Checkout Orchestrator → Email Service: sends confirmation (evidence: `src/checkout/main.go`)
- Checkout Orchestrator → Order Event Broker: publishes order event (evidence: `src/checkout/main.go`)
- Order Event Broker → Accounting Consumer: streams order events
- Checkout Orchestrator → Payment Service: charges payment
- Web Storefront → Advertising Service: requests advertisements
- Advertising Service → Ad Load Patterns: executes CPU pattern (evidence: `src/ad/src/main/java/oteldemo/AdService.java`)
- Advertising Service → Ad GC Patterns: triggers GC pattern (evidence: `src/ad/src/main/java/oteldemo/AdService.java`)
- Web Storefront → Recommendations: requests recommendations
- Web Storefront → Fraud Detection: checkout risk check
- Flag Configuration UI → Feature Flag Provider: configures flags
- Advertising Service → Feature Flag Provider: evaluates feature flags (evidence: `src/ad/src/main/java/oteldemo/AdService.java`)
- Cart Service → Feature Flag Provider: evaluates failure flag (evidence: `src/cart/src/services/CartService.cs`)
