How nafiaut/novamarket-backend works
NovaMarket is a Spring REST e-commerce backend. A client authenticates or registers, then browses the cached and searchable catalog, manages a persistent cart, and checks out into an order with stock validation and price snapshots. The map preserves those domain stages and the JWT/RBAC and centralized-error layers. The README documents the broad request/security flow and capabilities; source-index references and excerpts support the more specific service and repository links. Unsampled implementation details are not inferred.
Main entry points: ProductService.java Product Catalog · OrderService.java Order Checkout · CategoryService.java Category Service · CartService.java Cart Service
Components 26
REST API
- Auth Endpoints
src/main/java/com/novamarket/controller/AuthController.java - Catalog Endpoints
src/main/java/com/novamarket/controller/ProductController.java - Category Endpoints
src/main/java/com/novamarket/controller/CategoryController.java - Cart Endpoints
src/main/java/com/novamarket/controller/CartController.java - Order Endpoints
src/main/java/com/novamarket/controller/OrderController.java - Health Endpoint
src/main/java/com/novamarket/controller/HealthController.java
Identity & Security
- JWT Security
src/main/java/com/novamarket/config/SecurityConfig.java - JWT Filter
src/main/java/com/novamarket/security/JwtAuthenticationFilter.java - JWT Utilities
src/main/java/com/novamarket/security/JwtUtils.java - User Details
src/main/java/com/novamarket/security/CustomUserDetailsService.java - Auth Service
src/main/java/com/novamarket/service/AuthService.java
Commerce Services
- Product Catalog
src/main/java/com/novamarket/service/ProductService.java - Category Service
src/main/java/com/novamarket/service/CategoryService.java - Cart Service
src/main/java/com/novamarket/service/CartService.java - Order Checkout
src/main/java/com/novamarket/service/OrderService.java
Persistence & Domain
- Product Repository
src/main/java/com/novamarket/repository/ProductRepository.java - Category Repository
src/main/java/com/novamarket/repository/CategoryRepository.java - Cart Repository
src/main/java/com/novamarket/repository/CartRepository.java - Order Repository
src/main/java/com/novamarket/repository/OrderRepository.java - User Repository
src/main/java/com/novamarket/repository/UserRepository.java - Commerce Entities
src/main/java/com/novamarket/model - SQL Database
Runtime Support
- Caffeine Cache
src/main/java/com/novamarket/config/CacheConfig.java - Error Mapping
src/main/java/com/novamarket/exception/GlobalExceptionHandler.java - OpenAPI Setup
src/main/java/com/novamarket/config/OpenApiConfig.java
Other components
- API Client
Connections 35
- API Client → JWT Security: sends requests
- JWT Security → JWT Filter: filters requests
- JWT Filter → JWT Utilities: validates tokens
src/main/java/com/novamarket/security/JwtAuthenticationFilter.java - JWT Filter → User Details: loads identity
src/main/java/com/novamarket/security/JwtAuthenticationFilter.java - JWT Security → Auth Endpoints: routes authorized
- API Client → Auth Endpoints: authenticates
- Auth Endpoints → Auth Service: delegates to
src/main/java/com/novamarket/controller/AuthController.java - Auth Service → User Repository: reads and saves
src/main/java/com/novamarket/service/AuthService.java - Auth Service → JWT Utilities: issues tokens
src/main/java/com/novamarket/service/AuthService.java - User Details → User Repository: loads user
src/main/java/com/novamarket/security/CustomUserDetailsService.java - API Client → Catalog Endpoints: browses catalog
- Catalog Endpoints → Product Catalog: delegates to
src/main/java/com/novamarket/controller/ProductController.java - Category Endpoints → Category Service: delegates to
src/main/java/com/novamarket/controller/CategoryController.java - Product Catalog → Product Repository: queries products
src/main/java/com/novamarket/service/ProductService.java - Product Catalog → Category Service: validates category
src/main/java/com/novamarket/service/ProductService.java - Category Service → Category Repository: queries categories
src/main/java/com/novamarket/service/CategoryService.java - Product Catalog → Caffeine Cache: caches catalog
src/main/java/com/novamarket/service/ProductService.java - Category Service → Caffeine Cache: caches categories
src/main/java/com/novamarket/service/CategoryService.java - API Client → Cart Endpoints: manages cart
- Cart Endpoints → Cart Service: delegates to
src/main/java/com/novamarket/controller/CartController.java - Cart Service → Cart Repository: loads and saves
src/main/java/com/novamarket/service/CartService.java - Cart Service → Product Repository: checks product stock
src/main/java/com/novamarket/service/CartService.java - API Client → Order Endpoints: checks out
- Order Endpoints → Order Checkout: delegates to
src/main/java/com/novamarket/controller/OrderController.java - Order Checkout → Cart Service: loads and clears cart
src/main/java/com/novamarket/service/OrderService.java - Order Checkout → Product Repository: checks and updates stock
src/main/java/com/novamarket/service/OrderService.java - Order Checkout → Order Repository: saves and queries orders
src/main/java/com/novamarket/service/OrderService.java - Product Repository → SQL Database: persists entities
- Category Repository → SQL Database: persists entities
- Cart Repository → SQL Database: persists entities
- Order Repository → SQL Database: persists entities
- User Repository → SQL Database: persists entities
- Error Mapping → API Client: formats errors
- API Client → Health Endpoint: checks health
- API Client → OpenAPI Setup: uses Swagger UI