# manoj9329/boutique-full-stack-project architecture

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

- Interactive diagram: https://gitdiagram.com/manoj9329/boutique-full-stack-project
- Repository: https://github.com/manoj9329/boutique-full-stack-project

## Overview

This repository implements a boutique storefront with a React client and Spring backend. The user workflow is browse products, manage a local cart, submit customer and order data at checkout, and view orders; registration and login provide JWT-based authentication, while admin screens manage products and categories. Backend services and repositories support the domain API. The graph preserves the documented frontend routes and backend domains, but several backend links are dashed because their controller implementations were not excerpted.

Main entry points: [`boutique-frontend/src/services/api.js`](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/services/api.js) (HTTP client), [`boutique-frontend/src/App.jsx`](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/App.jsx) (App routes), [`boutique-frontend/src/pages/Checkout.jsx`](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Checkout.jsx) (Checkout), [`boutique-frontend/src/context/CartContext.jsx`](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/context/CartContext.jsx) (Cart state)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Storefront client"]
  node_app["App routes<br/>[App.jsx]"]
  node_cartctx["Cart state<br/>[CartContext.jsx]"]
  node_productsui["Product browsing<br/>[Products.jsx]"]
  node_cartui["Cart view<br/>[Cart.jsx]"]
  node_checkout["Checkout<br/>[Checkout.jsx]"]
  node_ordersui["Order history<br/>[Orders.jsx]"]
  node_api["HTTP client<br/>[api.js]"]
end

subgraph group_security["Authentication"]
  node_authctx["Auth state<br/>[AuthContext.jsx]"]
  node_login["Login and register<br/>[Register.jsx]"]
  node_authapi["Auth endpoints"]
  node_jwt["JWT utility<br/>[JwtUtil.java]"]
  node_userdetails["User lookup"]
  node_securityfilter["JWT security<br/>[JwtAuthFilter.java]"]
end

subgraph group_commerce["Commerce API"]
  node_orderapi["Order endpoints"]
  node_orderitemsapi["Order item endpoints"]
  node_paymentapi["Payment endpoints"]
  node_customerapi["Customer endpoints"]
  node_ordersvc["Order service<br/>[OrderService.java]"]
  node_orderitemsvc["Order item service"]
  node_paymentsvc["Payment service"]
  node_customersvc["Customer service"]
end

subgraph group_catalog["Catalog management"]
  node_adminui["Admin screens"]
  node_productapi["Product endpoints"]
  node_categoryapi["Category endpoints"]
  node_categorysvc["Category service"]
  node_productsvc["Product service"]
end

