How yashn555/travel-friend works
A-Traveler-Friend is a social travel-planning application: users register, discover travel companions, form groups, and coordinate trips using shared planning tools and chat. The graph follows the documented frontend-to-API-to-domain workflow, with group planning, expenses, AI assistance, authentication, and real-time communication represented as capabilities. Backend connection details are sampled only in part; documented but unsampled feature links are dashed where their exact runtime wiring is not evidenced.
Main entry points: App.jsx React application · aiChatService.js Gemini trip assistant · groupController.js Group management · Group.js Group records
Components 25
Web client
- React application
frontend/src/App.jsx - Registration and login
frontend/src/pages/auth - Travel dashboard
frontend/src/pages/DashboardPage.jsx - Find companions
frontend/src/pages/FindFriendsPage.jsx - User profiles
frontend/src/pages/ProfilePage.jsx - Group workspace
frontend/src/pages/groups/GroupDetailsPage.jsx - Trip creation
frontend/src/pages/trips/CreateTripPage.jsx - Group messaging
frontend/src/pages/chat/GroupChatPage.jsx
Backend API
- Authentication API
backend/controllers/authController.js - People and profile API
backend/controllers/userController.js - Group management
backend/controllers/groupController.js - Trip planning API
backend/controllers/tripController.js - Group planning API
backend/controllers/groupDashboardController.js - Expense management
backend/controllers/expenseController.js - AI travel chat
backend/routes/aiChatRoutes.js - JWT authorization
backend/middleware/authMiddleware.js - Chat and realtime
backend/routes/chatRoutes.js
Travel collaboration
- Gemini trip assistant
backend/services/aiChatService.js
Persistence and services
- User records
backend/models/User.js - Group records
backend/models/Group.js - Expense records
backend/models/Expense.js - Itinerary data
backend/models
Other components
- Traveler
- Weather provider
- MongoDB
Connections 32
- Traveler → React application: uses
- React application → Registration and login: routes to
frontend/src/App.jsx - React application → Travel dashboard: routes to
frontend/src/App.jsx - React application → User profiles: routes to
frontend/src/App.jsx - React application → Group workspace: routes to
frontend/src/App.jsx - React application → Group messaging: routes to
frontend/src/App.jsx - Registration and login → Authentication API: submits auth
- Travel dashboard → Group management: loads groups
- Find companions → People and profile API: finds travelers
- User profiles → People and profile API: updates profile
- Group workspace → Group management: manages groups
- Trip creation → Trip planning API: creates trips
- Group workspace → Group planning API: plans together
- Travel dashboard → Expense management: tracks expenses
- Group messaging → Chat and realtime: sends messages
- Authentication API → User records: reads and writes
- JWT authorization → User records: loads identity
backend/middleware/authMiddleware.js - Group management → Group records: reads and writes
backend/controllers/groupController.js - Group management → User records: reads
backend/controllers/groupController.js - Group planning API → Group records: checks membership
backend/controllers/groupDashboardController.js - Group planning API → Itinerary data: manages itinerary
backend/controllers/groupDashboardController.js - Expense management → Expense records: reads and writes
backend/controllers/expenseController.js - Expense management → Group records: checks group
backend/controllers/expenseController.js - Expense management → User records: loads members
backend/controllers/expenseController.js - AI travel chat → Gemini trip assistant: requests answers
backend/routes/aiChatRoutes.js - AI travel chat → Group records: fallback reads
backend/routes/aiChatRoutes.js - Gemini trip assistant → Group records: loads trip context
backend/services/aiChatService.js - Gemini trip assistant → Expense records: loads trip context
backend/services/aiChatService.js - Gemini trip assistant → Itinerary data: loads itinerary
backend/services/aiChatService.js - Gemini trip assistant → MongoDB: queries through ODM
- Group management → MongoDB: persists records
- Weather provider → Trip planning API: provides conditions