# NaviTour - Smart Transport Platform
NaviTour is an AI-powered smart transportation platform for Egypt. It combines public transport routing, Arabic conversational assistance, travel-time prediction, road issue intelligence, and location-aware recommendations into one FastAPI-based web application.
## Features
- Public transport routing using GTFS data and a RAPTOR-based routing engine.
- Cairo and Kafr El Sheikh service flows with web pages for each mode.
- Arabic chatbot support for route requests and travel assistance.
- Speech transcription endpoint for voice input.
- Route safety enrichment using reported road issues and severity scoring.
- Personalized recommendations for nearby places and restaurants.
- PostgreSQL/PostGIS-backed spatial data APIs.
- Generated Folium route maps for visual trip output.
## Project Structure
```text
.
|-- NaviTour/
| |-- api/ # Unified FastAPI API and transport endpoints
| |-- cairo_assistant/ # Cairo chatbot, intent model, and voice assistant code
| |-- data/ # GTFS feeds and translation files
| |-- KafrEL_sheikh/ # Kafr El Sheikh assistant and recommendation data
| |-- raptor/ # RAPTOR routing, map visualization, and duration logic
| |-- recommender/ # Hybrid recommendation system
| |-- services/ # Route safety, geometry, and spatial services
| |-- shared/ # Shared paths, database helpers, and Arabic utilities
| |-- sql/ # Database dumps and migration scripts
| |-- web/ # Templates, static assets, and generated maps
| |-- app_web.py # Combined web/API entry point
| |-- web_app.py # Lightweight web app entry point
| |-- web_app_api.py # Chat-focused API entry point
| |-- docker-compose.yml # PostgreSQL + PostGIS service
| `-- requirements.txt
|-- cairo_complaint/ # Road complaint cla …