How nikookinn/library-management-app works
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: repository Data Repositories · BookServiceImpl.java Book Operations · AuthorServiceImpl.java Author Operations · LoanServiceImpl.java Loan Operations
Components 26
REST API
- Book Endpoints
src/main/java/com/nikookinn/librarymanagement/controller/BookController.java - Author Endpoints
src/main/java/com/nikookinn/librarymanagement/controller/AuthorController.java - Category Endpoints
src/main/java/com/nikookinn/librarymanagement/controller/CategoryController.java - Member Endpoints
src/main/java/com/nikookinn/librarymanagement/controller/MemberController.java - Loan Endpoints
src/main/java/com/nikookinn/librarymanagement/controller/LoanController.java - Auth Endpoints
src/main/java/com/nikookinn/librarymanagement/controller/AuthController.java
Library Services
- Book Operations
src/main/java/com/nikookinn/librarymanagement/service/impl/BookServiceImpl.java - Author Operations
src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java - Category Operations
src/main/java/com/nikookinn/librarymanagement/service/impl/CategoryServiceImpl.java - Member Operations
src/main/java/com/nikookinn/librarymanagement/service/impl/MemberServiceImpl.java - Loan Operations
src/main/java/com/nikookinn/librarymanagement/service/impl/LoanServiceImpl.java - Overdue Scheduler
src/main/java/com/nikookinn/librarymanagement/service/impl/LoanTaskServiceImpl.java
Persistence Model
- Data Repositories
src/main/java/com/nikookinn/librarymanagement/repository - Library Entities
src/main/java/com/nikookinn/librarymanagement/entity
Identity & Security
- Authentication
src/main/java/com/nikookinn/librarymanagement/service/impl/AuthServiceImpl.java - JWT Services
src/main/java/com/nikookinn/librarymanagement/service/JwtService.java - Request Security
src/main/java/com/nikookinn/librarymanagement/config/SecurityConfig.java - JWT Filter
src/main/java/com/nikookinn/librarymanagement/security/JwtAuthenticationFilter.java
Platform Capabilities
- Cover File Storage
src/main/java/com/nikookinn/librarymanagement/service/impl/FileServiceImpl.java - Email Notifications
src/main/java/com/nikookinn/librarymanagement/service/impl/EmailServiceImpl.java - Read Caching
src/main/java/com/nikookinn/librarymanagement/config/CacheConfig.java - Error Responses
src/main/java/com/nikookinn/librarymanagement/exception/GlobalExceptionHandler.java
Other components
- API Client
- PostgreSQL
- Mail Provider
- Filesystem
Connections 31
- API Client → Book Endpoints: requests
README.md - API Client → Author Endpoints: requests
README.md - API Client → Category Endpoints: requests
README.md - API Client → Member Endpoints: requests
README.md - API Client → Loan Endpoints: requests
README.md - API Client → Auth Endpoints: registers or logs in
README.md - Book Endpoints → Book Operations: invokes
src/main/java/com/nikookinn/librarymanagement/controller/BookController.java - Author Endpoints → Author Operations: invokes
src/main/java/com/nikookinn/librarymanagement/controller/AuthorController.java - Category Endpoints → Category Operations: invokes
README.md - Member Endpoints → Member Operations: invokes
src/main/java/com/nikookinn/librarymanagement/controller/MemberController.java - Loan Endpoints → Loan Operations: invokes
src/main/java/com/nikookinn/librarymanagement/controller/LoanController.java - Auth Endpoints → Authentication: invokes
README.md - Book Operations → Data Repositories: reads and writes
README.md - Author Operations → Data Repositories: queries and saves
src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java - Category Operations → Data Repositories: reads and writes
README.md - Member Operations → Data Repositories: reads and writes
README.md - Loan Operations → Data Repositories: reads and writes
README.md - Data Repositories → Library Entities: maps records
src/main/java/com/nikookinn/librarymanagement/repository/BookRepository.java - Data Repositories → PostgreSQL: persists
README.md - Authentication → JWT Services: creates tokens
src/main/java/com/nikookinn/librarymanagement/service/impl/AuthServiceImpl.java - JWT Filter → JWT Services: validates tokens
README.md - Request Security → JWT Filter: configures
README.md - Request Security → Auth Endpoints: protects endpoints
README.md - Book Operations → Cover File Storage: handles cover images
README.md - Cover File Storage → Filesystem: stores image files
README.md - Loan Operations → Email Notifications: triggers notices
README.md - Overdue Scheduler → Email Notifications: sends overdue reminders
README.md - Email Notifications → Mail Provider: sends mail
README.md - Book Operations → Read Caching: caches reads
README.md - Author Operations → Read Caching: caches reads
src/main/java/com/nikookinn/librarymanagement/service/impl/AuthorServiceImpl.java - API Client → Error Responses: receives structured errors
README.md