How debang5hu/travel-companion-finder-system works
Travel Companion Finder is a Flask/MySQL web app for creating traveler profiles, discovering compatible users and trips, organizing groups, and messaging. The user-facing flow is browser pages → shared API client → Flask endpoints; recommendations use profile, ratings, location, and clustering signals. Group and chat capabilities are documented, but their implementation is part of the large Flask module and was not sampled in detail. Edges to those domain handlers are therefore documented at the API boundary; the recommendation-to-model call is shown as unverified.
Main entry points: api.js API client · main.sql MySQL database · poi.py POI service · frontend Browser pages
Components 12
Web experience
- Browser pages
app/frontend - API client
app/frontend/js/api.js
Accounts and groups
- Accounts and auth
app/backend/app.py - Travel groups
app/backend/app.py
Messaging
- Private chat
app/backend/app.py - Group chat
app/backend/app.py
Discovery and recommendations
- Recommendation endpoint
app/backend/app.py - Hybrid recommender
app/backend/module/recommender.py - POI service
app/backend/module/poi.py
Data services
- MySQL database
app/backend/main.sql
Other components
- Traveler
- OpenTripMap
Connections 15
- Traveler → Browser pages: uses
README.md - Browser pages → API client: requests data
- API client → Accounts and auth: calls account APIs
app/frontend/js/api.js - API client → Travel groups: calls group APIs
app/frontend/js/api.js - API client → Private chat: calls chat APIs
app/frontend/js/api.js - API client → Group chat: calls group chat
app/frontend/js/api.js - API client → Recommendation endpoint: requests matches
app/frontend/js/api.js - Accounts and auth → MySQL database: reads and writes
app/backend/app.py - Travel groups → MySQL database: reads and writes
app/backend/app.py - Private chat → MySQL database: reads and writes
app/backend/app.py - Group chat → MySQL database: reads and writes
app/backend/app.py - Recommendation endpoint → Hybrid recommender: requests scores
app/backend/app.py - Hybrid recommender → MySQL database: loads profiles and ratings
app/backend/module/recommender.py - POI service → OpenTripMap: fetches places
app/backend/module/poi.py - POI service → MySQL database: upserts places
app/backend/module/poi.py