Skip to content

DominikDab341/SpotFinder

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

24 Commits
 
 
 
 
 
 
 
 

Repository files navigation

📍 SpotFinder

Aplikacja do odkrywania i oceniania miejsc, zintegrowana z Google Maps API oraz AI (Gemini). Użytkownicy mogą przeglądać miejsca, czytać opinie i zadawać pytania o nie za pomocą wbudowanego czatu AI. Projekt oparty jest na Django REST Framework oraz React.


✨ Główne funkcje

  • Przeglądanie miejsc: wyszukiwanie i wyświetlanie szczegółów miejsc z Google Maps API.
  • Opinie i opisy: pobieranie recenzji i opisów redakcyjnych bezpośrednio z Google Places API.
  • Czat AI (SpotAI): zadawaj pytania o dowolne miejsce — Gemini odpowiada na podstawie opinii i opisu miejsca.
  • Autoryzacja JWT: bezpieczny dostęp do API z tokenami JWT.

🛠 Technologie

Backend

  • Python 3.12 / Django 6
  • Django REST Framework
  • ADRF (async Django REST Framework)
  • Google Maps / Places API
  • Google Gemini API
  • SQLite (domyślna baza danych)

Frontend

  • React 18+
  • Vite

🚀 Instalacja i uruchomienie

1) Backend (Django)

  1. Wejdź do folderu backendu:

    cd backend
  2. Utwórz i aktywuj środowisko wirtualne

    python -m venv venv
    source venv/bin/activate        # Linux / macOS
    venv\Scripts\activate           # Windows
  3. Zainstaluj zależności

    pip install -r requirements.txt
  4. Utwórz plik .env na podstawie poniższego szablonu:

    GOOGLE_MAPS_API=twoj_klucz_google_maps
    GEMINI_API_KEY=twoj_klucz_gemini
  5. Wykonaj migracje bazy danych

    python manage.py migrate
  6. Stwórz konto administratora

    python manage.py createsuperuser
  7. Uruchom serwer deweloperski

    python manage.py runserver

2) Frontend (React + Vite)

  1. Wejdź do folderu frontend:

    cd frontend
  2. Zainstaluj zależności

    npm install
  3. Utwórz plik .env i wypełnij zmienne środowiskowe.

  4. Uruchom aplikację

    npm run dev

Aplikacja frontendowa dostępna pod adresem: http://localhost:5173

About

No description, website, or topics provided.

Resources

Stars

Watchers

Forks

Releases

No releases published

Packages

 
 
 

Contributors