# rajashekar775/ultimate-devops-project-demo architecture

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

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

## Overview

The repository is the OpenTelemetry Astronomy Shop Demo: a microservice-based shopping system intended to demonstrate distributed observability. A shopper browses products, manages a cart, and submits an order; checkout coordinates cart retrieval, shipping, currency conversion, confirmation email, and optional post-processing. The graph also preserves the catalog, recommendations, ads, quote, accounting, fraud, and flag-management capabilities visible in the tree. Source excerpts establish only some service calls, so other cross-service relationships are omitted rather than inferred; unsampled service internals are represented by their exact directories.

Main entry points: [`src/checkout/main.go`](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/checkout/main.go) (Checkout coordinator), [`src/currency/src/tracer_common.h`](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/currency/src/tracer_common.h) (Telemetry instrumentation), [`src/ad/src/main/java/oteldemo/AdService.java`](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/AdService.java) (Ad service), [`src/frontend/services/ProductCatalog.service.ts`](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/frontend/services/ProductCatalog.service.ts) (Catalog presentation)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_shop["Shop experience"]
  node_frontend["Web storefront"]
  node_catalog_ui["Catalog presentation"]
end

subgraph group_commerce["Commerce services"]
  node_product_catalog["Product catalog<br/>[main.go]"]
  node_cart_api["Cart service<br/>[CartService.cs]"]
  node_cart_store[("Valkey cart store<br/>[ValkeyCartStore.cs]")]
  node_currency["Currency conversion<br/>[server.cpp]"]
  node_recommendations["Recommendations"]
  node_ads["Ad service<br/>[AdService.java]"]
  node_cpu_load["CPU load pattern<br/>[CPULoad.java]"]
  node_gc_trigger["GC trigger"]
  node_memory_utils["Memory utilities<br/>[MemoryUtils.java]"]
  node_quote["Quote service"]
end

subgraph group_operations["Order operations"]
  node_checkout["Checkout coordinator<br/>[main.go]"]
  node_shipping["Shipping service"]
  node_email["Order email<br/>[email_server.rb]"]
  node_accounting["Accounting consumer<br/>[Consumer.cs]"]
  node_payment["Payment processing<br/>[charge.js]"]
  node_fraud["Fraud detection<br/>[main.kt]"]
end

subgraph group_flags["Feature management"]
  node_flags_ui["Flag management UI<br/>[BasicView.tsx]"]
  node_flagd["Feature flag provider"]
end

subgraph group_telemetry["Observability"]
  node_telemetry_sdk["Telemetry instrumentation<br/>[tracer_common.h]"]
  node_telemetry_backend["Telemetry collector"]
end

node_shopper(("Shopper"))

node_shopper -->|"browses and orders"| node_frontend
node_frontend -.->|"loads catalog"| node_catalog_ui
node_catalog_ui -->|"requests products"| node_product_catalog
node_catalog_ui -->|"converts prices"| node_currency
node_checkout -->|"reads and empties cart"| node_cart_api
node_checkout -->|"gets quote and ships"| node_shipping
node_checkout -->|"converts currency"| node_currency
node_checkout -->|"posts confirmation"| node_email
node_checkout -.->|"publishes order"| node_accounting
node_checkout -.->|"charges payment"| node_payment
node_checkout -.->|"checks order"| node_fraud
node_cart_api -->|"reads and writes"| node_cart_store
node_ads -->|"executes load pattern"| node_cpu_load
node_ads -->|"triggers collection"| node_gc_trigger
node_gc_trigger -->|"uses utilities"| node_memory_utils
node_flags_ui -.->|"manages flags"| node_flagd
node_ads -->|"evaluates flags"| node_flagd
node_cart_api -->|"evaluates flags"| node_flagd
node_checkout -.->|"exports telemetry"| node_telemetry_sdk
node_product_catalog -.->|"exports telemetry"| node_telemetry_sdk
node_currency -->|"initializes tracing"| node_telemetry_sdk
node_shipping -->|"initializes tracing"| node_telemetry_sdk
node_telemetry_sdk -.->|"exports signals"| node_telemetry_backend

