# ambreesh-nayak/devops-ai-playbook architecture

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

- Interactive diagram: https://gitdiagram.com/ambreesh-nayak/devops-ai-playbook
- Repository: https://github.com/ambreesh-nayak/devops-ai-playbook

## Overview

This repository combines a boutique commerce application with a separate AIOps assistant. The commerce workflow is browsing and filtering products, adding them to a cart, authenticating, and placing or reviewing orders; the frontend API layer is the internal boundary to backend services. The README also describes monitoring, log analysis, and incident-response assistance through AWS Bedrock. Backend routing and most AIOps wiring were not sampled, so uncertain connections are omitted or marked dashed.

Main entry points: [`projects/boutique-microservices/frontend/src/App.tsx`](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/App.tsx) (React App), [`projects/boutique-microservices/backend/services/gateway/src/index.ts`](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/gateway/src/index.ts) (Backend Gateway), [`projects/aiops-assistant/app.py`](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/app.py) (AIOps Agent), [`projects/boutique-microservices/frontend/src/services/api.ts`](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/api.ts) (API Client)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["React App<br/>[App.tsx]"]
  node_catalog["Product Browsing<br/>[Products.tsx]"]
  node_product_detail["Product Detail<br/>[ProductDetail.tsx]"]
  node_home["Home Page<br/>[Home.tsx]"]
  node_cart_state["Cart State<br/>[CartContext.tsx]"]
  node_cart_page["Cart Page<br/>[Cart.tsx]"]
  node_auth_state["Auth State<br/>[AuthContext.tsx]"]
  node_login_register["Login And Register<br/>[Login.tsx]"]
  node_profile["Profile Page<br/>[Profile.tsx]"]
  node_orders_page["Order History<br/>[Orders.tsx]"]
  node_api_client["API Client<br/>[api.ts]"]
  node_product_api["Product API Adapter<br/>[productService.ts]"]
  node_auth_api["Auth API Adapter<br/>[authService.ts]"]
  node_order_api["Order API Adapter<br/>[orderService.ts]"]
end

subgraph group_commerce["Commerce Services"]
  node_backend_gateway["Backend Gateway<br/>[index.ts]"]
  node_auth_service["Authentication Service<br/>[auth.ts]"]
  node_auth_database[("Auth Database<br/>[connection.ts]")]
  node_product_service["Product Service<br/>[server.js]"]
  node_product_model["Product Model<br/>[productModel.js]"]
  node_orders_service["Orders Service<br/>[orders.ts]"]
  node_order_service_alt["Order Service<br/>[server.js]"]
  node_user_service["User Service<br/>[server.js]"]
end

subgraph group_aiops["AIOps Assistant"]
  node_aiops_agent["AIOps Agent<br/>[app.py]"]
  node_aiops_bundle["Lambda Bundle"]
  node_health_fetch["Health Fetcher<br/>[lambda_function.py]"]
  node_logs_fetch["Log Fetcher<br/>[lambda_function.py]"]
  node_metrics_fetch["Metrics Fetcher<br/>[lambda_function.py]"]
end

subgraph group_observability["Observability"]
  node_cloud_observability[("Cloud Observability")]
end

node_shopper(("Shopper"))
node_bedrock{{"AWS Bedrock"}}

node_shopper -->|"uses"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_catalog
node_app -->|"routes to"| node_product_detail
node_app -->|"routes to"| node_cart_page
node_app -->|"routes to"| node_login_register
node_app -->|"routes to"| node_profile
node_app -->|"routes to"| node_orders_page
node_catalog -->|"fetches products"| node_product_api
node_home -->|"fetches products"| node_product_api
node_product_detail -->|"adds item"| node_cart_state
node_cart_page -->|"uses cart"| node_cart_state
node_auth_state -->|"calls"| node_auth_api
node_login_register -.->|"uses auth"| node_auth_state
node_profile -.->|"uses auth"| node_auth_state
node_orders_page -->|"requests orders"| node_order_api
node_product_api -->|"sends requests"| node_api_client
node_auth_api -->|"sends requests"| node_api_client
node_order_api -->|"sends requests"| node_api_client
node_api_client -.->|"HTTP requests"| node_backend_gateway
node_backend_gateway -.->|"routes requests"| node_auth_service
node_backend_gateway -.->|"routes requests"| node_product_service
node_backend_gateway -.->|"routes requests"| node_orders_service
node_backend_gateway -.->|"routes requests"| node_user_service
node_auth_service -->|"uses connection"| node_auth_database
node_product_service -->|"delegates data"| node_product_model
node_order_service_alt -->|"fetches products"| node_product_service
node_aiops_agent -.->|"uses agent"| node_bedrock
node_health_fetch -.->|"collects health"| node_cloud_observability
node_logs_fetch -.->|"collects logs"| node_cloud_observability
node_metrics_fetch -.->|"collects metrics"| node_cloud_observability
node_aiops_agent -.->|"invokes"| node_health_fetch
node_aiops_agent -.->|"invokes"| node_logs_fetch
node_aiops_agent -.->|"invokes"| node_metrics_fetch

