How adityagarwal15/bugease works
Campus Buggy Tracker is a student-and-driver campus transport web app. Students authenticate, view buggy availability and follow live vehicle locations; drivers authenticate, set running status and share GPS updates. The frontend routes role-specific pages and uses REST and WebSocket services, while Django provides user and tracking APIs. The README also describes booking, history, alerts and analytics, though it labels some capabilities planned; those areas are shown as product surfaces without assuming they are fully operational. Evidence for unsampled page internals and several backend routes is limited.
Main entry points: App.tsx Route application · TrackingMap.tsx Tracking map · consumers.py Location consumer · Dashboard.tsx Student views
Components 26
Web client
- Route application
frontend/src/App.tsx - Student views
frontend/src/pages/Dashboard.tsx - Driver views
frontend/src/pages/driver/Dashboard.tsx - Tracking map
frontend/src/pages/TrackingMap.tsx
Identity and profiles
- Login and signup
frontend/src/pages/Signup.tsx - Profiles
frontend/src/pages/Profile.tsx - Auth service
frontend/src/services/authService.ts
Vehicle tracking
- Tracking service
frontend/src/services/trackingService.ts - WebSocket service
frontend/src/services/websocketService.ts
Transport features
- Ride booking
frontend/src/pages/BookRide.tsx - Ride history
frontend/src/pages/RideHistory.tsx - Admin panel
frontend/src/pages/AdminPanel.tsx - Alerts and notices
frontend/src/pages/Alerts.tsx - Usage analytics
frontend/src/pages/UsageStats.tsx
Django services
- User API views
backend/campusbuggy/users/views.py - User serializers
backend/campusbuggy/users/serializers.py - User model
backend/campusbuggy/users/models.py - Tracking REST API
backend/campusbuggy/tracking/views.py - Buggy data
backend/campusbuggy/tracking/models.py - WebSocket routing
backend/campusbuggy/tracking/routing.py - Location consumer
backend/campusbuggy/tracking/consumers.py
Other components
- Students
- Drivers
- REST API
- WebSocket server
- Google Maps
Connections 33
- Students → Route application: use
- Drivers → Route application: use
- Route application → Student views: routes
frontend/src/App.tsx - Route application → Driver views: routes
frontend/src/App.tsx - Route application → Tracking map: routes
frontend/src/App.tsx - Route application → Ride booking: routes
frontend/src/App.tsx - Route application → Ride history: routes
frontend/src/App.tsx - Route application → Admin panel: routes
frontend/src/App.tsx - Route application → Alerts and notices: routes
frontend/src/App.tsx - Route application → Usage analytics: routes
frontend/src/App.tsx - Students → Login and signup: authenticate
- Drivers → Login and signup: authenticate
- Login and signup → Auth service: uses
- Auth service → REST API: HTTP requests
frontend/src/services/authService.ts - REST API → User API views: serves user endpoints
- User API views → User serializers: validates and formats
backend/campusbuggy/users/views.py - User serializers → User model: creates and authenticates
backend/campusbuggy/users/serializers.py - Students → Student views: view availability
- Student views → Tracking service: fetches buggy data
- Tracking map → Tracking service: loads locations
- Tracking service → REST API: HTTP requests
frontend/src/services/trackingService.ts - REST API → Tracking REST API: serves tracking endpoints
- Tracking REST API → Buggy data: reads and updates
- Drivers → Driver views: share location
- Driver views → WebSocket service: sends location
- WebSocket service → WebSocket server: connects and sends updates
frontend/src/services/websocketService.ts - WebSocket server → WebSocket routing: routes connection
- WebSocket routing → Location consumer: dispatches
backend/campusbuggy/tracking/routing.py - Location consumer → Buggy data: updates locations
backend/campusbuggy/tracking/consumers.py - Location consumer → WebSocket server: broadcasts updates
- Tracking map → Google Maps: renders map
- Students → Profiles: manage profile
- Route application → Profiles: routes
frontend/src/App.tsx