# vishnuram18/isaac architecture

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

- Interactive diagram: https://gitdiagram.com/vishnuram18/isaac
- Repository: https://github.com/vishnuram18/isaac

## Overview

SmartShop is a buyer-and-seller e-commerce application: users browse or search products, manage a cart, authenticate, place orders, and manage their profiles; sellers also maintain listings. The frontend calls backend APIs through the gateway. Orders synchronously validate price and stock with the product service, then publish Kafka events for asynchronous stock changes. The graph includes the documented authentication, caching, seller, and order-lifecycle branches. Some UI and infrastructure relationships are README-documented rather than verified in sampled source.

Main entry points: [`api-gateway/api-gateway/src/main/java/com/smartshop/api_gateway/config/GatewayConfig.java`](https://github.com/vishnuram18/isaac/blob/main/api-gateway/api-gateway/src/main/java/com/smartshop/api_gateway/config/GatewayConfig.java) (API gateway), [`FRONT/smartshop-ui/app/page.tsx`](https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/app/page.tsx) (Shop and account pages), [`order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java`](https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java) (Order lifecycle), [`product-service/product-service/src/main/java/com/smartshop/product_service/service/ProductService.java`](https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/service/ProductService.java) (Catalog and stock logic)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Web storefront"]
  node_ui_pages["Shop and account pages<br/>[page.tsx]"]
  node_seller_pages["Seller pages"]
  node_cart["Cart state<br/>[CartContext.tsx]"]
  node_cart_button["Add to cart"]
  node_search["Product search UI<br/>[SearchBar.tsx]"]
  node_web_api["Frontend API client<br/>[api.ts]"]
end

subgraph group_platform["Gateway and discovery"]
  node_gateway["API gateway<br/>[GatewayConfig.java]"]
  node_registry["Service registry"]
end

subgraph group_identity["Identity and profiles"]
  node_user_api["User endpoints"]
  node_user_logic["Auth and profiles<br/>[UserService.java]"]
  node_user_store[("User records")]
  node_jwt["JWT issuance<br/>[JwtUtil.java]"]
end

subgraph group_catalog["Product catalog"]
  node_product_api["Product endpoints"]
  node_product_logic["Catalog and stock logic"]
  node_product_store[("Product records")]
  node_redis[("Redis cache<br/>[RedisConfig.java]")]
  node_stock_consumer["Stock event consumer"]
end

subgraph group_commerce["Orders and stock"]
  node_order_api["Order endpoints"]
  node_order_logic["Order lifecycle<br/>[OrderService.java]"]
  node_product_client["Product lookup client<br/>[ProductClient.java]"]
  node_order_store[("Order records")]
  node_publisher["Order event publisher"]
  node_kafka["Kafka topics"]
end

node_shopper(("Buyer or seller"))

node_shopper -->|"uses"| node_ui_pages
node_ui_pages -->|"fetches products"| node_web_api
node_ui_pages -->|"renders"| node_search
node_ui_pages -->|"renders"| node_cart_button
node_cart_button -.->|"adds item"| node_cart
node_shopper -->|"manages listings"| node_seller_pages
node_seller_pages -->|"calls listing APIs"| node_web_api
node_web_api -->|"sends REST requests"| node_gateway
node_gateway -->|"routes requests"| node_user_api
node_gateway -->|"routes requests"| node_product_api
node_gateway -->|"routes requests"| node_order_api
node_gateway -.->|"discovers services"| node_registry
node_user_api -->|"delegates to"| node_user_logic
node_user_logic -->|"reads and writes"| node_user_store
node_user_logic -->|"issues token"| node_jwt
node_product_api -->|"delegates to"| node_product_logic
node_product_logic -->|"reads and writes"| node_product_store
node_product_logic -->|"caches results"| node_redis
node_order_api -->|"delegates to"| node_order_logic
node_order_logic -->|"looks up product"| node_product_client
node_product_client -->|"fetches product"| node_product_api
node_order_logic -->|"reads and writes"| node_order_store
node_order_logic -->|"publishes events"| node_publisher
node_publisher -->|"sends events"| node_kafka
node_kafka -->|"delivers events"| node_stock_consumer
node_stock_consumer -.->|"updates stock"| node_product_logic

click node_ui_pages "https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/app/page.tsx"
click node_seller_pages "https://github.com/vishnuram18/isaac/tree/main/FRONT/smartshop-ui/app/seller"
click node_cart "https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/context/CartContext.tsx"
click node_cart_button "https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/components/AddToCartButton.tsx"
click node_search "https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/components/SearchBar.tsx"
click node_web_api "https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/services/api.ts"
click node_gateway "https://github.com/vishnuram18/isaac/blob/main/api-gateway/api-gateway/src/main/java/com/smartshop/api_gateway/config/GatewayConfig.java"
click node_registry "https://github.com/vishnuram18/isaac/blob/main/eureka-server/eureka-server/src/main/java/com/smartshop/eureka_server/EurekaServerApplication.java"
click node_user_api "https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/controller/UserController.java"
click node_user_logic "https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/service/UserService.java"
click node_user_store "https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/repository/UserRepository.java"
click node_jwt "https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/util/JwtUtil.java"
click node_product_api "https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/controller/ProductController.java"
click node_product_logic "https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/service/ProductService.java"
click node_product_store "https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/repository/ProductRepository.java"
click node_redis "https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/config/RedisConfig.java"
click node_order_api "https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/controller/OrderController.java"
click node_order_logic "https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java"
click node_product_client "https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/client/ProductClient.java"
click node_order_store "https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/repository/OrderRepository.java"
click node_publisher "https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/kafka/OrderEventPublisher.java"
click node_stock_consumer "https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/kafka/StockEventConsumer.java"

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_ui_pages,node_seller_pages,node_cart,node_cart_button,node_search,node_web_api toneBlue
class node_gateway,node_registry toneAmber
class node_user_api,node_user_logic,node_user_store,node_jwt toneMint
class node_product_api,node_product_logic,node_product_store,node_redis,node_stock_consumer toneRose
class node_order_api,node_order_logic,node_product_client,node_order_store,node_publisher,node_kafka,node_shopper toneIndigo
```

## Components

### Web storefront

- [Shop and account pages](https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/app/page.tsx): `FRONT/smartshop-ui/app/page.tsx`
- [Seller pages](https://github.com/vishnuram18/isaac/tree/main/FRONT/smartshop-ui/app/seller): `FRONT/smartshop-ui/app/seller`
- [Cart state](https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/context/CartContext.tsx): `FRONT/smartshop-ui/context/CartContext.tsx`
- [Add to cart](https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/components/AddToCartButton.tsx): `FRONT/smartshop-ui/components/AddToCartButton.tsx`
- [Product search UI](https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/components/SearchBar.tsx): `FRONT/smartshop-ui/components/SearchBar.tsx`
- [Frontend API client](https://github.com/vishnuram18/isaac/blob/main/FRONT/smartshop-ui/services/api.ts): `FRONT/smartshop-ui/services/api.ts`

### Gateway and discovery

- [API gateway](https://github.com/vishnuram18/isaac/blob/main/api-gateway/api-gateway/src/main/java/com/smartshop/api_gateway/config/GatewayConfig.java): `api-gateway/api-gateway/src/main/java/com/smartshop/api_gateway/config/GatewayConfig.java`
- [Service registry](https://github.com/vishnuram18/isaac/blob/main/eureka-server/eureka-server/src/main/java/com/smartshop/eureka_server/EurekaServerApplication.java): `eureka-server/eureka-server/src/main/java/com/smartshop/eureka_server/EurekaServerApplication.java`

### Identity and profiles

- [User endpoints](https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/controller/UserController.java): `user-service/user-service/src/main/java/com/smartshop/user_service/controller/UserController.java`
- [Auth and profiles](https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/service/UserService.java): `user-service/user-service/src/main/java/com/smartshop/user_service/service/UserService.java`
- [User records](https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/repository/UserRepository.java): `user-service/user-service/src/main/java/com/smartshop/user_service/repository/UserRepository.java`
- [JWT issuance](https://github.com/vishnuram18/isaac/blob/main/user-service/user-service/src/main/java/com/smartshop/user_service/util/JwtUtil.java): `user-service/user-service/src/main/java/com/smartshop/user_service/util/JwtUtil.java`

### Product catalog

- [Product endpoints](https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/controller/ProductController.java): `product-service/product-service/src/main/java/com/smartshop/product_service/controller/ProductController.java`
- [Catalog and stock logic](https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/service/ProductService.java): `product-service/product-service/src/main/java/com/smartshop/product_service/service/ProductService.java`
- [Product records](https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/repository/ProductRepository.java): `product-service/product-service/src/main/java/com/smartshop/product_service/repository/ProductRepository.java`
- [Redis cache](https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/config/RedisConfig.java): `product-service/product-service/src/main/java/com/smartshop/product_service/config/RedisConfig.java`
- [Stock event consumer](https://github.com/vishnuram18/isaac/blob/main/product-service/product-service/src/main/java/com/smartshop/product_service/kafka/StockEventConsumer.java): `product-service/product-service/src/main/java/com/smartshop/product_service/kafka/StockEventConsumer.java`

### Orders and stock

- [Order endpoints](https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/controller/OrderController.java): `order-service/order-service/src/main/java/com/smartshop/order_service/controller/OrderController.java`
- [Order lifecycle](https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java): `order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java`
- [Product lookup client](https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/client/ProductClient.java): `order-service/order-service/src/main/java/com/smartshop/order_service/client/ProductClient.java`
- [Order records](https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/repository/OrderRepository.java): `order-service/order-service/src/main/java/com/smartshop/order_service/repository/OrderRepository.java`
- [Order event publisher](https://github.com/vishnuram18/isaac/blob/main/order-service/order-service/src/main/java/com/smartshop/order_service/kafka/OrderEventPublisher.java): `order-service/order-service/src/main/java/com/smartshop/order_service/kafka/OrderEventPublisher.java`
- **Kafka topics**

### Other components

- **Buyer or seller**

## Connections

- Buyer or seller → Shop and account pages: uses
- Shop and account pages → Frontend API client: fetches products (evidence: `FRONT/smartshop-ui/app/page.tsx`)
- Shop and account pages → Product search UI: renders (evidence: `FRONT/smartshop-ui/app/page.tsx`)
- Shop and account pages → Add to cart: renders (evidence: `FRONT/smartshop-ui/app/page.tsx`)
- Add to cart → Cart state: adds item (evidence: `FRONT/smartshop-ui/components/AddToCartButton.tsx`)
- Buyer or seller → Seller pages: manages listings
- Seller pages → Frontend API client: calls listing APIs (evidence: `FRONT/smartshop-ui/app/seller/page.tsx`)
- Frontend API client → API gateway: sends REST requests (evidence: `FRONT/smartshop-ui/services/api.ts`)
- API gateway → User endpoints: routes requests
- API gateway → Product endpoints: routes requests
- API gateway → Order endpoints: routes requests
- API gateway → Service registry: discovers services
- User endpoints → Auth and profiles: delegates to (evidence: `user-service/user-service/src/main/java/com/smartshop/user_service/controller/UserController.java`)
- Auth and profiles → User records: reads and writes (evidence: `user-service/user-service/src/main/java/com/smartshop/user_service/service/UserService.java`)
- Auth and profiles → JWT issuance: issues token (evidence: `user-service/user-service/src/main/java/com/smartshop/user_service/service/UserService.java`)
- Product endpoints → Catalog and stock logic: delegates to (evidence: `product-service/product-service/src/main/java/com/smartshop/product_service/controller/ProductController.java`)
- Catalog and stock logic → Product records: reads and writes (evidence: `product-service/product-service/src/main/java/com/smartshop/product_service/service/ProductService.java`)
- Catalog and stock logic → Redis cache: caches results
- Order endpoints → Order lifecycle: delegates to (evidence: `order-service/order-service/src/main/java/com/smartshop/order_service/controller/OrderController.java`)
- Order lifecycle → Product lookup client: looks up product (evidence: `order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java`)
- Product lookup client → Product endpoints: fetches product
- Order lifecycle → Order records: reads and writes (evidence: `order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java`)
- Order lifecycle → Order event publisher: publishes events (evidence: `order-service/order-service/src/main/java/com/smartshop/order_service/service/OrderService.java`)
- Order event publisher → Kafka topics: sends events
- Kafka topics → Stock event consumer: delivers events
- Stock event consumer → Catalog and stock logic: updates stock
