BOOKSY

Booksy is an online library platform that enables users to browse a digital catalog of books, view detailed book information, and order physical copies with home delivery. The system provides a convenient and user-friendly way to discover, manage, and access books from a single web application.

Main Features

• Smart search and filtering: Search for books by title, author, genre or tags.
• Order system: Ability to add a book to the cart and place an order for delivery.
• Personal account: History of ordered books, "I want to read" list and current delivery status.
• AI-Powered Admin Panel: Convenient management of the library collection, order processing, and an integrated NLP service that analyzes book descriptions to automatically predict and assign genres.

Technology Stack

• Frontend: React, Redux Toolkit, SCSS
• Backend: Node.js (Express), Python
• Database: MongoDB

Screenshots

Installation Guide

Follow these steps to run the project locally on your machine.

Prerequisites

Make sure you have the following installed:

• Node.js (v18 or higher) & npm
• Python (v3.13 or higher)
• MongoDB (local instance or MongoDB Atlas URI)

---

Step-by-Step Setup

1. Clone the Repository

git clone https://github.com/your-username/booksy.git
cd booksy

---

2. Backend Setup (Node.js & Express)

Navigate to the backend directory:

cd backend

Install dependencies:

npm install

Create a .env file in the root of the backend folder and add your environment variables:

PORT=5000
MONGO_URI=your_mongodb_connection_string
JWT_SECRET=your_jwt_secret_key

Start the backend server:

npm run dev
# or
npm start

---

3. NLP Service Setup (Python)

If the NLP service runs as a separate microservice:

Navigate to the NLP/AI directory:

cd ../nlp-service

Create and activate a virtual environment:

python -m venv venv

Windows

venv\Scripts\activate

macOS / Linux

source venv/bin/activate

Install required Python packages:

pip install -r requirements.txt

Run the Python service:

python main.py

---

4. Frontend Setup (React & Redux)

Open a new terminal window and navigate to the frontend directory:

cd frontend

Install dependencies:

npm install

Start the React development server:

npm start

---

Running the Application

Once all services are running:

• Backend: http://localhost:5000
• Frontend: http://localhost:3000
• NLP Service: http://localhost:8000

Open the frontend in your browser:

http://localhost:3000

You can now explore Booksy and its features.

---

Notes

• Adjust the folder names (backend, frontend, nlp-service) according to your project structure.
• Make sure all required environment variables are configured before starting the application.
• If you use MongoDB Atlas, replace MONGO_URI with your Atlas connection string.
• Ensure the backend and NLP service are running before launching the frontend.

License

This project is licensed under the MIT License - see the LICENSE file for details.