{"id":15110084,"url":"https://github.com/amulyamachhan/library-management","last_synced_at":"2026-02-22T18:36:55.260Z","repository":{"id":256388803,"uuid":"855015368","full_name":"AmulyaMachhan/Library-Management","owner":"AmulyaMachhan","description":"The Library Management System is a full-stack application that manages users, books, transactions, and more. It consists of a backend API and a frontend web application.","archived":false,"fork":false,"pushed_at":"2024-09-26T12:35:15.000Z","size":343,"stargazers_count":1,"open_issues_count":0,"forks_count":0,"subscribers_count":1,"default_branch":"main","last_synced_at":"2025-09-06T17:46:21.687Z","etag":null,"topics":["api","express","library-management-system","mern-stack","mongodb","mongoose","node","react","react-icons","react-tanstack-query","redux","rtk-query","tailwind"],"latest_commit_sha":null,"homepage":"https://library-management-d9up.vercel.app/","language":"JavaScript","has_issues":true,"has_wiki":null,"has_pages":null,"mirror_url":null,"source_name":null,"license":null,"status":null,"scm":"git","pull_requests_enabled":true,"icon_url":"https://github.com/AmulyaMachhan.png","metadata":{"files":{"readme":"Readme.md","changelog":null,"contributing":null,"funding":null,"license":null,"code_of_conduct":null,"threat_model":null,"audit":null,"citation":null,"codeowners":null,"security":null,"support":null,"governance":null,"roadmap":null,"authors":null,"dei":null,"publiccode":null,"codemeta":null}},"created_at":"2024-09-10T06:46:36.000Z","updated_at":"2024-10-15T09:43:03.000Z","dependencies_parsed_at":"2024-10-31T08:24:22.045Z","dependency_job_id":"5af6878a-237a-4fc7-87af-6687c6e8f1db","html_url":"https://github.com/AmulyaMachhan/Library-Management","commit_stats":null,"previous_names":["amulyamachhan/library-management"],"tags_count":0,"template":false,"template_full_name":null,"purl":"pkg:github/AmulyaMachhan/Library-Management","repository_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmulyaMachhan%2FLibrary-Management","tags_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmulyaMachhan%2FLibrary-Management/tags","releases_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmulyaMachhan%2FLibrary-Management/releases","manifests_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmulyaMachhan%2FLibrary-Management/manifests","owner_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners/AmulyaMachhan","download_url":"https://codeload.github.com/AmulyaMachhan/Library-Management/tar.gz/refs/heads/main","sbom_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories/AmulyaMachhan%2FLibrary-Management/sbom","scorecard":null,"host":{"name":"GitHub","url":"https://github.com","kind":"github","repositories_count":280684034,"owners_count":26372971,"icon_url":"https://github.com/github.png","version":null,"created_at":"2022-05-30T11:31:42.601Z","updated_at":"2022-07-04T15:15:14.044Z","status":"online","status_checked_at":"2025-10-23T02:00:06.710Z","response_time":142,"last_error":null,"robots_txt_status":"success","robots_txt_updated_at":"2025-07-24T06:49:26.215Z","robots_txt_url":"https://github.com/robots.txt","online":true,"can_crawl_api":true,"host_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub","repositories_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repositories","repository_names_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/repository_names","owners_url":"https://repos.ecosyste.ms/api/v1/hosts/GitHub/owners"}},"keywords":["api","express","library-management-system","mern-stack","mongodb","mongoose","node","react","react-icons","react-tanstack-query","redux","rtk-query","tailwind"],"created_at":"2024-09-25T23:40:48.209Z","updated_at":"2025-10-23T19:57:17.876Z","avatar_url":"https://github.com/AmulyaMachhan.png","language":"JavaScript","funding_links":[],"categories":[],"sub_categories":[],"readme":"# Library Management System\n\n## Overview\n\nThe Library Management System is a full-stack application that manages users, books, transactions, and more. It consists of a backend API and a frontend web application.\n\n## Frontend Application\n\nThe frontend application is a user-friendly interface for interacting with the Library Management System. It allows users to manage books, view transactions, and perform other tasks through a web-based interface.\n\n- **Frontend URL:** [https://library-management-d9up.vercel.app/](https://library-management-d9up.vercel.app/)\n\n![localhost_5173_books](https://github.com/user-attachments/assets/3cb24dfc-b9f7-4052-82f0-5e3d213c08c1)\n\n## Backend API\n\nThe backend API provides endpoints for managing users, books, and transactions. The API is hosted on:\n\n- **Base URL:** `https://library-management-nu-seven.vercel.app/api/v1`\n\nFor detailed documentation on the available endpoints, please refer to the [Backend API Documentation](#backend-api-documentation).\n\n## Backend API Documentation\n\n### 1. User Endpoints\n\n#### 1.1 Get All Users\n- **Endpoint:** `/users/allusers`\n- **Method:** `GET`\n- **Description:** Fetches a list of all users in the system.\n- **URL:** `http://localhost:8000/api/v1/users/allusers`\n\n### 2. Book Endpoints\n\n#### 2.1 Get All Books\n- **Endpoint:** `/books/allbooks`\n- **Method:** `GET`\n- **Description:** Fetches a list of all books in the library.\n- **URL:** `https://library-management-nu-seven.vercel.app/api/v1/books/allbooks`\n\n#### 2.2 Get Books By Name\n- **Endpoint:** `/books/search/name`\n- **Method:** `GET`\n- **Description:** Fetches books by searching for a term in the book name.\n- **Query Parameters:**\n  - `query`: The search term.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/books/search/name?query=The`\n\n#### 2.3 Get Books By Rent\n- **Endpoint:** `/books/search/rent`\n- **Method:** `GET`\n- **Description:** Fetches books based on rent range.\n- **Query Parameters:**\n  - `min`: Minimum rent.\n  - `max`: Maximum rent.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/books/search/rent?max=2`\n\n#### 2.4 Global Book Search\n- **Endpoint:** `/books/search/global`\n- **Method:** `GET`\n- **Description:** Performs a global search based on category, name, and rent range.\n- **Query Parameters:**\n  - `category`: Book category.\n  - `query`: Search term.\n  - `min`: Minimum rent.\n  - `max`: Maximum rent.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/books/search/global?category=Fantasy\u0026query=the\u0026min=1.5\u0026max=2`\n\n#### 2.5 Get Book Categories\n- **Endpoint:** `/books/categories`\n- **Method:** `GET`\n- **Description:** Fetches a list of all available book categories.\n- **URL:** `https://library-management-nu-seven.vercel.app/api/v1/books/categories`\n\n### 3. Transaction Endpoints\n\n#### 3.1 Issue a Book\n- **Endpoint:** `/transactions/issue`\n- **Method:** `POST`\n- **Description:** Issues a book to a user.\n- **Request Body:**\n  - `bookName`: The name of the book.\n  - `userId`: The ID of the user.\n  - `issueDate`: The date the book is issued.\n- **URL:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/issue`\n\n#### 3.2 Return a Book\n- **Endpoint:** `/transactions/return`\n- **Method:** `POST`\n- **Description:** Returns a book and updates the transaction record.\n- **Request Body:**\n  - `bookName`: The name of the book.\n  - `userId`: The ID of the user.\n  - `returnDate`: The date the book is returned.\n- **URL:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/return`\n\n#### 3.3 Get Transactions by Book Name\n- **Endpoint:** `/transactions/book`\n- **Method:** `GET`\n- **Description:** Fetches all transactions for a particular book.\n- **Query Parameters:**\n  - `bookName`: The name of the book.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/book?bookName=The%20Great%20Gatsby`\n\n#### 3.4 Get Total Rent By Book\n- **Endpoint:** `/transactions/book/rent`\n- **Method:** `GET`\n- **Description:** Fetches the total rent generated by a particular book.\n- **Query Parameters:**\n  - `bookName`: The name of the book.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/book/rent?bookName=The%20Great%20Gatsby`\n\n#### 3.5 Get Users with Issued Book\n- **Endpoint:** `/transactions/users/book`\n- **Method:** `GET`\n- **Description:** Fetches a list of users who have issued a particular book.\n- **Query Parameters:**\n  - `bookName`: The name of the book.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/users/book?bookName=The%20Alchemist`\n\n#### 3.6 Books Rented by a User\n- **Endpoint:** `/transactions/user/:userId`\n- **Method:** `GET`\n- **Description:** Fetches a list of books rented by a specific user.\n- **Example:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/user/66e0342a9a94ae1b216754a1`\n\n#### 3.7 Get All Transactions\n- **Endpoint:** `/transactions/alltransactions`\n- **Method:** `GET`\n- **Description:** Fetches all transactions in the system.\n- **URL:** `https://library-management-nu-seven.vercel.app/api/v1/transactions/alltransactions`\n","project_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famulyamachhan%2Flibrary-management","html_url":"https://awesome.ecosyste.ms/projects/github.com%2Famulyamachhan%2Flibrary-management","lists_url":"https://awesome.ecosyste.ms/api/v1/projects/github.com%2Famulyamachhan%2Flibrary-management/lists"}