# boriskartofel/library-app architecture

> Architecture diagram of the GitHub repository boriskartofel/library-app, 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/boriskartofel/library-app
- Repository: https://github.com/boriskartofel/library-app

## Overview

This Spring MVC library app supports book and reader management, book lending/returns, and account registration and login. A user submits web requests to controllers, which validate input, invoke library or account services, and return rendered pages or redirects. Library records are accessed through JDBC; accounts use a Spring Data repository. Authentication loads account details for Spring Security. The source excerpts show controller-to-service/DAO calls and persistence operations; some security wiring is visible only through the source index.

Main entry points: [`src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java`](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java) (Library data access), [`src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java`](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java) (Person details service), [`src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java`](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java) (Library controller), [`src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java`](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java) (Auth controller)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web and views"]
  node_library_controller["Library controller"]
  node_auth_controller["Auth controller"]
  node_library_views["Library pages"]
  node_auth_views["Auth pages"]
end

subgraph group_library["Library domain"]
  node_library_dao["Library data access<br/>[LibraryDAO.java]"]
  node_reader_mapper["Reader row mapper"]
  node_book["Book model<br/>[Book.java]"]
  node_reader["Reader model<br/>[LibraryReader.java]"]
  node_reader_validator["Reader validator"]
end

subgraph group_accounts["Accounts and security"]
  node_auth_validator["Person validator"]
  node_registration_service["Registration service"]
  node_person_service["Person details service"]
  node_auth_provider["Authentication provider"]
  node_security_config["Security configuration"]
  node_person_details["Person details<br/>[PersonDetails.java]"]
  node_person["Person model<br/>[Person.java]"]
end

subgraph group_persistence["Persistence"]
  node_people_repository["People repository"]
  node_library_database[("Library database")]
end

node_visitor(("User"))

node_visitor -->|"requests"| node_library_controller
node_visitor -->|"requests"| node_auth_controller
node_library_controller -->|"calls"| node_library_dao
node_library_controller -->|"validates readers"| node_reader_validator
node_library_controller -->|"returns views"| node_library_views
node_auth_controller -->|"validates accounts"| node_auth_validator
node_auth_controller -->|"registers"| node_registration_service
node_auth_controller -->|"returns views"| node_auth_views
node_library_dao -->|"queries and updates"| node_library_database
node_library_dao -->|"maps reader rows"| node_reader_mapper
node_library_dao -->|"maps book records"| node_book
node_library_dao -->|"maps reader records"| node_reader
node_reader_validator -->|"checks duplicate names"| node_library_dao
node_auth_validator -->|"checks username"| node_person_service
node_registration_service -->|"saves account"| node_people_repository
node_registration_service -->|"updates account"| node_person
node_person_service -->|"looks up account"| node_people_repository
node_person_service -->|"wraps account"| node_person_details
node_person_service -->|"loads account"| node_person
node_people_repository -->|"persists"| node_person
node_auth_provider -->|"uses user lookup"| node_person_service
node_security_config -->|"configures lookup"| node_person_service