subgraph group_persistence["Domain persistence"]
  node_users[("User records<br/>[User.java]")]
  node_catalogdata[("Catalog records<br/>[Category.java]")]
  node_productdata[("Product records<br/>[Product.java]")]
  node_orderdata[("Order records<br/>[Order.java]")]
  node_itemdata[("Order item records<br/>[OrderItem.java]")]
  node_paymentdata[("Payment records<br/>[Payment.java]")]
  node_customerdata[("Customer records<br/>[Customer.java]")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"provides state"| node_authctx
node_app -->|"provides state"| node_cartctx
node_app -->|"routes to"| node_login
node_app -->|"routes to"| node_productsui
node_app -->|"routes to"| node_cartui
node_app -->|"routes to"| node_checkout
node_app -->|"routes to"| node_ordersui
node_app -->|"routes to"| node_adminui
node_login -->|"calls"| node_api
node_login -->|"updates"| node_authctx
node_productsui -->|"calls"| node_api
node_productsui -->|"adds products"| node_cartctx
node_cartui -->|"reads and updates"| node_cartctx
node_checkout -->|"reads and clears"| node_cartctx
node_checkout -->|"reads user"| node_authctx
node_checkout -->|"submits checkout"| node_api
node_ordersui -->|"calls"| node_api
node_adminui -->|"calls"| node_api
node_api -.->|"sends HTTP requests"| node_authapi
node_api -.->|"sends HTTP requests"| node_productapi
node_api -.->|"sends HTTP requests"| node_categoryapi
node_api -.->|"sends HTTP requests"| node_customerapi
node_api -.->|"sends HTTP requests"| node_orderapi
node_api -.->|"sends HTTP requests"| node_orderitemsapi
node_api -.->|"sends HTTP requests"| node_paymentapi
node_authapi -->|"generates tokens"| node_jwt
node_authapi -->|"reads and saves"| node_users
node_userdetails -->|"loads account"| node_users
node_securityfilter -.->|"validates tokens"| node_jwt
node_productapi -.->|"delegates"| node_productsvc
node_categoryapi -->|"delegates"| node_categorysvc
node_categorysvc -->|"reads and writes"| node_catalogdata
node_orderapi -.->|"delegates"| node_ordersvc
node_orderitemsapi -->|"delegates"| node_orderitemsvc
node_paymentapi -.->|"delegates"| node_paymentsvc
node_customerapi -->|"delegates"| node_customersvc
node_ordersvc -->|"reads and writes"| node_orderdata
node_orderitemsvc -->|"reads and writes"| node_itemdata
node_paymentsvc -->|"reads and writes"| node_paymentdata
node_customersvc -->|"reads and writes"| node_customerdata
node_productsvc -->|"reads and writes"| node_productdata

click node_app "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/App.jsx"
click node_authctx "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/context/AuthContext.jsx"
click node_cartctx "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/context/CartContext.jsx"
click node_login "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Register.jsx"
click node_productsui "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Products.jsx"
click node_cartui "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Cart.jsx"
click node_checkout "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Checkout.jsx"
click node_ordersui "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Orders.jsx"
click node_adminui "https://github.com/manoj9329/boutique-full-stack-project/tree/main/boutique-frontend/src/pages/admin"
click node_api "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/services/api.js"
click node_authapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/AuthController.java"
click node_jwt "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/config/JwtUtil.java"
click node_userdetails "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/config/CustomUserDetailsService.java"
click node_securityfilter "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/config/JwtAuthFilter.java"
click node_productapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/ProductController.java"
click node_categoryapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/CategoryController.java"
click node_categorysvc "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/CategoryService.java"
click node_orderapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/OrderController.java"
click node_orderitemsapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/OrderItemController.java"
click node_paymentapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/PaymentController.java"
click node_customerapi "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/CustomerController.java"
click node_ordersvc "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/OrderService.java"
click node_orderitemsvc "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/OrderItemService.java"
click node_paymentsvc "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/PaymentService.java"
click node_customersvc "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/CustomerService.java"
click node_productsvc "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/ProductService.java"
click node_users "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/User.java"
click node_catalogdata "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Category.java"
click node_productdata "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Product.java"
click node_orderdata "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Order.java"
click node_itemdata "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/OrderItem.java"
click node_paymentdata "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Payment.java"
click node_customerdata "https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Customer.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_cartctx,node_productsui,node_cartui,node_checkout,node_ordersui,node_api toneBlue
class node_authctx,node_login,node_authapi,node_jwt,node_userdetails,node_securityfilter toneAmber
class node_orderapi,node_orderitemsapi,node_paymentapi,node_customerapi,node_ordersvc,node_orderitemsvc,node_paymentsvc,node_customersvc toneMint
class node_adminui,node_productapi,node_categoryapi,node_categorysvc,node_productsvc toneRose
class node_users,node_catalogdata,node_productdata,node_orderdata,node_itemdata,node_paymentdata,node_customerdata,node_shopper toneIndigo
```

## Components

### Storefront client

- [App routes](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/App.jsx): `boutique-frontend/src/App.jsx`
- [Cart state](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/context/CartContext.jsx): `boutique-frontend/src/context/CartContext.jsx`
- [Product browsing](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Products.jsx): `boutique-frontend/src/pages/Products.jsx`
- [Cart view](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Cart.jsx): `boutique-frontend/src/pages/Cart.jsx`
- [Checkout](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Checkout.jsx): `boutique-frontend/src/pages/Checkout.jsx`
- [Order history](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Orders.jsx): `boutique-frontend/src/pages/Orders.jsx`
- [HTTP client](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/services/api.js): `boutique-frontend/src/services/api.js`

### Authentication

- [Auth state](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/context/AuthContext.jsx): `boutique-frontend/src/context/AuthContext.jsx`
- [Login and register](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-frontend/src/pages/Register.jsx): `boutique-frontend/src/pages/Register.jsx`
- [Auth endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/AuthController.java): `boutique-backend/src/main/java/com/boutique/controller/AuthController.java`
- [JWT utility](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/config/JwtUtil.java): `boutique-backend/src/main/java/com/boutique/config/JwtUtil.java`
- [User lookup](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/config/CustomUserDetailsService.java): `boutique-backend/src/main/java/com/boutique/config/CustomUserDetailsService.java`
- [JWT security](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/config/JwtAuthFilter.java): `boutique-backend/src/main/java/com/boutique/config/JwtAuthFilter.java`

### Commerce API

- [Order endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/OrderController.java): `boutique-backend/src/main/java/com/boutique/controller/OrderController.java`
- [Order item endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/OrderItemController.java): `boutique-backend/src/main/java/com/boutique/controller/OrderItemController.java`
- [Payment endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/PaymentController.java): `boutique-backend/src/main/java/com/boutique/controller/PaymentController.java`
- [Customer endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/CustomerController.java): `boutique-backend/src/main/java/com/boutique/controller/CustomerController.java`
- [Order service](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/OrderService.java): `boutique-backend/src/main/java/com/boutique/service/OrderService.java`
- [Order item service](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/OrderItemService.java): `boutique-backend/src/main/java/com/boutique/service/OrderItemService.java`
- [Payment service](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/PaymentService.java): `boutique-backend/src/main/java/com/boutique/service/PaymentService.java`
- [Customer service](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/CustomerService.java): `boutique-backend/src/main/java/com/boutique/service/CustomerService.java`

### Catalog management

- [Admin screens](https://github.com/manoj9329/boutique-full-stack-project/tree/main/boutique-frontend/src/pages/admin): `boutique-frontend/src/pages/admin`
- [Product endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/ProductController.java): `boutique-backend/src/main/java/com/boutique/controller/ProductController.java`
- [Category endpoints](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/controller/CategoryController.java): `boutique-backend/src/main/java/com/boutique/controller/CategoryController.java`
- [Category service](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/CategoryService.java): `boutique-backend/src/main/java/com/boutique/service/CategoryService.java`
- [Product service](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/service/ProductService.java): `boutique-backend/src/main/java/com/boutique/service/ProductService.java`

### Domain persistence

- [User records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/User.java): `boutique-backend/src/main/java/com/boutique/entity/User.java`
- [Catalog records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Category.java): `boutique-backend/src/main/java/com/boutique/entity/Category.java`
- [Product records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Product.java): `boutique-backend/src/main/java/com/boutique/entity/Product.java`
- [Order records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Order.java): `boutique-backend/src/main/java/com/boutique/entity/Order.java`
- [Order item records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/OrderItem.java): `boutique-backend/src/main/java/com/boutique/entity/OrderItem.java`
- [Payment records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Payment.java): `boutique-backend/src/main/java/com/boutique/entity/Payment.java`
- [Customer records](https://github.com/manoj9329/boutique-full-stack-project/blob/main/boutique-backend/src/main/java/com/boutique/entity/Customer.java): `boutique-backend/src/main/java/com/boutique/entity/Customer.java`

### Other components

- **Shopper**

## Connections

- Shopper → App routes: uses
- App routes → Auth state: provides state (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Cart state: provides state (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Login and register: routes to (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Product browsing: routes to (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Cart view: routes to (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Checkout: routes to (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Order history: routes to (evidence: `boutique-frontend/src/App.jsx`)
- App routes → Admin screens: routes to (evidence: `boutique-frontend/src/App.jsx`)
- Login and register → HTTP client: calls (evidence: `boutique-frontend/src/pages/Register.jsx`)
- Login and register → Auth state: updates (evidence: `boutique-frontend/src/pages/Register.jsx`)
- Product browsing → HTTP client: calls (evidence: `boutique-frontend/src/pages/Products.jsx`)
- Product browsing → Cart state: adds products (evidence: `boutique-frontend/src/pages/Products.jsx`)
- Cart view → Cart state: reads and updates (evidence: `boutique-frontend/src/pages/Cart.jsx`)
- Checkout → Cart state: reads and clears (evidence: `boutique-frontend/src/pages/Checkout.jsx`)
- Checkout → Auth state: reads user (evidence: `boutique-frontend/src/pages/Checkout.jsx`)
- Checkout → HTTP client: submits checkout (evidence: `boutique-frontend/src/pages/Checkout.jsx`)
- Order history → HTTP client: calls (evidence: `boutique-frontend/src/pages/Orders.jsx`)
- Admin screens → HTTP client: calls (evidence: `boutique-frontend/src/pages/admin/AdminProducts.jsx`)
- HTTP client → Auth endpoints: sends HTTP requests
- HTTP client → Product endpoints: sends HTTP requests
- HTTP client → Category endpoints: sends HTTP requests
- HTTP client → Customer endpoints: sends HTTP requests
- HTTP client → Order endpoints: sends HTTP requests
- HTTP client → Order item endpoints: sends HTTP requests
- HTTP client → Payment endpoints: sends HTTP requests
- Auth endpoints → JWT utility: generates tokens (evidence: `boutique-backend/src/main/java/com/boutique/controller/AuthController.java`)
- Auth endpoints → User records: reads and saves (evidence: `boutique-backend/src/main/java/com/boutique/controller/AuthController.java`)
- User lookup → User records: loads account (evidence: `boutique-backend/src/main/java/com/boutique/config/CustomUserDetailsService.java`)
- JWT security → JWT utility: validates tokens
- Product endpoints → Product service: delegates
- Category endpoints → Category service: delegates (evidence: `boutique-backend/src/main/java/com/boutique/controller/CategoryController.java`)
- Category service → Catalog records: reads and writes (evidence: `boutique-backend/src/main/java/com/boutique/service/CategoryService.java`)
- Order endpoints → Order service: delegates
- Order item endpoints → Order item service: delegates (evidence: `boutique-backend/src/main/java/com/boutique/controller/OrderItemController.java`)
- Payment endpoints → Payment service: delegates
- Customer endpoints → Customer service: delegates (evidence: `boutique-backend/src/main/java/com/boutique/controller/CustomerController.java`)
- Order service → Order records: reads and writes (evidence: `boutique-backend/src/main/java/com/boutique/service/OrderService.java`)
- Order item service → Order item records: reads and writes (evidence: `boutique-backend/src/main/java/com/boutique/service/OrderItemService.java`)
- Payment service → Payment records: reads and writes (evidence: `boutique-backend/src/main/java/com/boutique/service/PaymentService.java`)
- Customer service → Customer records: reads and writes (evidence: `boutique-backend/src/main/java/com/boutique/service/CustomerService.java`)
- Product service → Product records: reads and writes (evidence: `boutique-backend/src/main/java/com/boutique/service/ProductService.java`)