click node_app "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/App.tsx"
click node_catalog "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Products/Products.tsx"
click node_product_detail "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/ProductDetail/ProductDetail.tsx"
click node_home "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Home/Home.tsx"
click node_cart_state "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/contexts/CartContext.tsx"
click node_cart_page "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Cart/Cart.tsx"
click node_auth_state "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/contexts/AuthContext.tsx"
click node_login_register "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Login/Login.tsx"
click node_profile "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Profile/Profile.tsx"
click node_orders_page "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Orders/Orders.tsx"
click node_api_client "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/api.ts"
click node_product_api "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/productService.ts"
click node_auth_api "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/authService.ts"
click node_order_api "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/orderService.ts"
click node_backend_gateway "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/gateway/src/index.ts"
click node_auth_service "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/auth/src/routes/auth.ts"
click node_auth_database "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/auth/src/database/connection.ts"
click node_product_service "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/product-service/src/server.js"
click node_product_model "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/product-service/src/models/productModel.js"
click node_orders_service "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/orders/src/routes/orders.ts"
click node_order_service_alt "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/order-service/src/server.js"
click node_user_service "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/user-service/src/server.js"
click node_aiops_agent "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/app.py"
click node_aiops_bundle "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/aiops_all_lambda_code.py"
click node_health_fetch "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/lambda/fetch_health/lambda_function.py"
click node_logs_fetch "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/lambda/fetch_logs/lambda_function.py"
click node_metrics_fetch "https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/lambda/fetch_metrics/lambda_function.py"

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_app,node_catalog,node_product_detail,node_home,node_cart_state,node_cart_page,node_auth_state,node_login_register,node_profile,node_orders_page,node_api_client,node_product_api,node_auth_api,node_order_api toneBlue
class node_backend_gateway,node_auth_service,node_auth_database,node_product_service,node_product_model,node_orders_service,node_order_service_alt,node_user_service toneAmber
class node_aiops_agent,node_aiops_bundle,node_health_fetch,node_logs_fetch,node_metrics_fetch toneMint
class node_cloud_observability toneRose
class node_shopper,node_bedrock toneIndigo
```

## Components

### Storefront

- [React App](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/App.tsx): `projects/boutique-microservices/frontend/src/App.tsx`
- [Product Browsing](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Products/Products.tsx): `projects/boutique-microservices/frontend/src/pages/Products/Products.tsx`
- [Product Detail](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/ProductDetail/ProductDetail.tsx): `projects/boutique-microservices/frontend/src/pages/ProductDetail/ProductDetail.tsx`
- [Home Page](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Home/Home.tsx): `projects/boutique-microservices/frontend/src/pages/Home/Home.tsx`
- [Cart State](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/contexts/CartContext.tsx): `projects/boutique-microservices/frontend/src/contexts/CartContext.tsx`
- [Cart Page](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Cart/Cart.tsx): `projects/boutique-microservices/frontend/src/pages/Cart/Cart.tsx`
- [Auth State](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/contexts/AuthContext.tsx): `projects/boutique-microservices/frontend/src/contexts/AuthContext.tsx`
- [Login And Register](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Login/Login.tsx): `projects/boutique-microservices/frontend/src/pages/Login/Login.tsx`
- [Profile Page](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Profile/Profile.tsx): `projects/boutique-microservices/frontend/src/pages/Profile/Profile.tsx`
- [Order History](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/pages/Orders/Orders.tsx): `projects/boutique-microservices/frontend/src/pages/Orders/Orders.tsx`
- [API Client](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/api.ts): `projects/boutique-microservices/frontend/src/services/api.ts`
- [Product API Adapter](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/productService.ts): `projects/boutique-microservices/frontend/src/services/productService.ts`
- [Auth API Adapter](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/authService.ts): `projects/boutique-microservices/frontend/src/services/authService.ts`
- [Order API Adapter](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/frontend/src/services/orderService.ts): `projects/boutique-microservices/frontend/src/services/orderService.ts`

### Commerce Services

- [Backend Gateway](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/gateway/src/index.ts): `projects/boutique-microservices/backend/services/gateway/src/index.ts`
- [Authentication Service](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/auth/src/routes/auth.ts): `projects/boutique-microservices/backend/services/auth/src/routes/auth.ts`
- [Auth Database](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/auth/src/database/connection.ts): `projects/boutique-microservices/backend/services/auth/src/database/connection.ts`
- [Product Service](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/product-service/src/server.js): `projects/boutique-microservices/backend/services/product-service/src/server.js`
- [Product Model](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/product-service/src/models/productModel.js): `projects/boutique-microservices/backend/services/product-service/src/models/productModel.js`
- [Orders Service](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/orders/src/routes/orders.ts): `projects/boutique-microservices/backend/services/orders/src/routes/orders.ts`
- [Order Service](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/order-service/src/server.js): `projects/boutique-microservices/backend/services/order-service/src/server.js`
- [User Service](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/boutique-microservices/backend/services/user-service/src/server.js): `projects/boutique-microservices/backend/services/user-service/src/server.js`

### AIOps Assistant

- [AIOps Agent](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/app.py): `projects/aiops-assistant/app.py`
- [Lambda Bundle](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/aiops_all_lambda_code.py): `projects/aiops-assistant/aiops_all_lambda_code.py`
- [Health Fetcher](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/lambda/fetch_health/lambda_function.py): `projects/aiops-assistant/lambda/fetch_health/lambda_function.py`
- [Log Fetcher](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/lambda/fetch_logs/lambda_function.py): `projects/aiops-assistant/lambda/fetch_logs/lambda_function.py`
- [Metrics Fetcher](https://github.com/ambreesh-nayak/devops-ai-playbook/blob/main/projects/aiops-assistant/lambda/fetch_metrics/lambda_function.py): `projects/aiops-assistant/lambda/fetch_metrics/lambda_function.py`

### Observability

- **Cloud Observability**

### Other components

- **Shopper**
- **AWS Bedrock**

## Connections

- Shopper → React App: uses (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Home Page: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Product Browsing: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Product Detail: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Cart Page: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Login And Register: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Profile Page: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- React App → Order History: routes to (evidence: `projects/boutique-microservices/frontend/src/App.tsx`)
- Product Browsing → Product API Adapter: fetches products (evidence: `projects/boutique-microservices/frontend/src/pages/Products/Products.tsx`)
- Home Page → Product API Adapter: fetches products (evidence: `projects/boutique-microservices/frontend/src/pages/Home/Home.tsx`)
- Product Detail → Cart State: adds item (evidence: `projects/boutique-microservices/frontend/src/pages/ProductDetail/ProductDetail.tsx`)
- Cart Page → Cart State: uses cart (evidence: `projects/boutique-microservices/frontend/src/pages/Cart/Cart.tsx`)
- Auth State → Auth API Adapter: calls (evidence: `projects/boutique-microservices/frontend/src/contexts/AuthContext.tsx`)
- Login And Register → Auth State: uses auth (evidence: `projects/boutique-microservices/frontend/src/pages/Login/Login.tsx`)
- Profile Page → Auth State: uses auth (evidence: `projects/boutique-microservices/frontend/src/pages/Profile/Profile.tsx`)
- Order History → Order API Adapter: requests orders (evidence: `projects/boutique-microservices/frontend/src/pages/Orders/Orders.tsx`)
- Product API Adapter → API Client: sends requests (evidence: `projects/boutique-microservices/frontend/src/services/productService.ts`)
- Auth API Adapter → API Client: sends requests (evidence: `projects/boutique-microservices/frontend/src/services/authService.ts`)
- Order API Adapter → API Client: sends requests (evidence: `projects/boutique-microservices/frontend/src/services/orderService.ts`)
- API Client → Backend Gateway: HTTP requests
- Backend Gateway → Authentication Service: routes requests
- Backend Gateway → Product Service: routes requests
- Backend Gateway → Orders Service: routes requests
- Backend Gateway → User Service: routes requests
- Authentication Service → Auth Database: uses connection (evidence: `projects/boutique-microservices/backend/services/auth/src/routes/auth.ts`)
- Product Service → Product Model: delegates data (evidence: `projects/boutique-microservices/backend/services/product-service/src/server.js`)
- Order Service → Product Service: fetches products (evidence: `projects/boutique-microservices/backend/services/order-service/src/server.js`)
- AIOps Agent → AWS Bedrock: uses agent
- Health Fetcher → Cloud Observability: collects health
- Log Fetcher → Cloud Observability: collects logs
- Metrics Fetcher → Cloud Observability: collects metrics
- AIOps Agent → Health Fetcher: invokes
- AIOps Agent → Log Fetcher: invokes
- AIOps Agent → Metrics Fetcher: invokes