click node_frontend "https://github.com/rajashekar775/ultimate-devops-project-demo/tree/main/src/frontend/pages"
click node_catalog_ui "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/frontend/services/ProductCatalog.service.ts"
click node_product_catalog "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/product-catalog/main.go"
click node_cart_api "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/cart/src/services/CartService.cs"
click node_cart_store "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/cart/src/cartstore/ValkeyCartStore.cs"
click node_currency "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/currency/src/server.cpp"
click node_recommendations "https://github.com/rajashekar775/ultimate-devops-project-demo/tree/main/src/recommendation"
click node_ads "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/AdService.java"
click node_cpu_load "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/CPULoad.java"
click node_gc_trigger "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java"
click node_memory_utils "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/MemoryUtils.java"
click node_quote "https://github.com/rajashekar775/ultimate-devops-project-demo/tree/main/src/quote"
click node_checkout "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/checkout/main.go"
click node_shipping "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/shipping/src/shipping_service.rs"
click node_email "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/email/email_server.rb"
click node_accounting "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/accounting/Consumer.cs"
click node_payment "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/payment/charge.js"
click node_fraud "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/fraud-detection/src/main/kotlin/frauddetection/main.kt"
click node_flags_ui "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/flagd-ui/src/components/basic/BasicView.tsx"
click node_telemetry_sdk "https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/currency/src/tracer_common.h"

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_catalog_ui toneBlue
class node_product_catalog,node_cart_api,node_cart_store,node_currency,node_recommendations,node_ads,node_cpu_load,node_gc_trigger,node_memory_utils,node_quote toneAmber
class node_checkout,node_shipping,node_email,node_accounting,node_payment,node_fraud toneMint
class node_flags_ui,node_flagd toneRose
class node_telemetry_sdk,node_telemetry_backend,node_shopper toneIndigo
```

## Components

### Shop experience

- [Web storefront](https://github.com/rajashekar775/ultimate-devops-project-demo/tree/main/src/frontend/pages): `src/frontend/pages`
- [Catalog presentation](https://github.com/rajashekar775/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/rajashekar775/ultimate-devops-project-demo/blob/main/src/product-catalog/main.go): `src/product-catalog/main.go`
- [Cart service](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/cart/src/services/CartService.cs): `src/cart/src/services/CartService.cs`
- [Valkey cart store](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/cart/src/cartstore/ValkeyCartStore.cs): `src/cart/src/cartstore/ValkeyCartStore.cs`
- [Currency conversion](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/currency/src/server.cpp): `src/currency/src/server.cpp`
- [Recommendations](https://github.com/rajashekar775/ultimate-devops-project-demo/tree/main/src/recommendation): `src/recommendation`
- [Ad service](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/AdService.java): `src/ad/src/main/java/oteldemo/AdService.java`
- [CPU load pattern](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/CPULoad.java): `src/ad/src/main/java/oteldemo/problempattern/CPULoad.java`
- [GC trigger](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java): `src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java`
- [Memory utilities](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/ad/src/main/java/oteldemo/problempattern/MemoryUtils.java): `src/ad/src/main/java/oteldemo/problempattern/MemoryUtils.java`
- [Quote service](https://github.com/rajashekar775/ultimate-devops-project-demo/tree/main/src/quote): `src/quote`

### Order operations

- [Checkout coordinator](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/checkout/main.go): `src/checkout/main.go`
- [Shipping service](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/shipping/src/shipping_service.rs): `src/shipping/src/shipping_service.rs`
- [Order email](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/email/email_server.rb): `src/email/email_server.rb`
- [Accounting consumer](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/accounting/Consumer.cs): `src/accounting/Consumer.cs`
- [Payment processing](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/payment/charge.js): `src/payment/charge.js`
- [Fraud detection](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/fraud-detection/src/main/kotlin/frauddetection/main.kt): `src/fraud-detection/src/main/kotlin/frauddetection/main.kt`

### Feature management

- [Flag management UI](https://github.com/rajashekar775/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**

### Observability

- [Telemetry instrumentation](https://github.com/rajashekar775/ultimate-devops-project-demo/blob/main/src/currency/src/tracer_common.h): `src/currency/src/tracer_common.h`
- **Telemetry collector**

### Other components

- **Shopper**

## Connections

- Shopper → Web storefront: browses and orders (evidence: `README.md`)
- Web storefront → Catalog presentation: loads catalog
- Catalog presentation → Product catalog: requests products (evidence: `src/frontend/services/ProductCatalog.service.ts`)
- Catalog presentation → Currency conversion: converts prices (evidence: `src/frontend/services/ProductCatalog.service.ts`)
- Checkout coordinator → Cart service: reads and empties cart (evidence: `src/checkout/main.go`)
- Checkout coordinator → Shipping service: gets quote and ships (evidence: `src/checkout/main.go`)
- Checkout coordinator → Currency conversion: converts currency (evidence: `src/checkout/main.go`)
- Checkout coordinator → Order email: posts confirmation (evidence: `src/checkout/main.go`)
- Checkout coordinator → Accounting consumer: publishes order
- Checkout coordinator → Payment processing: charges payment
- Checkout coordinator → Fraud detection: checks order
- Cart service → Valkey cart store: reads and writes (evidence: `src/cart/src/services/CartService.cs`)
- Ad service → CPU load pattern: executes load pattern (evidence: `src/ad/src/main/java/oteldemo/AdService.java`)
- Ad service → GC trigger: triggers collection (evidence: `src/ad/src/main/java/oteldemo/AdService.java`)
- GC trigger → Memory utilities: uses utilities (evidence: `src/ad/src/main/java/oteldemo/problempattern/GarbageCollectionTrigger.java`)
- Flag management UI → Feature flag provider: manages flags
- Ad service → Feature flag provider: evaluates flags (evidence: `src/ad/src/main/java/oteldemo/AdService.java`)
- Cart service → Feature flag provider: evaluates flags
- Checkout coordinator → Telemetry instrumentation: exports telemetry
- Product catalog → Telemetry instrumentation: exports telemetry
- Currency conversion → Telemetry instrumentation: initializes tracing (evidence: `src/currency/src/server.cpp`)
- Shipping service → Telemetry instrumentation: initializes tracing
- Telemetry instrumentation → Telemetry collector: exports signals
