# azure-samples/aks-store-demo architecture

> Architecture diagram of the GitHub repository azure-samples/aks-store-demo, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-03). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/azure-samples/aks-store-demo
- Repository: https://github.com/azure-samples/aks-store-demo

## Overview

AKS Store Demo is a polyglot microservices storefront. Customers browse products and place orders; staff manage products and monitor orders, while a queue-driven makeline service processes orders. Product CRUD and AI generation are separate backend capabilities, and scheduled virtual clients/workers simulate activity. The product service excerpt uses an in-memory product store; the README documents DocumentDB and RabbitMQ as the broader application’s persistence and queue services. Some service-to-service wiring is documented only at a high level, so uncertain links are dashed.

Main entry points: [`src/store-admin/src/App.vue`](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/App.vue) (Admin UI), [`src/product-service/src/routes/products.rs`](https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/routes/products.rs) (Product API), [`src/product-service/src/app.rs`](https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/app.rs) (Product Server), [`src/store-front/src/App.vue`](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/App.vue) (Storefront UI)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Customer Storefront"]
  node_storefront_app["Storefront UI<br/>[App.vue]"]
  node_storefront_nav["Store Navigation<br/>[TopNav.vue]"]
  node_cart["Shopping Cart"]
end

subgraph group_admin["Store Administration"]
  node_admin_app["Admin UI<br/>[App.vue]"]
  node_admin_nav["Admin Navigation<br/>[TopNav.vue]"]
  node_order_views["Order Views<br/>[OrderListView.vue]"]
  node_product_admin["Product Management"]
end

subgraph group_backend["Commerce Services"]
  node_order_service["Order API<br/>[root.js]"]
  node_makeline["Order Processing<br/>[consumer.go]"]
  node_product_api["Product API<br/>[products.rs]"]
  node_product_app["Product Server<br/>[app.rs]"]
  node_product_store[("Product Store<br/>[models.rs]")]
  node_order_queue["Order Queue<br/>[orderqueue.go]"]
  node_documentdb[("DocumentDB")]
end

subgraph group_ai["AI Capabilities"]
  node_ai_proxy["AI Proxy Routes<br/>[ai.rs]"]
  node_ai_api["AI Service API<br/>[main.py]"]
  node_description["Description Generation"]
  node_image["Image Generation<br/>[image_generator.py]"]
  node_model_provider{{"OpenAI-Compatible Models"}}
end

subgraph group_simulation["Simulated Activity"]
  node_virtual_customer["Virtual Customer<br/>[main.rs]"]
  node_virtual_worker["Virtual Worker<br/>[main.rs]"]
end

node_customer(("Customer"))

node_customer -->|"uses"| node_storefront_app
node_storefront_app -->|"renders"| node_storefront_nav
node_customer -.->|"shops with"| node_cart
node_storefront_app -->|"fetches products"| node_product_api
node_cart -.->|"places orders"| node_order_service
node_admin_app -->|"renders"| node_admin_nav
node_admin_app -->|"fetches products"| node_product_api
node_admin_app -->|"fetches orders"| node_makeline
node_admin_app -->|"routes to"| node_order_views
node_admin_app -->|"routes to"| node_product_admin
node_product_admin -->|"saves products"| node_product_api
node_product_admin -->|"requests generation"| node_ai_proxy
node_order_service -.->|"queues orders"| node_order_queue
node_order_queue -.->|"dispatches orders"| node_makeline
node_makeline -.->|"persists orders"| node_documentdb
node_product_api -->|"reads and writes"| node_product_store
node_product_app -->|"registers routes"| node_product_api
node_product_app -->|"registers routes"| node_ai_proxy
node_product_app -->|"initializes"| node_product_store
node_ai_proxy -->|"proxies requests"| node_ai_api
node_ai_api -->|"registers router"| node_description
node_ai_api -->|"registers router"| node_image
node_description -->|"generates text"| node_model_provider
node_image -.->|"generates images"| node_model_provider
node_virtual_customer -.->|"simulates ordering"| node_order_service
node_virtual_worker -.->|"simulates completion"| node_order_queue

