# rajashekar775/juneawsaiopsproj architecture

> Architecture diagram of the GitHub repository rajashekar775/juneawsaiopsproj, 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/juneawsaiopsproj
- Repository: https://github.com/rajashekar775/juneawsaiopsproj

## Overview

Telugu Pickles is the customer-facing product: shoppers browse the catalog, manage a guest or signed-in cart, check out, and view orders through a React frontend and Node.js microservices. The repository also includes Dude, an AIOps assistant for DevOps troubleshooting, plus monitoring and deployment-analysis tools. The excerpts show frontend routing, API calls, shared service infrastructure, and several agent-to-tool relationships. The README documents broader AWS, observability, and delivery capabilities, but their implementation is not present in this file tree, so those links are shown only where documented.

Main entry points: [`projects/telugu-pickles/frontend/src/main.jsx`](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/main.jsx) (React App), [`projects/telugu-pickles/frontend/src/api.js`](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/api.js) (API Client), [`projects/telugu-pickles/services/common/service.js`](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/service.js) (Service Framework), [`projects/telugu-pickles/services/common/db.js`](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/db.js) (Database Bootstrap)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_frontend["React App<br/>[main.jsx]"]
  node_authui["Account Pages<br/>[Auth.jsx]"]
  node_authctx["Auth State<br/>[AuthContext.jsx]"]
  node_api["API Client<br/>[api.js]"]
  node_catalogui["Catalog Pages<br/>[Home.jsx]"]
  node_cartui["Cart Pages<br/>[Cart.jsx]"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_ordersui["Order Pages<br/>[Orders.jsx]"]
  node_cartctx["Cart State<br/>[CartContext.jsx]"]
  node_pricingui["Cart Pricing<br/>[pricing.js]"]
  node_jar["Jar Artwork<br/>[PickleJar.jsx]"]
  node_bits["Product Indicators<br/>[Bits.jsx]"]
end

subgraph group_services["Commerce Services"]
  node_gateway["API Gateway<br/>[index.js]"]
  node_authsvc["Auth Service<br/>[index.js]"]
  node_catalogsvc["Catalog Service<br/>[index.js]"]
  node_products["Product Data<br/>[products.js]"]
  node_cartsvc["Cart Service<br/>[index.js]"]
  node_ordersvc["Order Service<br/>[index.js]"]
  node_paymentsvc["Payment Service<br/>[index.js]"]
end

subgraph group_shared["Shared Runtime"]
  node_servicefw["Service Framework<br/>[service.js]"]
  node_dbhelper["Database Bootstrap<br/>[db.js]"]
  node_authhelper["JWT Helpers<br/>[auth.js]"]
  node_httphelper["Service HTTP<br/>[http.js]"]
  node_metrics["Prometheus Metrics<br/>[metrics.js]"]
end

subgraph group_aiops["Dude AIOps"]
  node_dudeapp["Dude Assistant<br/>[app.py]"]
  node_agent["Agent Orchestrator<br/>[kira.py]"]
  node_k8stools["Kubernetes Tools<br/>[k8s.py]"]
  node_deploytools["Deployment Tools<br/>[deploy_tools.py]"]
  node_logtools["Log Analysis<br/>[logs_tools.py]"]
  node_metrictools["Metric Analysis<br/>[metrics_tools.py]"]
end

subgraph group_operations["Operations Integrations"]
  node_bedrock{{"Amazon Bedrock"}}
end

node_shopper(("Shopper"))
node_postgres[("PostgreSQL")]
node_aiopsuser(("Operator"))

node_shopper -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_authui
node_frontend -->|"routes to"| node_catalogui
node_frontend -->|"routes to"| node_cartui
node_frontend -->|"routes to"| node_checkout
node_frontend -->|"routes to"| node_ordersui
node_authui -->|"uses"| node_authctx
node_authctx -->|"calls"| node_api
node_catalogui -->|"calls"| node_api
node_catalogui -->|"renders"| node_jar
node_catalogui -->|"renders"| node_bits
node_cartui -->|"uses"| node_cartctx
node_cartui -->|"renders"| node_bits
node_checkout -->|"calls"| node_api
node_checkout -->|"uses"| node_cartctx
node_ordersui -->|"calls"| node_api
node_cartctx -->|"calls"| node_api
node_cartctx -->|"reads user"| node_authctx
node_cartctx -->|"calculates totals"| node_pricingui
node_api -->|"sends API requests"| node_gateway
node_authsvc -->|"uses"| node_servicefw
node_authsvc -->|"initializes database"| node_dbhelper
node_authsvc -->|"signs tokens"| node_authhelper
node_catalogsvc -->|"uses"| node_servicefw
node_catalogsvc -->|"initializes database"| node_dbhelper
node_catalogsvc -->|"loads products"| node_products
node_cartsvc -->|"uses"| node_servicefw
node_cartsvc -->|"initializes database"| node_dbhelper
node_cartsvc -->|"checks tokens"| node_authhelper
node_cartsvc -->|"calls services"| node_httphelper
node_ordersvc -->|"uses"| node_servicefw
node_ordersvc -->|"initializes database"| node_dbhelper
node_ordersvc -->|"checks tokens"| node_authhelper
node_ordersvc -->|"calls services"| node_httphelper
node_paymentsvc -->|"uses"| node_servicefw
node_paymentsvc -->|"initializes database"| node_dbhelper
node_dbhelper -->|"connects"| node_postgres
node_servicefw -->|"records metrics"| node_metrics
node_aiopsuser -.->|"asks"| node_dudeapp
node_agent -->|"dispatches"| node_deploytools
node_agent -->|"dispatches"| node_logtools
node_agent -->|"dispatches"| node_metrictools
node_deploytools -->|"uses"| node_k8stools
node_metrictools -->|"uses"| node_k8stools
node_agent -.->|"invokes"| node_bedrock
node_dudeapp -.->|"invokes"| node_agent

click node_frontend "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/main.jsx"
click node_authui "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Auth.jsx"
click node_authctx "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/AuthContext.jsx"
click node_api "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/api.js"
click node_catalogui "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Home.jsx"
click node_cartui "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Cart.jsx"
click node_checkout "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Checkout.jsx"
click node_ordersui "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Orders.jsx"
click node_cartctx "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/CartContext.jsx"
click node_pricingui "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pricing.js"
click node_jar "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/components/PickleJar.jsx"
click node_bits "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/components/Bits.jsx"
click node_gateway "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/gateway/src/index.js"
click node_authsvc "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/auth-service/src/index.js"
click node_catalogsvc "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/catalog-service/src/index.js"
click node_products "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/catalog-service/src/products.js"
click node_cartsvc "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/cart-service/src/index.js"
click node_ordersvc "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/order-service/src/index.js"
click node_paymentsvc "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/payment-service/src/index.js"
click node_servicefw "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/service.js"
click node_dbhelper "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/db.js"
click node_authhelper "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/auth.js"
click node_httphelper "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/http.js"
click node_metrics "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/metrics.js"
click node_dudeapp "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/app.py"
click node_agent "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/kira.py"
click node_k8stools "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/k8s.py"
click node_deploytools "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/deploy_tools.py"
click node_logtools "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/logs_tools.py"
click node_metrictools "https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/metrics_tools.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_frontend,node_authui,node_authctx,node_api,node_catalogui,node_cartui,node_checkout,node_ordersui,node_cartctx,node_pricingui,node_jar,node_bits toneBlue
class node_gateway,node_authsvc,node_catalogsvc,node_products,node_cartsvc,node_ordersvc,node_paymentsvc,node_postgres toneAmber
class node_servicefw,node_dbhelper,node_authhelper,node_httphelper,node_metrics toneMint
class node_dudeapp,node_agent,node_k8stools,node_deploytools,node_logtools,node_metrictools toneRose
class node_bedrock,node_shopper,node_aiopsuser toneIndigo
```

## Components

### Storefront

- [React App](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/main.jsx): `projects/telugu-pickles/frontend/src/main.jsx`
- [Account Pages](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Auth.jsx): `projects/telugu-pickles/frontend/src/pages/Auth.jsx`
- [Auth State](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/AuthContext.jsx): `projects/telugu-pickles/frontend/src/context/AuthContext.jsx`
- [API Client](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/api.js): `projects/telugu-pickles/frontend/src/api.js`
- [Catalog Pages](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Home.jsx): `projects/telugu-pickles/frontend/src/pages/Home.jsx`
- [Cart Pages](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Cart.jsx): `projects/telugu-pickles/frontend/src/pages/Cart.jsx`
- [Checkout](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Checkout.jsx): `projects/telugu-pickles/frontend/src/pages/Checkout.jsx`
- [Order Pages](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pages/Orders.jsx): `projects/telugu-pickles/frontend/src/pages/Orders.jsx`
- [Cart State](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/CartContext.jsx): `projects/telugu-pickles/frontend/src/context/CartContext.jsx`
- [Cart Pricing](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/pricing.js): `projects/telugu-pickles/frontend/src/pricing.js`
- [Jar Artwork](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/components/PickleJar.jsx): `projects/telugu-pickles/frontend/src/components/PickleJar.jsx`
- [Product Indicators](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/components/Bits.jsx): `projects/telugu-pickles/frontend/src/components/Bits.jsx`

### Commerce Services

- [API Gateway](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/gateway/src/index.js): `projects/telugu-pickles/services/gateway/src/index.js`
- [Auth Service](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/auth-service/src/index.js): `projects/telugu-pickles/services/auth-service/src/index.js`
- [Catalog Service](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/catalog-service/src/index.js): `projects/telugu-pickles/services/catalog-service/src/index.js`
- [Product Data](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/catalog-service/src/products.js): `projects/telugu-pickles/services/catalog-service/src/products.js`
- [Cart Service](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/cart-service/src/index.js): `projects/telugu-pickles/services/cart-service/src/index.js`
- [Order Service](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/order-service/src/index.js): `projects/telugu-pickles/services/order-service/src/index.js`
- [Payment Service](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/payment-service/src/index.js): `projects/telugu-pickles/services/payment-service/src/index.js`

### Shared Runtime

- [Service Framework](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/service.js): `projects/telugu-pickles/services/common/service.js`
- [Database Bootstrap](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/db.js): `projects/telugu-pickles/services/common/db.js`
- [JWT Helpers](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/auth.js): `projects/telugu-pickles/services/common/auth.js`
- [Service HTTP](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/http.js): `projects/telugu-pickles/services/common/http.js`
- [Prometheus Metrics](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/metrics.js): `projects/telugu-pickles/services/common/metrics.js`

### Dude AIOps

- [Dude Assistant](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/app.py): `projects/aiops-assistant/app.py`
- [Agent Orchestrator](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/kira.py): `projects/aiops-assistant/lambda/kira.py`
- [Kubernetes Tools](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/k8s.py): `projects/aiops-assistant/lambda/k8s.py`
- [Deployment Tools](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/deploy_tools.py): `projects/aiops-assistant/lambda/deploy_tools.py`
- [Log Analysis](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/logs_tools.py): `projects/aiops-assistant/lambda/logs_tools.py`
- [Metric Analysis](https://github.com/rajashekar775/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/metrics_tools.py): `projects/aiops-assistant/lambda/metrics_tools.py`

### Operations Integrations

- **Amazon Bedrock**

### Other components

- **Shopper**
- **PostgreSQL**
- **Operator**

## Connections

- Shopper → React App: uses (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Account Pages: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Catalog Pages: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Cart Pages: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Checkout: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Order Pages: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- Account Pages → Auth State: uses (evidence: `projects/telugu-pickles/frontend/src/pages/Auth.jsx`)
- Auth State → API Client: calls (evidence: `projects/telugu-pickles/frontend/src/context/AuthContext.jsx`)
- Catalog Pages → API Client: calls (evidence: `projects/telugu-pickles/frontend/src/pages/Home.jsx`)
- Catalog Pages → Jar Artwork: renders (evidence: `projects/telugu-pickles/frontend/src/pages/Home.jsx`)
- Catalog Pages → Product Indicators: renders (evidence: `projects/telugu-pickles/frontend/src/pages/Home.jsx`)
- Cart Pages → Cart State: uses (evidence: `projects/telugu-pickles/frontend/src/pages/Cart.jsx`)
- Cart Pages → Product Indicators: renders (evidence: `projects/telugu-pickles/frontend/src/pages/Cart.jsx`)
- Checkout → API Client: calls (evidence: `projects/telugu-pickles/frontend/src/pages/Checkout.jsx`)
- Checkout → Cart State: uses (evidence: `projects/telugu-pickles/frontend/src/pages/Checkout.jsx`)
- Order Pages → API Client: calls (evidence: `projects/telugu-pickles/frontend/src/pages/Orders.jsx`)
- Cart State → API Client: calls (evidence: `projects/telugu-pickles/frontend/src/context/CartContext.jsx`)
- Cart State → Auth State: reads user (evidence: `projects/telugu-pickles/frontend/src/context/CartContext.jsx`)
- Cart State → Cart Pricing: calculates totals (evidence: `projects/telugu-pickles/frontend/src/context/CartContext.jsx`)
- API Client → API Gateway: sends API requests (evidence: `projects/telugu-pickles/frontend/src/api.js`)
- Auth Service → Service Framework: uses (evidence: `projects/telugu-pickles/services/auth-service/src/index.js`)
- Auth Service → Database Bootstrap: initializes database (evidence: `projects/telugu-pickles/services/auth-service/src/index.js`)
- Auth Service → JWT Helpers: signs tokens (evidence: `projects/telugu-pickles/services/auth-service/src/index.js`)
- Catalog Service → Service Framework: uses (evidence: `projects/telugu-pickles/services/catalog-service/src/index.js`)
- Catalog Service → Database Bootstrap: initializes database (evidence: `projects/telugu-pickles/services/catalog-service/src/index.js`)
- Catalog Service → Product Data: loads products (evidence: `projects/telugu-pickles/services/catalog-service/src/index.js`)
- Cart Service → Service Framework: uses (evidence: `projects/telugu-pickles/services/cart-service/src/index.js`)
- Cart Service → Database Bootstrap: initializes database (evidence: `projects/telugu-pickles/services/cart-service/src/index.js`)
- Cart Service → JWT Helpers: checks tokens (evidence: `projects/telugu-pickles/services/cart-service/src/index.js`)
- Cart Service → Service HTTP: calls services (evidence: `projects/telugu-pickles/services/cart-service/src/index.js`)
- Order Service → Service Framework: uses (evidence: `projects/telugu-pickles/services/order-service/src/index.js`)
- Order Service → Database Bootstrap: initializes database (evidence: `projects/telugu-pickles/services/order-service/src/index.js`)
- Order Service → JWT Helpers: checks tokens (evidence: `projects/telugu-pickles/services/order-service/src/index.js`)
- Order Service → Service HTTP: calls services (evidence: `projects/telugu-pickles/services/order-service/src/index.js`)
- Payment Service → Service Framework: uses (evidence: `projects/telugu-pickles/services/payment-service/src/index.js`)
- Payment Service → Database Bootstrap: initializes database (evidence: `projects/telugu-pickles/services/payment-service/src/index.js`)
- Database Bootstrap → PostgreSQL: connects (evidence: `projects/telugu-pickles/services/common/db.js`)
- Service Framework → Prometheus Metrics: records metrics (evidence: `projects/telugu-pickles/services/common/service.js`)
- Operator → Dude Assistant: asks (evidence: `README.md`)
- Agent Orchestrator → Deployment Tools: dispatches (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Agent Orchestrator → Log Analysis: dispatches (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Agent Orchestrator → Metric Analysis: dispatches (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Deployment Tools → Kubernetes Tools: uses (evidence: `projects/aiops-assistant/lambda/deploy_tools.py`)
- Metric Analysis → Kubernetes Tools: uses (evidence: `projects/aiops-assistant/lambda/metrics_tools.py`)
- Agent Orchestrator → Amazon Bedrock: invokes (evidence: `README.md`)
- Dude Assistant → Agent Orchestrator: invokes
