📚 Library Management System

---

🌟 A modern and robust Library Management System built with Node.js and PostgreSQL.

📖 Efficiently manage books, users, and borrowing transactions with ease.

Quick Start • Features • Installation • API • Contributing

---

🚀 Quick Start

# Clone & Install
git clone https://github.com/ozers/library-management.git
cd library-management
cp .env.example .env
npm install

# Start with Docker (Development)
docker-compose -f docker-compose.dev.yml up --build

# Or start without Docker
npm run dev

# Visit: http://localhost:3000

📊 System Architecture

graph TD
    Client[Client] -->|HTTP Request| Express[Express.js]
    Express -->|Route| Controller[Controllers]
    Controller -->|Validate| Validator[Validators]
    Controller -->|Process| Service[Services]
    Service -->|Query| Model[Models]
    Model -->|Store| DB[(PostgreSQL)]
    Controller -->|Response| Client

    style Client fill:#f9f,stroke:#333,stroke-width:2px
    style Express fill:#ff9900,stroke:#333,stroke-width:2px
    style Controller fill:#ff9900,stroke:#333,stroke-width:2px
    style Service fill:#ff9900,stroke:#333,stroke-width:2px
    style Model fill:#ff9900,stroke:#333,stroke-width:2px
    style DB fill:#ff9900,stroke:#333,stroke-width:2px

Loading

✨ Features

📚 Book Management

• Smart cataloging system
• Real-time availability tracking
• Advanced search capabilities
• Category organization

👥 User Management

• Seamless registration
• Detailed profiles
• Activity monitoring
• Preference settings

🔄 Borrowing System

• One-click borrowing
• Rating-enabled returns
• Overdue notifications
• Reservation system

🛠 Installation

Prerequisites

• Node.js (v14+)
• Docker & Docker Compose
• PostgreSQL
• Git

Environment Setup

DB_HOST=db
DB_PORT=5432
DB_NAME=library_db
DB_USER=postgres
DB_PASSWORD=postgres
NODE_ENV=development
PORT=3000

📚 API Endpoints

Books

• GET /api/books - List all books
• GET /api/books/:id - Get book details
• POST /api/books - Create new book

Users

• GET /api/users - List all users
• GET /api/users/:id - Get user details
• POST /api/users - Create new user

Borrowing & Transactions

• POST /api/borrow/:userId/borrow/:bookId - Borrow a book
• POST /api/borrow/:userId/return/:bookId - Return a book
• GET /api/transactions/user/:userId - Get user's transactions
• GET /api/transactions/:id - Get transaction details

📝 Contributing

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

📧 Contact & Support

📝 License

📜 MIT License

---

🌟 Made with ❤️ by Ozer SUBASI