# vishesh233/libverse architecture

> Architecture diagram of the GitHub repository vishesh233/libverse, generated by GitDiagram from its file tree, README and a sample of source files (last updated 2026-11-22). It is an AI-made overview: check details against the source.

- Interactive diagram: https://gitdiagram.com/vishesh233/libverse
- Repository: https://github.com/vishesh233/libverse

## Overview

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: [`backend/app.js`](https://github.com/vishesh233/libverse/blob/main/backend/app.js) (Express API), [`backend/controllers/transactionController.js`](https://github.com/vishesh233/libverse/blob/main/backend/controllers/transactionController.js) (Loan workflows), [`backend/services/reservationService.js`](https://github.com/vishesh233/libverse/blob/main/backend/services/reservationService.js) (Reservation queue), [`backend/models/Transaction.js`](https://github.com/vishesh233/libverse/blob/main/backend/models/Transaction.js) (Loan records)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_client["Web client"]
  node_frontend["React application<br/>[App.jsx]"]
end

subgraph group_api["API workflows"]
  node_api["Express API<br/>[app.js]"]
  node_auth["Authentication<br/>[authController.js]"]
  node_catalogue["Book catalogue<br/>[bookController.js]"]
  node_loans["Loan workflows"]
  node_desk["Counter desk<br/>[deskController.js]"]
  node_backenddeskservice["Desk service<br/>[deskService.js]"]
  node_reservations["Reservation queue"]
  node_notifications["Notifications"]
  node_analytics["Analytics and reports"]
  node_security["Route security<br/>[authMiddleware.js]"]
end

subgraph group_domain["Library domain"]
  node_userstore[("Member records<br/>[User.js]")]
  node_bookstore[("Catalogue records<br/>[Book.js]")]
  node_loanstore[("Loan records<br/>[Transaction.js]")]
  node_reservationstore[("Reservation records<br/>[Reservation.js]")]
  node_fine["Fine rules<br/>[fineCalculator.js]"]
  node_audit["Audit trail<br/>[audit.js]"]
  node_database[("MongoDB")]
end

subgraph group_support["Background services"]
  node_reminders["Reminder job<br/>[reminders.js]"]
  node_ai["Book recommendations<br/>[app.py]"]
end

node_browser(("Browser"))

node_browser -->|"uses"| node_frontend
node_frontend -->|"calls"| node_api
node_api -->|"routes requests"| node_catalogue
node_api -->|"routes requests"| node_loans
node_api -->|"routes requests"| node_auth
node_auth -->|"reads and writes"| node_userstore
node_loans -->|"reads and writes"| node_loanstore
node_loans -->|"updates copies"| node_bookstore
node_loans -->|"calls"| node_reservations
node_loans -->|"calculates fines"| node_fine
node_desk -->|"delegates to"| node_backenddeskservice
node_backenddeskservice -->|"calls"| node_reservations
node_backenddeskservice -->|"updates loans"| node_loanstore
node_reservations -->|"reads and writes"| node_reservationstore
node_reservations -->|"updates stock"| node_bookstore
node_reservations -->|"notifies members"| node_notifications
node_reminders -->|"checks loans"| node_loanstore
node_reminders -->|"expires holds"| node_reservations
node_reminders -->|"sends reminders"| node_notifications
node_catalogue -.->|"requests picks"| node_ai
node_api -->|"persists data"| node_database
node_api -->|"requests recommendations"| node_ai
node_analytics -.->|"reports on"| node_loanstore
node_loans -.->|"records actions"| node_audit
node_api -->|"protects routes"| node_security

click node_frontend "https://github.com/vishesh233/libverse/blob/main/frontend/src/App.jsx"
click node_api "https://github.com/vishesh233/libverse/blob/main/backend/app.js"
click node_auth "https://github.com/vishesh233/libverse/blob/main/backend/controllers/authController.js"
click node_catalogue "https://github.com/vishesh233/libverse/blob/main/backend/controllers/bookController.js"
click node_loans "https://github.com/vishesh233/libverse/blob/main/backend/controllers/transactionController.js"
click node_desk "https://github.com/vishesh233/libverse/blob/main/backend/controllers/deskController.js"
click node_backenddeskservice "https://github.com/vishesh233/libverse/blob/main/backend/services/deskService.js"
click node_reservations "https://github.com/vishesh233/libverse/blob/main/backend/services/reservationService.js"
click node_notifications "https://github.com/vishesh233/libverse/blob/main/backend/controllers/notificationController.js"
click node_analytics "https://github.com/vishesh233/libverse/blob/main/backend/controllers/analyticsController.js"
click node_userstore "https://github.com/vishesh233/libverse/blob/main/backend/models/User.js"
click node_bookstore "https://github.com/vishesh233/libverse/blob/main/backend/models/Book.js"
click node_loanstore "https://github.com/vishesh233/libverse/blob/main/backend/models/Transaction.js"
click node_reservationstore "https://github.com/vishesh233/libverse/blob/main/backend/models/Reservation.js"
click node_fine "https://github.com/vishesh233/libverse/blob/main/backend/utils/fineCalculator.js"
click node_security "https://github.com/vishesh233/libverse/blob/main/backend/middleware/authMiddleware.js"
click node_audit "https://github.com/vishesh233/libverse/blob/main/backend/utils/audit.js"
click node_reminders "https://github.com/vishesh233/libverse/blob/main/backend/jobs/reminders.js"
click node_ai "https://github.com/vishesh233/libverse/blob/main/ai-service/app.py"

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_frontend,node_browser toneBlue
class node_api,node_auth,node_catalogue,node_loans,node_desk,node_backenddeskservice,node_reservations,node_notifications,node_analytics,node_security toneAmber
class node_userstore,node_bookstore,node_loanstore,node_reservationstore,node_fine,node_audit,node_database toneMint
class node_reminders,node_ai toneRose
```

## Components

### Web client

- [React application](https://github.com/vishesh233/libverse/blob/main/frontend/src/App.jsx): `frontend/src/App.jsx`

### API workflows

- [Express API](https://github.com/vishesh233/libverse/blob/main/backend/app.js): `backend/app.js`
- [Authentication](https://github.com/vishesh233/libverse/blob/main/backend/controllers/authController.js): `backend/controllers/authController.js`
- [Book catalogue](https://github.com/vishesh233/libverse/blob/main/backend/controllers/bookController.js): `backend/controllers/bookController.js`
- [Loan workflows](https://github.com/vishesh233/libverse/blob/main/backend/controllers/transactionController.js): `backend/controllers/transactionController.js`
- [Counter desk](https://github.com/vishesh233/libverse/blob/main/backend/controllers/deskController.js): `backend/controllers/deskController.js`
- [Desk service](https://github.com/vishesh233/libverse/blob/main/backend/services/deskService.js): `backend/services/deskService.js`
- [Reservation queue](https://github.com/vishesh233/libverse/blob/main/backend/services/reservationService.js): `backend/services/reservationService.js`
- [Notifications](https://github.com/vishesh233/libverse/blob/main/backend/controllers/notificationController.js): `backend/controllers/notificationController.js`
- [Analytics and reports](https://github.com/vishesh233/libverse/blob/main/backend/controllers/analyticsController.js): `backend/controllers/analyticsController.js`
- [Route security](https://github.com/vishesh233/libverse/blob/main/backend/middleware/authMiddleware.js): `backend/middleware/authMiddleware.js`

### Library domain

- [Member records](https://github.com/vishesh233/libverse/blob/main/backend/models/User.js): `backend/models/User.js`
- [Catalogue records](https://github.com/vishesh233/libverse/blob/main/backend/models/Book.js): `backend/models/Book.js`
- [Loan records](https://github.com/vishesh233/libverse/blob/main/backend/models/Transaction.js): `backend/models/Transaction.js`
- [Reservation records](https://github.com/vishesh233/libverse/blob/main/backend/models/Reservation.js): `backend/models/Reservation.js`
- [Fine rules](https://github.com/vishesh233/libverse/blob/main/backend/utils/fineCalculator.js): `backend/utils/fineCalculator.js`
- [Audit trail](https://github.com/vishesh233/libverse/blob/main/backend/utils/audit.js): `backend/utils/audit.js`
- **MongoDB**

### Background services

- [Reminder job](https://github.com/vishesh233/libverse/blob/main/backend/jobs/reminders.js): `backend/jobs/reminders.js`
- [Book recommendations](https://github.com/vishesh233/libverse/blob/main/ai-service/app.py): `ai-service/app.py`

### Other components

- **Browser**

## Connections

- Browser → React application: uses
- React application → Express API: calls
- Express API → Book catalogue: routes requests (evidence: `backend/app.js`)
- Express API → Loan workflows: routes requests (evidence: `backend/app.js`)
- Express API → Authentication: routes requests (evidence: `backend/app.js`)
- Authentication → Member records: reads and writes (evidence: `backend/controllers/authController.js`)
- Loan workflows → Loan records: reads and writes (evidence: `backend/controllers/transactionController.js`)
- Loan workflows → Catalogue records: updates copies (evidence: `backend/controllers/transactionController.js`)
- Loan workflows → Reservation queue: calls (evidence: `backend/controllers/transactionController.js`)
- Loan workflows → Fine rules: calculates fines (evidence: `backend/controllers/transactionController.js`)
- Counter desk → Desk service: delegates to (evidence: `backend/controllers/deskController.js`)
- Desk service → Reservation queue: calls (evidence: `backend/services/deskService.js`)
- Desk service → Loan records: updates loans (evidence: `backend/services/deskService.js`)
- Reservation queue → Reservation records: reads and writes (evidence: `backend/services/reservationService.js`)
- Reservation queue → Catalogue records: updates stock (evidence: `backend/services/reservationService.js`)
- Reservation queue → Notifications: notifies members (evidence: `backend/services/reservationService.js`)
- Reminder job → Loan records: checks loans (evidence: `backend/jobs/reminders.js`)
- Reminder job → Reservation queue: expires holds (evidence: `backend/jobs/reminders.js`)
- Reminder job → Notifications: sends reminders (evidence: `backend/jobs/reminders.js`)
- Book catalogue → Book recommendations: requests picks (evidence: `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 (evidence: `backend/controllers/transactionController.js`)
- Express API → Route security: protects routes
