# bitovi/backend-fundamentals-training architecture

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

- Interactive diagram: https://gitdiagram.com/bitovi/backend-fundamentals-training
- Repository: https://github.com/bitovi/backend-fundamentals-training

## Overview

The product is a small Spring Boot library-books REST API backed by PostgreSQL. Its main workflow is an HTTP request entering the book controller, passing through service rules, and reaching the repository for persistence; responses use DTOs rather than exposing JPA entities. The README documents listing, creating, checkout, and return, plus structured error responses and startup seed data. Edges reflect the supplied source excerpts or README; database configuration and seed wiring are documented but their runtime source was not sampled.

Main entry points: [`src/main/java/com/bitovi/library/book/BookService.java`](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookService.java) (Book Service), [`src/main/java/com/bitovi/library/book/BookController.java`](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookController.java) (Book Controller), [`src/main/java/com/bitovi/library/book/BookRepository.java`](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookRepository.java) (Book Repository), [`src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java`](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java) (Error Handler)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_controller["Book Controller"]
  node_create_request["Create Request"]
  node_response["Book Response<br/>[BookResponse.java]"]
  node_error_handler["Error Handler"]
end

subgraph group_books["Book Domain"]
  node_service["Book Service<br/>[BookService.java]"]
  node_book["Book Entity<br/>[Book.java]"]
  node_not_found["Not Found Error"]
  node_conflict["Conflict Error"]
end

subgraph group_runtime["Runtime and Persistence"]
  node_application["Spring Boot App"]
  node_repository["Book Repository"]
  node_db_config["Datasource Config<br/>[application.yml]"]
  node_seed_data["Seed Books<br/>[data.sql]"]
end

node_client(("API Client"))
node_postgres[("PostgreSQL")]

node_client -->|"sends requests"| node_controller
node_application -->|"bootstraps"| node_controller
node_controller -->|"delegates"| node_service
node_controller -->|"accepts"| node_create_request
node_controller -->|"returns"| node_response
node_service -->|"queries and saves"| node_repository
node_service -->|"reads fields"| node_create_request
node_service -->|"builds"| node_response
node_service -->|"creates and updates"| node_book
node_repository -->|"persists"| node_book
node_service -->|"throws"| node_not_found
node_service -->|"throws"| node_conflict
node_error_handler -->|"handles"| node_not_found
node_error_handler -->|"handles"| node_conflict
node_db_config -.->|"configures datasource"| node_postgres
node_seed_data -.->|"seeds books"| node_postgres
node_repository -->|"reads and writes"| node_postgres
node_controller -->|"errors become JSON"| node_error_handler

click node_application "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/LibraryApplication.java"
click node_controller "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookController.java"
click node_create_request "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/dto/CreateBookRequest.java"
click node_response "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/dto/BookResponse.java"
click node_service "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookService.java"
click node_book "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/Book.java"
click node_not_found "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/NotFoundException.java"
click node_conflict "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/ConflictException.java"
click node_error_handler "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java"
click node_repository "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookRepository.java"
click node_db_config "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/resources/application.yml"
click node_seed_data "https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/resources/data.sql"

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_create_request,node_response,node_error_handler,node_client toneBlue
class node_service,node_book,node_not_found,node_conflict,node_postgres toneAmber
class node_application,node_repository,node_db_config,node_seed_data toneMint
```

## Components

### HTTP API

- [Book Controller](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookController.java): `src/main/java/com/bitovi/library/book/BookController.java`
- [Create Request](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/dto/CreateBookRequest.java): `src/main/java/com/bitovi/library/book/dto/CreateBookRequest.java`
- [Book Response](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/dto/BookResponse.java): `src/main/java/com/bitovi/library/book/dto/BookResponse.java`
- [Error Handler](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java): `src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java`

### Book Domain

- [Book Service](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookService.java): `src/main/java/com/bitovi/library/book/BookService.java`
- [Book Entity](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/Book.java): `src/main/java/com/bitovi/library/book/Book.java`
- [Not Found Error](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/NotFoundException.java): `src/main/java/com/bitovi/library/common/NotFoundException.java`
- [Conflict Error](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/common/ConflictException.java): `src/main/java/com/bitovi/library/common/ConflictException.java`

### Runtime and Persistence

- [Spring Boot App](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/LibraryApplication.java): `src/main/java/com/bitovi/library/LibraryApplication.java`
- [Book Repository](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/java/com/bitovi/library/book/BookRepository.java): `src/main/java/com/bitovi/library/book/BookRepository.java`
- [Datasource Config](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/resources/application.yml): `src/main/resources/application.yml`
- [Seed Books](https://github.com/bitovi/backend-fundamentals-training/blob/main/src/main/resources/data.sql): `src/main/resources/data.sql`

### Other components

- **API Client**
- **PostgreSQL**

## Connections

- API Client → Book Controller: sends requests (evidence: `README.md`)
- Spring Boot App → Book Controller: bootstraps (evidence: `src/main/java/com/bitovi/library/LibraryApplication.java`)
- Book Controller → Book Service: delegates (evidence: `src/main/java/com/bitovi/library/book/BookController.java`)
- Book Controller → Create Request: accepts (evidence: `src/main/java/com/bitovi/library/book/BookController.java`)
- Book Controller → Book Response: returns (evidence: `src/main/java/com/bitovi/library/book/BookController.java`)
- Book Service → Book Repository: queries and saves (evidence: `src/main/java/com/bitovi/library/book/BookService.java`)
- Book Service → Create Request: reads fields (evidence: `src/main/java/com/bitovi/library/book/BookService.java`)
- Book Service → Book Response: builds (evidence: `src/main/java/com/bitovi/library/book/BookService.java`)
- Book Service → Book Entity: creates and updates (evidence: `src/main/java/com/bitovi/library/book/BookService.java`)
- Book Repository → Book Entity: persists (evidence: `src/main/java/com/bitovi/library/book/BookRepository.java`)
- Book Service → Not Found Error: throws (evidence: `src/main/java/com/bitovi/library/book/BookService.java`)
- Book Service → Conflict Error: throws (evidence: `src/main/java/com/bitovi/library/book/BookService.java`)
- Error Handler → Not Found Error: handles (evidence: `src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java`)
- Error Handler → Conflict Error: handles (evidence: `src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java`)
- Datasource Config → PostgreSQL: configures datasource
- Seed Books → PostgreSQL: seeds books (evidence: `README.md`)
- Book Repository → PostgreSQL: reads and writes (evidence: `README.md`)
- Book Controller → Error Handler: errors become JSON (evidence: `README.md`)
