✨ Velora – AI-Powered Multi-Modal Travel Assistant

Velora is an intelligent transit planner that combines AI, smart routing, and real-world mapping to orchestrate seamless multi-modal trips.
From bus and train hops to last-mile taxi legs, Velora handles the ity of travel planning in one unified interface.

---

🚀 Feature Highlights (Complex Interactions, Simplified Experience)

Capability	Description
🧠 AI-Driven Mode Selector	Dynamically chooses optimal transport paths based on real-time factors like time, distance, and cost.
📍 Precision GraphHopper Routing	Utilizes advanced OpenStreetMap (OSM) data for highly accurate, granular pathfinding.
🤖 Personalized AI Suggestions	Employs Google Gemini for intuitive route suggestions, learning from user patterns.
⏱️ Real-time Cost & Time Estimates	Provides immediate, traffic-aware breakdowns for every segment of the journey.
🗺️ Interactive Map Visualization	Dynamic Leaflet.js maps offer clear multi-stop route previews and comparisons.

---

🧱 Powering Velora: The Tech Behind the Intelligence

• Backend: PHP 8+ (Robust & Secure PDO Architecture)
• Frontend: Dynamic Vanilla JS & Leaflet.js (Fluid UI/UX)
• Router: GraphHopper (Java/Maven) (High-Performance Routing Engine)
• AI Engine: Google Gemini (Intelligent Decision Making)
• Data Layer: OpenStreetMap (OSM) + Custom CSV Transit Data

---

🔐 Built with a Security-First Mindset

• Zero-Leak Policy: Critical API keys and secrets are never committed to version control.
• Secure Provisioning: Dedicated setup.php wizard ensures a safe, local environment setup.
• Database Integrity: Utilizes PDO prepared statements to actively prevent SQL Injection vulnerabilities.
• Isolated Services: Routing engine operates as a separate, contained microservice.

---

⚙️ Quick Deployment & Test Flight

1. Rapid Setup (One-Time)

git clone [https://github.com/JithuMon10/Velora-AI-Powered-Multi-Modal-Travel-Assistant.git](https://github.com/JithuMon10/Velora-AI-Powered-Multi-Modal-Travel-Assistant.git)
cd Velora-AI-Powered-Multi-Modal-Travel-Assistant
php setup/setup.php  # Interactive wizard for API keys & DB configuration

2. Launch Services (Two Simple Commands)

Component	Command	Access URL
PHP API Backend	php -S localhost:9000 -t backend/php	http://localhost:9000
GraphHopper Router	java -jar graphhopper/target/graphhopper-web-*.jar server config.yml	http://localhost:8989

First Test: Once running, navigate your browser to the PHP API URL. We recommend testing a route like Mallappally → Kochi to witness the multi-modal orchestration.

---

📂 Under the Hood: Core Architecture

Velora/
├── backend/php/    # Core API, Trip Planning Logic, AI Integration
├── frontend/       # User Interface, Interactive Maps, Frontend JS Logic
├── graphhopper/    # Self-Contained Java Routing Engine
├── setup/          # Environment Setup & Database Provisioning
├── Report/         # Detailed System Documentation & Flowcharts
└── stations*.csv   # Geographic & Transit Data Sources

---

🤝 Connect & Collaborate

Project Lead: Jithendra V Anand (JithuMon10) – Cyber Security & Full-Stack Development Expert

---

"Velora: Turning travel logistics into a smart, secure, and seamless journey."