click node_library_controller "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java"
click node_auth_controller "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java"
click node_library_views "https://github.com/boriskartofel/library-app/tree/main/src/main/resources/templates/library"
click node_auth_views "https://github.com/boriskartofel/library-app/tree/main/src/main/resources/templates/auth"
click node_library_dao "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java"
click node_reader_mapper "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/DAO/LibraryReaderMapper.java"
click node_book "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/models/Book.java"
click node_reader "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/models/LibraryReader.java"
click node_reader_validator "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/util/ReaderValidator.java"
click node_auth_validator "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/util/PersonValidator.java"
click node_registration_service "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/services/RegistrationService.java"
click node_person_service "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java"
click node_auth_provider "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/security/AuthProviderImplementation.java"
click node_security_config "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/config/SecurityConfig.java"
click node_person_details "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/security/PersonDetails.java"
click node_person "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/models/Person.java"
click node_people_repository "https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/repositories/PeopleRepository.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_library_controller,node_auth_controller,node_library_views,node_auth_views,node_visitor toneBlue
class node_library_dao,node_reader_mapper,node_book,node_reader,node_reader_validator toneAmber
class node_auth_validator,node_registration_service,node_person_service,node_auth_provider,node_security_config,node_person_details,node_person toneMint
class node_people_repository,node_library_database toneRose
```

## Components

### Web and views

- [Library controller](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java): `src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java`
- [Auth controller](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java): `src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java`
- [Library pages](https://github.com/boriskartofel/library-app/tree/main/src/main/resources/templates/library): `src/main/resources/templates/library`
- [Auth pages](https://github.com/boriskartofel/library-app/tree/main/src/main/resources/templates/auth): `src/main/resources/templates/auth`

### Library domain

- [Library data access](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java): `src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java`
- [Reader row mapper](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/DAO/LibraryReaderMapper.java): `src/main/java/fun/springMVC/libraryApp/DAO/LibraryReaderMapper.java`
- [Book model](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/models/Book.java): `src/main/java/fun/springMVC/libraryApp/models/Book.java`
- [Reader model](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/models/LibraryReader.java): `src/main/java/fun/springMVC/libraryApp/models/LibraryReader.java`
- [Reader validator](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/util/ReaderValidator.java): `src/main/java/fun/springMVC/libraryApp/util/ReaderValidator.java`

### Accounts and security

- [Person validator](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/util/PersonValidator.java): `src/main/java/fun/springMVC/libraryApp/util/PersonValidator.java`
- [Registration service](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/services/RegistrationService.java): `src/main/java/fun/springMVC/libraryApp/services/RegistrationService.java`
- [Person details service](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java): `src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java`
- [Authentication provider](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/security/AuthProviderImplementation.java): `src/main/java/fun/springMVC/libraryApp/security/AuthProviderImplementation.java`
- [Security configuration](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/config/SecurityConfig.java): `src/main/java/fun/springMVC/libraryApp/config/SecurityConfig.java`
- [Person details](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/security/PersonDetails.java): `src/main/java/fun/springMVC/libraryApp/security/PersonDetails.java`
- [Person model](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/models/Person.java): `src/main/java/fun/springMVC/libraryApp/models/Person.java`

### Persistence

- [People repository](https://github.com/boriskartofel/library-app/blob/main/src/main/java/fun/springMVC/libraryApp/repositories/PeopleRepository.java): `src/main/java/fun/springMVC/libraryApp/repositories/PeopleRepository.java`
- **Library database**

### Other components

- **User**

## Connections

- User → Library controller: requests (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java`)
- User → Auth controller: requests (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java`)
- Library controller → Library data access: calls (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java`)
- Library controller → Reader validator: validates readers (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java`)
- Library controller → Library pages: returns views (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/LibraryController.java`)
- Auth controller → Person validator: validates accounts (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java`)
- Auth controller → Registration service: registers (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java`)
- Auth controller → Auth pages: returns views (evidence: `src/main/java/fun/springMVC/libraryApp/controllers/AuthController.java`)
- Library data access → Library database: queries and updates (evidence: `src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java`)
- Library data access → Reader row mapper: maps reader rows (evidence: `src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java`)
- Library data access → Book model: maps book records (evidence: `src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java`)
- Library data access → Reader model: maps reader records (evidence: `src/main/java/fun/springMVC/libraryApp/DAO/LibraryDAO.java`)
- Reader validator → Library data access: checks duplicate names (evidence: `src/main/java/fun/springMVC/libraryApp/util/ReaderValidator.java`)
- Person validator → Person details service: checks username (evidence: `src/main/java/fun/springMVC/libraryApp/util/PersonValidator.java`)
- Registration service → People repository: saves account (evidence: `src/main/java/fun/springMVC/libraryApp/services/RegistrationService.java`)
- Registration service → Person model: updates account (evidence: `src/main/java/fun/springMVC/libraryApp/services/RegistrationService.java`)
- Person details service → People repository: looks up account (evidence: `src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java`)
- Person details service → Person details: wraps account (evidence: `src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java`)
- Person details service → Person model: loads account (evidence: `src/main/java/fun/springMVC/libraryApp/services/PersonDetailsService.java`)
- People repository → Person model: persists (evidence: `src/main/java/fun/springMVC/libraryApp/repositories/PeopleRepository.java`)
- Authentication provider → Person details service: uses user lookup (evidence: `src/main/java/fun/springMVC/libraryApp/security/AuthProviderImplementation.java`)
- Security configuration → Person details service: configures lookup (evidence: `src/main/java/fun/springMVC/libraryApp/config/SecurityConfig.java`)
