How vppm-ui/ferene-travel-app works
Ferene combines a browser travel-planning experience with a FastAPI destination-recommendation service. In the main workflow, travelers express crowd and trip preferences in the planner; the browser saves those preferences, and the hidden-gems page requests crowd-filtered recommendations for display. The service ranks tourism data by pressure and can calculate distance when starting coordinates are available. Separate frontend features include trip setup, emergency SOS, and swipe-based travel matching. The excerpts show no frontend call to the API chat endpoint; coordinate-file availability and some page wiring are not established by the supplied evidence.
Main entry points: planner.js Preference capture · home.js Trip setup · gems.js Recommendation display · recommendation.py Place ranking
Components 20
Travel planning
- Planner page
frontend/planner.html - Preference capture
frontend/planner.js - Browser preferences
- Trip setup
frontend/home.js - View navigation
frontend/script.js - Itinerary view
frontend/itinerary.html
Destination recommendations
- Hidden gems page
frontend/gems.html - Recommendation display
frontend/gems.js - FastAPI endpoints
backend/main.py - Place ranking
backend/recommendation.py - Distance calculation
backend/distance.py - Recommendations view
frontend/gems.html
Tourism data
- Pressure scoring
backend/tourism_pressure.py - Crowd input data
backend/uttarakhand_tourism_with_crowd.csv - Pressure results
backend/uttarakhand_tourism_with_pressure.csv
Travel safety and matching
- Emergency SOS
frontend/home.js - Swipe matching
frontend/swipe.js
Other components
- Traveler
- Geolocation and reverse lookup
- Device sharing
Connections 19
- Traveler → Planner page: sets preferences
- Planner page → Preference capture: submits text
frontend/planner.js - Preference capture → Browser preferences: saves preferences
frontend/planner.js - Preference capture → Hidden gems page: links to gems
frontend/planner.js - Hidden gems page → Recommendation display: loads recommendations
frontend/gems.js - Recommendation display → Browser preferences: reads preferences
frontend/gems.js - Recommendation display → FastAPI endpoints: requests recommendations
frontend/gems.js - FastAPI endpoints → Place ranking: calls ranking
backend/main.py - Place ranking → Pressure results: reads pressure data
backend/recommendation.py - Place ranking → Distance calculation: calculates distances
backend/recommendation.py - Pressure scoring → Crowd input data: reads crowd data
backend/tourism_pressure.py - Pressure scoring → Pressure results: writes scores
backend/tourism_pressure.py - Traveler → Trip setup: sets trip details
frontend/home.js - Trip setup → Geolocation and reverse lookup: looks up location
frontend/home.js - Trip setup → Emergency SOS: activates SOS
frontend/home.js - Emergency SOS → Geolocation and reverse lookup: gets coordinates
frontend/home.js - Emergency SOS → Device sharing: shares details
frontend/home.js - Traveler → Swipe matching: swipes profiles
frontend/swipe.js - View navigation → Itinerary view: opens itinerary
frontend/script.js