How dharnezz/digital-market-place works
This is a full-stack digital-products marketplace: React pages consume a Spring REST API that enforces authentication, seller ownership, moderation, transaction rules, and download authorization. The principal buyer workflow is product discovery → cart → checkout → payment → order → purchase entitlement → digital library and authorized download. Sellers manage listings and admins moderate pending products; verified buyers can review products. The README documents the layered backend and these capabilities. Several subsystem links below reflect README documentation; unsampled implementation details are not asserted.
Main entry points: pages Feature pages · repository Repositories · App.jsx React SPA · ProductService.java Product rules
Components 24
React application
- React SPA
frontend/src/App.jsx - Route guards
frontend/src/routes/AppRoutes.jsx - Feature pages
frontend/src/pages - API client
frontend/src/services/api.js - Auth state
frontend/src/context/AuthContext.jsx
Identity and access
- Auth endpoints
backend/src/main/java/com/digitalmarketplace/controller/AuthController.java - JWT security
backend/src/main/java/com/digitalmarketplace/security
Catalog and moderation
- Product endpoints
backend/src/main/java/com/digitalmarketplace/controller/ProductController.java - Product rules
backend/src/main/java/com/digitalmarketplace/service/ProductService.java - Admin moderation
backend/src/main/java/com/digitalmarketplace/controller/ProductModerationController.java - Category service
backend/src/main/java/com/digitalmarketplace/service/CategoryService.java
Buying and delivery
- Cart service
backend/src/main/java/com/digitalmarketplace/service/CartService.java - Order service
backend/src/main/java/com/digitalmarketplace/service/OrderService.java - Payment service
backend/src/main/java/com/digitalmarketplace/service/PaymentService.java - Payment processor
backend/src/main/java/com/digitalmarketplace/service/payment/MockPaymentProcessor.java - Purchase entitlements
backend/src/main/java/com/digitalmarketplace/service/PurchaseEntitlementService.java - Library and download
backend/src/main/java/com/digitalmarketplace/controller/DigitalLibraryController.java - Verified-buyer reviews
backend/src/main/java/com/digitalmarketplace/service/ReviewService.java
Backend data and services
- Repositories
backend/src/main/java/com/digitalmarketplace/repository - Marketplace database
backend/src/main/java/com/digitalmarketplace/entity
Other components
- Buyer
- Seller
- Admin
- External file storage
Connections 31
- Buyer → React SPA: browses and buys
README.md - Seller → React SPA: manages listings
README.md - Admin → React SPA: moderates listings
README.md - React SPA → Route guards: loads routes
frontend/src/App.jsx - Route guards → Feature pages: routes to
frontend/src/routes/AppRoutes.jsx - Feature pages → API client: requests data
README.md - React SPA → Auth state: provides auth state
frontend/src/App.jsx - API client → Auth endpoints: calls REST API
README.md - Auth endpoints → JWT security: issues JWT
backend/src/main/java/com/digitalmarketplace/controller/AuthController.java - Product endpoints → Product rules: delegates rules
README.md - Product rules → Repositories: queries listings
backend/src/main/java/com/digitalmarketplace/service/ProductService.java - Admin moderation → Product rules: moderates products
README.md - Product rules → Category service: uses categories
- Feature pages → Product endpoints: discovers products
README.md - Feature pages → Cart service: manages cart
README.md - Cart service → Repositories: reads and writes
backend/src/main/java/com/digitalmarketplace/service/CartService.java - Feature pages → Order service: checks out
README.md - Order service → Cart service: reads cart
backend/src/main/java/com/digitalmarketplace/service/OrderService.java - Order service → Product rules: validates products
backend/src/main/java/com/digitalmarketplace/service/OrderService.java - Order service → Repositories: persists orders
backend/src/main/java/com/digitalmarketplace/service/OrderService.java - Feature pages → Payment service: pays order
README.md - Payment service → Payment processor: dispatches payment
README.md - Payment service → Purchase entitlements: grants purchase
README.md - Feature pages → Library and download: views purchases
README.md - Library and download → Purchase entitlements: checks authorization
README.md - Purchase entitlements → Repositories: stores entitlements
README.md - Library and download → External file storage: authorizes file access
- Feature pages → Verified-buyer reviews: reads and submits reviews
README.md - Verified-buyer reviews → Repositories: reads and writes
backend/src/main/java/com/digitalmarketplace/service/ReviewService.java - Verified-buyer reviews → Purchase entitlements: verifies purchase
backend/src/main/java/com/digitalmarketplace/service/ReviewService.java - Repositories → Marketplace database: persists entities
README.md