# khan-aamir01/library-management-system architecture

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

- Interactive diagram: https://gitdiagram.com/khan-aamir01/library-management-system
- Repository: https://github.com/khan-aamir01/library-management-system

## Overview

This is a MERN library-management application. Users register or sign in, browse and search a book catalog, and request borrowing; administrators manage books and members, process requests and loans, and review fines. Backend controllers handle catalog, account, borrowing, and fine operations against MongoDB models; scheduled jobs also update loan statuses. The route tree and controller/model relationships are supported by excerpts or the SOURCE INDEX. Frontend-to-backend request wiring was not shown, so that link is marked unverified.

Main entry points: [`frontend/src/main.jsx`](https://github.com/khan-aamir01/library-management-system/blob/main/frontend/src/main.jsx) (Role routes), [`backend/server.js`](https://github.com/khan-aamir01/library-management-system/blob/main/backend/server.js) (Express server), [`backend/controllers/userController.js`](https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/userController.js) (Account operations), [`backend/controllers/auth`](https://github.com/khan-aamir01/library-management-system/tree/main/backend/controllers/auth) (Authentication)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_web["Web application"]
  node_web_routes["Role routes<br/>[main.jsx]"]
  node_user_catalog["User catalog"]
  node_user_account["User account"]
  node_admin_catalog["Admin catalog"]
  node_admin_members["Member management"]
  node_admin_requests["Request queue"]
  node_admin_loans["Loan dashboard"]
  node_admin_fines["Late fees"]
end

subgraph group_api["API and domain"]
  node_server["Express server<br/>[server.js]"]
  node_book_routes["Book routes<br/>[bookRoutes.js]"]
  node_user_routes["User routes<br/>[userRoutes.js]"]
  node_borrow_routes["Borrow routes<br/>[borrowRoutes.js]"]
  node_fine_routes["Fine routes<br/>[fineRoutes.js]"]
  node_auth_routes["Auth routes<br/>[authRoutes.js]"]
  node_book_domain["Catalog operations<br/>[bookController.js]"]
  node_user_domain["Account operations<br/>[userController.js]"]
  node_auth_domain["Authentication"]
  node_borrow_domain["Borrow operations"]
  node_fine_domain["Fine operations<br/>[fineController.js]"]
  node_email["Email delivery<br/>[emailService.js]"]
  node_reset_email["Reset email"]
end

subgraph group_records["MongoDB records"]
  node_books[("Book records<br/>[books.js]")]
  node_users[("User records<br/>[user.js]")]
  node_admins[("Admin records<br/>[admin.js]")]
  node_borrows[("Borrow records<br/>[borrow.js]")]
  node_fines[("Fine records<br/>[fine.js]")]
  node_otp[("OTP records<br/>[otp.js]")]
end

subgraph group_automation["Scheduled operations"]
  node_expired_job["Expire requests"]
  node_overdue_job["Overdue processing"]
end

node_visitor(("Library user"))
node_librarian(("Librarian"))

node_visitor -->|"uses"| node_web_routes
node_librarian -->|"uses"| node_web_routes
node_web_routes -->|"routes to"| node_user_catalog
node_web_routes -->|"routes to"| node_user_account
node_web_routes -->|"routes to"| node_admin_catalog
node_web_routes -->|"routes to"| node_admin_members
node_web_routes -->|"routes to"| node_admin_requests
node_web_routes -->|"routes to"| node_admin_loans
node_web_routes -->|"routes to"| node_admin_fines
node_web_routes -.->|"calls API"| node_server
node_server -->|"mounts"| node_book_routes
node_server -->|"mounts"| node_user_routes
node_server -->|"mounts"| node_borrow_routes
node_server -->|"mounts"| node_fine_routes
node_server -->|"mounts"| node_auth_routes
node_book_routes -->|"dispatches"| node_book_domain
node_user_routes -->|"dispatches"| node_user_domain
node_borrow_routes -->|"dispatches"| node_borrow_domain
node_fine_routes -->|"dispatches"| node_fine_domain
node_auth_routes -->|"dispatches"| node_auth_domain
node_book_domain -->|"reads/writes"| node_books
node_user_domain -->|"reads/writes"| node_users
node_user_domain -->|"reads"| node_borrows
node_user_domain -->|"reads"| node_fines
node_user_domain -->|"reads/writes"| node_otp
node_user_domain -->|"sends OTP"| node_reset_email
node_auth_domain -->|"uses"| node_users
node_auth_domain -->|"uses"| node_admins
node_auth_domain -->|"uses"| node_otp
node_auth_domain -->|"sends email"| node_email
node_borrow_domain -->|"reads/writes"| node_borrows
node_borrow_domain -->|"reads"| node_books
node_borrow_domain -->|"reads"| node_users
node_fine_domain -->|"reads/writes"| node_fines
node_fine_domain -->|"reads"| node_users
node_fine_domain -->|"reads"| node_books
node_expired_job -->|"updates status"| node_borrows
node_overdue_job -->|"checks loans"| node_borrows
node_overdue_job -->|"references"| node_users
node_overdue_job -->|"creates fines"| node_fines
node_overdue_job -->|"updates availability"| node_books

click node_web_routes "https://github.com/khan-aamir01/library-management-system/blob/main/frontend/src/main.jsx"
click node_user_catalog "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/User/Books"
click node_user_account "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/User"
click node_admin_catalog "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/Books"
click node_admin_members "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/Members"
click node_admin_requests "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/PendingRequest"
click node_admin_loans "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/bookOnLoan"
click node_admin_fines "https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/LateFeesBooks"
click node_server "https://github.com/khan-aamir01/library-management-system/blob/main/backend/server.js"
click node_book_routes "https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/bookRoutes.js"
click node_user_routes "https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/userRoutes.js"
click node_borrow_routes "https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/borrowRoutes.js"
click node_fine_routes "https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/fineRoutes.js"
click node_auth_routes "https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/authRoutes.js"
click node_book_domain "https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/bookController.js"
click node_user_domain "https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/userController.js"
click node_auth_domain "https://github.com/khan-aamir01/library-management-system/tree/main/backend/controllers/auth"
click node_borrow_domain "https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/borrowController.js"
click node_fine_domain "https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/fineController.js"
click node_books "https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/books.js"
click node_users "https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/user.js"
click node_admins "https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/admin.js"
click node_borrows "https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/borrow.js"
click node_fines "https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/fine.js"
click node_otp "https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/otp.js"
click node_expired_job "https://github.com/khan-aamir01/library-management-system/blob/main/backend/cronJobs/updateExpiredStatus.js"
click node_overdue_job "https://github.com/khan-aamir01/library-management-system/blob/main/backend/cronJobs/updateNotReturnStatus.js"
click node_email "https://github.com/khan-aamir01/library-management-system/blob/main/backend/services/emailService.js"
click node_reset_email "https://github.com/khan-aamir01/library-management-system/blob/main/backend/services/updatePassEmailService.js"

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_web_routes,node_user_catalog,node_user_account,node_admin_catalog,node_admin_members,node_admin_requests,node_admin_loans,node_admin_fines,node_visitor toneBlue
class node_server,node_book_routes,node_user_routes,node_borrow_routes,node_fine_routes,node_auth_routes,node_book_domain,node_user_domain,node_auth_domain,node_borrow_domain,node_fine_domain,node_email,node_reset_email toneAmber
class node_books,node_users,node_admins,node_borrows,node_fines,node_otp toneMint
class node_expired_job,node_overdue_job toneRose
class node_librarian toneIndigo
```

## Components

### Web application

- [Role routes](https://github.com/khan-aamir01/library-management-system/blob/main/frontend/src/main.jsx): `frontend/src/main.jsx`
- [User catalog](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/User/Books): `frontend/src/components/User/Books`
- [User account](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/User): `frontend/src/components/User`
- [Admin catalog](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/Books): `frontend/src/components/Admin/Books`
- [Member management](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/Members): `frontend/src/components/Admin/Members`
- [Request queue](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/PendingRequest): `frontend/src/components/Admin/PendingRequest`
- [Loan dashboard](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/bookOnLoan): `frontend/src/components/Admin/bookOnLoan`
- [Late fees](https://github.com/khan-aamir01/library-management-system/tree/main/frontend/src/components/Admin/LateFeesBooks): `frontend/src/components/Admin/LateFeesBooks`

### API and domain

- [Express server](https://github.com/khan-aamir01/library-management-system/blob/main/backend/server.js): `backend/server.js`
- [Book routes](https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/bookRoutes.js): `backend/routes/bookRoutes.js`
- [User routes](https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/userRoutes.js): `backend/routes/userRoutes.js`
- [Borrow routes](https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/borrowRoutes.js): `backend/routes/borrowRoutes.js`
- [Fine routes](https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/fineRoutes.js): `backend/routes/fineRoutes.js`
- [Auth routes](https://github.com/khan-aamir01/library-management-system/blob/main/backend/routes/authRoutes.js): `backend/routes/authRoutes.js`
- [Catalog operations](https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/bookController.js): `backend/controllers/bookController.js`
- [Account operations](https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/userController.js): `backend/controllers/userController.js`
- [Authentication](https://github.com/khan-aamir01/library-management-system/tree/main/backend/controllers/auth): `backend/controllers/auth`
- [Borrow operations](https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/borrowController.js): `backend/controllers/borrowController.js`
- [Fine operations](https://github.com/khan-aamir01/library-management-system/blob/main/backend/controllers/fineController.js): `backend/controllers/fineController.js`
- [Email delivery](https://github.com/khan-aamir01/library-management-system/blob/main/backend/services/emailService.js): `backend/services/emailService.js`
- [Reset email](https://github.com/khan-aamir01/library-management-system/blob/main/backend/services/updatePassEmailService.js): `backend/services/updatePassEmailService.js`

### MongoDB records

- [Book records](https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/books.js): `backend/models/books.js`
- [User records](https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/user.js): `backend/models/user.js`
- [Admin records](https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/admin.js): `backend/models/admin.js`
- [Borrow records](https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/borrow.js): `backend/models/borrow.js`
- [Fine records](https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/fine.js): `backend/models/fine.js`
- [OTP records](https://github.com/khan-aamir01/library-management-system/blob/main/backend/models/otp.js): `backend/models/otp.js`

### Scheduled operations

- [Expire requests](https://github.com/khan-aamir01/library-management-system/blob/main/backend/cronJobs/updateExpiredStatus.js): `backend/cronJobs/updateExpiredStatus.js`
- [Overdue processing](https://github.com/khan-aamir01/library-management-system/blob/main/backend/cronJobs/updateNotReturnStatus.js): `backend/cronJobs/updateNotReturnStatus.js`

### Other components

- **Library user**
- **Librarian**

## Connections

- Library user → Role routes: uses (evidence: `frontend/src/main.jsx`)
- Librarian → Role routes: uses (evidence: `frontend/src/main.jsx`)
- Role routes → User catalog: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → User account: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → Admin catalog: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → Member management: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → Request queue: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → Loan dashboard: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → Late fees: routes to (evidence: `frontend/src/main.jsx`)
- Role routes → Express server: calls API
- Express server → Book routes: mounts (evidence: `backend/server.js`)
- Express server → User routes: mounts (evidence: `backend/server.js`)
- Express server → Borrow routes: mounts (evidence: `backend/server.js`)
- Express server → Fine routes: mounts (evidence: `backend/server.js`)
- Express server → Auth routes: mounts (evidence: `backend/server.js`)
- Book routes → Catalog operations: dispatches (evidence: `backend/routes/bookRoutes.js`)
- User routes → Account operations: dispatches (evidence: `backend/routes/userRoutes.js`)
- Borrow routes → Borrow operations: dispatches (evidence: `backend/routes/borrowRoutes.js`)
- Fine routes → Fine operations: dispatches (evidence: `backend/routes/fineRoutes.js`)
- Auth routes → Authentication: dispatches (evidence: `backend/routes/authRoutes.js`)
- Catalog operations → Book records: reads/writes (evidence: `backend/controllers/bookController.js`)
- Account operations → User records: reads/writes (evidence: `backend/controllers/userController.js`)
- Account operations → Borrow records: reads (evidence: `backend/controllers/userController.js`)
- Account operations → Fine records: reads (evidence: `backend/controllers/userController.js`)
- Account operations → OTP records: reads/writes (evidence: `backend/controllers/userController.js`)
- Account operations → Reset email: sends OTP (evidence: `backend/controllers/userController.js`)
- Authentication → User records: uses (evidence: `backend/controllers/auth/userAuth.js`)
- Authentication → Admin records: uses (evidence: `backend/controllers/auth/adminAuth.js`)
- Authentication → OTP records: uses (evidence: `backend/controllers/auth/userAuth.js`)
- Authentication → Email delivery: sends email (evidence: `backend/controllers/auth/userAuth.js`)
- Borrow operations → Borrow records: reads/writes (evidence: `backend/controllers/borrowController.js`)
- Borrow operations → Book records: reads (evidence: `backend/controllers/borrowController.js`)
- Borrow operations → User records: reads (evidence: `backend/controllers/borrowController.js`)
- Fine operations → Fine records: reads/writes (evidence: `backend/controllers/fineController.js`)
- Fine operations → User records: reads (evidence: `backend/controllers/fineController.js`)
- Fine operations → Book records: reads (evidence: `backend/controllers/fineController.js`)
- Expire requests → Borrow records: updates status (evidence: `backend/cronJobs/updateExpiredStatus.js`)
- Overdue processing → Borrow records: checks loans (evidence: `backend/cronJobs/updateNotReturnStatus.js`)
- Overdue processing → User records: references (evidence: `backend/cronJobs/updateNotReturnStatus.js`)
- Overdue processing → Fine records: creates fines (evidence: `backend/cronJobs/updateNotReturnStatus.js`)
- Overdue processing → Book records: updates availability (evidence: `backend/cronJobs/updateNotReturnStatus.js`)
