Skip to content

README.md

Latest commit

 

History

History
71 lines (55 loc) · 2.68 KB

README.md

File metadata and controls

71 lines (55 loc) · 2.68 KB

📚 Modern AI Library Management System (v4.0)

License Python React PWA

A state-of-the-art Library Management System that modernizes a legacy Python backend with a stunning, AI-powered React frontend.

🚀 Features

✨ Modern UI/UX

  • Glassmorphism Design: Sleek, modern interface with frosted glass effects.
  • Dark/Light Mode: Fully adaptive theming with persistent preferences.
  • Responsive & PWA: Mobile-first design that can be installed as an App on your phone.

🤖 AI-Powered

  • AI Librarian Chatbot: Ask "Who is Sherlock Holmes?" or "Recommend a mystery book" and get context-aware answers.
  • Smart Recommendations: Visual "Recommended for You" section based on reading patterns.
  • Explainable AI: Visual badges explaining why a book was recommended.

🛠️ Advanced Management

  • Role-Based Access Control (RBAC):
    • Admin: Full control, manage books (Add/Delete/Issue/Return), view all history.
    • Librarian: Issue/Return books, view history.
    • Student: View profile, search books, get recommendations.
  • Visual Analytics: Interactive dashboard with charts and real-time statistics.
  • Audit Logs: Full transaction history tracking.

🏗️ Architecture

This project uses a unique "Backend Adapter" pattern to modernize a legacy system without rewriting it:

  • Backend: Python (Flask) acts as a wrapper around the legacy LMS class, mocking CLI inputs to expose a RESTful API.
  • Frontend: React (No-Build) using ES Modules, Tailwind CSS, and Framer Motion directly in the browser.

📦 Installation & Deployment

Local Setup

  1. Clone the repository

    git clone https://github.com/yourusername/library-management-system.git
cd library-management-system

  2. Install Dependencies

    pip install -r requirements.txt

  3. Run the Server

    python server.py

    The app will start at http://127.0.0.1:5000.

Web Deployment (Heroku / Render)

This project is configured for cloud deployment.

  • Procfile included for Gunicorn.
  • requirements.txt ready.
  • Just push to your platform of choice!

🔑 Default Credentials

Role Username / Email Password / Mobile
Administrator - admin123
Librarian - lib123
Student student@uni.edu 1234567890

v4.0 Update Notes:

  • Added PWA Manifest and Service Worker support.
  • Implemented Librarian role.
  • Added /api/history endpoint and UI.