# gokulvgk/online-jwellery-shop architecture

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

- Interactive diagram: https://gitdiagram.com/gokulvgk/online-jwellery-shop
- Repository: https://github.com/gokulvgk/online-jwellery-shop

## Overview

This repository implements a small storefront: users browse products, build a session-persisted cart, and submit purchases; separate screens support registration and login. The React client routes these workflows and shares cart state, while Spring controllers handle account and purchase requests, with services and repositories behind them. The purchase submission endpoint is visible in the client, but the purchase controller implementation was not excerpted, so that connection is marked unverified. The README is empty; other unsampled behavior is not inferred.

Main entry points: [`client/src/App.jsx`](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/App.jsx) (Route App), [`client/src/contexts/CartProvider.jsx`](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/contexts/CartProvider.jsx) (Cart State), [`client/src/pages/CartPage.jsx`](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/CartPage.jsx) (Cart Page), [`client/src/components/BillAmount.jsx`](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/BillAmount.jsx) (Bill Amount)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront UI"]
  node_app["Route App<br/>[App.jsx]"]
  node_home["Product Browse<br/>[HomePage.jsx]"]
  node_items["Product List<br/>[ItemList.jsx]"]
  node_item["Product Selection<br/>[Item.jsx]"]
end

subgraph group_cart["Cart Workflow"]
  node_cartstate["Cart State<br/>[CartProvider.jsx]"]
  node_cartpage["Cart Page<br/>[CartPage.jsx]"]
  node_cartlist["Cart List<br/>[CartList.jsx]"]
  node_cartitem["Cart Item<br/>[CartItem.jsx]"]
  node_quantity["Quantity Controls"]
  node_bill["Bill Amount<br/>[BillAmount.jsx]"]
  node_buy["Purchase Submit<br/>[BuyButton.jsx]"]
  node_closure["Purchase Closure<br/>[ClosureModal.jsx]"]
end

subgraph group_identity["Account Services"]
  node_login["Login Screen<br/>[LoginPage.jsx]"]
  node_register["Registration Screen<br/>[RegisterPage.jsx]"]
  node_loginapi["Account Controller"]
  node_loginservice["Account Service"]
  node_encoder["Password Encoder"]
  node_usersrepo["User Repository<br/>[UsersRepo.java]"]
  node_userentity[("User Record<br/>[UsersEntity.java]")]
end

subgraph group_purchases["Purchase Services"]
  node_buyapi["Purchase Controller<br/>[BuyController.java]"]
  node_purchaseservice["Purchase Service"]
  node_purchaserepo["Purchase Repository<br/>[PurchaseRepo.java]"]
  node_purchaseentity[("Purchase Record")]
end

node_shopper(("Shopper"))

node_shopper -->|"opens"| node_app
node_app -->|"routes to"| node_home
node_app -->|"routes to"| node_cartpage
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_register
node_home -->|"renders"| node_items
node_items -->|"renders"| node_item
node_item -->|"updates"| node_cartstate
node_cartpage -->|"reads"| node_cartstate
node_cartpage -->|"renders"| node_cartlist
node_cartlist -->|"renders"| node_cartitem
node_cartitem -->|"renders"| node_quantity
node_quantity -->|"adjusts"| node_cartstate
node_cartpage -->|"renders"| node_bill
node_bill -->|"reads"| node_cartstate
node_bill -->|"renders"| node_buy
node_bill -->|"renders"| node_closure
node_buy -->|"reads"| node_cartstate
node_buy -.->|"posts purchases"| node_buyapi
node_register -->|"posts registration"| node_loginapi
node_loginapi -->|"delegates to"| node_loginservice
node_loginservice -->|"reads and saves"| node_usersrepo
node_loginservice -->|"encodes and matches"| node_encoder
node_usersrepo -->|"persists"| node_userentity
node_buyapi -->|"delegates to"| node_purchaseservice
node_purchaseservice -->|"saves batches"| node_purchaserepo
node_purchaseservice -->|"maps purchases"| node_purchaseentity
node_purchaserepo -->|"persists"| node_purchaseentity

click node_app "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/App.jsx"
click node_home "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/HomePage.jsx"
click node_items "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/ItemList.jsx"
click node_item "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/Item.jsx"
click node_login "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/LoginPage.jsx"
click node_register "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/RegisterPage.jsx"
click node_cartstate "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/contexts/CartProvider.jsx"
click node_cartpage "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/CartPage.jsx"
click node_cartlist "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/CartList.jsx"
click node_cartitem "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/CartItem.jsx"
click node_quantity "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/AdjustQuantityButtons.jsx"
click node_bill "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/BillAmount.jsx"
click node_buy "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/BuyButton.jsx"
click node_closure "https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/ClosureModal.jsx"
click node_loginapi "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/controllers/LoginRegisterController.java"
click node_loginservice "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/services/LoginRegisterService.java"
click node_encoder "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/services/EncoderService.java"
click node_usersrepo "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/repositories/UsersRepo.java"
click node_userentity "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/DAOmodels/UsersEntity.java"
click node_buyapi "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/controllers/BuyController.java"
click node_purchaseservice "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/services/PurchaseService.java"
click node_purchaserepo "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/repositories/PurchaseRepo.java"
click node_purchaseentity "https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/DAOmodels/PurchaseEntity.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_app,node_home,node_items,node_item toneBlue
class node_cartstate,node_cartpage,node_cartlist,node_cartitem,node_quantity,node_bill,node_buy,node_closure toneAmber
class node_login,node_register,node_loginapi,node_loginservice,node_encoder,node_usersrepo,node_userentity toneMint
class node_buyapi,node_purchaseservice,node_purchaserepo,node_purchaseentity toneRose
class node_shopper toneIndigo
```

## Components

### Storefront UI

- [Route App](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/App.jsx): `client/src/App.jsx`
- [Product Browse](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/HomePage.jsx): `client/src/pages/HomePage.jsx`
- [Product List](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/ItemList.jsx): `client/src/components/ItemList.jsx`
- [Product Selection](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/Item.jsx): `client/src/components/Item.jsx`

### Cart Workflow

- [Cart State](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/contexts/CartProvider.jsx): `client/src/contexts/CartProvider.jsx`
- [Cart Page](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/CartPage.jsx): `client/src/pages/CartPage.jsx`
- [Cart List](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/CartList.jsx): `client/src/components/CartList.jsx`
- [Cart Item](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/CartItem.jsx): `client/src/components/CartItem.jsx`
- [Quantity Controls](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/AdjustQuantityButtons.jsx): `client/src/components/AdjustQuantityButtons.jsx`
- [Bill Amount](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/BillAmount.jsx): `client/src/components/BillAmount.jsx`
- [Purchase Submit](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/BuyButton.jsx): `client/src/components/BuyButton.jsx`
- [Purchase Closure](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/components/ClosureModal.jsx): `client/src/components/ClosureModal.jsx`

### Account Services

- [Login Screen](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/LoginPage.jsx): `client/src/pages/LoginPage.jsx`
- [Registration Screen](https://github.com/gokulvgk/online-jwellery-shop/blob/main/client/src/pages/RegisterPage.jsx): `client/src/pages/RegisterPage.jsx`
- [Account Controller](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/controllers/LoginRegisterController.java): `server/src/main/java/packages/react_backend/controllers/LoginRegisterController.java`
- [Account Service](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/services/LoginRegisterService.java): `server/src/main/java/packages/react_backend/services/LoginRegisterService.java`
- [Password Encoder](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/services/EncoderService.java): `server/src/main/java/packages/react_backend/services/EncoderService.java`
- [User Repository](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/repositories/UsersRepo.java): `server/src/main/java/packages/react_backend/repositories/UsersRepo.java`
- [User Record](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/DAOmodels/UsersEntity.java): `server/src/main/java/packages/react_backend/DAOmodels/UsersEntity.java`

### Purchase Services

- [Purchase Controller](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/controllers/BuyController.java): `server/src/main/java/packages/react_backend/controllers/BuyController.java`
- [Purchase Service](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/services/PurchaseService.java): `server/src/main/java/packages/react_backend/services/PurchaseService.java`
- [Purchase Repository](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/repositories/PurchaseRepo.java): `server/src/main/java/packages/react_backend/repositories/PurchaseRepo.java`
- [Purchase Record](https://github.com/gokulvgk/online-jwellery-shop/blob/main/server/src/main/java/packages/react_backend/DAOmodels/PurchaseEntity.java): `server/src/main/java/packages/react_backend/DAOmodels/PurchaseEntity.java`

### Other components

- **Shopper**

## Connections

- Shopper → Route App: opens
- Route App → Product Browse: routes to (evidence: `client/src/App.jsx`)
- Route App → Cart Page: routes to (evidence: `client/src/App.jsx`)
- Route App → Login Screen: routes to (evidence: `client/src/App.jsx`)
- Route App → Registration Screen: routes to (evidence: `client/src/App.jsx`)
- Product Browse → Product List: renders (evidence: `client/src/pages/HomePage.jsx`)
- Product List → Product Selection: renders (evidence: `client/src/components/ItemList.jsx`)
- Product Selection → Cart State: updates (evidence: `client/src/components/Item.jsx`)
- Cart Page → Cart State: reads (evidence: `client/src/pages/CartPage.jsx`)
- Cart Page → Cart List: renders (evidence: `client/src/pages/CartPage.jsx`)
- Cart List → Cart Item: renders (evidence: `client/src/components/CartList.jsx`)
- Cart Item → Quantity Controls: renders (evidence: `client/src/components/CartItem.jsx`)
- Quantity Controls → Cart State: adjusts (evidence: `client/src/components/AdjustQuantityButtons.jsx`)
- Cart Page → Bill Amount: renders (evidence: `client/src/pages/CartPage.jsx`)
- Bill Amount → Cart State: reads (evidence: `client/src/components/BillAmount.jsx`)
- Bill Amount → Purchase Submit: renders (evidence: `client/src/components/BillAmount.jsx`)
- Bill Amount → Purchase Closure: renders (evidence: `client/src/components/BillAmount.jsx`)
- Purchase Submit → Cart State: reads (evidence: `client/src/components/BuyButton.jsx`)
- Purchase Submit → Purchase Controller: posts purchases
- Registration Screen → Account Controller: posts registration (evidence: `client/src/pages/RegisterPage.jsx`)
- Account Controller → Account Service: delegates to (evidence: `server/src/main/java/packages/react_backend/controllers/LoginRegisterController.java`)
- Account Service → User Repository: reads and saves (evidence: `server/src/main/java/packages/react_backend/services/LoginRegisterService.java`)
- Account Service → Password Encoder: encodes and matches (evidence: `server/src/main/java/packages/react_backend/services/LoginRegisterService.java`)
- User Repository → User Record: persists (evidence: `server/src/main/java/packages/react_backend/repositories/UsersRepo.java`)
- Purchase Controller → Purchase Service: delegates to (evidence: `server/src/main/java/packages/react_backend/controllers/BuyController.java`)
- Purchase Service → Purchase Repository: saves batches (evidence: `server/src/main/java/packages/react_backend/services/PurchaseService.java`)
- Purchase Service → Purchase Record: maps purchases (evidence: `server/src/main/java/packages/react_backend/services/PurchaseService.java`)
- Purchase Repository → Purchase Record: persists (evidence: `server/src/main/java/packages/react_backend/repositories/PurchaseRepo.java`)
