# sandeepkumar-s-18/bookstore-management-system architecture

> Architecture diagram of the GitHub repository sandeepkumar-s-18/bookstore-management-system, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2025-10-26). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/sandeepkumar-s-18/bookstore-management-system
- Repository: https://github.com/sandeepkumar-s-18/bookstore-management-system

## Overview

##### Project type and purpose
- This is a backend-only RESTful API for a Bookstore Management System built with Java 21 and Spring Boot.
- It exposes endpoints for book CRUD, user authentication (JWT), order processing, pagination/search, and Swagger docs.

##### File structure
- Top-level: pom.xml, Maven wrappers, README.
- src/main/java/com/bookstore: standard Spring Boot layout with subpackages:
- controller – REST API entry points (AuthController, BookController, OrderController)
- dto – request/response payloads
- entity – JPA entities (Book, User, Order, OrderItem)
- enumClassess – domain enums (OrderStatus, PaymentStatus, Role)
- repository – Spring Data JPA interfaces (BookRepository, UserRepository, OrderRepository)
- service & serviceImpl – business logic interfaces and implementations (AuthService, BookService, OrderService)
- security – JWT util, filter, userDetailsService, Spring Security config
- exception – global exception handler, custom ResourceNotFoundException
- src/main/resources/application.properties – DB & JWT config
- src/test – unit/integration test scaffold

##### Insights from the README
- Tech stack: Spring Boot, Spring Security + JWT, MySQL, JPA/Hibernate, Swagger/OpenAPI, Maven.
- Key features: role-based access (Customer/Admin), JWT auth, pagination, search, global error handling.

- Break the project into these components: Client, Security Filter, Controllers, Services, Repositories, Database, Utilities (JWT, Exception Handler, Swagger).
- Data flow (client request, token validation, service logic, DB access, response).
- Configuration (application.properties) off to the side as a note: “DB & JWT settings”.

## Diagram (Mermaid)

```mermaid
flowchart TB
    subgraph "Clients"
        Client["Web/Mobile Clients"]:::client
    end

    subgraph "Security Layer"
        JwtFilter["JwtAuthenticationFilter"]:::security
        SecurityConfig["SecurityConfig"]:::security
    end

    subgraph "API Layer"
        AuthController["AuthController"]:::controller
        BookController["BookController"]:::controller
        OrderController["OrderController"]:::controller
    end

    subgraph "Business Layer"
        AuthService["AuthService"]:::service
        BookService["BookService"]:::service
        OrderService["OrderService"]:::service
    end

    subgraph "Persistence Layer"
        BookRepo["BookRepository"]:::repository
        UserRepo["UserRepository"]:::repository
        OrderRepo["OrderRepository"]:::repository
    end

    subgraph "Utilities"
        JwtUtil["JwtUtil"]:::util
        CustomUserDetailsService["CustomUserDetailsService"]:::util
        GlobalExceptionHandler["GlobalExceptionHandler"]:::util
        SwaggerUI["Swagger UI"]:::util
    end

    subgraph "Database"
        MySQL["MySQL"]:::db
    end

    Config["application.properties"]:::config

    Client -->|HTTP/JSON| JwtFilter
    JwtFilter -->|Authenticated| AuthController
    JwtFilter -->|Authenticated| BookController
    JwtFilter -->|Authenticated| OrderController
    AuthController -->|"calls"| AuthService
    BookController -->|"calls"| BookService
    OrderController -->|"calls"| OrderService
    AuthService -->|"uses"| JwtUtil
    AuthService -->|"uses"| CustomUserDetailsService
    BookService -->|"calls"| BookRepo
    OrderService -->|"calls"| OrderRepo
    BookRepo -->|"CRUD"| MySQL
    UserRepo -->|"CRUD"| MySQL
    OrderRepo -->|"CRUD"| MySQL
    Client -->|HTTP| SwaggerUI
    Config -.->|settings| MySQL
    Config -.->|settings| JwtFilter

    click BookstoreBackendApplication "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/BookstoreBackendApplication.java"
    click AuthController "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/controller/AuthController.java"
    click BookController "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/controller/BookController.java"
    click OrderController "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/controller/OrderController.java"
    click AuthService "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/service/AuthService.java"
    click BookService "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/service/BookService.java"
    click OrderService "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/service/OrderService.java"
    click AuthServiceImpl "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/serviceImpl/AuthServiceImpl.java"
    click BookServiceImpl "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/serviceImpl/BookServiceImpl.java"
    click OrderServiceImpl "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/serviceImpl/OrderServiceImpl.java"
    click BookRepo "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/repository/BookRepository.java"
    click UserRepo "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/repository/UserRepository.java"
    click OrderRepo "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/repository/OrderRepository.java"
    click Book["Book"] "src/main/java/com/bookstore/entity/Book.java"
    click User["User"] "src/main/java/com/bookstore/entity/User.java"
    click Order["Order"] "src/main/java/com/bookstore/entity/Order.java"
    click OrderItem["OrderItem"] "src/main/java/com/bookstore/entity/OrderItem.java"
    click BookRequestDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/BookRequestDTO.java"
    click BookResponseDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/BookResponseDTO.java"
    click UserRequestDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/UserRequestDTO.java"
    click UserResponseDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/UserResponseDTO.java"
    click OrderRequestDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/OrderRequestDTO.java"
    click OrderResponseDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/OrderResponseDTO.java"
    click OrderItemRequestDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/OrderItemRequestDTO.java"
    click OrderItemResponseDTO "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/dto/OrderItemResponseDTO.java"
    click JwtUtil "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/security/JwtUtil.java"
    click JwtFilter "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/security/JwtAuthenticationFilter.java"
    click CustomUserDetailsService "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/security/CustomUserDetailsService.java"
    click SecurityConfig "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/security/SecurityConfig.java"
    click GlobalExceptionHandler "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/exception/GlobalExceptionHandler.java"
    click ResourceNotFoundException "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/exception/ResourceNotFoundException.java"
    click OrderStatus "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/enumClassess/OrderStatus.java"
    click PaymentStatus "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/enumClassess/PaymentStatus.java"
    click Role "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/java/com/bookstore/enumClassess/Role.java"
    click Config "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/main/resources/application.properties"
    click BookstoreBackendApplicationTests "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/src/test/java/com/bookstore/bookstore/BookstoreBackendApplicationTests.java"
    click pom.xml "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/pom.xml"
    click README.md "https://github.com/sandeepkumar-s-18/bookstore-management-system/blob/master/README.md"

    classDef client fill:#f9f,stroke:#333,stroke-width:1px;
    classDef security fill:#fdd,stroke:#333,stroke-width:1px;
    classDef controller fill:#cfc,stroke:#333,stroke-width:1px;
    classDef service fill:#ccf,stroke:#333,stroke-width:1px;
    classDef repository fill:#fcf,stroke:#333,stroke-width:1px;
    classDef util fill:#ff9,stroke:#333,stroke-width:1px;
    classDef db fill:#9ff,stroke:#333,stroke-width:1px;
    classDef config fill:#ccc,stroke:#333,stroke-width:1px;
```
