How kavyachitluriii/shopease works
ShopEase is a React storefront backed by a Spring Boot API and MongoDB. Shoppers browse and filter products, add items to a locally persisted cart, simulate payment, and view orders; merchants manage inventory, while admins manage users and platform data. Authentication uses JWTs and role-based route protection. The graph includes the documented product areas, but some page and controller implementations were not excerpted, so their API connections are shown as unverified rather than asserted.
Main entry points: api.js API Client · App.jsx App Routing · Cart.jsx Cart & Checkout · CartContext.jsx Cart State
Components 24
Storefront
- App Routing
frontend/src/App.jsx - Homepage
frontend/src/pages/Home.jsx - Product Explorer
frontend/src/pages/Products.jsx - Product Details
frontend/src/components/ProductDetailModal.jsx - Cart State
frontend/src/context/CartContext.jsx - Cart & Checkout
frontend/src/pages/Cart.jsx - Payment Modal
frontend/src/components/FakeRazorpayModal.jsx - Order History
frontend/src/pages/MyOrders.jsx - Notifications
frontend/src/components/Toast.jsx
Commerce Portals
- Merchant Portal
frontend/src/pages/MerchantDashboard.jsx - Admin Portal
frontend/src/pages/AdminDashboard.jsx
Backend API
- API Client
frontend/src/services/api.js - Admin API
backend/src/main/java/com/shopease/backend/controllers/AdminController.java - Product API
backend/src/main/java/com/shopease/backend/controllers/ProductController.java - Order API
backend/src/main/java/com/shopease/backend/controllers/OrderController.java
Identity & Security
- Auth Context
frontend/src/context/AuthContext.jsx - Authentication API
backend/src/main/java/com/shopease/backend/controllers/AuthController.java - JWT Utilities
backend/src/main/java/com/shopease/backend/security/JwtUtils.java - User Details
backend/src/main/java/com/shopease/backend/security/UserDetailsServiceImpl.java
MongoDB Persistence
- User Repository
backend/src/main/java/com/shopease/backend/repositories/UserRepository.java - Product Repository
backend/src/main/java/com/shopease/backend/repositories/ProductRepository.java - Order Repository
backend/src/main/java/com/shopease/backend/repositories/OrderRepository.java
Other components
- Shopper
- MongoDB
Connections 33
- Shopper → App Routing: uses
frontend/src/App.jsx - App Routing → Homepage: routes to
frontend/src/App.jsx - App Routing → Product Explorer: routes to
frontend/src/App.jsx - App Routing → Cart & Checkout: protects route
frontend/src/App.jsx - App Routing → Order History: protects route
frontend/src/App.jsx - App Routing → Merchant Portal: role-gates
frontend/src/App.jsx - App Routing → Admin Portal: role-gates
frontend/src/App.jsx - Product Explorer → Product Details: opens details
frontend/src/pages/Products.jsx - Product Explorer → Cart State: adds products
frontend/src/pages/Products.jsx - Product Details → Cart State: adds products
frontend/src/components/ProductDetailModal.jsx - Cart & Checkout → Cart State: updates cart
frontend/src/pages/Cart.jsx - Cart & Checkout → Payment Modal: opens payment
frontend/src/pages/Cart.jsx - Cart State → MongoDB: persists locally
frontend/src/context/CartContext.jsx - Auth Context → API Client: calls
frontend/src/context/AuthContext.jsx - Auth Context → Authentication API: requests auth
- Cart & Checkout → API Client: requests orders
frontend/src/pages/Cart.jsx - Order History → API Client: requests history
frontend/src/pages/MyOrders.jsx - Merchant Portal → API Client: requests inventory
frontend/src/pages/MerchantDashboard.jsx - Admin Portal → API Client: requests admin data
frontend/src/pages/AdminDashboard.jsx - API Client → Product API: sends API requests
- API Client → Order API: sends API requests
- API Client → Admin API: sends API requests
- Authentication API → JWT Utilities: creates tokens
backend/src/main/java/com/shopease/backend/controllers/AuthController.java - Authentication API → User Repository: reads and saves
backend/src/main/java/com/shopease/backend/controllers/AuthController.java - Admin API → User Repository: manages users
backend/src/main/java/com/shopease/backend/controllers/AdminController.java - Product API → Product Repository: accesses products
backend/src/main/java/com/shopease/backend/controllers/ProductController.java - Order API → Order Repository: accesses orders
backend/src/main/java/com/shopease/backend/controllers/OrderController.java - User Details → User Repository: loads users
backend/src/main/java/com/shopease/backend/security/UserDetailsServiceImpl.java - User Repository → MongoDB: stores users
- Product Repository → MongoDB: stores products
- Order Repository → MongoDB: stores orders
- Cart & Checkout → Notifications: shows notices
frontend/src/pages/Cart.jsx - Admin Portal → Notifications: shows notices
frontend/src/pages/AdminDashboard.jsx