# nafiaut/novamarket-backend architecture

> Architecture diagram of the GitHub repository nafiaut/novamarket-backend, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-10-04). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/nafiaut/novamarket-backend
- Repository: https://github.com/nafiaut/novamarket-backend

## Overview

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: [`src/main/java/com/novamarket/service/ProductService.java`](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/ProductService.java) (Product Catalog), [`src/main/java/com/novamarket/service/OrderService.java`](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/OrderService.java) (Order Checkout), [`src/main/java/com/novamarket/service/CategoryService.java`](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/CategoryService.java) (Category Service), [`src/main/java/com/novamarket/service/CartService.java`](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/CartService.java) (Cart Service)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_authcontroller["Auth Endpoints"]
  node_catalogapi["Catalog Endpoints"]
  node_categoryapi["Category Endpoints"]
  node_cartapi["Cart Endpoints"]
  node_orderapi["Order Endpoints"]
  node_health["Health Endpoint"]
end

subgraph group_identity["Identity &amp; Security"]
  node_security["JWT Security"]
  node_jwtfilter["JWT Filter"]
  node_jwtutils["JWT Utilities<br/>[JwtUtils.java]"]
  node_userdetails["User Details"]
  node_authservice["Auth Service<br/>[AuthService.java]"]
end

subgraph group_commerce["Commerce Services"]
  node_productservice["Product Catalog"]
  node_categoryservice["Category Service"]
  node_cartservice["Cart Service<br/>[CartService.java]"]
  node_orderservice["Order Checkout<br/>[OrderService.java]"]
end

subgraph group_data["Persistence &amp; Domain"]
  node_productrepo["Product Repository"]
  node_categoryrepo["Category Repository"]
  node_cartrepo["Cart Repository"]
  node_orderrepo["Order Repository"]
  node_userrepo["User Repository"]
  node_domain["Commerce Entities"]
  node_database[("SQL Database")]
end

subgraph group_platform["Runtime Support"]
  node_cache[("Caffeine Cache<br/>[CacheConfig.java]")]
  node_errors["Error Mapping"]
  node_openapi["OpenAPI Setup<br/>[OpenApiConfig.java]"]
end

node_client(("API Client"))

node_client -->|"sends requests"| node_security
node_security -->|"filters requests"| node_jwtfilter
node_jwtfilter -->|"validates tokens"| node_jwtutils
node_jwtfilter -->|"loads identity"| node_userdetails
node_security -->|"routes authorized"| node_authcontroller
node_client -->|"authenticates"| node_authcontroller
node_authcontroller -->|"delegates to"| node_authservice
node_authservice -->|"reads and saves"| node_userrepo
node_authservice -->|"issues tokens"| node_jwtutils
node_userdetails -->|"loads user"| node_userrepo
node_client -->|"browses catalog"| node_catalogapi
node_catalogapi -->|"delegates to"| node_productservice
node_categoryapi -->|"delegates to"| node_categoryservice
node_productservice -->|"queries products"| node_productrepo
node_productservice -->|"validates category"| node_categoryservice
node_categoryservice -->|"queries categories"| node_categoryrepo
node_productservice -->|"caches catalog"| node_cache
node_categoryservice -->|"caches categories"| node_cache
node_client -->|"manages cart"| node_cartapi
node_cartapi -->|"delegates to"| node_cartservice
node_cartservice -->|"loads and saves"| node_cartrepo
node_cartservice -->|"checks product stock"| node_productrepo
node_client -->|"checks out"| node_orderapi
node_orderapi -->|"delegates to"| node_orderservice
node_orderservice -->|"loads and clears cart"| node_cartservice
node_orderservice -->|"checks and updates stock"| node_productrepo
node_orderservice -->|"saves and queries orders"| node_orderrepo
node_productrepo -->|"persists entities"| node_database
node_categoryrepo -->|"persists entities"| node_database
node_cartrepo -->|"persists entities"| node_database
node_orderrepo -->|"persists entities"| node_database
node_userrepo -->|"persists entities"| node_database
node_errors -->|"formats errors"| node_client
node_client -->|"checks health"| node_health
node_client -->|"uses Swagger UI"| node_openapi

