How bitovi/backend-fundamentals-training works
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: BookService.java Book Service · BookController.java Book Controller · BookRepository.java Book Repository · GlobalExceptionHandler.java Error Handler
Components 14
HTTP API
- Book Controller
src/main/java/com/bitovi/library/book/BookController.java - Create Request
src/main/java/com/bitovi/library/book/dto/CreateBookRequest.java - Book Response
src/main/java/com/bitovi/library/book/dto/BookResponse.java - Error Handler
src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java
Book Domain
- Book Service
src/main/java/com/bitovi/library/book/BookService.java - Book Entity
src/main/java/com/bitovi/library/book/Book.java - Not Found Error
src/main/java/com/bitovi/library/common/NotFoundException.java - Conflict Error
src/main/java/com/bitovi/library/common/ConflictException.java
Runtime and Persistence
- Spring Boot App
src/main/java/com/bitovi/library/LibraryApplication.java - Book Repository
src/main/java/com/bitovi/library/book/BookRepository.java - Datasource Config
src/main/resources/application.yml - Seed Books
src/main/resources/data.sql
Other components
- API Client
- PostgreSQL
Connections 18
- API Client → Book Controller: sends requests
README.md - Spring Boot App → Book Controller: bootstraps
src/main/java/com/bitovi/library/LibraryApplication.java - Book Controller → Book Service: delegates
src/main/java/com/bitovi/library/book/BookController.java - Book Controller → Create Request: accepts
src/main/java/com/bitovi/library/book/BookController.java - Book Controller → Book Response: returns
src/main/java/com/bitovi/library/book/BookController.java - Book Service → Book Repository: queries and saves
src/main/java/com/bitovi/library/book/BookService.java - Book Service → Create Request: reads fields
src/main/java/com/bitovi/library/book/BookService.java - Book Service → Book Response: builds
src/main/java/com/bitovi/library/book/BookService.java - Book Service → Book Entity: creates and updates
src/main/java/com/bitovi/library/book/BookService.java - Book Repository → Book Entity: persists
src/main/java/com/bitovi/library/book/BookRepository.java - Book Service → Not Found Error: throws
src/main/java/com/bitovi/library/book/BookService.java - Book Service → Conflict Error: throws
src/main/java/com/bitovi/library/book/BookService.java - Error Handler → Not Found Error: handles
src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java - Error Handler → Conflict Error: handles
src/main/java/com/bitovi/library/common/GlobalExceptionHandler.java - Datasource Config → PostgreSQL: configures datasource
- Seed Books → PostgreSQL: seeds books
README.md - Book Repository → PostgreSQL: reads and writes
README.md - Book Controller → Error Handler: errors become JSON
README.md