Skip to content

evee03/bookly

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

5 Commits
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

Bookly
Platforma Księgarska

Nowoczesna platforma księgarska z funkcjami AI, interaktywnym czytaniem i systemem społecznościowym.

React Node.js MongoDB Vite JavaScript CSS Modules Express.js JWT Figma License


📋 Spis treści

📖 Opis Projektu

Użytkownicy mogą przeglądać i dodawać książki do ulubionych, rezerwować je w koszyku na 15 minut (po czym wracają do dostępnych produktów, jeśli nie zostaną kupione). Mogą także wystawiać recenzje. Każdy użytkownik posiada dostęp do próbki książki, którą może otworzyć i przeczytać. Platforma łączy nowoczesne technologie z intuicyjną obsługą, zapewniając wygodę oraz dzieleniem się opinią o książkach.

⭐ Główne Funkcjonalności

  • Sklep z książkami - katalog książek różnych kategorii, sortowanie oraz wyszukiwarka
  • Interaktywna książka - możliwość czytania próbek książek online z funkcją stronicowania
  • Asystent AI "Owly" - inteligentna sowa, która pomoże w wyborze książki
  • System recenzji - ocenianie i komentowanie książek
  • Lista ulubionych - dodawanie książek do ulubionych, aby wrócić do nich w dowolnym momencie
  • Koszyk zakupowy - książki rezerwowane na 15 minut z automatycznym zwrotem
  • System użytkowników - rejestracja, logowanie, profile (możliwość zalogowania przez Google i GitHub)
  • Responsywny design - dostosowanie do różnych urządzeń

🖼️ Zrzuty ekranu

🔐 Logowanie i rejestracja

Strona logowania Walidacja formularza

Bezpieczne logowanie z walidacją w czasie rzeczywistym


🏠 Strona główna i nawigacja

Strona główna
Nawigacja po stronie

Przejrzysta strona główna wraz z nawigacją


📚 Katalog książek i wyszukiwanie

Katalog książek
Wyszukiwanie i filtrowanie

Katalog z wyszukiwarką


📖 Interaktywny czytelnik książek

Widok książki
Czytanie książki

Immersyjne doświadczenie czytania z funkcją stronicowania


🤖 Asystent AI "Owly"

Asystent AI Owly

Inteligentna Owly AI pomagająca w wyborze książek


🛒 System zakupowy

Koszyk zakupowy

Koszyk z 15-minutową rezerwacją książek


👤 Profil użytkownika

Profil użytkownika

Profil ze statystykami i możliwością zmiany danych


⭐ Lista ulubionych

Lista ulubionych książek

Zbieranie i organizowanie ulubionych pozycji


📱 Responsywny design

Widok mobilny Widok tablet

Dopasowanie strony na różnych urządzeniach


🛠️ Technologie

🔧 Backend

  • Node.js z Express.js
  • MongoDB z Mongoose
  • Passport.js - autentykacja (Google, GitHub, Local)
  • JWT - zarządzanie tokenami
  • bcryptjs - szyfrowanie haseł
  • GROQ API - asystent AI
  • node-cron - zadania cykliczne
  • CORS - obsługa cross-origin

🎨 Frontend

  • React 18 z Vite
  • React Router - routing SPA
  • CSS Modules - stylowanie komponentów
  • React Icons - ikony interfejsu
  • Axios - komunikacja z API
  • JS Cookie - zarządzanie ciasteczkami

🗄️ Baza danych & Inne

  • MongoDB Atlas - baza NoSQL w chmurze
  • Mongoose - ODM dla MongoDB
  • Express Session - zarządzanie sesjami
  • Connect-mongo - przechowywanie sesji
  • Cookie Parser - obsługa ciasteczek

🚀 Instalacja i Uruchomienie

📋 Wymagania

  • Node.js
  • MongoDB
  • npm lub yarn

🔧 Backend

cd backend
npm install

# skopiuj i skonfiguruj zmienne środowiskowe
cp .env.example .env
# następnie otwórz plik .env i uzupełnij o prawdziwe wartości

# wypełnij bazę danych przykładowymi danymi
node seed.js

# Uruchom serwer
npm start

🎨 Frontend

cd frontend
npm install

# Uruchom aplikację
npm run dev

Aplikacja będzie dostępna pod adresem http://localhost:5173


🎨 Design i UX

  • Spójna paleta kolorów w odcieniach brązu i beżu inspirowane naturalnymi materiałami, jak papier czy drewno, nadają platformie ciepły i przytulny charakter
  • Responsywny layout działający na wszystkich urządzeniach - od telefonów po duże ekrany komputerów
  • Intuicyjna nawigacja wyraźny podział na sekcje, łatwo dostępne menu główne oraz szybki dostęp do kluczowych funkcji, takich jak wyszukiwanie, koszyk czy profil użytkownika.
  • Customowy przycisk wyszukiwania zaprojektowany w bajkowym stylu w chwili najechania kursorem pojawiają się liście
  • Animacje i efekty hover płynne przejścia oraz delikatne efekty, które pojawiają się przy najechaniu na elementy interfejsu, zwiększają atrakcyjność wizualną.
  • Interaktywna książka każda książka ma próbkę tekstu który można przeczytać w interaktywnej stronicowanej książce
  • Tło ze spadającymi książkami w sekcji polityka prywatności, regulamin oraz dostawy znajduje się animacja gdzie książki opadają jak liście, tworząc przyjemny i bajkowy klimat

Niektóre elementy interfejsu zostały zaprojektowane w Figmie docs/design/Bookly.fig

🚀 Planowany rozwój

  • System płatności - kompletny walidowalny formularz do płatności i jej symulacja
  • Zaawansowane filtry - bardziej precyzyjne wyszukiwanie książek
  • Społeczność czytelników - forum dyskusyjne dla czytelników
  • Integracja z API - różnych księgarń zewnętrznych
  • Optymalizacja kodu - doskonalenie wydajności
  • Podział na ebooki i audiobooki - próbki audiobooków (nagrań) oraz e-czytnik z próbkami
  • Historia zakupów - wszystkie zakupione książki na platformie

📝 Licencja

Ten projekt jest udostępniany na licencji MIT - LICENSE.

Projekt stworzony jako demonstracja umiejętności fullstack development.


Stworzone z ❤️ przez Ewelina Musińska

Jeśli podoba Ci się ten projekt, zostaw gwiazdkę!

About

Projekt internetowego sklepu z książkami, gdzie użytkownicy mogą przeglądać dostępne tytuły, dodawać je do ulubionych i koszyka. Dodatkowo aplikacja oferuje interaktywnego chatbota "Sowa AI", który pomaga w wyborze idealnej książki.

Resources

License

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors