https://github.com/ysskrishna/libmate
A full stack application for a library book vending application built with NextJS, TailwindCSS, FastAPI, Postgres and Docker. It is designed to manage book inventories, and member management, ensuring a seamless experience for borrowing and returning books through automated vending machines.
https://github.com/ysskrishna/libmate
alembic docker fastapi inventory-management javascript library-management-system library-software logger logger-middleware nextjs postgres postgresql react sql sqlalchemy sqlite tailwind tailwindcss web-application
Last synced: 2 months ago
JSON representation
A full stack application for a library book vending application built with NextJS, TailwindCSS, FastAPI, Postgres and Docker. It is designed to manage book inventories, and member management, ensuring a seamless experience for borrowing and returning books through automated vending machines.
- Host: GitHub
- URL: https://github.com/ysskrishna/libmate
- Owner: ysskrishna
- License: agpl-3.0
- Created: 2024-07-22T15:38:28.000Z (almost 2 years ago)
- Default Branch: main
- Last Pushed: 2025-01-31T14:21:04.000Z (over 1 year ago)
- Last Synced: 2025-02-05T22:53:04.322Z (over 1 year ago)
- Topics: alembic, docker, fastapi, inventory-management, javascript, library-management-system, library-software, logger, logger-middleware, nextjs, postgres, postgresql, react, sql, sqlalchemy, sqlite, tailwind, tailwindcss, web-application
- Language: JavaScript
- Homepage:
- Size: 13.4 MB
- Stars: 0
- Watchers: 1
- Forks: 0
- Open Issues: 0
-
Metadata Files:
- Readme: README.md
- License: LICENSE
Awesome Lists containing this project
README
# Library Management System
A full stack application for a library book vending application. It is designed to manage book inventories, and member management, ensuring a seamless experience for borrowing and returning books through automated vending machines.
## Media - User Portal
https://github.com/user-attachments/assets/beebd49a-4143-4efb-a8ec-5e95c4675e0a
#### User - Login Page
#### User - Register Page
#### User - Dashboard Page
#### User - Search Page
#### User - Add Book to Cart Page
#### User - Cart Page
## Media - Admin Portal
https://github.com/user-attachments/assets/245bd896-74c6-43ae-9126-12d275c7b481
#### Admin - Login Page
#### Admin - Dashboard Page
#### Admin - Add Book Page
#### Admin - Update Book Page
## Techstack used
- NextJS
- Redux Toolkit
- Redux Persist
- Tailwindcss
- FastAPI
- Postgres
- Alembic
- SQLAlchemy
- Docker
## Features
- User Authentication
- Admin and User login functionality
- Secure credential management
- Book Management
- Add, edit, and remove books from the library catalog
- Track book availability and loan status
- User Management
- Register new library Admins and Users
- Loan Management
- Check out and return books
## Installation
Prerequisites: Docker
1. Clone the repository
2. Run `docker compose -f docker-compose-production.yml up` to start the all instances
3. Run `docker compose -f docker-compose-production.yml down` to stop the all instances
4. Run `docker compose -f docker-compose-production.yml up --build` to build and start the all instances
5. Frontend will be running on `http://localhost:3000`
6. Backend will be running on `http://localhost:8081`
7. Database will be running on `http://localhost:5432`
## Usage
### Admin Access
- Email: admin@gmail.com
- Password: admin
### User Access
- Email: john@gmail.com
- Password: demo
# License
Copyright (c) 2024 [Y. Siva Sai Krishna](https://github.com/ysskrishna)
This project is licensed under the AGPL-3.0 License - see the LICENSE file for details.