How anasimran22/buddyride works
BuddyRide is a ride-sharing and parcel-delivery app for passengers, drivers, and administrators. Passengers search trips and book seats or parcels; drivers post trips, handle requests, and complete rides or deliveries. The backend exposes authenticated APIs backed by MongoDB, with Socket.io for live location and notifications and an ML service for route/fare-related capabilities. The README documents the core booking and tracking flows; several secondary feature implementations are represented from the repository tree, so their internal wiring is not asserted here.
Main entry points: bookingController.js Booking and delivery · server.js HTTP and socket server · adminController.js Admin management · socketHandler.js Live event handling
Components 24
Mobile app
- BuddyRide app
frontend/App.tsx - Session management
frontend/src/context/AuthContext.tsx - Trip search
frontend/src/screens/passenger/SearchScreen.tsx - Driver operations
frontend/src/screens/driver/DriverScreens.tsx - Passenger rides
frontend/src/screens/passenger/PassengerScreens.tsx - Parcel tracking
frontend/src/screens/passenger/ParcelTrackScreen.tsx - Safety features
frontend/src/services/safetyApi.ts - Wallet screens
frontend/src/screens/passenger/WalletScreen.tsx - Admin console
frontend/src/screens/admin/AdminDashboardScreen.tsx
Backend API
- HTTP and socket server
backend/server.js - Authentication
backend/controllers/authController.js - Trip management
backend/controllers/tripController.js - Booking and delivery
backend/controllers/bookingController.js - Admin management
backend/controllers/adminController.js - Safety, wallet, and feedback
backend/routes - ML API client
backend/services/mlApi.js
Domain data
- User records
backend/models/User.js - Trip records
backend/models/Trip.js - Booking records
backend/models/Booking.js
Live services
- Live event handling
backend/sockets/socketHandler.js - Notifications
backend/utils/notify.js
ML service
- Route and demand API
ml-service/main.py
Other components
- Passengers and drivers
- Administrators
Connections 32
- Passengers and drivers → BuddyRide app: use
README.md - Administrators → Admin console: manage
README.md - BuddyRide app → Session management: provides session
frontend/App.tsx - Session management → Authentication: authenticates through
README.md - Session management → Live event handling: connects socket
frontend/src/context/AuthContext.tsx - Trip search → Trip management: requests trips
frontend/src/screens/passenger/SearchScreen.tsx - Trip search → Booking and delivery: requests booking
frontend/src/screens/passenger/SearchScreen.tsx - Driver operations → Trip management: posts trips
- Passenger rides → Booking and delivery: manages rides
- Parcel tracking → Booking and delivery: tracks delivery
- Safety features → Safety, wallet, and feedback: uses safety API
- Wallet screens → Safety, wallet, and feedback: uses wallet API
- Admin console → Admin management: calls admin API
- HTTP and socket server → Authentication: mounts routes
backend/server.js - HTTP and socket server → Trip management: mounts routes
backend/server.js - HTTP and socket server → Booking and delivery: mounts routes
backend/server.js - HTTP and socket server → Safety, wallet, and feedback: mounts routes
backend/server.js - HTTP and socket server → Admin management: mounts routes
backend/server.js - HTTP and socket server → Live event handling: registers handlers
backend/server.js - Authentication → User records: reads users
backend/controllers/authController.js - Trip management → Trip records: reads and writes
backend/controllers/tripController.js - Booking and delivery → Booking records: reads and writes
backend/controllers/bookingController.js - Booking and delivery → Trip records: reserves trip seats
backend/controllers/bookingController.js - Booking and delivery → ML API client: requests fare estimate
backend/controllers/bookingController.js - Trip management → ML API client: requests predictions
backend/controllers/tripController.js - ML API client → Route and demand API: calls ML service
- Live event handling → User records: updates location
backend/sockets/socketHandler.js - Live event handling → Booking records: checks bookings
backend/sockets/socketHandler.js - Live event handling → Notifications: sends alerts
backend/sockets/socketHandler.js - Admin management → Booking records: manages bookings
backend/controllers/adminController.js - Admin management → Trip records: monitors trips
backend/controllers/adminController.js - Admin management → User records: manages users
backend/controllers/adminController.js