How kareemmas3ud/new-valley-hub works
New Valley Hub is an AI-powered tourism platform for discovering and planning visits to Egypt’s New Valley. Visitors browse attractions, hotels, services and artisan products; plan trips; and use map, museum, souvenir and emergency features. The React app connects to Django APIs, with tourism-specific planning and chat modules and separate catalog domains. The README documents additional capabilities, but sampled source confirms only app routing, authentication persistence and service-catalog requests; uncertain backend wiring is therefore not drawn.
Main entry points: App.jsx App routes · api.js API client · views.py Tourism handlers · PlannerPage.jsx Trip planner
Components 25
Visitor experience
- App routes
frontend/src/App.jsx - Attractions
frontend/src/pages/AttractionsPage.jsx - Interactive map
frontend/src/pages/MapPage.jsx - Trip planner
frontend/src/pages/PlannerPage.jsx - Virtual museum
frontend/src/pages/VirtualMuseumPage.jsx - Souvenir maker
frontend/src/pages/SouvenirPage.jsx - Emergency SOS
frontend/src/components/SOSButton.jsx - AI guide
frontend/src/components/ChatbotWidget.jsx
Identity and trips
- Auth context
frontend/src/context/AuthContext.jsx - My trips
frontend/src/pages/MyTrips.jsx
Tourism catalogs
- Hotels
frontend/src/pages/HotelsPage.jsx - Services
frontend/src/pages/ServicesPage.jsx - Marketplace
frontend/src/pages/MarketplacePage.jsx - Global search
frontend/src/pages/SearchResults.jsx
API and intelligence
- API client
frontend/src/services/api.js - Tourism API
backend/tourism/urls.py - Tourism handlers
backend/tourism/views.py - AI trip planning
backend/tourism/ai_planner.py - Chat handler
backend/tourism/chat_view.py - Hospitality API
backend/hospitality/urls.py - Services API
backend/services/urls.py - Marketplace API
backend/marketplace/urls.py - Platform database
backend/tourism/models.py
Other components
- Visitor
- Google Gemini
Connections 28
- Visitor → App routes: uses
- App routes → Attractions: routes to
- App routes → Interactive map: routes to
- App routes → Trip planner: routes to
- App routes → Virtual museum: routes to
- App routes → Souvenir maker: routes to
- App routes → Emergency SOS: renders
- App routes → AI guide: renders
- App routes → Auth context: provides context
- App routes → My trips: routes to
- App routes → Hotels: routes to
- App routes → Services: routes to
- App routes → Marketplace: routes to
- App routes → Global search: routes to
- Services → API client: requests services
- Auth context → API client: requests authentication
- Trip planner → API client: requests plans
- AI guide → API client: requests answers
- API client → Tourism API: sends requests
- API client → Hospitality API: sends requests
- API client → Services API: sends requests
- API client → Marketplace API: sends requests
- Tourism API → Tourism handlers: dispatches
- Tourism handlers → AI trip planning: generates itinerary
- Tourism handlers → Chat handler: handles chat
- Chat handler → Google Gemini: queries
- AI trip planning → Google Gemini: queries
- Tourism handlers → Platform database: reads and writes