How spect-apple/cyberopus---e-commerce-book-shop works
CyberOpus is a full-stack online bookstore. Customers browse and filter books, manage a cart and addresses, check out with simulated payment and reward-point redemption, then view orders; the app also supports authentication, wishlists, recommendations, and admin catalog management. The graph shows the documented React-to-REST boundary and the sampled category, catalog, authentication, cart, and checkout behavior. Several backend controllers and services are unsampled, so their internal links are omitted rather than inferred.
Main entry points: api API clients · CheckoutService.java Checkout service · App.tsx React routes · AuthService.java Auth service
Components 23
Web experience
- React routes
frontend/src/App.tsx - Storefront pages
frontend/src/pages - Customer pages
frontend/src/pages - Admin pages
frontend/src/pages/admin - API clients
frontend/src/api - Cart state
frontend/src/contexts/CartContext.tsx
Identity and access
- Auth context
frontend/src/contexts/AuthContext.tsx - Auth endpoints
backend/src/main/java/com/cyberopus/controller/AuthController.java - Auth service
backend/src/main/java/com/cyberopus/service/AuthService.java - JWT security
backend/src/main/java/com/cyberopus/security
Book catalog
- Catalog pages
frontend/src/pages - Catalog endpoints
backend/src/main/java/com/cyberopus/controller - Book service
backend/src/main/java/com/cyberopus/service/BookService.java
Shopping and orders
- Cart service
backend/src/main/java/com/cyberopus/service/CartService.java - Checkout and orders
frontend/src/pages - Checkout endpoint
backend/src/main/java/com/cyberopus/controller/CheckoutController.java - Checkout service
backend/src/main/java/com/cyberopus/service/CheckoutService.java - Order reward services
backend/src/main/java/com/cyberopus/service
Backend persistence
- Book repository
backend/src/main/java/com/cyberopus/repository/BookRepository.java - Commerce repositories
backend/src/main/java/com/cyberopus/repository - User repository
backend/src/main/java/com/cyberopus/repository/UserRepository.java
Other components
- Shopper
- Administrator
Connections 27
- Shopper → React routes: uses
frontend/src/App.tsx - Administrator → React routes: uses
frontend/src/App.tsx - React routes → Storefront pages: routes to
frontend/src/App.tsx - React routes → Customer pages: routes to
frontend/src/App.tsx - React routes → Admin pages: routes to
frontend/src/App.tsx - Storefront pages → API clients: requests data
frontend/src/pages/CheckoutPage.tsx - Customer pages → API clients: requests data
frontend/src/pages/CheckoutPage.tsx - Admin pages → API clients: requests data
- Auth context → API clients: requests auth
frontend/src/contexts/AuthContext.tsx - Cart state → API clients: calls cart API
frontend/src/contexts/CartContext.tsx - API clients → Auth endpoints: calls REST API
README.md - API clients → Catalog endpoints: calls REST API
README.md - API clients → Checkout endpoint: calls REST API
README.md - Catalog pages → API clients: requests catalog
frontend/src/pages/CheckoutPage.tsx - Auth endpoints → Auth service: delegates to
- Auth service → User repository: reads and writes
backend/src/main/java/com/cyberopus/service/AuthService.java - Auth service → JWT security: generates token
backend/src/main/java/com/cyberopus/service/AuthService.java - Catalog endpoints → Book service: delegates to
backend/src/main/java/com/cyberopus/controller/CategoryController.java - Catalog endpoints → Book repository: reads and writes
backend/src/main/java/com/cyberopus/controller/CategoryController.java - Book service → Book repository: queries books
backend/src/main/java/com/cyberopus/service/BookService.java - Checkout and orders → API clients: requests checkout
frontend/src/pages/CheckoutPage.tsx - Checkout endpoint → Checkout service: delegates to
- Checkout service → Commerce repositories: reads and writes
backend/src/main/java/com/cyberopus/service/CheckoutService.java - Checkout service → User repository: loads user
backend/src/main/java/com/cyberopus/service/CheckoutService.java - Checkout service → Book repository: locks and updates stock
backend/src/main/java/com/cyberopus/service/CheckoutService.java - Checkout service → Order reward services: earns points
backend/src/main/java/com/cyberopus/service/CheckoutService.java - Order reward services → Commerce repositories: persists commerce data
backend/src/main/java/com/cyberopus/service/AuthService.java