# nikookinn/library-management-app architecture

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

- Interactive diagram: https://gitdiagram.com/nikookinn/library-management-app
- Repository: https://github.com/nikookinn/library-management-app

## Overview

This is a Spring Boot REST backend for library catalog, member, and loan operations. The principal flow is a client request through controllers, domain services, and repositories, returning DTO responses; authentication protects role-specific operations. README documents cover-image filesystem handling, caching, scheduled overdue processing, and asynchronous email notifications as additional capabilities. Several implementations were not excerpted, so those branches are included only where documented, with relationships grounded in the README rather than claims of source inspection.

Main entry points: [`src/main/java/com/nikookinn/librarymanagement/repository`](https://github.com/nikookinn/library-management-app/tree/main/src/main/java/com/nikookinn/librarymanagement/repository) (Data Repositories), [`src/main/java/com/nikookinn/librarymanagement/service/impl/BookServiceImpl.java`](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/BookServiceImpl.java) (Book Operations), [`src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java`](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java) (Author Operations), [`src/main/java/com/nikookinn/librarymanagement/service/impl/LoanServiceImpl.java`](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/LoanServiceImpl.java) (Loan Operations)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["REST API"]
  node_book_api["Book Endpoints"]
  node_author_api["Author Endpoints"]
  node_category_api["Category Endpoints"]
  node_member_api["Member Endpoints"]
  node_loan_api["Loan Endpoints"]
  node_auth_api["Auth Endpoints"]
end

subgraph group_domain["Library Services"]
  node_book_service["Book Operations"]
  node_author_service["Author Operations"]
  node_category_service["Category Operations"]
  node_member_service["Member Operations"]
  node_loan_service["Loan Operations"]
  node_loan_tasks["Overdue Scheduler"]
end

subgraph group_persistence["Persistence Model"]
  node_repositories["Data Repositories"]
  node_entities["Library Entities"]
end

subgraph group_identity["Identity &amp; Security"]
  node_auth_service["Authentication"]
  node_jwt["JWT Services<br/>[JwtService.java]"]
  node_security["Request Security"]
  node_jwt_filter["JWT Filter"]
end

subgraph group_support["Platform Capabilities"]
  node_covers["Cover File Storage"]
  node_email["Email Notifications"]
  node_cache["Read Caching<br/>[CacheConfig.java]"]
  node_errors["Error Responses"]
end

node_client(("API Client"))
node_database[("PostgreSQL")]
node_mail_service["Mail Provider"]
node_filesystem[("Filesystem")]

node_client -->|"requests"| node_book_api
node_client -->|"requests"| node_author_api
node_client -->|"requests"| node_category_api
node_client -->|"requests"| node_member_api
node_client -->|"requests"| node_loan_api
node_client -->|"registers or logs in"| node_auth_api
node_book_api -->|"invokes"| node_book_service
node_author_api -->|"invokes"| node_author_service
node_category_api -.->|"invokes"| node_category_service
node_member_api -->|"invokes"| node_member_service
node_loan_api -->|"invokes"| node_loan_service
node_auth_api -.->|"invokes"| node_auth_service
node_book_service -.->|"reads and writes"| node_repositories
node_author_service -->|"queries and saves"| node_repositories
node_category_service -.->|"reads and writes"| node_repositories
node_member_service -.->|"reads and writes"| node_repositories
node_loan_service -.->|"reads and writes"| node_repositories
node_repositories -.->|"maps records"| node_entities
node_repositories -.->|"persists"| node_database
node_auth_service -->|"creates tokens"| node_jwt
node_jwt_filter -.->|"validates tokens"| node_jwt
node_security -.->|"configures"| node_jwt_filter
node_security -.->|"protects endpoints"| node_auth_api
node_book_service -.->|"handles cover images"| node_covers
node_covers -->|"stores image files"| node_filesystem
node_loan_service -.->|"triggers notices"| node_email
node_loan_tasks -.->|"sends overdue reminders"| node_email
node_email -.->|"sends mail"| node_mail_service
node_book_service -.->|"caches reads"| node_cache
node_author_service -->|"caches reads"| node_cache
node_client -.->|"receives structured errors"| node_errors

click node_book_api "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/BookController.java"
click node_author_api "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/AuthorController.java"
click node_category_api "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/CategoryController.java"
click node_member_api "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/MemberController.java"
click node_loan_api "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/LoanController.java"
click node_auth_api "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/AuthController.java"
click node_book_service "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/BookServiceImpl.java"
click node_author_service "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java"
click node_category_service "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/CategoryServiceImpl.java"
click node_member_service "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/MemberServiceImpl.java"
click node_loan_service "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/LoanServiceImpl.java"
click node_loan_tasks "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/LoanTaskServiceImpl.java"
click node_auth_service "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/AuthServiceImpl.java"
click node_jwt "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/JwtService.java"
click node_security "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/config/SecurityConfig.java"
click node_jwt_filter "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/security/JwtAuthenticationFilter.java"
click node_repositories "https://github.com/nikookinn/library-management-app/tree/main/src/main/java/com/nikookinn/librarymanagement/repository"
click node_entities "https://github.com/nikookinn/library-management-app/tree/main/src/main/java/com/nikookinn/librarymanagement/entity"
click node_covers "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/FileServiceImpl.java"
click node_email "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/EmailServiceImpl.java"
click node_cache "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/config/CacheConfig.java"
click node_errors "https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/exception/GlobalExceptionHandler.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_book_api,node_author_api,node_category_api,node_member_api,node_loan_api,node_auth_api,node_client toneBlue
class node_book_service,node_author_service,node_category_service,node_member_service,node_loan_service,node_loan_tasks,node_database,node_filesystem toneAmber
class node_repositories,node_entities toneMint
class node_auth_service,node_jwt,node_security,node_jwt_filter toneRose
class node_covers,node_email,node_cache,node_errors,node_mail_service toneIndigo
```

## Components

### REST API

- [Book Endpoints](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/BookController.java): `src/main/java/com/nikookinn/librarymanagement/controller/BookController.java`
- [Author Endpoints](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/AuthorController.java): `src/main/java/com/nikookinn/librarymanagement/controller/AuthorController.java`
- [Category Endpoints](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/CategoryController.java): `src/main/java/com/nikookinn/librarymanagement/controller/CategoryController.java`
- [Member Endpoints](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/MemberController.java): `src/main/java/com/nikookinn/librarymanagement/controller/MemberController.java`
- [Loan Endpoints](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/LoanController.java): `src/main/java/com/nikookinn/librarymanagement/controller/LoanController.java`
- [Auth Endpoints](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/controller/AuthController.java): `src/main/java/com/nikookinn/librarymanagement/controller/AuthController.java`

### Library Services

- [Book Operations](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/BookServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/BookServiceImpl.java`
- [Author Operations](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java`
- [Category Operations](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/CategoryServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/CategoryServiceImpl.java`
- [Member Operations](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/MemberServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/MemberServiceImpl.java`
- [Loan Operations](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/LoanServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/LoanServiceImpl.java`
- [Overdue Scheduler](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/LoanTaskServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/LoanTaskServiceImpl.java`

### Persistence Model

- [Data Repositories](https://github.com/nikookinn/library-management-app/tree/main/src/main/java/com/nikookinn/librarymanagement/repository): `src/main/java/com/nikookinn/librarymanagement/repository`
- [Library Entities](https://github.com/nikookinn/library-management-app/tree/main/src/main/java/com/nikookinn/librarymanagement/entity): `src/main/java/com/nikookinn/librarymanagement/entity`

### Identity & Security

- [Authentication](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/AuthServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/AuthServiceImpl.java`
- [JWT Services](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/JwtService.java): `src/main/java/com/nikookinn/librarymanagement/service/JwtService.java`
- [Request Security](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/config/SecurityConfig.java): `src/main/java/com/nikookinn/librarymanagement/config/SecurityConfig.java`
- [JWT Filter](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/security/JwtAuthenticationFilter.java): `src/main/java/com/nikookinn/librarymanagement/security/JwtAuthenticationFilter.java`

### Platform Capabilities

- [Cover File Storage](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/FileServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/FileServiceImpl.java`
- [Email Notifications](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/service/impl/EmailServiceImpl.java): `src/main/java/com/nikookinn/librarymanagement/service/impl/EmailServiceImpl.java`
- [Read Caching](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/config/CacheConfig.java): `src/main/java/com/nikookinn/librarymanagement/config/CacheConfig.java`
- [Error Responses](https://github.com/nikookinn/library-management-app/blob/main/src/main/java/com/nikookinn/librarymanagement/exception/GlobalExceptionHandler.java): `src/main/java/com/nikookinn/librarymanagement/exception/GlobalExceptionHandler.java`

### Other components

- **API Client**
- **PostgreSQL**
- **Mail Provider**
- **Filesystem**

## Connections

- API Client → Book Endpoints: requests (evidence: `README.md`)
- API Client → Author Endpoints: requests (evidence: `README.md`)
- API Client → Category Endpoints: requests (evidence: `README.md`)
- API Client → Member Endpoints: requests (evidence: `README.md`)
- API Client → Loan Endpoints: requests (evidence: `README.md`)
- API Client → Auth Endpoints: registers or logs in (evidence: `README.md`)
- Book Endpoints → Book Operations: invokes (evidence: `src/main/java/com/nikookinn/librarymanagement/controller/BookController.java`)
- Author Endpoints → Author Operations: invokes (evidence: `src/main/java/com/nikookinn/librarymanagement/controller/AuthorController.java`)
- Category Endpoints → Category Operations: invokes (evidence: `README.md`)
- Member Endpoints → Member Operations: invokes (evidence: `src/main/java/com/nikookinn/librarymanagement/controller/MemberController.java`)
- Loan Endpoints → Loan Operations: invokes (evidence: `src/main/java/com/nikookinn/librarymanagement/controller/LoanController.java`)
- Auth Endpoints → Authentication: invokes (evidence: `README.md`)
- Book Operations → Data Repositories: reads and writes (evidence: `README.md`)
- Author Operations → Data Repositories: queries and saves (evidence: `src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java`)
- Category Operations → Data Repositories: reads and writes (evidence: `README.md`)
- Member Operations → Data Repositories: reads and writes (evidence: `README.md`)
- Loan Operations → Data Repositories: reads and writes (evidence: `README.md`)
- Data Repositories → Library Entities: maps records (evidence: `src/main/java/com/nikookinn/librarymanagement/repository/BookRepository.java`)
- Data Repositories → PostgreSQL: persists (evidence: `README.md`)
- Authentication → JWT Services: creates tokens (evidence: `src/main/java/com/nikookinn/librarymanagement/service/impl/AuthServiceImpl.java`)
- JWT Filter → JWT Services: validates tokens (evidence: `README.md`)
- Request Security → JWT Filter: configures (evidence: `README.md`)
- Request Security → Auth Endpoints: protects endpoints (evidence: `README.md`)
- Book Operations → Cover File Storage: handles cover images (evidence: `README.md`)
- Cover File Storage → Filesystem: stores image files (evidence: `README.md`)
- Loan Operations → Email Notifications: triggers notices (evidence: `README.md`)
- Overdue Scheduler → Email Notifications: sends overdue reminders (evidence: `README.md`)
- Email Notifications → Mail Provider: sends mail (evidence: `README.md`)
- Book Operations → Read Caching: caches reads (evidence: `README.md`)
- Author Operations → Read Caching: caches reads (evidence: `src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java`)
- API Client → Error Responses: receives structured errors (evidence: `README.md`)
