How joaopauloolt/library-api works
Library API is a Spring REST backend for catalog, physical copies, user identity and loan circulation. The main workflow runs from an API request through an application use case to domain repositories and PostgreSQL; loan operations enforce copy availability and update loan/copy state. Authentication issues and rotates JWT/refresh tokens, while security infrastructure handles token validation and RBAC. The README documents pagination, filtering and additional user/author capabilities; unsampled controllers and services are represented by their exact tree paths, but their internal calls are not inferred.
Main entry points: LoanService.java Loan Circulation · AuthService.java Authentication · BookService.java Book Catalog · UserRepository.java User Repository
Components 24
REST API
- Authentication API
src/main/java/com/jpoltramari/library_api/api/controller/AuthController.java - Catalog API
src/main/java/com/jpoltramari/library_api/api/controller/BookController.java - Author API
src/main/java/com/jpoltramari/library_api/api/controller/AuthorController.java - Book Copy API
src/main/java/com/jpoltramari/library_api/api/controller/BookCopyController.java - Loan API
src/main/java/com/jpoltramari/library_api/api/controller/LoanController.java - User API
src/main/java/com/jpoltramari/library_api/api/controller/UserController.java
Application Use Cases
- Authentication
src/main/java/com/jpoltramari/library_api/application/service/AuthService.java - Book Catalog
src/main/java/com/jpoltramari/library_api/application/service/BookService.java - Author Management
src/main/java/com/jpoltramari/library_api/application/service/AuthorService.java - Copy Management
src/main/java/com/jpoltramari/library_api/application/service/BookCopyService.java - Loan Circulation
src/main/java/com/jpoltramari/library_api/application/service/LoanService.java - User Management
src/main/java/com/jpoltramari/library_api/application/service/UserService.java - Token Versions
src/main/java/com/jpoltramari/library_api/application/service/TokenVersionService.java
Security Infrastructure
- JWT Validation
src/main/java/com/jpoltramari/library_api/infrastructure/security/JwtService.java - Refresh Tokens
src/main/java/com/jpoltramari/library_api/infrastructure/security/jwt/RefreshTokenService.java - Authentication and RBAC
src/main/java/com/jpoltramari/library_api/infrastructure/security/SecurityConfig.java
Domain and Persistence
- Library Entities
src/main/java/com/jpoltramari/library_api/domain/model - User Repository
src/main/java/com/jpoltramari/library_api/domain/repository/UserRepository.java - Loan Repository
src/main/java/com/jpoltramari/library_api/domain/repository/LoanRepository.java - Book Repository
src/main/java/com/jpoltramari/library_api/domain/repository/BookRepository.java - Copy Repository
src/main/java/com/jpoltramari/library_api/domain/repository/BookCopyRepository.java - Author Repository
src/main/java/com/jpoltramari/library_api/domain/repository/AuthorRepository.java
Other components
- API Client
- PostgreSQL
Connections 31
- API Client → Authentication API: requests
README.md - API Client → Catalog API: requests
README.md - API Client → Author API: requests
README.md - API Client → Book Copy API: requests
README.md - API Client → Loan API: requests
README.md - API Client → User API: requests
README.md - Authentication API → Authentication: delegates
README.md - Catalog API → Book Catalog: delegates
README.md - Author API → Author Management: delegates
README.md - Book Copy API → Copy Management: delegates
src/main/java/com/jpoltramari/library_api/api/controller/BookCopyController.java - Loan API → Loan Circulation: delegates
src/main/java/com/jpoltramari/library_api/api/controller/LoanController.java - User API → User Management: delegates
README.md - Authentication → User Repository: loads user
src/main/java/com/jpoltramari/library_api/application/service/AuthService.java - Authentication → JWT Validation: blacklists token
src/main/java/com/jpoltramari/library_api/application/service/AuthService.java - Authentication → Refresh Tokens: issues or rotates
src/main/java/com/jpoltramari/library_api/application/service/AuthService.java - Book Catalog → Book Repository: queries and saves
src/main/java/com/jpoltramari/library_api/application/service/BookService.java - Book Catalog → Author Repository: loads authors
src/main/java/com/jpoltramari/library_api/application/service/BookService.java - Book Catalog → Copy Repository: creates copies
src/main/java/com/jpoltramari/library_api/application/service/BookService.java - Author Management → Author Repository: queries and saves
src/main/java/com/jpoltramari/library_api/application/service/AuthorService.java - Loan Circulation → User Repository: loads borrower
src/main/java/com/jpoltramari/library_api/application/service/LoanService.java - Loan Circulation → Book Repository: checks book
src/main/java/com/jpoltramari/library_api/application/service/LoanService.java - Loan Circulation → Copy Repository: selects and updates copy
src/main/java/com/jpoltramari/library_api/application/service/LoanService.java - Loan Circulation → Loan Repository: checks and saves loans
src/main/java/com/jpoltramari/library_api/application/service/LoanService.java - Refresh Tokens → User Repository: loads user
src/main/java/com/jpoltramari/library_api/infrastructure/security/jwt/RefreshTokenService.java - Refresh Tokens → Token Versions: revokes sessions
src/main/java/com/jpoltramari/library_api/infrastructure/security/jwt/RefreshTokenService.java - JWT Validation → PostgreSQL: blacklist state
- Loan Repository → PostgreSQL: persists loans
README.md - Book Repository → PostgreSQL: persists catalog
README.md - Copy Repository → PostgreSQL: persists copies
README.md - Author Repository → PostgreSQL: persists authors
README.md - User Repository → PostgreSQL: persists users
README.md