How bhavinv2/travel-companion works
Connecting Desis is a Flask travel-companion service: travellers post routes and dates, discover compatible trips, request connections and communicate under consent and claim rules. Its wider product includes a staff console for imported and scraped posts, configurable administration, notifications, Sahayak services and a separate insurance quote experience. The README documents these capabilities, but most route and service implementations were not sampled; links below follow documented workflows, with uncertain call wiring omitted.
Main entry points: __init__.py Flask app · models.py Application database · trips.py Trip routes · chat.py Chat routes
Components 22
Traveller experience
- Trip routes
app/routes/trips.py - Trip discovery
app/routes/matches.py - Route matching
app/services/matching.py - Chat routes
app/routes/chat.py - Claim flow
app/routes/claim.py
Staff and imports
- CS console
app/routes/cs.py - Spreadsheet import
app/services/importer.py - Scraper console
app/routes/scraper.py - Scrape worker
app/services/scraper_worker.py - Scrape service
app/services/scraper.py
Insurance quotes
- Insurance experience
frontend/insurance/src/App.tsx - Quote handling
app/routes/main.py
Administration
- Admin console
app/routes/admin.py - Notifications
app/services/notify.py
Shared platform
- Flask app
app/__init__.py - Domain records
app/models.py - Sahayak service
app/services/sahayak.py - File storage
app/services/storage.py - Private files
app/routes/files.py - Application database
app/models.py
Other components
- Traveller
- CS staff
Connections 27
- Traveller → Flask app: uses
- Flask app → Trip routes: dispatches
- Flask app → Trip discovery: dispatches
- Flask app → Chat routes: dispatches
- Flask app → Claim flow: dispatches
- Trip discovery → Route matching: finds matches
- Trip routes → Application database: stores trips
- Route matching → Application database: reads trips
- Chat routes → Application database: stores messages
- Claim flow → Application database: stores claims
- CS staff → Flask app: uses
- Flask app → CS console: dispatches
- CS console → Spreadsheet import: imports posts
- CS console → Scraper console: opens scraper
- Scraper console → Scrape worker: queues jobs
- Scrape worker → Scrape service: runs scraping
- Scrape worker → Application database: records progress
- Scraper console → Application database: reads scraped rows
- Insurance experience → Quote handling: requests quote
- Quote handling → Application database: records quote
- Flask app → Sahayak service: serves service
- Admin console → Application database: manages settings
- Admin console → Notifications: configures channels
- Trip routes → File storage: stores images
- Chat routes → File storage: stores attachments
- Private files → File storage: serves private files
- Private files → Application database: checks ownership