# franticskipper/book-store architecture

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

- Interactive diagram: https://gitdiagram.com/franticskipper/book-store
- Repository: https://github.com/franticskipper/book-store

## Overview

This is a Spring-based book catalog API. Clients create, retrieve, update, delete, and search books; requests pass through the controller to the service, which maps DTOs and uses a repository for persistence. Search criteria are built from reusable specifications, and search price ranges have custom validation. The source excerpts and index support these principal links; the README provides no additional capability detail, and the concrete database configuration was not sampled.

Main entry points: [`src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java) (Book spec builder), [`src/main/java/com/book/store/service/impl/BookServiceImpl.java`](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/service/impl/BookServiceImpl.java) (Book service), [`src/main/java/com/book/store/controller/BookController.java`](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/controller/BookController.java) (Book controller), [`src/main/java/com/book/store/mapper/BookMapper.java`](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/mapper/BookMapper.java) (Book mapper)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["API and contracts"]
  node_controller["Book controller"]
  node_request["Create request"]
  node_response["Book response<br/>[BookDto.java]"]
end

subgraph group_domain["Book domain"]
  node_service["Book service"]
  node_serviceapi["Service contract<br/>[BookService.java]"]
  node_mapper["Book mapper<br/>[BookMapper.java]"]
  node_mapperconfig["Mapper config<br/>[MapperConfig.java]"]
  node_book["Book entity<br/>[Book.java]"]
end

subgraph group_search["Search and validation"]
  node_searchparams["Search parameters"]
  node_specbuilder["Book spec builder"]
  node_speccontract["Specification builder contract"]
  node_authorfilter["Author filter"]
  node_titlefilter["Title filter"]
  node_minfilter["Minimum price filter"]
  node_maxfilter["Maximum price filter"]
  node_specprovider["Book spec provider"]
  node_priceannotation["Price range constraint"]
  node_pricevalidator["Price range validator"]
end

subgraph group_persistence["Persistence and errors"]
  node_repository["Book repository"]
  node_database[("Book database")]
  node_notfound["Not found exception"]
  node_exceptionhandler["Exception handler"]
end

node_client(("API client"))

node_client -->|"sends requests"| node_controller
node_controller -->|"dispatches operations"| node_serviceapi
node_controller -->|"accepts input"| node_request
node_controller -->|"binds search"| node_searchparams
node_controller -->|"returns books"| node_response
node_service -->|"implements contract"| node_serviceapi
node_service -->|"maps books"| node_mapper
node_service -->|"reads and writes"| node_repository
node_service -->|"builds search spec"| node_specbuilder
node_service -->|"throws on missing"| node_notfound
node_mapper -->|"uses config"| node_mapperconfig
node_mapper -->|"maps entity"| node_book
node_mapper -->|"maps input"| node_request
node_mapper -->|"maps output"| node_response
node_repository -->|"stores entities"| node_book
node_repository -.->|"persists books"| node_database
node_specbuilder -->|"implements builder"| node_speccontract
node_specbuilder -->|"uses filter"| node_authorfilter
node_specbuilder -->|"uses filter"| node_titlefilter
node_specbuilder -->|"uses filter"| node_minfilter
node_specbuilder -->|"uses filter"| node_maxfilter
node_authorfilter -->|"implements provider"| node_specprovider
node_searchparams -->|"declares constraint"| node_priceannotation
node_priceannotation -->|"registers validator"| node_pricevalidator
node_pricevalidator -->|"validates range"| node_searchparams
node_exceptionhandler -->|"handles exception"| node_notfound

click node_controller "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/controller/BookController.java"
click node_request "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/dto/CreateBookRequestDto.java"
click node_response "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/dto/BookDto.java"
click node_searchparams "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/dto/BookSearchParameters.java"
click node_service "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/service/impl/BookServiceImpl.java"
click node_serviceapi "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/service/BookService.java"
click node_mapper "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/mapper/BookMapper.java"
click node_mapperconfig "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/config/MapperConfig.java"
click node_book "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/model/Book.java"
click node_repository "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/BookRepository.java"
click node_specbuilder "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java"
click node_speccontract "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/specification/SpecificationBuilder.java"
click node_authorfilter "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/AuthorSpecification.java"
click node_titlefilter "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/TitleSpecification.java"
click node_minfilter "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/MinPriceSpecification.java"
click node_maxfilter "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/MaxPriceSpecification.java"
click node_specprovider "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/BookSpecificationProvider.java"
click node_priceannotation "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/validation/PriceRangeValidation.java"
click node_pricevalidator "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/validation/PriceRangeValidator.java"
click node_notfound "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/exception/EntityNotFoundException.java"
click node_exceptionhandler "https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/exception/CustomGlobalExceptionHandler.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_controller,node_request,node_response,node_client toneBlue
class node_service,node_serviceapi,node_mapper,node_mapperconfig,node_book toneAmber
class node_searchparams,node_specbuilder,node_speccontract,node_authorfilter,node_titlefilter,node_minfilter,node_maxfilter,node_specprovider,node_priceannotation,node_pricevalidator toneMint
class node_repository,node_database,node_notfound,node_exceptionhandler toneRose
```

## Components

### API and contracts

- [Book controller](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/controller/BookController.java): `src/main/java/com/book/store/controller/BookController.java`
- [Create request](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/dto/CreateBookRequestDto.java): `src/main/java/com/book/store/dto/CreateBookRequestDto.java`
- [Book response](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/dto/BookDto.java): `src/main/java/com/book/store/dto/BookDto.java`

### Book domain

- [Book service](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/service/impl/BookServiceImpl.java): `src/main/java/com/book/store/service/impl/BookServiceImpl.java`
- [Service contract](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/service/BookService.java): `src/main/java/com/book/store/service/BookService.java`
- [Book mapper](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/mapper/BookMapper.java): `src/main/java/com/book/store/mapper/BookMapper.java`
- [Mapper config](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/config/MapperConfig.java): `src/main/java/com/book/store/config/MapperConfig.java`
- [Book entity](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/model/Book.java): `src/main/java/com/book/store/model/Book.java`

### Search and validation

- [Search parameters](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/dto/BookSearchParameters.java): `src/main/java/com/book/store/dto/BookSearchParameters.java`
- [Book spec builder](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java): `src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`
- [Specification builder contract](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/specification/SpecificationBuilder.java): `src/main/java/com/book/store/repository/specification/SpecificationBuilder.java`
- [Author filter](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/AuthorSpecification.java): `src/main/java/com/book/store/repository/book/specification/AuthorSpecification.java`
- [Title filter](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/TitleSpecification.java): `src/main/java/com/book/store/repository/book/specification/TitleSpecification.java`
- [Minimum price filter](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/MinPriceSpecification.java): `src/main/java/com/book/store/repository/book/specification/MinPriceSpecification.java`
- [Maximum price filter](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/MaxPriceSpecification.java): `src/main/java/com/book/store/repository/book/specification/MaxPriceSpecification.java`
- [Book spec provider](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/specification/BookSpecificationProvider.java): `src/main/java/com/book/store/repository/book/specification/BookSpecificationProvider.java`
- [Price range constraint](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/validation/PriceRangeValidation.java): `src/main/java/com/book/store/validation/PriceRangeValidation.java`
- [Price range validator](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/validation/PriceRangeValidator.java): `src/main/java/com/book/store/validation/PriceRangeValidator.java`

### Persistence and errors

- [Book repository](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/repository/book/BookRepository.java): `src/main/java/com/book/store/repository/book/BookRepository.java`
- **Book database**
- [Not found exception](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/exception/EntityNotFoundException.java): `src/main/java/com/book/store/exception/EntityNotFoundException.java`
- [Exception handler](https://github.com/franticskipper/book-store/blob/main/src/main/java/com/book/store/exception/CustomGlobalExceptionHandler.java): `src/main/java/com/book/store/exception/CustomGlobalExceptionHandler.java`

### Other components

- **API client**

## Connections

- API client → Book controller: sends requests (evidence: `src/main/java/com/book/store/controller/BookController.java`)
- Book controller → Service contract: dispatches operations (evidence: `src/main/java/com/book/store/controller/BookController.java`)
- Book controller → Create request: accepts input (evidence: `src/main/java/com/book/store/controller/BookController.java`)
- Book controller → Search parameters: binds search (evidence: `src/main/java/com/book/store/controller/BookController.java`)
- Book controller → Book response: returns books (evidence: `src/main/java/com/book/store/controller/BookController.java`)
- Book service → Service contract: implements contract (evidence: `src/main/java/com/book/store/service/impl/BookServiceImpl.java`)
- Book service → Book mapper: maps books (evidence: `src/main/java/com/book/store/service/impl/BookServiceImpl.java`)
- Book service → Book repository: reads and writes (evidence: `src/main/java/com/book/store/service/impl/BookServiceImpl.java`)
- Book service → Book spec builder: builds search spec (evidence: `src/main/java/com/book/store/service/impl/BookServiceImpl.java`)
- Book service → Not found exception: throws on missing (evidence: `src/main/java/com/book/store/service/impl/BookServiceImpl.java`)
- Book mapper → Mapper config: uses config (evidence: `src/main/java/com/book/store/mapper/BookMapper.java`)
- Book mapper → Book entity: maps entity (evidence: `src/main/java/com/book/store/mapper/BookMapper.java`)
- Book mapper → Create request: maps input (evidence: `src/main/java/com/book/store/mapper/BookMapper.java`)
- Book mapper → Book response: maps output (evidence: `src/main/java/com/book/store/mapper/BookMapper.java`)
- Book repository → Book entity: stores entities (evidence: `src/main/java/com/book/store/repository/book/BookRepository.java`)
- Book repository → Book database: persists books
- Book spec builder → Specification builder contract: implements builder (evidence: `src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`)
- Book spec builder → Author filter: uses filter (evidence: `src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`)
- Book spec builder → Title filter: uses filter (evidence: `src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`)
- Book spec builder → Minimum price filter: uses filter (evidence: `src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`)
- Book spec builder → Maximum price filter: uses filter (evidence: `src/main/java/com/book/store/repository/book/specification/BookSpecificationBuilder.java`)
- Author filter → Book spec provider: implements provider (evidence: `src/main/java/com/book/store/repository/book/specification/AuthorSpecification.java`)
- Search parameters → Price range constraint: declares constraint (evidence: `src/main/java/com/book/store/dto/BookSearchParameters.java`)
- Price range constraint → Price range validator: registers validator (evidence: `src/main/java/com/book/store/validation/PriceRangeValidation.java`)
- Price range validator → Search parameters: validates range (evidence: `src/main/java/com/book/store/validation/PriceRangeValidator.java`)
- Exception handler → Not found exception: handles exception (evidence: `src/main/java/com/book/store/exception/CustomGlobalExceptionHandler.java`)