click node_storefront_app "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/App.vue"
click node_storefront_nav "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/components/TopNav.vue"
click node_cart "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/views/ShoppingCartView.vue"
click node_admin_app "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/App.vue"
click node_admin_nav "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/components/TopNav.vue"
click node_order_views "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/views/OrderListView.vue"
click node_product_admin "https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/views/ProductFormView.vue"
click node_order_service "https://github.com/azure-samples/aks-store-demo/blob/main/src/order-service/routes/root.js"
click node_makeline "https://github.com/azure-samples/aks-store-demo/blob/main/src/makeline-service/consumer.go"
click node_product_api "https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/routes/products.rs"
click node_product_app "https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/app.rs"
click node_product_store "https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/models.rs"
click node_order_queue "https://github.com/azure-samples/aks-store-demo/blob/main/src/makeline-service/orderqueue.go"
click node_ai_proxy "https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/routes/ai.rs"
click node_ai_api "https://github.com/azure-samples/aks-store-demo/blob/main/src/ai-service/main.py"
click node_description "https://github.com/azure-samples/aks-store-demo/blob/main/src/ai-service/routers/description_generator.py"
click node_image "https://github.com/azure-samples/aks-store-demo/blob/main/src/ai-service/routers/image_generator.py"
click node_virtual_customer "https://github.com/azure-samples/aks-store-demo/blob/main/src/virtual-customer/src/main.rs"
click node_virtual_worker "https://github.com/azure-samples/aks-store-demo/blob/main/src/virtual-worker/src/main.rs"

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_storefront_app,node_storefront_nav,node_cart toneBlue
class node_admin_app,node_admin_nav,node_order_views,node_product_admin toneAmber
class node_order_service,node_makeline,node_product_api,node_product_app,node_product_store,node_order_queue,node_documentdb toneMint
class node_ai_proxy,node_ai_api,node_description,node_image,node_model_provider toneRose
class node_virtual_customer,node_virtual_worker,node_customer toneIndigo
```

## Components

### Customer Storefront

- [Storefront UI](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/App.vue): `src/store-front/src/App.vue`
- [Store Navigation](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/components/TopNav.vue): `src/store-front/src/components/TopNav.vue`
- [Shopping Cart](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-front/src/views/ShoppingCartView.vue): `src/store-front/src/views/ShoppingCartView.vue`

### Store Administration

- [Admin UI](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/App.vue): `src/store-admin/src/App.vue`
- [Admin Navigation](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/components/TopNav.vue): `src/store-admin/src/components/TopNav.vue`
- [Order Views](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/views/OrderListView.vue): `src/store-admin/src/views/OrderListView.vue`
- [Product Management](https://github.com/azure-samples/aks-store-demo/blob/main/src/store-admin/src/views/ProductFormView.vue): `src/store-admin/src/views/ProductFormView.vue`

### Commerce Services

- [Order API](https://github.com/azure-samples/aks-store-demo/blob/main/src/order-service/routes/root.js): `src/order-service/routes/root.js`
- [Order Processing](https://github.com/azure-samples/aks-store-demo/blob/main/src/makeline-service/consumer.go): `src/makeline-service/consumer.go`
- [Product API](https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/routes/products.rs): `src/product-service/src/routes/products.rs`
- [Product Server](https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/app.rs): `src/product-service/src/app.rs`
- [Product Store](https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/models.rs): `src/product-service/src/models.rs`
- [Order Queue](https://github.com/azure-samples/aks-store-demo/blob/main/src/makeline-service/orderqueue.go): `src/makeline-service/orderqueue.go`
- **DocumentDB**

### AI Capabilities

- [AI Proxy Routes](https://github.com/azure-samples/aks-store-demo/blob/main/src/product-service/src/routes/ai.rs): `src/product-service/src/routes/ai.rs`
- [AI Service API](https://github.com/azure-samples/aks-store-demo/blob/main/src/ai-service/main.py): `src/ai-service/main.py`
- [Description Generation](https://github.com/azure-samples/aks-store-demo/blob/main/src/ai-service/routers/description_generator.py): `src/ai-service/routers/description_generator.py`
- [Image Generation](https://github.com/azure-samples/aks-store-demo/blob/main/src/ai-service/routers/image_generator.py): `src/ai-service/routers/image_generator.py`
- **OpenAI-Compatible Models**

### Simulated Activity

- [Virtual Customer](https://github.com/azure-samples/aks-store-demo/blob/main/src/virtual-customer/src/main.rs): `src/virtual-customer/src/main.rs`
- [Virtual Worker](https://github.com/azure-samples/aks-store-demo/blob/main/src/virtual-worker/src/main.rs): `src/virtual-worker/src/main.rs`

### Other components

- **Customer**

## Connections

- Customer → Storefront UI: uses (evidence: `README.md`)
- Storefront UI → Store Navigation: renders (evidence: `src/store-front/src/App.vue`)
- Customer → Shopping Cart: shops with
- Storefront UI → Product API: fetches products (evidence: `src/store-front/src/App.vue`)
- Shopping Cart → Order API: places orders
- Admin UI → Admin Navigation: renders (evidence: `src/store-admin/src/App.vue`)
- Admin UI → Product API: fetches products (evidence: `src/store-admin/src/App.vue`)
- Admin UI → Order Processing: fetches orders (evidence: `src/store-admin/src/App.vue`)
- Admin UI → Order Views: routes to
- Admin UI → Product Management: routes to
- Product Management → Product API: saves products (evidence: `src/store-admin/src/views/ProductFormView.vue`)
- Product Management → AI Proxy Routes: requests generation (evidence: `src/store-admin/src/views/ProductFormView.vue`)
- Order API → Order Queue: queues orders (evidence: `README.md`)
- Order Queue → Order Processing: dispatches orders (evidence: `README.md`)
- Order Processing → DocumentDB: persists orders (evidence: `README.md`)
- Product API → Product Store: reads and writes (evidence: `src/product-service/src/routes/products.rs`)
- Product Server → Product API: registers routes (evidence: `src/product-service/src/app.rs`)
- Product Server → AI Proxy Routes: registers routes (evidence: `src/product-service/src/app.rs`)
- Product Server → Product Store: initializes (evidence: `src/product-service/src/app.rs`)
- AI Proxy Routes → AI Service API: proxies requests (evidence: `src/product-service/src/routes/ai.rs`)
- AI Service API → Description Generation: registers router (evidence: `src/ai-service/main.py`)
- AI Service API → Image Generation: registers router (evidence: `src/ai-service/main.py`)
- Description Generation → OpenAI-Compatible Models: generates text (evidence: `src/ai-service/routers/description_generator.py`)
- Image Generation → OpenAI-Compatible Models: generates images (evidence: `README.md`)
- Virtual Customer → Order API: simulates ordering (evidence: `README.md`)
- Virtual Worker → Order Queue: simulates completion (evidence: `README.md`)
