How badwanecr/advanced-library works
LibAssist is a library-management application with a React client, Spring Boot REST API, and PostgreSQL persistence. Patrons browse physical and digital titles, borrow books, rent ebooks or subscribe, and read ebooks; librarians manage catalogue and circulation, while admins can view reports and manage staff accounts. Ebook reading can additionally use ebook-grounded Q&A with page citations. The map preserves those branches and the payment, indexing, and retrieval stages. Some backend controllers and services were not sampled, so their internal wiring is omitted where the excerpts and README do not establish it.
Main entry points: App.js React application · EbookRagService.java Grounded Q&A · PaymentOrderService.java Order creation · PaymentVerificationService.java Payment verification
Components 34
React client
- React application
frontend/src/App.js - Book browsing
frontend/src/pages/Home/Library.js - Ebook browsing
frontend/src/pages/Home/Ebooks.js - Ebook reader
frontend/src/pages/EbookReader/index.js - Ask panel
frontend/src/pages/EbookReader/AskPanel.js - Profile and reports
frontend/src/pages/Profile/index.js
Library operations
- Book endpoints
backend/src/main/java/com/libassist/library/controller/BookController.java - Book catalogue
backend/src/main/java/com/libassist/library/service/BookService.java - Circulation endpoints
backend/src/main/java/com/libassist/library/controller/IssueController.java - Issue and return
backend/src/main/java/com/libassist/library/service/IssueService.java - Report endpoints
backend/src/main/java/com/libassist/library/controller/ReportController.java - Revenue reporting
backend/src/main/java/com/libassist/library/service/ReportService.java
Ebook experience
- Ebook endpoints
backend/src/main/java/com/libassist/library/controller/EbookController.java - Ebook access and reading
backend/src/main/java/com/libassist/library/service/EbookService.java - Ebook question endpoint
backend/src/main/java/com/libassist/library/controller/EbookAskController.java - Grounded Q&A
backend/src/main/java/com/libassist/library/rag/EbookRagService.java - PDF indexing
backend/src/main/java/com/libassist/library/rag/EbookIndexingService.java - Embedding client
backend/src/main/java/com/libassist/library/rag/OpenAiEmbeddingService.java - Ebook records
backend/src/main/java/com/libassist/library/entity/Ebook.java - Ebook repository
backend/src/main/java/com/libassist/library/repository/EbookRepository.java
Access and payments
- Payment endpoints
backend/src/main/java/com/libassist/library/controller/PaymentController.java - Order creation
backend/src/main/java/com/libassist/library/payment/PaymentOrderService.java - Payment verification
backend/src/main/java/com/libassist/library/payment/PaymentVerificationService.java - Subscription access
backend/src/main/java/com/libassist/library/service/SubscriptionService.java - Payment records
backend/src/main/java/com/libassist/library/entity/Payment.java - Payment repository
backend/src/main/java/com/libassist/library/repository/PaymentRepository.java
Identity and persistence
- User endpoints
backend/src/main/java/com/libassist/library/controller/UserController.java - User accounts
backend/src/main/java/com/libassist/library/service/UserService.java - JWT security
backend/src/main/java/com/libassist/library/security/JwtAuthFilter.java - User records
backend/src/main/java/com/libassist/library/entity/User.java - User repository
backend/src/main/java/com/libassist/library/repository/UserRepository.java
Other components
- Patron
- Razorpay
- PostgreSQL
Connections 35
- Patron → React application: uses
README.md - React application → Book endpoints: requests catalogue
README.md - React application → Circulation endpoints: requests borrowing
README.md - React application → Ebook endpoints: requests ebook access
README.md - React application → User endpoints: registers and logs in
README.md - React application → Report endpoints: requests reports
README.md - Book endpoints → Book catalogue
backend/src/main/java/com/libassist/library/controller/BookController.java - Circulation endpoints → Issue and return: delegates
backend/src/main/java/com/libassist/library/service/IssueService.java - Report endpoints → Revenue reporting
- Ebook endpoints → Ebook access and reading
backend/src/main/java/com/libassist/library/controller/EbookController.java - Ebook question endpoint → Grounded Q&A
- Payment endpoints → Order creation
backend/src/main/java/com/libassist/library/controller/PaymentController.java - Payment endpoints → Payment verification
backend/src/main/java/com/libassist/library/controller/PaymentController.java - User endpoints → User accounts
- Ebook browsing → Ebook reader: opens reader
- Ebook reader → Ask panel: offers questions
frontend/src/pages/EbookReader/index.js - Order creation → Razorpay: creates orders
backend/src/main/java/com/libassist/library/payment/PaymentOrderService.java - Payment verification → Subscription access: activates access
backend/src/main/java/com/libassist/library/payment/PaymentVerificationService.java - Payment verification → Ebook access and reading: activates rental
backend/src/main/java/com/libassist/library/payment/PaymentVerificationService.java - Payment verification → Payment repository: loads payment
backend/src/main/java/com/libassist/library/payment/PaymentVerificationService.java - Order creation → Ebook repository: loads ebook
backend/src/main/java/com/libassist/library/payment/PaymentOrderService.java - Order creation → User repository: loads patron
backend/src/main/java/com/libassist/library/payment/PaymentOrderService.java - Grounded Q&A → Ebook access and reading: checks reading access
backend/src/main/java/com/libassist/library/rag/EbookRagService.java - Grounded Q&A → Embedding client: embeds question
backend/src/main/java/com/libassist/library/rag/EbookRagService.java - PDF indexing → Embedding client: embeds chunks
backend/src/main/java/com/libassist/library/rag/EbookIndexingService.java - Ebook access and reading → PDF indexing: starts indexing
backend/src/main/java/com/libassist/library/service/EbookService.java - Grounded Q&A → Ebook repository: loads ebook
backend/src/main/java/com/libassist/library/rag/EbookRagService.java - Grounded Q&A → User repository: loads user
backend/src/main/java/com/libassist/library/rag/EbookRagService.java - User repository → User records: loads records
backend/src/main/java/com/libassist/library/repository/UserRepository.java - Ebook repository → Ebook records: loads records
backend/src/main/java/com/libassist/library/rag/EbookRagService.java - Payment repository → Payment records: loads records
backend/src/main/java/com/libassist/library/payment/PaymentVerificationService.java - User records → PostgreSQL: persists
README.md - Ebook records → PostgreSQL: persists
README.md - Payment records → PostgreSQL: persists
README.md - Payment endpoints → Razorpay: accepts webhook