# muhammadhmunas92-rgb/shopio-ecommerce- architecture

> Architecture diagram of the GitHub repository muhammadhmunas92-rgb/shopio-ecommerce-, 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/muhammadhmunas92-rgb/shopio-ecommerce-
- Repository: https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-

## Overview

FORME is a luxury handbag storefront backed by a Spring Boot REST API and H2 database. The principal journey runs from storefront browsing and account/cart state through API requests to catalog, cart, and order services, which persist domain data; authentication, reviews, favorites, and administration add distinct branches. The README documents the layered backend and frontend/API boundary. Source excerpts show selected frontend and service calls; several controllers and services are represented from the index or README, so unsampled internal links are omitted where evidence is insufficient.

Main entry points: [`frontend/src/api/client.js`](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/api/client.js) (API Client), [`backend/src/main/java/com/forme/ecommerce/service/ProductService.java`](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/ProductService.java) (Product Service), [`backend/src/main/java/com/forme/ecommerce/service/OrderService.java`](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/OrderService.java) (Order Service), [`backend/src/main/java/com/forme/ecommerce/service/UserService.java`](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/UserService.java) (User Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_storefront["Storefront"]
  node_app["Storefront App<br/>[App.jsx]"]
  node_api_client["API Client<br/>[client.js]"]
end

subgraph group_identity["Identity &amp; Shopping"]
  node_authui["Auth Context<br/>[AuthContext.jsx]"]
  node_cartui["Cart Context<br/>[CartContext.jsx]"]
  node_wishlistui["Wishlist Context"]
end

subgraph group_api["REST API"]
  node_auth_api["Auth API"]
  node_product_api["Catalog API"]
  node_cart_api["Cart API"]
  node_order_api["Order API"]
  node_category_api["Category API"]
  node_favorite_api["Favorites API"]
  node_review_api["Reviews API"]
end

subgraph group_commerce["Commerce Services"]
  node_users["User Service<br/>[UserService.java]"]
  node_products["Product Service"]
  node_cart["Cart Service<br/>[CartService.java]"]
  node_orders["Order Service<br/>[OrderService.java]"]
  node_reviews["Review Service<br/>[ReviewService.java]"]
  node_categories["Category Service"]
  node_favorites["Favorite Service"]
end

subgraph group_persistence["Persistence"]
  node_catalog_store[("Catalog &amp; Reviews")]
  node_user_store[("User Records")]
  node_cart_store[("Cart Records")]
  node_order_store[("Order Records")]
  node_h2[("H2 Database")]
end

node_shopper(("Shopper"))

node_shopper -->|"uses"| node_app
node_app -->|"fetches catalog"| node_api_client
node_app -->|"provides context"| node_authui
node_authui -->|"authenticates"| node_api_client
node_cartui -->|"uses API"| node_api_client
node_api_client -->|"HTTP requests"| node_auth_api
node_api_client -->|"HTTP requests"| node_product_api
node_api_client -->|"HTTP requests"| node_cart_api
node_api_client -->|"HTTP requests"| node_order_api
node_api_client -.->|"HTTP requests"| node_category_api
node_api_client -.->|"HTTP requests"| node_favorite_api
node_api_client -->|"HTTP requests"| node_review_api
node_auth_api -->|"delegates to"| node_users
node_product_api -->|"delegates to"| node_products
node_cart_api -.->|"delegates to"| node_cart
node_order_api -->|"delegates to"| node_orders
node_category_api -.->|"delegates to"| node_categories
node_favorite_api -.->|"delegates to"| node_favorites
node_review_api -->|"delegates to"| node_reviews
node_users -->|"reads and writes"| node_user_store
node_products -->|"queries catalog"| node_catalog_store
node_products -->|"reads ratings"| node_catalog_store
node_cart -->|"updates cart"| node_cart_store
node_orders -->|"persists orders"| node_order_store
node_orders -->|"clears cart"| node_cart_store
node_reviews -->|"stores reviews"| node_catalog_store
node_reviews -->|"loads reviewer"| node_users
node_products -->|"persists via JPA"| node_h2
node_orders -->|"persists via JPA"| node_h2
node_users -->|"persists via JPA"| node_h2

click node_app "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/App.jsx"
click node_authui "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/context/AuthContext.jsx"
click node_cartui "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/context/CartContext.jsx"
click node_wishlistui "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/context/WishlistContext.jsx"
click node_api_client "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/api/client.js"
click node_auth_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/AuthController.java"
click node_product_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/ProductController.java"
click node_cart_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/CartController.java"
click node_order_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/OrderController.java"
click node_category_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/CategoryController.java"
click node_favorite_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/FavoriteController.java"
click node_review_api "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/ReviewController.java"
click node_users "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/UserService.java"
click node_products "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/ProductService.java"
click node_cart "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/CartService.java"
click node_orders "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/OrderService.java"
click node_reviews "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/ReviewService.java"
click node_categories "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/CategoryService.java"
click node_favorites "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/FavoriteService.java"
click node_catalog_store "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/ProductRepository.java"
click node_user_store "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/UserRepository.java"
click node_cart_store "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/CartItemRepository.java"
click node_order_store "https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/OrderRepository.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_api_client toneBlue
class node_authui,node_cartui,node_wishlistui toneAmber
class node_auth_api,node_product_api,node_cart_api,node_order_api,node_category_api,node_favorite_api,node_review_api toneMint
class node_users,node_products,node_cart,node_orders,node_reviews,node_categories,node_favorites toneRose
class node_catalog_store,node_user_store,node_cart_store,node_order_store,node_h2,node_shopper toneIndigo
```

## Components

### Storefront

- [Storefront App](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`
- [API Client](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/api/client.js): `frontend/src/api/client.js`

### Identity & Shopping

- [Auth Context](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/context/AuthContext.jsx): `frontend/src/context/AuthContext.jsx`
- [Cart Context](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/context/CartContext.jsx): `frontend/src/context/CartContext.jsx`
- [Wishlist Context](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/frontend/src/context/WishlistContext.jsx): `frontend/src/context/WishlistContext.jsx`

### REST API

- [Auth API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/AuthController.java): `backend/src/main/java/com/forme/ecommerce/controller/AuthController.java`
- [Catalog API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/ProductController.java): `backend/src/main/java/com/forme/ecommerce/controller/ProductController.java`
- [Cart API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/CartController.java): `backend/src/main/java/com/forme/ecommerce/controller/CartController.java`
- [Order API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/OrderController.java): `backend/src/main/java/com/forme/ecommerce/controller/OrderController.java`
- [Category API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/CategoryController.java): `backend/src/main/java/com/forme/ecommerce/controller/CategoryController.java`
- [Favorites API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/FavoriteController.java): `backend/src/main/java/com/forme/ecommerce/controller/FavoriteController.java`
- [Reviews API](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/controller/ReviewController.java): `backend/src/main/java/com/forme/ecommerce/controller/ReviewController.java`

### Commerce Services

- [User Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/UserService.java): `backend/src/main/java/com/forme/ecommerce/service/UserService.java`
- [Product Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/ProductService.java): `backend/src/main/java/com/forme/ecommerce/service/ProductService.java`
- [Cart Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/CartService.java): `backend/src/main/java/com/forme/ecommerce/service/CartService.java`
- [Order Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/OrderService.java): `backend/src/main/java/com/forme/ecommerce/service/OrderService.java`
- [Review Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/ReviewService.java): `backend/src/main/java/com/forme/ecommerce/service/ReviewService.java`
- [Category Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/CategoryService.java): `backend/src/main/java/com/forme/ecommerce/service/CategoryService.java`
- [Favorite Service](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/service/FavoriteService.java): `backend/src/main/java/com/forme/ecommerce/service/FavoriteService.java`

### Persistence

- [Catalog & Reviews](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/ProductRepository.java): `backend/src/main/java/com/forme/ecommerce/repository/ProductRepository.java`
- [User Records](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/UserRepository.java): `backend/src/main/java/com/forme/ecommerce/repository/UserRepository.java`
- [Cart Records](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/CartItemRepository.java): `backend/src/main/java/com/forme/ecommerce/repository/CartItemRepository.java`
- [Order Records](https://github.com/muhammadhmunas92-rgb/shopio-ecommerce-/blob/main/backend/src/main/java/com/forme/ecommerce/repository/OrderRepository.java): `backend/src/main/java/com/forme/ecommerce/repository/OrderRepository.java`
- **H2 Database**

### Other components

- **Shopper**

## Connections

- Shopper → Storefront App: uses (evidence: `frontend/src/App.jsx`)
- Storefront App → API Client: fetches catalog (evidence: `frontend/src/App.jsx`)
- Storefront App → Auth Context: provides context (evidence: `frontend/src/App.jsx`)
- Auth Context → API Client: authenticates (evidence: `frontend/src/context/AuthContext.jsx`)
- Cart Context → API Client: uses API (evidence: `frontend/src/context/CartContext.jsx`)
- API Client → Auth API: HTTP requests (evidence: `README.md`)
- API Client → Catalog API: HTTP requests (evidence: `README.md`)
- API Client → Cart API: HTTP requests (evidence: `README.md`)
- API Client → Order API: HTTP requests (evidence: `README.md`)
- API Client → Category API: HTTP requests
- API Client → Favorites API: HTTP requests
- API Client → Reviews API: HTTP requests (evidence: `frontend/src/api/client.js`)
- Auth API → User Service: delegates to
- Catalog API → Product Service: delegates to (evidence: `backend/src/main/java/com/forme/ecommerce/controller/ProductController.java`)
- Cart API → Cart Service: delegates to (evidence: `backend/src/main/java/com/forme/ecommerce/controller/CartController.java`)
- Order API → Order Service: delegates to (evidence: `backend/src/main/java/com/forme/ecommerce/controller/OrderController.java`)
- Category API → Category Service: delegates to
- Favorites API → Favorite Service: delegates to
- Reviews API → Review Service: delegates to (evidence: `backend/src/main/java/com/forme/ecommerce/controller/ReviewController.java`)
- User Service → User Records: reads and writes (evidence: `backend/src/main/java/com/forme/ecommerce/service/UserService.java`)
- Product Service → Catalog & Reviews: queries catalog (evidence: `backend/src/main/java/com/forme/ecommerce/service/ProductService.java`)
- Product Service → Catalog & Reviews: reads ratings (evidence: `backend/src/main/java/com/forme/ecommerce/service/ProductService.java`)
- Cart Service → Cart Records: updates cart (evidence: `backend/src/main/java/com/forme/ecommerce/service/CartService.java`)
- Order Service → Order Records: persists orders (evidence: `backend/src/main/java/com/forme/ecommerce/service/OrderService.java`)
- Order Service → Cart Records: clears cart (evidence: `backend/src/main/java/com/forme/ecommerce/service/OrderService.java`)
- Review Service → Catalog & Reviews: stores reviews (evidence: `backend/src/main/java/com/forme/ecommerce/service/ReviewService.java`)
- Review Service → User Service: loads reviewer (evidence: `backend/src/main/java/com/forme/ecommerce/service/ReviewService.java`)
- Product Service → H2 Database: persists via JPA (evidence: `README.md`)
- Order Service → H2 Database: persists via JPA (evidence: `README.md`)
- User Service → H2 Database: persists via JPA (evidence: `README.md`)
