How sushilranavare/dreamcart-backend works
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: OrderController.java Shopping APIs · AdminDashboardController.java Admin APIs · ProductController.java Catalog APIs · ProductService.java Product Service
Components 22
REST API
- Authentication API
src/main/java/com/dreamcart/backend/controller/AuthController.java - Shopping APIs
src/main/java/com/dreamcart/backend/controller/OrderController.java - Catalog APIs
src/main/java/com/dreamcart/backend/controller/ProductController.java - Admin APIs
src/main/java/com/dreamcart/backend/controller/AdminDashboardController.java
Identity & Access
- JWT Request Filter
src/main/java/com/dreamcart/backend/security/JwtAuthenticationFilter.java - Auth Service
src/main/java/com/dreamcart/backend/service/AuthService.java - User Lookup
src/main/java/com/dreamcart/backend/service/CustomUserDetailsService.java - User Service
src/main/java/com/dreamcart/backend/service/UserService.java
Shopping & Checkout
- Cart Service
src/main/java/com/dreamcart/backend/service/CartService.java - Address Service
src/main/java/com/dreamcart/backend/service/ShippingAddressService.java - Order Service
src/main/java/com/dreamcart/backend/service/OrderService.java - Payment Service
src/main/java/com/dreamcart/backend/service/PaymentService.java - Order Email
src/main/java/com/dreamcart/backend/service/EmailService.java - Wishlist Service
src/main/java/com/dreamcart/backend/service/WishlistService.java
Catalog & Feedback
- Product Service
src/main/java/com/dreamcart/backend/service/ProductService.java - Category Service
src/main/java/com/dreamcart/backend/service/CategoryService.java - Review Service
src/main/java/com/dreamcart/backend/service/ReviewService.java - Image Storage
src/main/java/com/dreamcart/backend/service/ImageStorageService.java
Administration
- Dashboard Service
src/main/java/com/dreamcart/backend/service/AdminDashboardService.java
Other components
- Customer / Admin
- PostgreSQL
- SMTP Mail
Connections 30
- Customer / Admin → Authentication API: register / login
- Authentication API → Auth Service: delegates
src/main/java/com/dreamcart/backend/service/AuthService.java - Auth Service → PostgreSQL: reads / saves users
src/main/java/com/dreamcart/backend/service/AuthService.java - Auth Service → JWT Request Filter: generates JWT
src/main/java/com/dreamcart/backend/service/AuthService.java - Customer / Admin → JWT Request Filter: Bearer requests
- JWT Request Filter → User Lookup: loads user
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
src/main/java/com/dreamcart/backend/controller/ProductController.java - Product Service → PostgreSQL: searches / saves
src/main/java/com/dreamcart/backend/service/ProductService.java - Product Service → Image Storage: stores image
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
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