# tatvan-24/xbrain-intership-personalized-project architecture

> Architecture diagram of the GitHub repository tatvan-24/xbrain-intership-personalized-project, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-07). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/tatvan-24/xbrain-intership-personalized-project
- Repository: https://github.com/tatvan-24/xbrain-intership-personalized-project

## Overview

This repository is an OpenTelemetry microservices demo of an online shop. The principal workflow is browsing products, managing a cart, submitting an order, and receiving shipping and payment-related results; the tree also includes review, recommendation, advertising, currency, and account capabilities. Sampled frontend and service code confirms several local calls, while many service-to-service connections are not shown. Those relationships are omitted rather than inferred from service names or conventional architecture.

Main entry points: [`source/techx-corp-platform/src/frontend/gateways/Api.gateway.ts`](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/gateways/Api.gateway.ts) (Frontend API gateway), [`source/techx-corp-platform/src/frontend/gateways/rpc`](https://github.com/tatvan-24/xbrain-intership-personalized-project/tree/main/source/techx-corp-platform/src/frontend/gateways/rpc) (RPC gateways), [`source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx`](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx) (Reviews UI), [`source/techx-corp-platform/src/frontend/pages`](https://github.com/tatvan-24/xbrain-intership-personalized-project/tree/main/source/techx-corp-platform/src/frontend/pages) (Shop frontend)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_experience["Shop experience"]
  node_frontend["Shop frontend"]
  node_review_ui["Reviews UI<br/>[ProductReviews.tsx]"]
  node_review_provider["Review provider"]
  node_ai_provider["AI assistant provider"]
  node_api_gateway["Frontend API gateway<br/>[Api.gateway.ts]"]
  node_rpc_gateways["RPC gateways"]
  node_proto_types["RPC message types<br/>[demo.ts]"]
end

subgraph group_commerce["Commerce services"]
  node_cart_service["Cart service<br/>[CartService.cs]"]
  node_cart_store["Cart store<br/>[ValkeyCartStore.cs]"]
  node_checkout["Checkout service<br/>[main.go]"]
  node_payment["Payment service<br/>[charge.js]"]
  node_accounting["Accounting consumer<br/>[Consumer.cs]"]
  node_shipping["Shipping service"]
  node_shipping_quote["Quote calculation<br/>[quote.rs]"]
  node_currency["Currency service<br/>[server.cpp]"]
  node_quote_service["Quote service<br/>[routes.php]"]
end

subgraph group_discovery["Discovery and support"]
  node_catalog["Product catalog<br/>[main.go]"]
  node_reviews["Product reviews service"]
  node_reviews_db["Reviews database access<br/>[database.py]"]
  node_recommendations["Recommendations"]
  node_ads["Advertising service<br/>[AdService.java]"]
end

subgraph group_operations["Operations and flags"]
  node_fraud["Fraud detection<br/>[main.kt]"]
  node_user_service["User service<br/>[main.py]"]
  node_email["Email service<br/>[email_server.rb]"]
  node_llm["AI service<br/>[app.py]"]
  node_flag_ui["Feature flag UI<br/>[router.ex]"]
  node_flag_storage["Flag storage<br/>[storage.ex]"]
end

node_shopper(("Shopper"))
node_valkey[("Valkey")]

node_shopper -->|"uses"| node_frontend
node_review_ui -->|"uses"| node_review_provider
node_review_ui -->|"uses"| node_ai_provider
node_review_provider -->|"requests reviews"| node_api_gateway
node_api_gateway -->|"uses message types"| node_proto_types
node_rpc_gateways -->|"uses message types"| node_proto_types
node_cart_service -->|"uses store interface"| node_cart_store
node_cart_store -.->|"reads and writes"| node_valkey
node_shipping -->|"calculates quote"| node_shipping_quote
node_reviews -->|"queries database"| node_reviews_db
node_frontend -.->|"calls API"| node_api_gateway
node_api_gateway -.->|"routes cart requests"| node_cart_service
node_api_gateway -.->|"routes checkout"| node_checkout
node_api_gateway -.->|"requests shipping"| node_shipping
node_api_gateway -.->|"requests products"| node_catalog
node_rpc_gateways -.->|"calls currency"| node_currency
node_rpc_gateways -.->|"calls catalog"| node_catalog
node_rpc_gateways -.->|"calls reviews"| node_reviews
node_ai_provider -.->|"requests answers"| node_llm

click node_frontend "https://github.com/tatvan-24/xbrain-intership-personalized-project/tree/main/source/techx-corp-platform/src/frontend/pages"
click node_review_ui "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx"
click node_review_provider "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/providers/ProductReview.provider.tsx"
click node_ai_provider "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/providers/ProductAIAssistant.provider.tsx"
click node_api_gateway "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/gateways/Api.gateway.ts"
click node_rpc_gateways "https://github.com/tatvan-24/xbrain-intership-personalized-project/tree/main/source/techx-corp-platform/src/frontend/gateways/rpc"
click node_proto_types "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/protos/demo.ts"
click node_cart_service "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/cart/src/services/CartService.cs"
click node_cart_store "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/cart/src/cartstore/ValkeyCartStore.cs"
click node_checkout "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/checkout/main.go"
click node_payment "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/payment/charge.js"
click node_accounting "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/accounting/Consumer.cs"
click node_shipping "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/shipping/src/shipping_service.rs"
click node_shipping_quote "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/shipping/src/shipping_service/quote.rs"
click node_currency "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/currency/src/server.cpp"
click node_catalog "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/product-catalog/main.go"
click node_reviews "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/product-reviews/product_reviews_server.py"
click node_reviews_db "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/product-reviews/database.py"
click node_recommendations "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/recommendation/recommendation_server.py"
click node_ads "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/ad/src/main/java/oteldemo/AdService.java"
click node_fraud "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/fraud-detection/src/main/kotlin/frauddetection/main.kt"
click node_user_service "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/user-service/main.py"
click node_email "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/email/email_server.rb"
click node_llm "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/llm/app.py"
click node_flag_ui "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/flagd-ui/lib/flagd_ui_web/router.ex"
click node_flag_storage "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/flagd-ui/lib/flagd_ui/storage.ex"
click node_quote_service "https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/quote/app/routes.php"

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_review_ui,node_review_provider,node_ai_provider,node_api_gateway,node_rpc_gateways,node_proto_types toneBlue
class node_cart_service,node_cart_store,node_checkout,node_payment,node_accounting,node_shipping,node_shipping_quote,node_currency,node_quote_service,node_valkey toneAmber
class node_catalog,node_reviews,node_reviews_db,node_recommendations,node_ads toneMint
class node_fraud,node_user_service,node_email,node_llm,node_flag_ui,node_flag_storage toneRose
class node_shopper toneIndigo
```

## Components

### Shop experience

- [Shop frontend](https://github.com/tatvan-24/xbrain-intership-personalized-project/tree/main/source/techx-corp-platform/src/frontend/pages): `source/techx-corp-platform/src/frontend/pages`
- [Reviews UI](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx): `source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx`
- [Review provider](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/providers/ProductReview.provider.tsx): `source/techx-corp-platform/src/frontend/providers/ProductReview.provider.tsx`
- [AI assistant provider](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/providers/ProductAIAssistant.provider.tsx): `source/techx-corp-platform/src/frontend/providers/ProductAIAssistant.provider.tsx`
- [Frontend API gateway](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/gateways/Api.gateway.ts): `source/techx-corp-platform/src/frontend/gateways/Api.gateway.ts`
- [RPC gateways](https://github.com/tatvan-24/xbrain-intership-personalized-project/tree/main/source/techx-corp-platform/src/frontend/gateways/rpc): `source/techx-corp-platform/src/frontend/gateways/rpc`
- [RPC message types](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/frontend/protos/demo.ts): `source/techx-corp-platform/src/frontend/protos/demo.ts`

### Commerce services

- [Cart service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/cart/src/services/CartService.cs): `source/techx-corp-platform/src/cart/src/services/CartService.cs`
- [Cart store](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/cart/src/cartstore/ValkeyCartStore.cs): `source/techx-corp-platform/src/cart/src/cartstore/ValkeyCartStore.cs`
- [Checkout service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/checkout/main.go): `source/techx-corp-platform/src/checkout/main.go`
- [Payment service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/payment/charge.js): `source/techx-corp-platform/src/payment/charge.js`
- [Accounting consumer](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/accounting/Consumer.cs): `source/techx-corp-platform/src/accounting/Consumer.cs`
- [Shipping service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/shipping/src/shipping_service.rs): `source/techx-corp-platform/src/shipping/src/shipping_service.rs`
- [Quote calculation](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/shipping/src/shipping_service/quote.rs): `source/techx-corp-platform/src/shipping/src/shipping_service/quote.rs`
- [Currency service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/currency/src/server.cpp): `source/techx-corp-platform/src/currency/src/server.cpp`
- [Quote service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/quote/app/routes.php): `source/techx-corp-platform/src/quote/app/routes.php`

### Discovery and support

- [Product catalog](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/product-catalog/main.go): `source/techx-corp-platform/src/product-catalog/main.go`
- [Product reviews service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/product-reviews/product_reviews_server.py): `source/techx-corp-platform/src/product-reviews/product_reviews_server.py`
- [Reviews database access](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/product-reviews/database.py): `source/techx-corp-platform/src/product-reviews/database.py`
- [Recommendations](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/recommendation/recommendation_server.py): `source/techx-corp-platform/src/recommendation/recommendation_server.py`
- [Advertising service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/ad/src/main/java/oteldemo/AdService.java): `source/techx-corp-platform/src/ad/src/main/java/oteldemo/AdService.java`

### Operations and flags

- [Fraud detection](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/fraud-detection/src/main/kotlin/frauddetection/main.kt): `source/techx-corp-platform/src/fraud-detection/src/main/kotlin/frauddetection/main.kt`
- [User service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/user-service/main.py): `source/techx-corp-platform/src/user-service/main.py`
- [Email service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/email/email_server.rb): `source/techx-corp-platform/src/email/email_server.rb`
- [AI service](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/llm/app.py): `source/techx-corp-platform/src/llm/app.py`
- [Feature flag UI](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/flagd-ui/lib/flagd_ui_web/router.ex): `source/techx-corp-platform/src/flagd-ui/lib/flagd_ui_web/router.ex`
- [Flag storage](https://github.com/tatvan-24/xbrain-intership-personalized-project/blob/main/source/techx-corp-platform/src/flagd-ui/lib/flagd_ui/storage.ex): `source/techx-corp-platform/src/flagd-ui/lib/flagd_ui/storage.ex`

### Other components

- **Shopper**
- **Valkey**

## Connections

- Shopper → Shop frontend: uses
- Reviews UI → Review provider: uses (evidence: `source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx`)
- Reviews UI → AI assistant provider: uses (evidence: `source/techx-corp-platform/src/frontend/components/ProductReviews/ProductReviews.tsx`)
- Review provider → Frontend API gateway: requests reviews (evidence: `source/techx-corp-platform/src/frontend/providers/ProductReview.provider.tsx`)
- Frontend API gateway → RPC message types: uses message types (evidence: `source/techx-corp-platform/src/frontend/gateways/Api.gateway.ts`)
- RPC gateways → RPC message types: uses message types (evidence: `source/techx-corp-platform/src/frontend/gateways/rpc/ProductReview.gateway.ts`)
- Cart service → Cart store: uses store interface (evidence: `source/techx-corp-platform/src/cart/src/services/CartService.cs`)
- Cart store → Valkey: reads and writes
- Shipping service → Quote calculation: calculates quote (evidence: `source/techx-corp-platform/src/shipping/src/shipping_service.rs`)
- Product reviews service → Reviews database access: queries database (evidence: `source/techx-corp-platform/src/product-reviews/product_reviews_server.py`)
- Shop frontend → Frontend API gateway: calls API
- Frontend API gateway → Cart service: routes cart requests
- Frontend API gateway → Checkout service: routes checkout
- Frontend API gateway → Shipping service: requests shipping
- Frontend API gateway → Product catalog: requests products
- RPC gateways → Currency service: calls currency
- RPC gateways → Product catalog: calls catalog
- RPC gateways → Product reviews service: calls reviews
- AI assistant provider → AI service: requests answers
