How muhammadhmunas92-rgb/shopio-ecommerce- works
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: client.js API Client · ProductService.java Product Service · OrderService.java Order Service · UserService.java User Service
Components 25
Storefront
- Storefront App
frontend/src/App.jsx - API Client
frontend/src/api/client.js
Identity & Shopping
- Auth Context
frontend/src/context/AuthContext.jsx - Cart Context
frontend/src/context/CartContext.jsx - Wishlist Context
frontend/src/context/WishlistContext.jsx
REST API
- Auth API
backend/src/main/java/com/forme/ecommerce/controller/AuthController.java - Catalog API
backend/src/main/java/com/forme/ecommerce/controller/ProductController.java - Cart API
backend/src/main/java/com/forme/ecommerce/controller/CartController.java - Order API
backend/src/main/java/com/forme/ecommerce/controller/OrderController.java - Category API
backend/src/main/java/com/forme/ecommerce/controller/CategoryController.java - Favorites API
backend/src/main/java/com/forme/ecommerce/controller/FavoriteController.java - Reviews API
backend/src/main/java/com/forme/ecommerce/controller/ReviewController.java
Commerce Services
- User Service
backend/src/main/java/com/forme/ecommerce/service/UserService.java - Product Service
backend/src/main/java/com/forme/ecommerce/service/ProductService.java - Cart Service
backend/src/main/java/com/forme/ecommerce/service/CartService.java - Order Service
backend/src/main/java/com/forme/ecommerce/service/OrderService.java - Review Service
backend/src/main/java/com/forme/ecommerce/service/ReviewService.java - Category Service
backend/src/main/java/com/forme/ecommerce/service/CategoryService.java - Favorite Service
backend/src/main/java/com/forme/ecommerce/service/FavoriteService.java
Persistence
- Catalog & Reviews
backend/src/main/java/com/forme/ecommerce/repository/ProductRepository.java - User Records
backend/src/main/java/com/forme/ecommerce/repository/UserRepository.java - Cart Records
backend/src/main/java/com/forme/ecommerce/repository/CartItemRepository.java - Order Records
backend/src/main/java/com/forme/ecommerce/repository/OrderRepository.java - H2 Database
Other components
- Shopper
Connections 30
- Shopper → Storefront App: uses
frontend/src/App.jsx - Storefront App → API Client: fetches catalog
frontend/src/App.jsx - Storefront App → Auth Context: provides context
frontend/src/App.jsx - Auth Context → API Client: authenticates
frontend/src/context/AuthContext.jsx - Cart Context → API Client: uses API
frontend/src/context/CartContext.jsx - API Client → Auth API: HTTP requests
README.md - API Client → Catalog API: HTTP requests
README.md - API Client → Cart API: HTTP requests
README.md - API Client → Order API: HTTP requests
README.md - API Client → Category API: HTTP requests
- API Client → Favorites API: HTTP requests
- API Client → Reviews API: HTTP requests
frontend/src/api/client.js - Auth API → User Service: delegates to
- Catalog API → Product Service: delegates to
backend/src/main/java/com/forme/ecommerce/controller/ProductController.java - Cart API → Cart Service: delegates to
backend/src/main/java/com/forme/ecommerce/controller/CartController.java - Order API → Order Service: delegates to
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
backend/src/main/java/com/forme/ecommerce/controller/ReviewController.java - User Service → User Records: reads and writes
backend/src/main/java/com/forme/ecommerce/service/UserService.java - Product Service → Catalog & Reviews: queries catalog
backend/src/main/java/com/forme/ecommerce/service/ProductService.java - Product Service → Catalog & Reviews: reads ratings
backend/src/main/java/com/forme/ecommerce/service/ProductService.java - Cart Service → Cart Records: updates cart
backend/src/main/java/com/forme/ecommerce/service/CartService.java - Order Service → Order Records: persists orders
backend/src/main/java/com/forme/ecommerce/service/OrderService.java - Order Service → Cart Records: clears cart
backend/src/main/java/com/forme/ecommerce/service/OrderService.java - Review Service → Catalog & Reviews: stores reviews
backend/src/main/java/com/forme/ecommerce/service/ReviewService.java - Review Service → User Service: loads reviewer
backend/src/main/java/com/forme/ecommerce/service/ReviewService.java - Product Service → H2 Database: persists via JPA
README.md - Order Service → H2 Database: persists via JPA
README.md - User Service → H2 Database: persists via JPA
README.md