🏛️ BydGoWATor - Odkryj Ukrytą Historię Bydgoszczy

Interaktywna aplikacja mobilna do odkrywania historii Bydgoszczy z wykorzystaniem technologii AR i AI

Demo • Funkcjonalności • Instalacja • Technologie • Zespół

---

📖 O Projekcie

BydGoWATor to innowacyjna aplikacja webowa typu PWA (Progressive Web App), która pozwala użytkownikom odkrywać ukrytą historię Bydgoszczy w nowy, interaktywny sposób. Łączy w sobie technologię rozszerzonej rzeczywistości (AR), sztuczną inteligencję (AI) oraz gamifikację, tworząc unikalne doświadczenie turystyczne.

🎯 Cel Projektu

Celem aplikacji jest ożywienie historii miasta Bydgoszczy poprzez:

• Wizualizacje AR historycznych miejsc i wydarzeń
• Interaktywne trasy tematyczne prowadzące przez najważniejsze punkty miasta
• System nagród i achievementów zachęcający do eksploracji
• Edukację poprzez zabawę

---

✨ Funkcjonalności

🗺️ Interaktywna Mapa

• Przeglądaj mapę Bydgoszczy z zaznaczonymi lokalizacjami historycznymi
• Filtruj miejsca według kategorii i epoki historycznej
• Sprawdzaj odległość od swojej lokalizacji

🛤️ Trasy Tematyczne

• Gotowe trasy turystyczne o różnym czasie trwania
• Trasy tematyczne: przemysłowe, wojenne, kulturalne i inne
• Szczegółowe opisy każdego punktu na trasie

📱 Rozszerzona Rzeczywistość (AR)

• Wizualizacje historycznych budynków i scen
• Nakładanie warstw historycznych na współczesny widok
• Interaktywne elementy AR do eksploracji

🏆 System Nagród i Gamifikacji

• Zbieraj punkty za odwiedzane miejsca
• Zdobywaj unikalne odznaki i osiągnięcia
• Rywalizuj na tablicach wyników

👤 Profil Użytkownika

• Śledzenie postępów w eksploracji miasta
• Historia odwiedzonych miejsc
• Personalizowane rekomendacje

---

🚀 Instalacja

Wymagania

• Node.js 18+
• npm lub yarn

Krok po kroku

# 1. Sklonuj repozytorium
git clone https://github.com/sitekm/bydgowator.git

# 2. Przejdź do katalogu projektu
cd bydgoszcz

# 3. Zainstaluj zależności
npm install

# 4. Uruchom serwer deweloperski
npm run dev

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

Budowanie produkcyjne

# Zbuduj aplikację
npm run build

# Podgląd wersji produkcyjnej
npm run preview

---

🛠️ Technologie

Frontend

Technologia	Opis
React 18	Biblioteka do budowy interfejsów użytkownika
TypeScript	Silne typowanie dla większej niezawodności
Vite	Nowoczesny bundler z błyskawicznym HMR
Tailwind CSS	Utility-first framework CSS
shadcn/ui	Wysokiej jakości komponenty UI
Framer Motion	Biblioteka animacji
React Router	Routing SPA

Mapy i Geolokalizacja

Technologia	Opis
Leaflet	Biblioteka map interaktywnych
React Leaflet	Integracja Leaflet z React

Dodatkowe

Technologia	Opis
React Query	Zarządzanie stanem serwera
Zod	Walidacja schematów danych
Recharts	Wykresy i wizualizacje
PWA	Wsparcie dla Progressive Web App

---

📁 Struktura Projektu

bydgoszcz/
├── public/              # Pliki statyczne i manifest PWA
├── src/
│   ├── components/      # Komponenty React (64 komponenty)
│   │   └── ui/          # Komponenty shadcn/ui
│   ├── data/            # Dane o lokalizacjach
│   ├── hooks/           # Custom React hooks
│   ├── lib/             # Utilitariusze
│   ├── pages/           # Strony aplikacji
│   │   ├── Index.tsx        # Strona główna
│   │   ├── MapPage.tsx      # Mapa interaktywna
│   │   ├── RoutesPage.tsx   # Lista tras
│   │   ├── RouteDetailPage.tsx # Szczegóły trasy
│   │   ├── ARPage.tsx       # Widok AR
│   │   ├── ProfilePage.tsx  # Profil użytkownika
│   │   ├── RewardsPage.tsx  # System nagród
│   │   └── MorePage.tsx     # Ustawienia
│   └── services/        # Serwisy i API
├── package.json
├── tailwind.config.ts
├── vite.config.ts
└── README.md

---

📱 Responsywność i PWA

Aplikacja jest w pełni responsywna i zoptymalizowana pod kątem urządzeń mobilnych:

• Mobile-first design - interfejs zaprojektowany z myślą o smartfonach
• PWA - możliwość instalacji na urządzeniu jako natywna aplikacja
• Offline support - podstawowa funkcjonalność dostępna bez internetu

---

👥 Zespół

Projekt stworzony w ramach hackathonu HACKNATION.

---

Wykonane z ❤️ dla Bydgoszczy