click node_security "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/config/SecurityConfig.java"
click node_jwtfilter "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/security/JwtAuthenticationFilter.java"
click node_jwtutils "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/security/JwtUtils.java"
click node_userdetails "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/security/CustomUserDetailsService.java"
click node_authcontroller "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/AuthController.java"
click node_authservice "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/AuthService.java"
click node_catalogapi "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/ProductController.java"
click node_categoryapi "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/CategoryController.java"
click node_productservice "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/ProductService.java"
click node_categoryservice "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/CategoryService.java"
click node_cartapi "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/CartController.java"
click node_cartservice "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/CartService.java"
click node_orderapi "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/OrderController.java"
click node_orderservice "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/OrderService.java"
click node_productrepo "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/ProductRepository.java"
click node_categoryrepo "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/CategoryRepository.java"
click node_cartrepo "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/CartRepository.java"
click node_orderrepo "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/OrderRepository.java"
click node_userrepo "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/UserRepository.java"
click node_domain "https://github.com/nafiaut/novamarket-backend/tree/main/src/main/java/com/novamarket/model"
click node_cache "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/config/CacheConfig.java"
click node_errors "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/exception/GlobalExceptionHandler.java"
click node_openapi "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/config/OpenApiConfig.java"
click node_health "https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/HealthController.java"

classDef toneNeutral fill:#f8fafc,stroke:#334155,stroke-width:1.5px,color:#0f172a
classDef toneBlue fill:#dbeafe,stroke:#2563eb,stroke-width:1.5px,color:#172554
classDef toneAmber fill:#fef3c7,stroke:#d97706,stroke-width:1.5px,color:#78350f
classDef toneMint fill:#dcfce7,stroke:#16a34a,stroke-width:1.5px,color:#14532d
classDef toneRose fill:#ffe4e6,stroke:#e11d48,stroke-width:1.5px,color:#881337
classDef toneIndigo fill:#e0e7ff,stroke:#4f46e5,stroke-width:1.5px,color:#312e81
classDef toneTeal fill:#ccfbf1,stroke:#0f766e,stroke-width:1.5px,color:#134e4a
class node_authcontroller,node_catalogapi,node_categoryapi,node_cartapi,node_orderapi,node_health,node_client toneBlue
class node_security,node_jwtfilter,node_jwtutils,node_userdetails,node_authservice toneAmber
class node_productservice,node_categoryservice,node_cartservice,node_orderservice toneMint
class node_productrepo,node_categoryrepo,node_cartrepo,node_orderrepo,node_userrepo,node_domain,node_database toneRose
class node_cache,node_errors,node_openapi toneIndigo
```

## Components

### REST API

- [Auth Endpoints](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/AuthController.java): `src/main/java/com/novamarket/controller/AuthController.java`
- [Catalog Endpoints](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/ProductController.java): `src/main/java/com/novamarket/controller/ProductController.java`
- [Category Endpoints](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/CategoryController.java): `src/main/java/com/novamarket/controller/CategoryController.java`
- [Cart Endpoints](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/CartController.java): `src/main/java/com/novamarket/controller/CartController.java`
- [Order Endpoints](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/OrderController.java): `src/main/java/com/novamarket/controller/OrderController.java`
- [Health Endpoint](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/controller/HealthController.java): `src/main/java/com/novamarket/controller/HealthController.java`

### Identity & Security

- [JWT Security](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/config/SecurityConfig.java): `src/main/java/com/novamarket/config/SecurityConfig.java`
- [JWT Filter](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/security/JwtAuthenticationFilter.java): `src/main/java/com/novamarket/security/JwtAuthenticationFilter.java`
- [JWT Utilities](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/security/JwtUtils.java): `src/main/java/com/novamarket/security/JwtUtils.java`
- [User Details](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/security/CustomUserDetailsService.java): `src/main/java/com/novamarket/security/CustomUserDetailsService.java`
- [Auth Service](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/AuthService.java): `src/main/java/com/novamarket/service/AuthService.java`

### Commerce Services

- [Product Catalog](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/ProductService.java): `src/main/java/com/novamarket/service/ProductService.java`
- [Category Service](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/CategoryService.java): `src/main/java/com/novamarket/service/CategoryService.java`
- [Cart Service](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/CartService.java): `src/main/java/com/novamarket/service/CartService.java`
- [Order Checkout](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/service/OrderService.java): `src/main/java/com/novamarket/service/OrderService.java`

### Persistence & Domain

- [Product Repository](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/ProductRepository.java): `src/main/java/com/novamarket/repository/ProductRepository.java`
- [Category Repository](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/CategoryRepository.java): `src/main/java/com/novamarket/repository/CategoryRepository.java`
- [Cart Repository](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/CartRepository.java): `src/main/java/com/novamarket/repository/CartRepository.java`
- [Order Repository](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/OrderRepository.java): `src/main/java/com/novamarket/repository/OrderRepository.java`
- [User Repository](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/repository/UserRepository.java): `src/main/java/com/novamarket/repository/UserRepository.java`
- [Commerce Entities](https://github.com/nafiaut/novamarket-backend/tree/main/src/main/java/com/novamarket/model): `src/main/java/com/novamarket/model`
- **SQL Database**

### Runtime Support

- [Caffeine Cache](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/config/CacheConfig.java): `src/main/java/com/novamarket/config/CacheConfig.java`
- [Error Mapping](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/exception/GlobalExceptionHandler.java): `src/main/java/com/novamarket/exception/GlobalExceptionHandler.java`
- [OpenAPI Setup](https://github.com/nafiaut/novamarket-backend/blob/main/src/main/java/com/novamarket/config/OpenApiConfig.java): `src/main/java/com/novamarket/config/OpenApiConfig.java`

### Other components

- **API Client**

## Connections

- API Client → JWT Security: sends requests
- JWT Security → JWT Filter: filters requests
- JWT Filter → JWT Utilities: validates tokens (evidence: `src/main/java/com/novamarket/security/JwtAuthenticationFilter.java`)
- JWT Filter → User Details: loads identity (evidence: `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 (evidence: `src/main/java/com/novamarket/controller/AuthController.java`)
- Auth Service → User Repository: reads and saves (evidence: `src/main/java/com/novamarket/service/AuthService.java`)
- Auth Service → JWT Utilities: issues tokens (evidence: `src/main/java/com/novamarket/service/AuthService.java`)
- User Details → User Repository: loads user (evidence: `src/main/java/com/novamarket/security/CustomUserDetailsService.java`)
- API Client → Catalog Endpoints: browses catalog
- Catalog Endpoints → Product Catalog: delegates to (evidence: `src/main/java/com/novamarket/controller/ProductController.java`)
- Category Endpoints → Category Service: delegates to (evidence: `src/main/java/com/novamarket/controller/CategoryController.java`)
- Product Catalog → Product Repository: queries products (evidence: `src/main/java/com/novamarket/service/ProductService.java`)
- Product Catalog → Category Service: validates category (evidence: `src/main/java/com/novamarket/service/ProductService.java`)
- Category Service → Category Repository: queries categories (evidence: `src/main/java/com/novamarket/service/CategoryService.java`)
- Product Catalog → Caffeine Cache: caches catalog (evidence: `src/main/java/com/novamarket/service/ProductService.java`)
- Category Service → Caffeine Cache: caches categories (evidence: `src/main/java/com/novamarket/service/CategoryService.java`)
- API Client → Cart Endpoints: manages cart
- Cart Endpoints → Cart Service: delegates to (evidence: `src/main/java/com/novamarket/controller/CartController.java`)
- Cart Service → Cart Repository: loads and saves (evidence: `src/main/java/com/novamarket/service/CartService.java`)
- Cart Service → Product Repository: checks product stock (evidence: `src/main/java/com/novamarket/service/CartService.java`)
- API Client → Order Endpoints: checks out
- Order Endpoints → Order Checkout: delegates to (evidence: `src/main/java/com/novamarket/controller/OrderController.java`)
- Order Checkout → Cart Service: loads and clears cart (evidence: `src/main/java/com/novamarket/service/OrderService.java`)
- Order Checkout → Product Repository: checks and updates stock (evidence: `src/main/java/com/novamarket/service/OrderService.java`)
- Order Checkout → Order Repository: saves and queries orders (evidence: `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
