# nikkkitosss/library-management-system architecture

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

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

## Overview

This is an Express backend for a library management system. Requests enter through the HTTP routes, pass applicable validation and authorization, reach controllers, and then invoke domain services; services use Prisma for persistent user, book, and loan operations. Major workflows cover authentication and password recovery, catalog administration, user profiles and avatar management, and loan creation/return/listing. Sampled source confirms the auth, book, and avatar call paths; the README documents loan and SMTP capabilities whose implementation details were not fully sampled.

Main entry points: [`src/routes/index.ts`](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/index.ts) (Route Mounts), [`src/db/client.ts`](https://github.com/nikkkitosss/library-management-system/blob/main/src/db/client.ts) (Prisma Client), [`src/routes/auth.routes.ts`](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/auth.routes.ts) (Auth Routes), [`src/routes/books.routes.ts`](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/books.routes.ts) (Book Routes)

## Diagram (Mermaid)

```mermaid
flowchart TD

subgraph group_api["HTTP API"]
  node_server["Server Startup<br/>[server.ts]"]
  node_app["Express App<br/>[app.ts]"]
  node_routes["Route Mounts<br/>[index.ts]"]
  node_authroutes["Auth Routes<br/>[auth.routes.ts]"]
  node_bookroutes["Book Routes<br/>[books.routes.ts]"]
  node_loanroutes["Loan Routes<br/>[loans.routes.ts]"]
  node_userroutes["User Routes<br/>[users.routes.ts]"]
  node_authctrl["Auth Controller<br/>[authController.ts]"]
  node_bookctrl["Book Controller<br/>[bookController.ts]"]
  node_loanctrl["Loan Controller<br/>[loanController.ts]"]
  node_userctrl["User Controller<br/>[userController.ts]"]
end

subgraph group_domain["Domain Services"]
  node_authsvc["Authentication<br/>[authService.ts]"]
  node_booksvc["Book Catalog<br/>[bookService.ts]"]
  node_loansvc["Loan Management<br/>[loanService.ts]"]
  node_usersvc["User Management<br/>[userService.ts]"]
end

subgraph group_shared["Shared Infrastructure"]
  node_schemas["Request Schemas<br/>[index.ts]"]
  node_authmw["JWT Authorization<br/>[auth.middleware.ts]"]
  node_uploadmw["Upload Middleware"]
  node_config["Configuration<br/>[config.ts]"]
  node_mailer["Email Delivery<br/>[sendMail.ts]"]
  node_avatarfiles["Avatar Processing<br/>[avatarFiles.ts]"]
end

subgraph group_state["Persistence and Files"]
  node_dbclient["Prisma Client<br/>[client.ts]"]
  node_database[("Library Database<br/>[schema.prisma]")]
  node_avatarstore[("Avatar Files<br/>[app.ts]")]
end

node_client(("API Client"))
node_smtp["SMTP Service"]

node_client -->|"sends requests"| node_app
node_server -->|"starts"| node_app
node_app -->|"mounts"| node_routes
node_routes -->|"registers"| node_authroutes
node_routes -->|"registers"| node_bookroutes
node_routes -->|"registers"| node_loanroutes
node_routes -->|"registers"| node_userroutes
node_authroutes -->|"dispatches"| node_authctrl
node_bookroutes -->|"dispatches"| node_bookctrl
node_loanroutes -->|"dispatches"| node_loanctrl
node_userroutes -->|"dispatches"| node_userctrl
node_authroutes -->|"validates with"| node_schemas
node_bookroutes -->|"validates with"| node_schemas
node_loanroutes -->|"validates with"| node_schemas
node_authroutes -->|"protects logout"| node_authmw
node_bookroutes -->|"checks roles"| node_authmw
node_userroutes -->|"protects routes"| node_authmw
node_userroutes -->|"parses uploads"| node_uploadmw
node_authctrl -->|"invokes"| node_authsvc
node_bookctrl -->|"invokes"| node_booksvc
node_loanctrl -->|"invokes"| node_loansvc
node_userctrl -->|"invokes"| node_usersvc
node_userctrl -->|"processes images"| node_avatarfiles
node_authsvc -->|"queries"| node_dbclient
node_booksvc -->|"queries"| node_dbclient
node_loansvc -->|"queries"| node_dbclient
node_usersvc -->|"queries"| node_dbclient
node_dbclient -.->|"accesses"| node_database
node_authsvc -->|"sends reset email"| node_mailer
node_mailer -->|"delivers email"| node_smtp
node_mailer -->|"reads settings"| node_config
node_authsvc -->|"uses token settings"| node_config
node_avatarfiles -.->|"writes images"| node_avatarstore
node_app -->|"serves uploads"| node_avatarstore

click node_server "https://github.com/nikkkitosss/library-management-system/blob/main/src/server.ts"
click node_app "https://github.com/nikkkitosss/library-management-system/blob/main/src/app.ts"
click node_routes "https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/index.ts"
click node_authroutes "https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/auth.routes.ts"
click node_bookroutes "https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/books.routes.ts"
click node_loanroutes "https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/loans.routes.ts"
click node_userroutes "https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/users.routes.ts"
click node_authctrl "https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/authController.ts"
click node_bookctrl "https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/bookController.ts"
click node_loanctrl "https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/loanController.ts"
click node_userctrl "https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/userController.ts"
click node_authsvc "https://github.com/nikkkitosss/library-management-system/blob/main/src/services/authService.ts"
click node_booksvc "https://github.com/nikkkitosss/library-management-system/blob/main/src/services/bookService.ts"
click node_loansvc "https://github.com/nikkkitosss/library-management-system/blob/main/src/services/loanService.ts"
click node_usersvc "https://github.com/nikkkitosss/library-management-system/blob/main/src/services/userService.ts"
click node_schemas "https://github.com/nikkkitosss/library-management-system/blob/main/src/schemas/index.ts"
click node_authmw "https://github.com/nikkkitosss/library-management-system/blob/main/src/middleware/auth.middleware.ts"
click node_uploadmw "https://github.com/nikkkitosss/library-management-system/blob/main/src/middleware/upload.middleware.ts"
click node_config "https://github.com/nikkkitosss/library-management-system/blob/main/src/config.ts"
click node_mailer "https://github.com/nikkkitosss/library-management-system/blob/main/src/utils/sendMail.ts"
click node_avatarfiles "https://github.com/nikkkitosss/library-management-system/blob/main/src/utils/avatarFiles.ts"
click node_dbclient "https://github.com/nikkkitosss/library-management-system/blob/main/src/db/client.ts"
click node_database "https://github.com/nikkkitosss/library-management-system/blob/main/prisma/schema.prisma"
click node_avatarstore "https://github.com/nikkkitosss/library-management-system/blob/main/src/app.ts"

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_server,node_app,node_routes,node_authroutes,node_bookroutes,node_loanroutes,node_userroutes,node_authctrl,node_bookctrl,node_loanctrl,node_userctrl,node_client toneBlue
class node_authsvc,node_booksvc,node_loansvc,node_usersvc toneAmber
class node_schemas,node_authmw,node_uploadmw,node_config,node_mailer,node_avatarfiles toneMint
class node_dbclient,node_database,node_avatarstore toneRose
class node_smtp toneIndigo
```

## Components

### HTTP API

- [Server Startup](https://github.com/nikkkitosss/library-management-system/blob/main/src/server.ts): `src/server.ts`
- [Express App](https://github.com/nikkkitosss/library-management-system/blob/main/src/app.ts): `src/app.ts`
- [Route Mounts](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/index.ts): `src/routes/index.ts`
- [Auth Routes](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/auth.routes.ts): `src/routes/auth.routes.ts`
- [Book Routes](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/books.routes.ts): `src/routes/books.routes.ts`
- [Loan Routes](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/loans.routes.ts): `src/routes/loans.routes.ts`
- [User Routes](https://github.com/nikkkitosss/library-management-system/blob/main/src/routes/users.routes.ts): `src/routes/users.routes.ts`
- [Auth Controller](https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/authController.ts): `src/controllers/authController.ts`
- [Book Controller](https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/bookController.ts): `src/controllers/bookController.ts`
- [Loan Controller](https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/loanController.ts): `src/controllers/loanController.ts`
- [User Controller](https://github.com/nikkkitosss/library-management-system/blob/main/src/controllers/userController.ts): `src/controllers/userController.ts`

### Domain Services

- [Authentication](https://github.com/nikkkitosss/library-management-system/blob/main/src/services/authService.ts): `src/services/authService.ts`
- [Book Catalog](https://github.com/nikkkitosss/library-management-system/blob/main/src/services/bookService.ts): `src/services/bookService.ts`
- [Loan Management](https://github.com/nikkkitosss/library-management-system/blob/main/src/services/loanService.ts): `src/services/loanService.ts`
- [User Management](https://github.com/nikkkitosss/library-management-system/blob/main/src/services/userService.ts): `src/services/userService.ts`

### Shared Infrastructure

- [Request Schemas](https://github.com/nikkkitosss/library-management-system/blob/main/src/schemas/index.ts): `src/schemas/index.ts`
- [JWT Authorization](https://github.com/nikkkitosss/library-management-system/blob/main/src/middleware/auth.middleware.ts): `src/middleware/auth.middleware.ts`
- [Upload Middleware](https://github.com/nikkkitosss/library-management-system/blob/main/src/middleware/upload.middleware.ts): `src/middleware/upload.middleware.ts`
- [Configuration](https://github.com/nikkkitosss/library-management-system/blob/main/src/config.ts): `src/config.ts`
- [Email Delivery](https://github.com/nikkkitosss/library-management-system/blob/main/src/utils/sendMail.ts): `src/utils/sendMail.ts`
- [Avatar Processing](https://github.com/nikkkitosss/library-management-system/blob/main/src/utils/avatarFiles.ts): `src/utils/avatarFiles.ts`

### Persistence and Files

- [Prisma Client](https://github.com/nikkkitosss/library-management-system/blob/main/src/db/client.ts): `src/db/client.ts`
- [Library Database](https://github.com/nikkkitosss/library-management-system/blob/main/prisma/schema.prisma): `prisma/schema.prisma`
- [Avatar Files](https://github.com/nikkkitosss/library-management-system/blob/main/src/app.ts): `src/app.ts`

### Other components

- **API Client**
- **SMTP Service**

## Connections

- API Client → Express App: sends requests (evidence: `README.md`)
- Server Startup → Express App: starts (evidence: `src/server.ts`)
- Express App → Route Mounts: mounts (evidence: `src/app.ts`)
- Route Mounts → Auth Routes: registers (evidence: `src/routes/index.ts`)
- Route Mounts → Book Routes: registers (evidence: `src/routes/index.ts`)
- Route Mounts → Loan Routes: registers (evidence: `src/routes/index.ts`)
- Route Mounts → User Routes: registers (evidence: `src/routes/index.ts`)
- Auth Routes → Auth Controller: dispatches (evidence: `src/routes/auth.routes.ts`)
- Book Routes → Book Controller: dispatches (evidence: `src/routes/books.routes.ts`)
- Loan Routes → Loan Controller: dispatches (evidence: `src/routes/loans.routes.ts`)
- User Routes → User Controller: dispatches (evidence: `src/routes/users.routes.ts`)
- Auth Routes → Request Schemas: validates with (evidence: `src/routes/auth.routes.ts`)
- Book Routes → Request Schemas: validates with (evidence: `src/routes/books.routes.ts`)
- Loan Routes → Request Schemas: validates with (evidence: `src/routes/loans.routes.ts`)
- Auth Routes → JWT Authorization: protects logout (evidence: `src/routes/auth.routes.ts`)
- Book Routes → JWT Authorization: checks roles (evidence: `src/routes/books.routes.ts`)
- User Routes → JWT Authorization: protects routes (evidence: `src/routes/users.routes.ts`)
- User Routes → Upload Middleware: parses uploads (evidence: `src/routes/users.routes.ts`)
- Auth Controller → Authentication: invokes (evidence: `src/controllers/authController.ts`)
- Book Controller → Book Catalog: invokes (evidence: `src/controllers/bookController.ts`)
- Loan Controller → Loan Management: invokes (evidence: `src/controllers/loanController.ts`)
- User Controller → User Management: invokes (evidence: `src/controllers/userController.ts`)
- User Controller → Avatar Processing: processes images (evidence: `src/controllers/userController.ts`)
- Authentication → Prisma Client: queries (evidence: `src/services/authService.ts`)
- Book Catalog → Prisma Client: queries (evidence: `src/services/bookService.ts`)
- Loan Management → Prisma Client: queries (evidence: `src/services/loanService.ts`)
- User Management → Prisma Client: queries (evidence: `src/services/userService.ts`)
- Prisma Client → Library Database: accesses
- Authentication → Email Delivery: sends reset email (evidence: `src/services/authService.ts`)
- Email Delivery → SMTP Service: delivers email (evidence: `README.md`)
- Email Delivery → Configuration: reads settings (evidence: `src/utils/sendMail.ts`)
- Authentication → Configuration: uses token settings
- Avatar Processing → Avatar Files: writes images
- Express App → Avatar Files: serves uploads (evidence: `src/app.ts`)
