# bharathreddyd3297/juneawsaiopsproj architecture

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

- Interactive diagram: https://gitdiagram.com/bharathreddyd3297/juneawsaiopsproj
- Repository: https://github.com/bharathreddyd3297/juneawsaiopsproj

## Overview

Telugu Pickles is a React storefront backed by six Node.js microservices; its user journey runs from browsing products through cart, checkout, and order history. The same repository also includes Dude, an AIOps assistant for monitoring, log analysis, troubleshooting, and incident response. The graph shows the frontend entry points, sampled service boundaries, and shared runtime layer. Some service-to-service routing and the assistant’s external wiring are not visible in the excerpts, so those links are omitted rather than inferred.

Main entry points: [`projects/telugu-pickles/services/common/service.js`](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/service.js) (Service Framework), [`projects/aiops-assistant/lambda/kira.py`](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/kira.py) (Agent Orchestrator), [`projects/telugu-pickles/frontend/src/api.js`](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/api.js) (API Client), [`projects/telugu-pickles/frontend/src/main.jsx`](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/main.jsx) (React App)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_frontend["React App<br/>[main.jsx]"]
  node_browse["Browse Products"]
  node_authctx["Auth State<br/>[AuthContext.jsx]"]
  node_cartctx["Cart State<br/>[CartContext.jsx]"]
  node_checkout["Checkout &amp; Orders"]
  node_api["API Client<br/>[api.js]"]
end

subgraph group_commerce["Commerce Services"]
  node_gateway["API Gateway<br/>[index.js]"]
  node_authsvc["Authentication<br/>[index.js]"]
  node_catalog["Product Catalog<br/>[products.js]"]
  node_cartsvc["Cart Service<br/>[index.js]"]
  node_orders["Order Service<br/>[index.js]"]
  node_payments["Payment Service<br/>[index.js]"]
end

subgraph group_runtime["Shared Runtime"]
  node_shared["Service Framework<br/>[service.js]"]
  node_db["Database Bootstrap<br/>[db.js]"]
  node_metrics["Metrics Runtime<br/>[metrics.js]"]
end

subgraph group_aiops["AIOps Assistant"]
  node_dude["Dude Assistant<br/>[app.py]"]
  node_agent["Agent Orchestrator<br/>[kira.py]"]
  node_k8s["Kubernetes Tools<br/>[k8s.py]"]
  node_deploy["Deployment Tools<br/>[deploy_tools.py]"]
  node_logs["Log Analysis<br/>[logs_tools.py]"]
  node_metrictools["Metrics Analysis<br/>[metrics_tools.py]"]
end

node_shopper(("Shopper"))
node_postgres[("PostgreSQL")]
node_prometheus[("Prometheus")]
node_bedrock{{"Amazon Bedrock"}}

node_shopper -->|"uses"| node_frontend
node_frontend -->|"routes to"| node_browse
node_frontend -->|"routes to"| node_checkout
node_browse -->|"requests data"| node_api
node_checkout -->|"requests operations"| node_api
node_authctx -->|"authenticates via"| node_api
node_cartctx -->|"syncs cart"| node_api
node_api -->|"sends API requests"| node_gateway
node_authsvc -->|"starts with"| node_shared
node_cartsvc -->|"starts with"| node_shared
node_catalog -->|"starts with"| node_shared
node_orders -->|"starts with"| node_shared
node_payments -->|"starts with"| node_shared
node_gateway -->|"starts with"| node_shared
node_shared -->|"records metrics"| node_metrics
node_db -->|"initializes databases"| node_postgres
node_metrics -.->|"exposes metrics"| node_prometheus
node_dude -.->|"invokes assistant"| node_agent
node_agent -->|"uses tools"| node_k8s
node_agent -->|"uses tools"| node_deploy
node_agent -->|"uses tools"| node_logs
node_agent -->|"uses tools"| node_metrictools
node_deploy -->|"delegates to"| node_k8s
node_metrictools -->|"queries cluster"| node_k8s
node_agent -.->|"uses Converse API"| node_bedrock

