Skip to content

Agastyasourcecodes/SmartLibrary

Folders and files

NameName
Last commit message
Last commit date

Latest commit

Β 

History

6 Commits
Β 
Β 
Β 
Β 
Β 
Β 
Β 
Β 

Repository files navigation

πŸ“š SmartLibrary β€” AI-Powered ELibrary Management Platform

A modern full-stack Library Management System engineered to streamline digital library operations through intelligent workflows, role-based dashboards, and AI-driven book discovery. Built using the MERN stack, SmartLibrary delivers a seamless experience for both readers and librarians with secure authentication, real-time inventory management, and personalized recommendation systems.

MERN Stack React Node.js MongoDB JWT


πŸš€ Overview

SmartLibrary modernizes traditional library systems by combining efficient inventory management with AI-powered personalization. The platform features separate dashboards for readers and administrators, enabling smooth issue-request handling, secure authentication, and scalable backend architecture.

Key Objectives

  • Simplify library management workflows
  • Improve accessibility to digital catalogs
  • Automate issue-request processing
  • Enhance user engagement with AI recommendations
  • Provide centralized inventory control for administrators

✨ Features

πŸ‘€ Reader Dashboard

πŸ“– Personalized Reading Experience

  • Browse and search books by title, author, or genre
  • View real-time availability and issue status
  • Clean and responsive UI for seamless navigation

πŸ€– AI Book Recommendations

  • Personalized recommendations based on:
    • Reading history
    • Preferred genres
    • Search patterns and activity
  • Helps users discover books intelligently

πŸ“š Smart Borrowing Workflow

  • One-click issue requests
  • Track:
    • Pending requests
    • Approved books
    • Currently issued books

πŸ” Secure Authentication

  • JWT-based authentication system
  • Password hashing with bcrypt.js
  • Protected API routes and user sessions

πŸ›‘οΈ Admin Dashboard

πŸ“¦ Inventory Management

  • Add new books to the catalog
  • Edit or remove existing books
  • Manage stock and availability

βœ… Request Processing System

  • Review pending requests
  • Approve or reject issue requests
  • Track issued books in real time

πŸ“Š Library Monitoring

  • Monitor issued vs available inventory
  • Manage overall library activity efficiently

πŸ› οΈ Tech Stack

Category Technologies
Frontend React.js, Vite, React Router DOM, Context API
Backend Node.js, Express.js
Database MongoDB, Mongoose
Authentication JWT, bcrypt.js
AI Features Recommendation Logic / AI APIs
Version Control Git & GitHub

🧠 System Architecture

Frontend (React + Vite)
        ↓
REST API (Express.js)
        ↓
Authentication Layer (JWT)
        ↓
MongoDB Database (Mongoose ODM)
        ↓
AI Recommendation Engine

⚑ Quick Start

1️⃣ Clone the Repository

git clone https://github.com/yourusername/smartlibrary.git
cd smartlibrary

2️⃣ Backend Environment Setup

Create a .env file inside the backend/ directory:

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key

# Optional AI Service Key
AI_API_KEY=your_api_key

3️⃣ Run the Application

Terminal 1 β€” Backend

cd backend
npm install
npm run dev

Terminal 2 β€” Frontend

cd frontend
npm install
npm run dev

Frontend typically runs on:

http://localhost:5173

πŸ“‘ API Endpoints

Method Endpoint Description Access
POST /api/auth/register Register a new user Public
POST /api/auth/login Authenticate user & generate token Public
GET /api/books Fetch complete book catalog Public
POST /api/issues/request Submit issue request User
GET /api/issues/my-books Get user's issued/pending books User
GET /api/issues/requests View all pending requests Admin
PUT /api/issues/:id Approve or reject request Admin

πŸ”₯ Project Highlights

  • Full-stack MERN architecture
  • Role-based authentication system
  • AI-powered recommendation engine
  • Real-time issue tracking
  • RESTful API integration
  • Secure JWT authentication
  • Scalable backend structure
  • Responsive modern UI

πŸ“ˆ Future Enhancements

  • πŸ“„ PDF / eBook reader integration
  • πŸ”” Email & notification system
  • πŸ“Š Analytics dashboard
  • 🧠 Advanced ML-based recommendation engine
  • ☁️ Cloud deployment & CI/CD pipeline
  • πŸ“± Enhanced mobile responsiveness

πŸ‘¨β€πŸ’» Author

Agastya Maurya

Full Stack Developer β€’ MERN Stack Enthusiast β€’ AI Projects Builder

Projects

  • Civix
  • AI Habit Builder
  • SmartLibrary

GitHub: @agastya


🀝 Contributing

Contributions, feature suggestions, and pull requests are welcome.

Steps to Contribute

  1. Fork the repository
  2. Create a feature branch
  3. Commit your changes
  4. Push to your branch
  5. Open a Pull Request

πŸ“ License

This project is licensed under the MIT License.


⭐ If you found this project useful, consider giving it a star on GitHub!

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors