📚 Library Management System Backend

REST API built with NestJS, PostgreSQL, TypeORM, and JWT Authentication

---

📖 Overview

A Library Book Management System API built using NestJS, PostgreSQL, and TypeORM with JWT Authentication, Token Blacklist, Logout-All Sessions, and Role-Based Access Control (Admin & User).

This project demonstrates:

• 🔐 Secure Authentication
• 👨‍💼 Admin & 👤 User Roles
• 📚 Book CRUD Operations
• 📡 Swagger API Documentation
• 🧪 Postman Testing
• ⚙️ Config Module & Environment Variables
• 🧱 Clean Backend Architecture

---

🚀 Features

🔐 Authentication & Security

Feature	Description
Register	User account creation
Login	JWT authentication
Logout	Blacklist current token
Logout All	Logout from all devices
Token Blacklist	Stores logged out JWT tokens
Scheduler	Removes expired tokens daily
Default Admin	Pre-created admin account
Guards	Protected routes
JWT	Token-based security

---

📚 Book Management

Feature	Admin	User
View All Books	✅	✅
View Book by ID	✅	✅
Create Books	✅	❌
Update Books	✅	❌
Delete Books	✅	❌

---

👥 User Management

Feature	Admin	User
Register	❌	✅
Login	✅	✅
View All Users	✅	❌
Delete Users	✅	❌
Delete Admin	❌	❌
Logout	✅	✅
Logout-all	✅	✅

---

🛠️ Tech Stack

Technology	Usage
NestJS	Backend Framework
PostgreSQL	Database
TypeORM	ORM
JWT	Authentication
Swagger	API Documentation
Class Validator	DTO Validation
Guards	Authorization
Middleware	Request Handling
Interceptors	Response Control
Exception Filters	Error Handling
Postman	API Testing
Config Module	Environment Config

---

📁 Project Structure

src
│
├── auth
├── users
├── books
├── blacklist
├── common
│   ├── guards
│   ├── decorators
│   ├── interceptors
│   ├── filters
│   ├── middleware
│
├── config
├── app.module.ts
└── main.ts

---

🔑 Default Admin Login

Email: admin@library.com
Password: admin123

---

📡 API Endpoints

🔐Auth

POST /auth/register
POST /auth/login
POST /auth/logout
POST /auth/logout-all

👨🏻‍💻ADMIN

POST   /admin/books
GET    /admin/books
GET    /admin/books/:id
PATCH  /admin/books/:id
DELETE /admin/books/:id
GET    /users
GET    /users/:id
DELETE /users/admin/:id

👤USERS

GET    /users/books
GET    /users/books/:id

---

📖 Swagger Documentation

http://localhost:3000/api

Test all APIs directly in browser.

---

📮 Postman API Collection

Use the Postman collection to test all API endpoints easily.

1. Login as Admin
2. Copy JWT Token
3. Add Bearer Token in Authorization
4. Test APIs

---

⚙️ Installation

1️⃣ Clone Repository

git clone https://github.com/rocky-rakesh2004/Library-management-system-backend.git

2️⃣ Go to Project

cd Library-management-system-backend

3️⃣ Install Dependencies

npm install

4️⃣ Setup PostgreSQL

Create database:

library_db

5️⃣ Create .env file

DB_HOST=localhost
DB_PORT=5432
DB_USERNAME=postgres
DB_PASSWORD=yourpassword
DB_NAME=library_db

JWT_SECRET=librarysecret
JWT_EXPIRES_IN=1d

PORT=3000

6️⃣ Run Project

npm run start:dev

---

🧪 Run API

Service	URL
Server	http://localhost:3000
Swagger	http://localhost:3000/api

---

🎯 Project Purpose

• Learn NestJS architecture
• Understand JWT authentication
• Implement role-based authorization
• Work with PostgreSQL and TypeORM
• Build real-world backend APIs
• Prepare for backend developer roles

---

👨‍💻 Author

RAKESH

GitHub: https://github.com/rocky-rakesh2004

---

⭐ Support

If you like this project:

⭐ Star the repository 🍴 Fork it 🛠️ Contribute 📩 Share feedback

---

Made with ❤️ using NestJS