# sushilranavare/dreamcart-backend architecture

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

- Interactive diagram: https://gitdiagram.com/sushilranavare/dreamcart-backend
- Repository: https://github.com/sushilranavare/dreamcart-backend

## Overview

DreamCart is a Spring Boot REST backend for an e-commerce storefront and its administrators. The principal customer flow authenticates with JWT, browses products, manages a cart and shipping address, places an order, and submits a simulated payment; order confirmation is emailed asynchronously. Separate capabilities cover reviews, wishlists, profiles, catalog administration, and dashboard statistics. The README documents the broad controller-to-service-to-PostgreSQL architecture and checkout sequence; source excerpts confirm selected service calls and repository access. Other domain links are documented at feature level rather than verified from their implementations.

Main entry points: [`src/main/java/com/dreamcart/backend/controller/OrderController.java`](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/OrderController.java) (Shopping APIs), [`src/main/java/com/dreamcart/backend/controller/AdminDashboardController.java`](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/AdminDashboardController.java) (Admin APIs), [`src/main/java/com/dreamcart/backend/controller/ProductController.java`](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/ProductController.java) (Catalog APIs), [`src/main/java/com/dreamcart/backend/service/ProductService.java`](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ProductService.java) (Product Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_authapi["Authentication API"]
  node_shopapi["Shopping APIs"]
  node_catalogapi["Catalog APIs"]
  node_adminapi["Admin APIs"]
end

subgraph group_identity["Identity &amp; Access"]
  node_jwtfilter["JWT Request Filter"]
  node_authservice["Auth Service<br/>[AuthService.java]"]
  node_userdetails["User Lookup"]
  node_users["User Service<br/>[UserService.java]"]
end

subgraph group_shopping["Shopping &amp; Checkout"]
  node_cart["Cart Service<br/>[CartService.java]"]
  node_address["Address Service"]
  node_orders["Order Service<br/>[OrderService.java]"]
  node_payments["Payment Service"]
  node_email["Order Email<br/>[EmailService.java]"]
  node_wishlist["Wishlist Service"]
end

subgraph group_catalog["Catalog &amp; Feedback"]
  node_products["Product Service"]
  node_categories["Category Service"]
  node_reviews["Review Service<br/>[ReviewService.java]"]
  node_images["Image Storage"]
end

subgraph group_operations["Administration"]
  node_dashboard["Dashboard Service"]
end

node_customer(("Customer / Admin"))
node_db[("PostgreSQL")]
node_smtp["SMTP Mail"]

node_customer -->|"register / login"| node_authapi
node_authapi -->|"delegates"| node_authservice
node_authservice -->|"reads / saves users"| node_db
node_authservice -->|"generates JWT"| node_jwtfilter
node_customer -->|"Bearer requests"| node_jwtfilter
node_jwtfilter -->|"loads user"| node_userdetails
node_userdetails -->|"loads account"| node_db
node_customer -->|"browse catalog"| node_catalogapi
node_catalogapi -->|"delegates"| node_products
node_products -->|"searches / saves"| node_db
node_products -->|"stores image"| node_images
node_customer -->|"cart / checkout"| node_shopapi
node_shopapi -->|"delegates"| node_cart
node_cart -->|"reads / saves cart"| node_db
node_shopapi -->|"manages addresses"| node_address
node_shopapi -->|"places orders"| node_orders
node_orders -->|"locks stock; saves order"| node_db
node_shopapi -->|"initiates payment"| node_payments
node_payments -->|"saves payment; updates order"| node_db
node_payments -.->|"queues confirmation"| node_email
node_email -.->|"sends email"| node_smtp
node_customer -.->|"wishlist actions"| node_shopapi
node_customer -.->|"reviews products"| node_catalogapi
node_catalogapi -.->|"delegates"| node_reviews
node_customer -.->|"admin operations"| node_adminapi
node_adminapi -.->|"requests statistics"| node_dashboard
node_adminapi -.->|"manages products"| node_products
node_adminapi -.->|"manages categories"| node_categories
node_adminapi -.->|"manages users"| node_users
node_dashboard -.->|"reads statistics"| node_db

click node_authapi "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/AuthController.java"
click node_shopapi "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/OrderController.java"
click node_catalogapi "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/ProductController.java"
click node_adminapi "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/AdminDashboardController.java"
click node_jwtfilter "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/security/JwtAuthenticationFilter.java"
click node_authservice "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/AuthService.java"
click node_userdetails "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/CustomUserDetailsService.java"
click node_cart "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/CartService.java"
click node_address "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ShippingAddressService.java"
click node_orders "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/OrderService.java"
click node_payments "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/PaymentService.java"
click node_email "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/EmailService.java"
click node_wishlist "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/WishlistService.java"
click node_products "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ProductService.java"
click node_categories "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/CategoryService.java"
click node_reviews "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ReviewService.java"
click node_images "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ImageStorageService.java"
click node_users "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/UserService.java"
click node_dashboard "https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/AdminDashboardService.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_authapi,node_shopapi,node_catalogapi,node_adminapi toneBlue
class node_jwtfilter,node_authservice,node_userdetails,node_users,node_db toneAmber
class node_cart,node_address,node_orders,node_payments,node_email,node_wishlist toneMint
class node_products,node_categories,node_reviews,node_images toneRose
class node_dashboard,node_customer,node_smtp toneIndigo
```

## Components

### REST API

- [Authentication API](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/AuthController.java): `src/main/java/com/dreamcart/backend/controller/AuthController.java`
- [Shopping APIs](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/OrderController.java): `src/main/java/com/dreamcart/backend/controller/OrderController.java`
- [Catalog APIs](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/ProductController.java): `src/main/java/com/dreamcart/backend/controller/ProductController.java`
- [Admin APIs](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/controller/AdminDashboardController.java): `src/main/java/com/dreamcart/backend/controller/AdminDashboardController.java`

### Identity & Access

- [JWT Request Filter](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/security/JwtAuthenticationFilter.java): `src/main/java/com/dreamcart/backend/security/JwtAuthenticationFilter.java`
- [Auth Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/AuthService.java): `src/main/java/com/dreamcart/backend/service/AuthService.java`
- [User Lookup](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/CustomUserDetailsService.java): `src/main/java/com/dreamcart/backend/service/CustomUserDetailsService.java`
- [User Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/UserService.java): `src/main/java/com/dreamcart/backend/service/UserService.java`

### Shopping & Checkout

- [Cart Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/CartService.java): `src/main/java/com/dreamcart/backend/service/CartService.java`
- [Address Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ShippingAddressService.java): `src/main/java/com/dreamcart/backend/service/ShippingAddressService.java`
- [Order Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/OrderService.java): `src/main/java/com/dreamcart/backend/service/OrderService.java`
- [Payment Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/PaymentService.java): `src/main/java/com/dreamcart/backend/service/PaymentService.java`
- [Order Email](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/EmailService.java): `src/main/java/com/dreamcart/backend/service/EmailService.java`
- [Wishlist Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/WishlistService.java): `src/main/java/com/dreamcart/backend/service/WishlistService.java`

### Catalog & Feedback

- [Product Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ProductService.java): `src/main/java/com/dreamcart/backend/service/ProductService.java`
- [Category Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/CategoryService.java): `src/main/java/com/dreamcart/backend/service/CategoryService.java`
- [Review Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ReviewService.java): `src/main/java/com/dreamcart/backend/service/ReviewService.java`
- [Image Storage](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/ImageStorageService.java): `src/main/java/com/dreamcart/backend/service/ImageStorageService.java`

### Administration

- [Dashboard Service](https://github.com/sushilranavare/dreamcart-backend/blob/master/src/main/java/com/dreamcart/backend/service/AdminDashboardService.java): `src/main/java/com/dreamcart/backend/service/AdminDashboardService.java`

### Other components

- **Customer / Admin**
- **PostgreSQL**
- **SMTP Mail**

## Connections

- Customer / Admin → Authentication API: register / login
- Authentication API → Auth Service: delegates (evidence: `src/main/java/com/dreamcart/backend/service/AuthService.java`)
- Auth Service → PostgreSQL: reads / saves users (evidence: `src/main/java/com/dreamcart/backend/service/AuthService.java`)
- Auth Service → JWT Request Filter: generates JWT (evidence: `src/main/java/com/dreamcart/backend/service/AuthService.java`)
- Customer / Admin → JWT Request Filter: Bearer requests
- JWT Request Filter → User Lookup: loads user (evidence: `src/main/java/com/dreamcart/backend/security/JwtAuthenticationFilter.java`)
- User Lookup → PostgreSQL: loads account
- Customer / Admin → Catalog APIs: browse catalog
- Catalog APIs → Product Service: delegates (evidence: `src/main/java/com/dreamcart/backend/controller/ProductController.java`)
- Product Service → PostgreSQL: searches / saves (evidence: `src/main/java/com/dreamcart/backend/service/ProductService.java`)
- Product Service → Image Storage: stores image (evidence: `src/main/java/com/dreamcart/backend/service/ProductService.java`)
- Customer / Admin → Shopping APIs: cart / checkout
- Shopping APIs → Cart Service: delegates
- Cart Service → PostgreSQL: reads / saves cart (evidence: `src/main/java/com/dreamcart/backend/service/CartService.java`)
- Shopping APIs → Address Service: manages addresses
- Shopping APIs → Order Service: places orders
- Order Service → PostgreSQL: locks stock; saves order
- Shopping APIs → Payment Service: initiates payment
- Payment Service → PostgreSQL: saves payment; updates order
- Payment Service → Order Email: queues confirmation
- Order Email → SMTP Mail: sends email
- Customer / Admin → Shopping APIs: wishlist actions
- Customer / Admin → Catalog APIs: reviews products
- Catalog APIs → Review Service: delegates
- Customer / Admin → Admin APIs: admin operations
- Admin APIs → Dashboard Service: requests statistics
- Admin APIs → Product Service: manages products
- Admin APIs → Category Service: manages categories
- Admin APIs → User Service: manages users
- Dashboard Service → PostgreSQL: reads statistics
