# mustafarawat/commercecore architecture

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

- Interactive diagram: https://gitdiagram.com/mustafarawat/commercecore
- Repository: https://github.com/mustafarawat/commercecore

## Overview

This is a Spring-based e-commerce backend. The principal workflow is product discovery and cart/order handling, followed by payment and order tracking; the code tree also identifies account/authentication, catalog administration, wishlist, addresses, and contact-message capabilities. Sampled controller and service references support only some links, so other likely routes are shown as unverified rather than asserted. The README is empty, and several subsystem implementations were not excerpted.

Main entry points: [`src/main/java/com/e/commerce/mini/Repository`](https://github.com/mustafarawat/commercecore/tree/main/src/main/java/com/e/commerce/mini/Repository) (JPA repositories), [`src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java`](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java) (Google OAuth handler), [`src/main/java/com/e/commerce/mini/Service/implementation/PaymentServiceImpl.java`](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/PaymentServiceImpl.java) (Payment service), [`src/main/java/com/e/commerce/mini/controller/ProductController.java`](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ProductController.java) (Product API)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API"]
  node_product_api["Product API"]
  node_image_api["Product images API"]
  node_cart_api["Cart API"]
  node_wishlist_api["Wishlist API"]
  node_address_api["Address API"]
  node_order_api["Order API"]
  node_payment_api["Payment API"]
  node_user_api["Account API"]
  node_contact_api["Contact messages"]
  node_exception_handler["Exception mapping"]
end

subgraph group_catalog["Catalog"]
  node_product_service["Product service"]
  node_image_service["Image service"]
  node_catalog_admin["Brands and categories"]
  node_wishlist_service["Wishlist service"]
end

subgraph group_identity["Identity"]
  node_user_service["User service"]
  node_oauth_handler["Google OAuth handler"]
  node_sms_service["SMS service"]
end

subgraph group_commerce["Orders and payments"]
  node_address_service["Address service"]
  node_order_service["Order service"]
  node_payment_service["Payment service"]
end

subgraph group_data["Persistence"]
  node_repositories["JPA repositories"]
  node_entities[("Commerce entities")]
end

node_shopper(("Shopper"))
node_razorpay["Razorpay"]
node_textbee["TextBee"]

node_shopper -.->|"browses"| node_product_api
node_product_api -->|"delegates"| node_product_service
node_image_api -.->|"delegates"| node_image_service
node_shopper -.->|"manages cart"| node_cart_api
node_shopper -->|"manages wishlist"| node_wishlist_api
node_wishlist_api -->|"delegates"| node_wishlist_service
node_shopper -.->|"manages address"| node_address_api
node_address_api -->|"delegates"| node_address_service
node_shopper -.->|"places order"| node_order_api
node_order_api -.->|"delegates"| node_order_service
node_shopper -.->|"pays order"| node_payment_api
node_payment_api -.->|"delegates"| node_payment_service
node_payment_service -.->|"uses gateway"| node_razorpay
node_shopper -.->|"authenticates"| node_user_api
node_user_api -.->|"delegates"| node_user_service
node_oauth_handler -->|"looks up users"| node_repositories
node_oauth_handler -->|"creates or links"| node_entities
node_oauth_handler -->|"issues refresh token"| node_user_service
node_oauth_handler -->|"redirects tokens"| node_shopper
node_sms_service -.->|"sends SMS"| node_textbee
node_product_service -.->|"uses product data"| node_repositories
node_order_service -->|"reads and writes"| node_repositories
node_payment_service -->|"reads and writes"| node_repositories
node_repositories -->|"persists"| node_entities
node_shopper -.->|"sends message"| node_contact_api

click node_product_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ProductController.java"
click node_product_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/ProductServiceimpl.java"
click node_image_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ProductImageController.java"
click node_image_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/ProductImageServiceImpl.java"
click node_catalog_admin "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/BrandController.java"
click node_cart_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/CartController.java"
click node_wishlist_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/WishlistController.java"
click node_wishlist_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/WishlistServiceImpl.java"
click node_address_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/AddressController.java"
click node_address_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/AddressServiceImpl.java"
click node_order_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/OrderController.java"
click node_order_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/OrderServiceImpl.java"
click node_payment_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/PaymentController.java"
click node_payment_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/PaymentServiceImpl.java"
click node_user_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/UserController.java"
click node_user_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/UserServiceImpl.java"
click node_oauth_handler "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java"
click node_sms_service "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/TextBeeSmsService.java"
click node_repositories "https://github.com/mustafarawat/commercecore/tree/main/src/main/java/com/e/commerce/mini/Repository"
click node_entities "https://github.com/mustafarawat/commercecore/tree/main/src/main/java/com/e/commerce/mini/models"
click node_contact_api "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ContactController.java"
click node_exception_handler "https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Exception/GlobalExceptionHandler.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_product_api,node_image_api,node_cart_api,node_wishlist_api,node_address_api,node_order_api,node_payment_api,node_user_api,node_contact_api,node_exception_handler toneBlue
class node_product_service,node_image_service,node_catalog_admin,node_wishlist_service toneAmber
class node_user_service,node_oauth_handler,node_sms_service toneMint
class node_address_service,node_order_service,node_payment_service toneRose
class node_repositories,node_entities,node_shopper,node_razorpay,node_textbee toneIndigo
```

## Components

### API

- [Product API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ProductController.java): `src/main/java/com/e/commerce/mini/controller/ProductController.java`
- [Product images API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ProductImageController.java): `src/main/java/com/e/commerce/mini/controller/ProductImageController.java`
- [Cart API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/CartController.java): `src/main/java/com/e/commerce/mini/controller/CartController.java`
- [Wishlist API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/WishlistController.java): `src/main/java/com/e/commerce/mini/controller/WishlistController.java`
- [Address API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/AddressController.java): `src/main/java/com/e/commerce/mini/controller/AddressController.java`
- [Order API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/OrderController.java): `src/main/java/com/e/commerce/mini/controller/OrderController.java`
- [Payment API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/PaymentController.java): `src/main/java/com/e/commerce/mini/controller/PaymentController.java`
- [Account API](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/UserController.java): `src/main/java/com/e/commerce/mini/controller/UserController.java`
- [Contact messages](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/ContactController.java): `src/main/java/com/e/commerce/mini/controller/ContactController.java`
- [Exception mapping](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Exception/GlobalExceptionHandler.java): `src/main/java/com/e/commerce/mini/Exception/GlobalExceptionHandler.java`

### Catalog

- [Product service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/ProductServiceimpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/ProductServiceimpl.java`
- [Image service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/ProductImageServiceImpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/ProductImageServiceImpl.java`
- [Brands and categories](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/controller/BrandController.java): `src/main/java/com/e/commerce/mini/controller/BrandController.java`
- [Wishlist service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/WishlistServiceImpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/WishlistServiceImpl.java`

### Identity

- [User service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/UserServiceImpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/UserServiceImpl.java`
- [Google OAuth handler](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java): `src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java`
- [SMS service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/TextBeeSmsService.java): `src/main/java/com/e/commerce/mini/Service/implementation/TextBeeSmsService.java`

### Orders and payments

- [Address service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/AddressServiceImpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/AddressServiceImpl.java`
- [Order service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/OrderServiceImpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/OrderServiceImpl.java`
- [Payment service](https://github.com/mustafarawat/commercecore/blob/main/src/main/java/com/e/commerce/mini/Service/implementation/PaymentServiceImpl.java): `src/main/java/com/e/commerce/mini/Service/implementation/PaymentServiceImpl.java`

### Persistence

- [JPA repositories](https://github.com/mustafarawat/commercecore/tree/main/src/main/java/com/e/commerce/mini/Repository): `src/main/java/com/e/commerce/mini/Repository`
- [Commerce entities](https://github.com/mustafarawat/commercecore/tree/main/src/main/java/com/e/commerce/mini/models): `src/main/java/com/e/commerce/mini/models`

### Other components

- **Shopper**
- **Razorpay**
- **TextBee**

## Connections

- Shopper → Product API: browses
- Product API → Product service: delegates (evidence: `src/main/java/com/e/commerce/mini/controller/ProductController.java`)
- Product images API → Image service: delegates
- Shopper → Cart API: manages cart
- Shopper → Wishlist API: manages wishlist (evidence: `src/main/java/com/e/commerce/mini/controller/WishlistController.java`)
- Wishlist API → Wishlist service: delegates (evidence: `src/main/java/com/e/commerce/mini/controller/WishlistController.java`)
- Shopper → Address API: manages address
- Address API → Address service: delegates (evidence: `src/main/java/com/e/commerce/mini/controller/AddressController.java`)
- Shopper → Order API: places order
- Order API → Order service: delegates
- Shopper → Payment API: pays order
- Payment API → Payment service: delegates
- Payment service → Razorpay: uses gateway
- Shopper → Account API: authenticates
- Account API → User service: delegates
- Google OAuth handler → JPA repositories: looks up users (evidence: `src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java`)
- Google OAuth handler → Commerce entities: creates or links (evidence: `src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java`)
- Google OAuth handler → User service: issues refresh token (evidence: `src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java`)
- Google OAuth handler → Shopper: redirects tokens (evidence: `src/main/java/com/e/commerce/mini/Security/GoogleOAuth2SuccessHandler.java`)
- SMS service → TextBee: sends SMS
- Product service → JPA repositories: uses product data (evidence: `src/main/java/com/e/commerce/mini/Service/implementation/ProductServiceimpl.java`)
- Order service → JPA repositories: reads and writes (evidence: `src/main/java/com/e/commerce/mini/Service/implementation/OrderServiceImpl.java`)
- Payment service → JPA repositories: reads and writes (evidence: `src/main/java/com/e/commerce/mini/Service/implementation/PaymentServiceImpl.java`)
- JPA repositories → Commerce entities: persists (evidence: `src/main/java/com/e/commerce/mini/Repository/ProductRepository.java`)
- Shopper → Contact messages: sends message
