How vishesh233/libverse works
LibVerse is a role-based library management application: students discover and borrow books, librarians handle desk and request workflows, and admins manage the library and its reporting. The React client calls an Express API backed by MongoDB; a separate Python service provides recommendations, and a scheduled job handles reminders and reservation expiry. The graph preserves the documented authentication, catalogue, loan, reservation, fines, notification, reporting, and AI capabilities. Some frontend and AI internals were not sampled, so only documented or indexed connections are shown.
Main entry points: app.js Express API · transactionController.js Loan workflows · reservationService.js Reservation queue · Transaction.js Loan records
Components 21
Web client
- React application
frontend/src/App.jsx
API workflows
- Express API
backend/app.js - Authentication
backend/controllers/authController.js - Book catalogue
backend/controllers/bookController.js - Loan workflows
backend/controllers/transactionController.js - Counter desk
backend/controllers/deskController.js - Desk service
backend/services/deskService.js - Reservation queue
backend/services/reservationService.js - Notifications
backend/controllers/notificationController.js - Analytics and reports
backend/controllers/analyticsController.js - Route security
backend/middleware/authMiddleware.js
Library domain
- Member records
backend/models/User.js - Catalogue records
backend/models/Book.js - Loan records
backend/models/Transaction.js - Reservation records
backend/models/Reservation.js - Fine rules
backend/utils/fineCalculator.js - Audit trail
backend/utils/audit.js - MongoDB
Background services
- Reminder job
backend/jobs/reminders.js - Book recommendations
ai-service/app.py
Other components
- Browser
Connections 25
- Browser → React application: uses
- React application → Express API: calls
- Express API → Book catalogue: routes requests
backend/app.js - Express API → Loan workflows: routes requests
backend/app.js - Express API → Authentication: routes requests
backend/app.js - Authentication → Member records: reads and writes
backend/controllers/authController.js - Loan workflows → Loan records: reads and writes
backend/controllers/transactionController.js - Loan workflows → Catalogue records: updates copies
backend/controllers/transactionController.js - Loan workflows → Reservation queue: calls
backend/controllers/transactionController.js - Loan workflows → Fine rules: calculates fines
backend/controllers/transactionController.js - Counter desk → Desk service: delegates to
backend/controllers/deskController.js - Desk service → Reservation queue: calls
backend/services/deskService.js - Desk service → Loan records: updates loans
backend/services/deskService.js - Reservation queue → Reservation records: reads and writes
backend/services/reservationService.js - Reservation queue → Catalogue records: updates stock
backend/services/reservationService.js - Reservation queue → Notifications: notifies members
backend/services/reservationService.js - Reminder job → Loan records: checks loans
backend/jobs/reminders.js - Reminder job → Reservation queue: expires holds
backend/jobs/reminders.js - Reminder job → Notifications: sends reminders
backend/jobs/reminders.js - Book catalogue → Book recommendations: requests picks
backend/controllers/bookController.js - Express API → MongoDB: persists data
- Express API → Book recommendations: requests recommendations
- Analytics and reports → Loan records: reports on
- Loan workflows → Audit trail: records actions
backend/controllers/transactionController.js - Express API → Route security: protects routes