click node_frontend "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/main.jsx"
click node_browse "https://github.com/bharathreddyd3297/juneawsaiopsproj/tree/main/projects/telugu-pickles/frontend/src/pages"
click node_authctx "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/AuthContext.jsx"
click node_cartctx "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/CartContext.jsx"
click node_checkout "https://github.com/bharathreddyd3297/juneawsaiopsproj/tree/main/projects/telugu-pickles/frontend/src/pages"
click node_api "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/api.js"
click node_gateway "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/gateway/src/index.js"
click node_authsvc "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/auth-service/src/index.js"
click node_catalog "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/catalog-service/src/products.js"
click node_cartsvc "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/cart-service/src/index.js"
click node_orders "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/order-service/src/index.js"
click node_payments "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/payment-service/src/index.js"
click node_shared "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/service.js"
click node_db "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/db.js"
click node_metrics "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/metrics.js"
click node_dude "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/aiops-assistant/app.py"
click node_agent "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/kira.py"
click node_k8s "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/k8s.py"
click node_deploy "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/deploy_tools.py"
click node_logs "https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/aiops-assistant/lambda/logs_tools.py"
click node_metrictools "https://github.com/bharathreddyd3297/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_browse,node_authctx,node_cartctx,node_checkout,node_api toneBlue
class node_gateway,node_authsvc,node_catalog,node_cartsvc,node_orders,node_payments,node_postgres,node_prometheus toneAmber
class node_shared,node_db,node_metrics toneMint
class node_dude,node_agent,node_k8s,node_deploy,node_logs,node_metrictools toneRose
class node_shopper,node_bedrock toneIndigo
```

## Components

### Storefront

- [React App](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/main.jsx): `projects/telugu-pickles/frontend/src/main.jsx`
- [Browse Products](https://github.com/bharathreddyd3297/juneawsaiopsproj/tree/main/projects/telugu-pickles/frontend/src/pages): `projects/telugu-pickles/frontend/src/pages`
- [Auth State](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/AuthContext.jsx): `projects/telugu-pickles/frontend/src/context/AuthContext.jsx`
- [Cart State](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/context/CartContext.jsx): `projects/telugu-pickles/frontend/src/context/CartContext.jsx`
- [Checkout & Orders](https://github.com/bharathreddyd3297/juneawsaiopsproj/tree/main/projects/telugu-pickles/frontend/src/pages): `projects/telugu-pickles/frontend/src/pages`
- [API Client](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/frontend/src/api.js): `projects/telugu-pickles/frontend/src/api.js`

### Commerce Services

- [API Gateway](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/gateway/src/index.js): `projects/telugu-pickles/services/gateway/src/index.js`
- [Authentication](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/auth-service/src/index.js): `projects/telugu-pickles/services/auth-service/src/index.js`
- [Product Catalog](https://github.com/bharathreddyd3297/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/bharathreddyd3297/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/bharathreddyd3297/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/bharathreddyd3297/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/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/service.js): `projects/telugu-pickles/services/common/service.js`
- [Database Bootstrap](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/db.js): `projects/telugu-pickles/services/common/db.js`
- [Metrics Runtime](https://github.com/bharathreddyd3297/juneawsaiopsproj/blob/main/projects/telugu-pickles/services/common/metrics.js): `projects/telugu-pickles/services/common/metrics.js`

### AIOps Assistant

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

### Other components

- **Shopper**
- **PostgreSQL**
- **Prometheus**
- **Amazon Bedrock**

## Connections

- Shopper → React App: uses (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Browse Products: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- React App → Checkout & Orders: routes to (evidence: `projects/telugu-pickles/frontend/src/main.jsx`)
- Browse Products → API Client: requests data (evidence: `projects/telugu-pickles/frontend/src/pages/Home.jsx`)
- Checkout & Orders → API Client: requests operations (evidence: `projects/telugu-pickles/frontend/src/pages/Checkout.jsx`)
- Auth State → API Client: authenticates via (evidence: `projects/telugu-pickles/frontend/src/context/AuthContext.jsx`)
- Cart State → API Client: syncs cart (evidence: `projects/telugu-pickles/frontend/src/context/CartContext.jsx`)
- API Client → API Gateway: sends API requests (evidence: `projects/telugu-pickles/frontend/src/api.js`)
- Authentication → Service Framework: starts with (evidence: `projects/telugu-pickles/services/auth-service/src/index.js`)
- Cart Service → Service Framework: starts with (evidence: `projects/telugu-pickles/services/cart-service/src/index.js`)
- Product Catalog → Service Framework: starts with (evidence: `projects/telugu-pickles/services/catalog-service/src/index.js`)
- Order Service → Service Framework: starts with (evidence: `projects/telugu-pickles/services/order-service/src/index.js`)
- Payment Service → Service Framework: starts with (evidence: `projects/telugu-pickles/services/payment-service/src/index.js`)
- API Gateway → Service Framework: starts with (evidence: `projects/telugu-pickles/services/gateway/src/index.js`)
- Service Framework → Metrics Runtime: records metrics (evidence: `projects/telugu-pickles/services/common/service.js`)
- Database Bootstrap → PostgreSQL: initializes databases (evidence: `projects/telugu-pickles/services/common/db.js`)
- Metrics Runtime → Prometheus: exposes metrics (evidence: `README.md`)
- Dude Assistant → Agent Orchestrator: invokes assistant
- Agent Orchestrator → Kubernetes Tools: uses tools (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Agent Orchestrator → Deployment Tools: uses tools (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Agent Orchestrator → Log Analysis: uses tools (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Agent Orchestrator → Metrics Analysis: uses tools (evidence: `projects/aiops-assistant/lambda/kira.py`)
- Deployment Tools → Kubernetes Tools: delegates to (evidence: `projects/aiops-assistant/lambda/deploy_tools.py`)
- Metrics Analysis → Kubernetes Tools: queries cluster (evidence: `projects/aiops-assistant/lambda/metrics_tools.py`)
- Agent Orchestrator → Amazon Bedrock: uses Converse API (evidence: `README.md`)