How naresh-kumar08/campus_ride_share works
Campus Ride Share is a student-only ride marketplace: students register and authenticate, browse or post rides, request and confirm bookings, complete trips, then rate participants or report complaints. Administrators manage users, rides, and complaints. The React app calls an Express API; its controllers implement domain rules over MongoDB models. The README documents OTP email verification and the major rating, complaint, and admin capabilities. Some UI and controller internals were not sampled, so their links are shown only where the README or source index supports them.
Main entry points: User.js User records · auth.js JWT access control · models Ride and booking records · App.js App routes
Components 27
Student web app
- App routes
Frontend/src/App.js - Account screens
Frontend/src/pages/Register.js - Auth state
Frontend/src/context/AuthContext.js - API client
Frontend/src/api.js - Ride discovery
Frontend/src/pages/Dashboard.js - Trip history
Frontend/src/pages/PreviousRides.js - Admin dashboard
Frontend/src/pages/AdminDashboard.js
Identity and access
- Auth routes
Backend/routes/authRoutes.js - Account services
Backend/controllers/authController.js - JWT access control
Backend/middleware/auth.js - User records
Backend/models/User.js
Rides and bookings
- Ride routes
Backend/routes/rideRoutes.js - Ride management
Backend/controllers/rideController.js - Ride and booking records
Backend/models - Booking routes
Backend/routes/bookingRoutes.js - Booking lifecycle
Backend/controllers/bookingController.js
Trust and administration
- Two-sided ratings
Backend/controllers/ratingController.js - Rating records
Backend/models/Rating.js - Complaints
Backend/controllers/complaintController.js - Complaint records
Backend/models/Complaint.js - Admin routes
Backend/routes/adminRoutes.js - Admin management
Backend/controllers/adminController.js
API and persistence
- Express API
Backend/server.js - Email service
Backend/utils/emailService.js
Other components
- Student
- Gmail SMTP
- MongoDB
Connections 48
- Student → App routes: uses
- App routes → Account screens: routes to
Frontend/src/App.js - App routes → Ride discovery: routes to
Frontend/src/App.js - App routes → Trip history: routes to
Frontend/src/App.js - App routes → Admin dashboard: routes to
Frontend/src/App.js - Account screens → Auth state: uses
Frontend/src/pages/Register.js - Auth state → API client: calls
Frontend/src/context/AuthContext.js - Ride discovery → API client: calls
Frontend/src/pages/Dashboard.js - Trip history → API client: calls
Frontend/src/pages/PreviousRides.js - Admin dashboard → API client: calls
Frontend/src/pages/AdminDashboard.js - API client → Express API: sends requests
- Express API → Auth routes: mounts
Backend/server.js - Express API → Ride routes: mounts
Backend/server.js - Express API → Booking routes: mounts
Backend/server.js - Express API → Admin routes: mounts
Backend/server.js - Auth routes → Account services: dispatches
Backend/routes/authRoutes.js - Auth routes → JWT access control: uses
Backend/routes/authRoutes.js - Account services → User records: reads and writes
Backend/controllers/authController.js - Account services → Email service: sends verification
Backend/controllers/authController.js - Account services → JWT access control: creates tokens
Backend/controllers/authController.js - JWT access control → User records: checks identity
- Ride routes → Ride management: dispatches
Backend/routes/rideRoutes.js - Ride routes → JWT access control: uses
Backend/routes/rideRoutes.js - Ride management → Ride and booking records: reads and writes
Backend/controllers/rideController.js - Ride management → User records: checks rider
Backend/controllers/rideController.js - Booking routes → Booking lifecycle: dispatches
Backend/routes/bookingRoutes.js - Booking routes → JWT access control: uses
Backend/routes/bookingRoutes.js - Booking lifecycle → Ride and booking records: reads and writes
Backend/controllers/bookingController.js - Booking lifecycle → User records: checks participants
Backend/controllers/bookingController.js - Booking lifecycle → Rating records: checks prior ratings
Backend/controllers/bookingController.js - Booking lifecycle → Email service: sends notices
Backend/controllers/bookingController.js - Email service → Gmail SMTP: sends mail
Backend/utils/emailService.js - Admin routes → Admin management: dispatches
Backend/routes/adminRoutes.js - Admin routes → JWT access control: uses
Backend/routes/adminRoutes.js - Admin management → User records: manages
Backend/controllers/adminController.js - Admin management → Ride and booking records: manages
Backend/controllers/adminController.js - Admin management → Complaint records: manages
Backend/controllers/adminController.js - Admin management → Rating records: reads
Backend/controllers/adminController.js - Two-sided ratings → Rating records: records ratings
Backend/controllers/ratingController.js - Two-sided ratings → Ride and booking records: checks trips
Backend/controllers/ratingController.js - Two-sided ratings → User records: updates ratings
Backend/controllers/ratingController.js - Complaints → Complaint records: records reports
Backend/controllers/complaintController.js - Complaints → Ride and booking records: checks trip
Backend/controllers/complaintController.js - Complaints → Email service: notifies admin
Backend/controllers/complaintController.js - MongoDB → Ride and booking records: stores
- MongoDB → User records: stores
- MongoDB → Rating records: stores
- MongoDB → Complaint records: stores